Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.zerokeyusb.com/llms.txt

Use this file to discover all available pages before exploring further.

This guide details every operation in the on-device editor. If you just want to create your first credential, start with the Create your first credential guide.

Step 1 — Select the credential

From the main screen, navigate to the credential you want to edit using Left/Right. If you have many, hold Left/Right to jump 10 slots at a time. Selecting credential 4 (github) When the right credential is on screen (you’ll see its number at the top left — here 4), move on to the next step.

Step 2 — Select the field and open the editor

The active field shows as an inverted white block on the left (globe = site, silhouette = user, padlock = password, key = 2FA). Switch between fields with Down/Up:
  • SiteUserPass2FA (if the credential has TOTP)
When you’re on the right field, hold Center for ~1 second to enter the editor. Long-press Center to open editor A short Center press types the field to the host (not what you want). A long press (~800 ms, until you see the large halo) opens the editor.

Step 3 — Editor anatomy

The editor looks like this: Editor anatomy
ElementFunction
Row 1Shows the current field content (max 16 chars) with an inverted cursor at the insertion point
Row 2 — < >Move the field cursor (insertion position)
Row 2 — KB1Uppercase keyboard: A B C D E F G H I J K L M N O P
Row 3 — RandFills the entire field with 12 strong random characters
Row 3 — KB2Lowercase keyboard: a b c d e f g h i j k l m n o p
Row 4 — SaveSaves changes and returns to the main view
Row 4 — KB3Numbers/symbols: 0 1 2 3 4 5 6 7 8 9 - + ! @ #

Step 4 — Move the cursor across the keyboard

When you enter the editor, focus starts on KB1 (row 2). Left/Right move the keyboard cursor within the current row. Keyboard cursor on L Press Right to advance the keyboard cursor, Left to go back. At the end/start, the cursor jumps to the control in the adjacent row (Rand, Save, <, >).

Step 5 — Insert a character

With the desired character under the keyboard cursor, press Center. It gets inserted at the field cursor’s current position, which then advances automatically. Character L inserted The L is inserted at position 5 of the field and the field cursor advances to position 6. If you wanted to replace instead of insert, read the next step.

Step 6 — Move the field cursor (not the keyboard)

Sometimes you want to edit characters in the middle of the field, not just append to the end. For that, use the < and > symbols on row 2. Field cursor active Reach the < or > symbol with Left (from KB1) and press Center. The field cursor moves one position left or right. When it’s on the position you want to edit, go back to KB1/KB2/KB3 and press Center on the new letter — it overwrites the existing one.
Keyboard insertions overwrite the character at the current position, they don’t push existing content. So “deleting” a character is simply moving onto it and entering a space (KB3, first character).

Step 7 — Generate a random password

For password fields, instead of typing letter by letter, use Rand: 12 alphanumeric + symbol characters from the ATECC608A’s hardware TRNG. Rand highlighted in editor Navigate to Rand with Down from row 2. Press Center: the field fills up. If you don’t like it, press Center again to regenerate.

Step 8 — Save

When you’re done, navigate to Save (bottom-left corner) and press Center. The changes are encrypted with AES-128 CBC and written to EEPROM. Save highlighted The editor closes and you return to the main view. The credential now has the changes.
Leaving the editor without pressing Save discards the changes. There is no confirmation: the moment you change screen via any path other than Save, what you typed is lost.

Shortcut table

ActionHow
Enter the editorLong-press Center on a field
Move keyboard cursorLeft/Right
Change row/keyboardUp/Down
Insert characterCenter on the letter
Move field cursorCenter on < or > (row 2)
“Delete” a characterMove the cursor there and insert space (KB3 first character)
Generate random passwordCenter on Rand
Save and exitCenter on Save
Discard changesUnplug USB before pressing Save

Next steps

Set up 2FA

The TOTP field is imported over USB-CDC only, not editable on-device.

Create a backup

Save your current state before editing many credentials.