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.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.
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.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:- Site ↓ User ↓ Pass ↓ 2FA (if the credential has TOTP)
Step 3 — Editor anatomy
The editor looks like this:| Element | Function |
|---|---|
| Row 1 | Shows 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 — KB1 | Uppercase keyboard: A B C D E F G H I J K L M N O P |
Row 3 — Rand | Fills the entire field with 12 strong random characters |
| Row 3 — KB2 | Lowercase keyboard: a b c d e f g h i j k l m n o p |
Row 4 — Save | Saves changes and returns to the main view |
| Row 4 — KB3 | Numbers/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.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.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.
< 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.
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 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 toSave (bottom-left corner) and press Center. The changes are encrypted with AES-128 CBC and written to EEPROM.
Shortcut table
| Action | How |
|---|---|
| Enter the editor | Long-press Center on a field |
| Move keyboard cursor | Left/Right |
| Change row/keyboard | Up/Down |
| Insert character | Center on the letter |
| Move field cursor | Center on < or > (row 2) |
| “Delete” a character | Move the cursor there and insert space (KB3 first character) |
| Generate random password | Center on Rand |
| Save and exit | Center on Save |
| Discard changes | Unplug 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.