Repository navigation
Highlight: vault export to Android
OneCritto Desktop can now send your passwords to the OneCritto for Android app over a USB cable, as an encrypted file that only the paired phone can open. No cloud, no account, no network connection.
How it works
Pairing your phone — once only. Connect the phone in "File transfer" mode and click Pair mobile device: the desktop detects the phone and reads the public key published by the app on its own, with no files to hunt for or copy. Both apps then display the same 8-digit code: you compare them on screen and confirm.
Exporting. Select the entries to export, save the .onecritto-vault file and copy it to the phone over the cable; the app imports it into its own vault.
Security
The protocol uses HPKE (RFC 9180) in base mode, with the DHKEM(P-256, HKDF-SHA256) + HKDF-SHA256 + AES-256-GCM suite.
No secret in transit: pairing exchanges nothing but a public key, useless to anyone who intercepts it.
Non-extractable private key: generated in the Android Keystore with PURPOSE_AGREE_KEY; the ECDH runs inside the Keystore and the key never leaves the phone.
Per-export forward secrecy: every export uses an ephemeral key, so compromising one file does not expose the others.
Recipient authenticity: AEAD verification fails if the file is not sealed for that phone or has been tampered with.
Anti-MITM pairing: the 8-digit code compared by the user prevents an attacker from substituting the phone's key.
Wire formats and deterministic test vectors are documented in docs/onecritto-v3-wire-spec.md and docs/onecritto-v3-test-vectors.json, and verified by automated tests on every build.
Requirements
OneCritto Mobile 1.0.1, Android 12 (API 31) or later
Automatic phone detection on Windows and Linux; on macOS the manual method remains
Notes and limitations
Only password entries are exported: encrypted files and SSH connections stay on your computer.
A vault is paired with one phone at a time; pairing another one replaces the previous device, after explicit confirmation.
This is not synchronisation: the export is manual and one-way (computer → phone).
Fixes
Fixed the installed application failing to start with debug mode enabled: logs were written to the installation folder, which is not writable, and startup failed with "Failed to launch JVM". Logs are now written to ~/.onecritto.
Linux: MTP devices are now mounted automatically via gio while searching for the phone, so you no longer have to open it in the file manager first.
Pairing and export confirmation messages no longer overlap the vault-saving ones.
Full changelog: v2.9.6...v2.10.0