Two ways to add codes
You can add a TOTP code to Ključar in two ways: scanning a QR code (faster) or manually entering the secret key (when QR is not available). Both methods produce the same result.
Scanning a QR code
This is the fastest method. Most services display a QR code when you enable 2FA.
- On the service's website (Gmail, GitHub, Instagram...) enable two-factor authentication.
- The service will display a QR code.
- In Ključar, tap "+" (add new code).
- Select "Scan QR code".
- Point your camera at the QR code — Ključar detects it automatically.
- Check the account name and tap "Save".
- Enter the generated 6-digit code on the website to confirm.
The QR code contains the secret key, algorithm (SHA-1/SHA-256), period (30s) and number of digits. Everything is automatically captured by scanning.
Manual entry
If you can't scan the QR code (e.g. on the same device), the service usually offers "Can't scan? Enter manually".
- On the website, copy the secret key (a string of letters and numbers, e.g.
JBSWY3DPEHPK3PXP). - In Ključar, tap "+" → "Manual entry".
- Enter the account name (e.g. "Gmail — john@gmail.com").
- Paste the secret key.
- Choose parameters (defaults are correct for most services):
- Algorithm: SHA-1 (standard), SHA-256 or SHA-512
- Period: 30 seconds (standard)
- Digits: 6 (standard) or 8
- Tap "Save".
- Enter the generated code on the website to confirm.
Don't change the parameters unless the service explicitly requires different ones. Wrong algorithm or period means codes won't work.
Organising codes
Renaming
Long-press a code → "Edit". Change the name for easier identification (e.g. "Gmail work" vs "Gmail personal").
Icons
Ključar automatically recognises popular services and displays their icon. For others, you can choose a colour or emoji.
Search
With more than 10 codes, use the search bar at the top to quickly find the right code.
Deleting
Long-press → "Delete". Ključar asks for confirmation. Deleted codes cannot be recovered.
Using codes
- Open Ključar and unlock (master password or biometrics).
- Find the account you need a code for.
- Tap the code — it's automatically copied to the clipboard.
- Paste the code on the website.
The code is automatically cleared from the clipboard after 30 seconds. The circular timer shows how much time remains before a new code is generated.
Code not working?
Device time
TOTP depends on accurate time. Check that automatic time setting is enabled in your device settings.
Wrong algorithm
Some services use SHA-256 instead of SHA-1. Check the service's documentation and match the parameters.
Code expired
TOTP codes last 30 seconds. If the circular timer is near the end, wait for a new code before entering.