KeyGenerator
User Guide
A personal vault on your Mac — no cloud, no compromises. Here's how to generate passwords and keys, and how to set up and use your encrypted vault.
Password generator
Everything runs fully offline: the app never reaches the internet and never sends any data anywhere.
- Open the Passwords section in the sidebar.
- Set the password length and character sets (lowercase/uppercase letters, digits, symbols).
- Optionally enable "Exclude look-alike characters" to avoid confusing O with 0 or l with 1.
- Click Generate new password — the password appears in the field, ready to copy.
- The eye icon shows/hides the generated value; the copy button sends it to the clipboard (with optional auto-clear after 60 seconds).
Encryption key generator
- Open the Encryption Keys section.
- Choose the key type (AES-128, AES-256, ChaCha20, or the generic 512-bit key) and the output format (Base64 or HEX).
- The key is generated automatically; Generate new key creates a new one with the current settings.
Vault: setting up the key
The first time you open the Vault section, the app will ask you to set up a vault key — a separate secret that's combined with your password and stored in macOS Keychain (not inside the app itself). Without it, no password can open the vault.
- Hex — the app immediately suggests a random value; you can leave it as is or edit it by hand.
- Phrase — type any phrase in any language (something easy to remember). The key is derived from it automatically and will always be the same for that phrase — even on another Mac.
- To use the same vault on another Mac, use the exact same key — or type the exact same phrase there — before creating or unlocking anything.
- Click Save Key to save your choice and continue.
Creating a new vault
If there's no vault yet, you'll see a prompt: Create New or Locate Existing. If any vaults are in your history (see Previously Used Vaults under Opening an existing vault, below), they're listed right here too — pick one directly instead of starting over.
- Click Choose Folder… and pick the folder where the vault file will live (you can create several vaults with different names in the same folder).
- Enter a name for the vault.
- Set a password and confirm it.
- Click Create — the vault is created and opens right away.
Opening an existing vault
If the vault file already exists on disk, the app remembers its location and, on your next visit, only asks for the password (Unlock Vault…). To point it at a different file, use Locate Existing or Forget Vault to detach from the current one and choose a new one. Every vault you've ever created or located shows up in a Previously Used Vaults list on this screen (vault icon, name, and file size) — the currently remembered one is highlighted there, but the list itself stays locked until you click Forget Vault; afterward, picking a row there works just like Locate Existing, without re-browsing for the file. Entries whose file no longer exists are dropped automatically. The context menu on any other entry (not the currently remembered one) offers Remove from List, with a confirmation — this only forgets it here, the vault file itself is untouched.
Adding and editing entries
- Click Add Entry.
- Fill in the fields: type (password/key), name (required), usage/account, project, status (active/inactive), generation parameters, description, and the secret value itself (required).
- Click Save.
- Click an entry in the list to edit it; use the context menu to delete one.
- The secret value is never shown directly in the list — only inside the entry form.
Storing other files
The Keys / Files switcher at the top of an open vault (next to Change Password) lets you keep any other document inside the vault, not just generated passwords and keys — encrypted exactly the same way.
- Add File… opens a picker to copy one or more files into the vault.
- Click a file to select it (⇧-click or ⌘-click to select several); double-click a file, or use Open, to open it with its default application.
- Open With… lets you pick a specific application to open the selected file with.
- Copy saves the selected file(s) to a location you choose outside the vault, keeping the copy in the vault as well.
- Move does the same, then deletes the selected file(s) from the vault.
- Delete removes the selected file(s) from the vault. The context menu on a file offers the same actions.
Locking the vault
Click Lock Vault (next to the Keys/Files switcher) to lock it yourself at any time, without waiting for one of the automatic triggers below. The vault also locks (unmounts) automatically in several cases:
- Switching sections — moving to Passwords, Encryption Keys, or Transfer locks the vault after a 2-minute grace period; switching back to Vault or Vault Key within that window cancels the lock (Vault Key counts as part of the vault workflow, so hopping there and back never locks it).
- Sitting idle — leaving the Vault screen open without touching the mouse or keyboard for 15 minutes locks it automatically, even if you never switched away.
- Sleep, screen lock, or switching users — locks it immediately, without waiting for either timer above.
- Quitting the app — locks it right away.
Moving the vault to another Mac
- To use the same vault on another computer, you need three things: the vault file, the password, and the same vault key.
- Type the same phrase in Phrase mode on the new Mac — the key is derived automatically, nothing to copy.
- Or copy the key itself using the Transfer section, or manually via Keychain Access.
Changing the vault key
Vault Key, in the sidebar below Transfer, lets you switch which key is currently active in Keychain — for example, to bring several vaults created under different keys onto one common key so they can all be opened on the same Mac without switching back and forth. It opens the same screen as the first-time setup, with a warning: switching the key doesn't touch any vault file, only what the app currently has active in Keychain. A vault encrypted under a different key will show "Incorrect password" until you either switch back to its key or update its password to match the new one, using Change Password below.
Changing a vault's password
While a vault is open, click Change Password in its toolbar to re-encrypt it in place with a new password under whichever vault key is currently active in Keychain. If the app still remembers your current password from unlocking it this session, only the new password is asked for; otherwise you'll also be asked to confirm the current one first.
Bringing several vaults under one key
To make several existing vaults — each created under a different vault key — all open with the same key on one Mac, repeat for each vault:
- Vault Key → enter that vault's original key → Save Key.
- Vault → locate and unlock that vault with its password.
- Vault Key again → enter the common key you want to standardize on → Save Key (the open vault stays open — switching between Vault and Vault Key doesn't lock it).
- Vault → Change Password → set a new password → confirm.
- Once every vault has been through this, they all open with the same vault key.
Transfer
The Transfer item at the bottom of the sidebar lets you copy any combination of the following to another disk or drive. The vault must be mounted (unlocked) before a transfer can start — open it first if it's locked:
- Application — the Key Generator app itself.
- Vault — your vault file.
- Vault Key — the vault key from Keychain, exported as a text file.
- Pick what you need, click Choose Folder… to set the destination, and click Apply. If files with the same names already exist at the destination, the app will ask you to confirm overwriting them.
Security and privacy
- All passwords and keys are generated locally through macOS's cryptographically secure system random number generator.
- The vault is a standard AES-256 encrypted disk image (.sparsebundle) that can be opened not only by this app but by any macOS system tool, given the password and the key.
- The vault key is stored in Keychain, not in the app's code — it can't be extracted just by reverse-engineering the program.
- The app has no internet access and sends nothing anywhere: everything you create stays on your Mac (or on whatever drive you choose to move it to).
- Since the app deliberately never reaches the internet, it can't check for or install updates on its own — watch for new releases and update manually from keygenerator-macos.com.