Adding TOTP Codes
Scan a QR code or enter the secret key — 2FA for any account.
Two ways to add codes
Ključar is in beta. The steps below describe the Android beta and may change before the official release.
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, and codes are generated on your device.
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 "+".
- Choose "Skeniraj QR / ručni unos" (Scan QR / manual entry) — the "Skeniraj QR" tab opens.
- Point your camera at the QR code — Ključar detects it automatically.
- Ključar saves the code as soon as it recognises the QR and returns you to the code list.
- Enter the generated code (usually 6 digits) on the website to confirm.
The QR code contains the secret key, algorithm, period 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 "+" → "Skeniraj QR / ručni unos" → the "Ručni unos" (Manual entry) tab.
- Enter the service name (e.g. "Gmail") and, optionally, the account (e.g. "john@gmail.com").
- Paste the secret key.
- If needed, open "Napredne postavke" (Advanced settings) — defaults are correct for most services:
- Algorithm: SHA-1 (standard), SHA-256 or SHA-512
- Period: 30 seconds (standard) or 60 seconds
- Digits: 6 (standard) or 8
- Tap "Spremi" (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
Icons
Ključar automatically recognises popular services and displays their icon. Other services show a circle with the first letter of the name.
Editing and deleting
Renaming, deleting and searching codes are not available in the beta yet. So enter a clear service and account name right when you add a code (e.g. "Gmail" and "work").
Using codes
- Open Ključar (if you turned on the biometric lock, confirm with your fingerprint).
- Find the account you need a code for.
- Tap the code — it's automatically copied to the clipboard.
- Paste the code on the website.
After a short time the code is automatically cleared from the clipboard. The circular timer shows how much time remains until a new code, and near the end the next code is shown below.
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 usually last 30 seconds. If the circular timer is near the end, wait for a new code before entering.
Did not find an answer? Write to us