Documentation

Installation

Download TwinKey from the App Store. The app is free and works on iPhone with iOS 15 or later. No registration required — you can start using it right away.

Adding an account — scanning a QR code with the camera

Tap "+" in the top-right corner of the main screen. The scanner will open — point your camera at the QR code (usually shown on a website or service when enabling two-factor authentication). As soon as the code is in frame, the app will recognize it and add the account right away — a login code will start generating automatically.

TwinKey main screen with a list of accounts; the "+" button in the top-right corner is circled in red — Main screen — the "+" button

Scanner screen with a QR code in the camera's frame — QR code in the scanner's frame

Adding an account — from a QR code photo in the gallery

In the scanner, tap "Select from Photos" — your device's photo library will open. Choose a photo containing a QR code (for example, a screenshot you received or downloaded) — the app will recognize the code in the image and add the account.

Scanner screen with an empty camera viewfinder; the "Select from Photos" button is outlined in red — The "Select from Photos" button

Photos app screen with a saved QR code screenshot open, about to be selected for import — Selecting a QR code from the photo library

Adding an account — manually

In the scanner, tap "Add Manually" — a form will open for entering account details. Fill in the service name (issuer), username, and secret key; if needed, you can also set the algorithm, code length, and time interval (if the service didn't specify these, the defaults usually work fine). The app will add the account and start generating codes.

Scanner screen with an empty camera viewfinder; the "Add Manually" button is outlined in red — The "Add Manually" button

Empty manual entry form with placeholder hints in the service name, key, and username fields — Manual entry form

Importing multiple accounts from Google Authenticator

If you're moving accounts from Google Authenticator, start the account transfer there — the app will display a QR code containing multiple accounts at once. In TwinKey, tap "+" and point your camera at that code (or load it as a photo via "Select from Photos"). The app will show a list of the accounts found — select the ones you want and confirm the import.

Screen listing the accounts recognized from the Google Authenticator transfer QR code — some are already checked; a "Select All" button is at the bottom — Accounts recognized from the QR code

Searching accounts

The main screen has a search bar — start typing a service name or username and the account list will filter in real time.

Copying a code

Tap a code on the main screen — it will be copied to your clipboard. If Universal Clipboard (Handoff) is enabled on both your iPhone and Mac, a code copied on your phone can be pasted on your computer right away — and vice versa.

Editing

Open Settings and tap "Edit" in the "Accounts" section — the list will enter edit mode. Tap an account to change the username or service name, or to view the key. You can also delete an account from here. To reorder accounts, drag them to the desired position.

TwinKey Settings, "Accounts" section; the "Edit" item is underlined in red — "Accounts" section — "Edit"

Account list in edit mode — each account has a drag handle next to it — List in edit mode

Google account details screen with fields for username, key, number of digits, time interval, and algorithm, plus a delete-account button at the bottom — Account editing screen

Exporting and importing data

In Settings, under "Accounts", choose "Export to File". You can export all accounts at once or select specific ones — the app will save them as a .twinkey file. Import works the same way: choose "Import from File", select the .twinkey file, and pick which accounts to add.

Settings, "Accounts" section; "Export to File" and "Import from File" are underlined in red — Export and import in Settings

Account selection screen for export — all accounts are checked; the export icon in the top-right corner is circled in red — Selecting accounts to export

Data Management

In Settings, open the "Data Management" section. Two actions are available: "Delete Accounts" removes all accounts from the app, and "Erase All" removes accounts along with all settings, returning the app to its initial screen.

iCloud sync

TwinKey stores keys in iCloud Keychain — Apple's secure storage, separate from the app itself. This means that if you delete the app and reinstall it, all your accounts will still be there. Other apps have no access to these keys. Sync between iPhone and Mac works automatically — no additional setup is needed in the app. To enable it, turn on password syncing in iCloud settings on each device.

iCloud settings screen with storage sections; the "Passwords" tile is outlined in red — "Passwords" in iCloud

"Passwords & Keychain" screen; the "Sync this iPhone" toggle is on and outlined in red — Sync for this iPhone is on

Installation

Download TwinKey from the Mac App Store. The app is free and works on Mac with macOS 13 Ventura or later. No registration required — it's ready to use right after installation.

Adding an account — from a QR code photo

Click "+" on the main screen — a menu will appear with "Select from Photos" and "Add Manually" options. Choose "Select from Photos" — Finder will open, where you can select a file or a photo with a QR code. The app will recognize the code and add the account.

TwinKey main window with a list of accounts; the dropdown menu from the "+" button is open, showing "Select from Photos" and "Add Manually" — Dropdown menu after clicking "+"

Finder's "Select from Photos" window with a saved QR code image selected — Finder window for selecting an image

Adding an account — manually

Click "+" on the main screen and choose "Add Manually" — a form will open for entering account details. Fill in the service name (issuer), username, and secret key; if needed, you can also set the algorithm, code length, and time interval. The app will add the account and start generating codes.

TwinKey main window with a list of accounts; the dropdown menu from the "+" button is open, with "Add Manually" highlighted — Dropdown menu with "Add Manually" selected

"New Account" form with fields for service provider, key, username, time interval, number of digits, and algorithm — Manual entry form

Importing multiple accounts from Google Authenticator — via photo

If you're moving accounts from Google Authenticator, start the account transfer there and save the QR code that appears as an image (for example, by taking a screenshot). In TwinKey, click "+", choose "Select from Photos", and select the saved image. The app will show a list of the accounts found — select the ones you want and confirm the import.

"Import Accounts" window listing the accounts recognized from the Google Authenticator image — some are already checked; a "Select All" button is at the bottom — Accounts recognized from the image

Searching accounts

The main screen has a search bar — start typing a service name or username and the account list will filter in real time.

Copying a code

Click a code on the main screen — it will be copied to your clipboard. If Universal Clipboard (Handoff) is enabled on both your Mac and iPhone, a code copied on your computer can be pasted on your phone right away — and vice versa.

Editing

On the main screen, click "Edit" — the list will enter edit mode. Click an account to change the username or service name, or to view the key. You can also delete an account from here. To reorder accounts, drag them to the desired position.

TwinKey main window with a list of accounts; the "Edit" button in the top-left corner is outlined in red — Main screen with the "Edit" button

Account list in edit mode, with the "Done" button in the top-left corner; accounts here can be dragged to reorder them — Edit mode — drag accounts to reorder them

Account editing form with fields for service provider, username, and key, plus number of digits, time interval, algorithm, and a "Delete Account…" button — Account screen with editable fields

Exporting and importing data

Open Settings via the TwinKey menu in the menu bar at the top of the screen. Under "Accounts", choose "Export to File" — you can export all accounts or just the ones you select. The .twinkey file works on both Mac and iPhone. Import works the same way: choose "Import from File" and select the accounts you want to add.

TwinKey menu in the menu bar with "Settings…" highlighted — TwinKey menu in the menu bar

Settings window, "Accounts" section, with the "Export to File" and "Import from File" buttons outlined in red — Settings, "Accounts" section

"Export Accounts" dialog with a checked list of accounts and the "Next" button outlined in red — Selecting accounts to export

Data Management

iCloud sync

macOS System Settings, iCloud section; the "Passwords" tile, showing "On", is outlined in red — iCloud settings on Mac — Passwords section (enabled)

Installation

Download TwinKey from Google Play or RuStore. The app is free and works on Android 8 or later. No registration required — you can start using it right away.

Adding an account — scanning a QR code with the camera

Adding an account — from a QR code photo in the gallery

In the scanner, tap "Select from Photos" — your device's gallery will open. Choose a photo containing a QR code (for example, a screenshot you received or downloaded) — the app will recognize the code in the image and add the account.