Getting started
The Getting started card on Home walks you through the basics: looking around, adding an expense and income, choosing an AI model, letting the AI write an entry, and backing up or syncing. To try things first, add the sample journal of made-up transactions (Settings › Journals › Add the sample journal) and remove it when you no longer need it.
Open a journal you already keep
Settings › Journals › Open a journal: choose a single journal file, or a folder whose main file includes the others. Twentry works on its own copy and doesn't change the original in Files. To take your changes back to a computer, use Export on that journal, or sync it with GitHub.
Import a bank statement
Export a statement from your bank's website or app as a CSV or Excel file. In Twentry, tap + on Home, then Bank statement, and choose the file. Twentry finds the date, description and amount columns; you check every line and its category before anything is saved.
Use the AI
In Settings, open Models. Twentry lists the models that fit your iPhone and suggests the most accurate one. A model is a file of 2.5–4.6 GB, downloaded once from its page on Hugging Face; after that, the AI works offline.
Then tap + on Home and choose With AI. Type, dictate or show what happened, and tap Propose. Check each proposed entry: a field the AI had to guess is marked, and nothing is saved until you confirm it.
Sync with GitHub
Sync keeps a copy of your journal in your own private GitHub repository: a backup, and the same journal for Ledger or hledger on a computer. It's optional.
- On github.com, create a private repository without a README (for example, my-money). If your journal is already on GitHub, use its repository.
- Create a fine-grained token: on github.com, open Settings › Developer settings › Personal access tokens › Fine-grained tokens › Generate new token. Under Repository access, choose Only select repositories and pick that repository. Under Repository permissions, set Contents to Read and write. Generate the token and copy it.
- In Twentry, open Settings › Journals. For the journal on your iPhone, tap GitHub and publish it to the empty repository. For a journal already on GitHub, choose Connect a GitHub repository instead. Paste the repository (owner/name) and the token.
The token stays in your iPhone's Keychain and is sent only to GitHub. Before every upload, Twentry checks that the repository is still private, and sends nothing if it isn't. A private repository isn't encrypted: GitHub, and anyone you give access to it, can read the journal.
Backups and restoring
Before every change, Twentry keeps the previous version of the journal, for the last 50 changes: Settings › Journals › Backups, where any of them can be restored. Your iPhone's own backups, to iCloud or a computer, include Twentry's data too.
Removing your data
Settings › Journals, ⋯, Remove from this phone deletes the journal's files, its backups and its token from this iPhone; a GitHub repository keeps its own copy. Deleting the app deletes everything it kept on the iPhone.
Common questions are answered on the home page.