Ownbook
User guide · Android

Using Ownbook on your phone

The Android app is a companion to the desktop app: it opens the same data folder, so your budget is the same wherever you look. The phone is for a quick look and quick entries; setting things up and digging deep happen on the computer.

Before you start

1. Install the app

  1. On the phone, open the download page and download the Android app (an .apk file).
  2. Open the file. If Android asks, allow your browser to install unknown apps, then tap Install.
  3. Updating later works the same way: install the newer file over the old one and your data stays. Then just open the app; there is no need to force stop it. The launch screen shows the version it is opening, and Updated to that version the first time after an update.
  4. Had a version before 0.1.123? That one installs as a separate app, because the app's id changed ahead of Google Play. Open the old app once so its last changes reach your folder, install the new one and link the same folder, then uninstall the old one.
Why not the Play Store?Not yet. For now the app is shared directly; the download page always has the latest version.

2. Start a new book, or use your computer's

The first screen offers three starts. You don't need a computer for the first.

A book started on the phone says Kept on this phone under Settings › Sync. To keep a copy somewhere safe, which also lets a computer open it, tap Keep a copy in a folder and pick an empty folder that syncs with Google Drive, Dropbox or OneDrive. The phone's book is saved there, and from then on it syncs like any other. A folder that already holds a book is never written over.

3. Get your data folder onto the phone

Only if you chose Use a Synced Folder. The app opens a real folder on the phone. Most cloud apps (Google Drive in particular) don't offer their folders to other apps, so a small sync app keeps a phone folder in step with the cloud:

  1. Install a two-way sync app such as Autosync for Google Drive or FolderSync.
  2. Sign in with the same cloud account your computer uses.
  3. Create one two-way folder pair: the cloud side is your data folder; the phone side is a new folder, for example Documents/Ownbook Data.
  4. Turn on syncing when files change, then run the first sync. Check the phone folder now contains a data folder with warehouse.db inside.

If your phone's folder picker does show your cloud folders with a working Use this folder button, you can pick the cloud folder directly and skip the sync app.

  1. Open Ownbook and tap Use a Synced Folder.
  2. Choose the phone folder from step 3: the one that contains data and categories, not the data folder itself.
  3. Tap Use this folder, then Allow. The app copies your data in and opens on Budget.
  4. Check a few balances against the computer.
Nothing is touched by mistake.If the folder you pick doesn't hold a budget, the app says so, shows what it found, and asks again. It never writes to a folder it hasn't loaded your data from.

5. The five tabs

Budget on the phone
Budget: Ready to place at the top, then each category with what's left.
Reports on the phone, leading with what's left to spend
Reports, set to Left: what's left this month and about how much a day.

Accounts are added and changed in Settings on the phone. Loans, the payoff planner and backups stay on the computer; they show up on the phone after the next sync.

6. Import a statement

Most banks let you export a statement as a CSV file. There are two ways to bring one in:

Each file becomes one card with its money out, money in and what was checked. A row that couldn't be read is listed there by line number, never left out quietly. If two of your layouts fit a file, it asks Which account is this? A card statement missing a bill payment you made from the bank says so in the review, with Add it to the card. Then:

Reviewing an imported card statement on the phone
An import's review: tap a row to pick its category.

A file Ownbook already knows needs no setup. For some, it asks once which account the rows go into, then reads files like it by themselves.

A bank Ownbook hasn't seen yet asks four quick questions, one per screen: which column has the date, how amounts are shown, which column says what it was, and which account it goes into. Each starts on Ownbook's guess. Then it shows the totals and the first rows to check before saving; after that, files like it are read by themselves.

A statement from a new card or bank: once its rows are added, the review asks where its money lives (a credit card, a bank account, part of one you have, or don't keep a balance). Ask me later keeps the question on the Nest until you answer it.

Unfinished imports carry over. Start a review on the phone and finish it on the computer, or the other way round; the picks from both are kept. Until it's done, an import also shows as Unfinished Imports at the top of Transactions. Picks reach the other device when the files sync, as in step 8.

7. Choose how it opens

Tap the gear at the top right of any tab for Settings. A dot on the gear means something there needs a look:

8. Using the phone and the computer

Use one device at a time, and let the files sync in between:

One device changes things at a time, the same as between two computers. While Ownbook is open on your computer, the phone is view only, shown in one line at the top (View only · open on …): you can look around, and Edit here moves editing to the phone (the computer goes view only once the folder passes the news on). If the computer says Ownbook is open but nothing from it has arrived for 10 minutes or more, the phone asks what to do, as the computer does (View only for now, Edit anyway, or … is closed if it shut down without closing Ownbook).

If both sides changed in between anyway, nothing is overwritten: the phone keeps its copy in your data folder for the computer, shows the computer's copy, and says This phone and … both changed things. Next time Ownbook opens on the computer it offers to Combine them, and asks only about things changed differently on each. The same happens if a change the phone sent is replaced in the folder by a copy that never had it. If the phone's copy turns out to match the folder's, the computer settles it without asking.

Cloud apps don't always bring a save's files all at once. When only part of the computer's latest changes has reached the folder, the phone keeps showing what it had, and Settings says Some of …'s latest changes are still arriving in the folder. Changes you make meanwhile wait on the phone; it brings the computer's in, and sends yours, once the rest arrives.

Try it once (5 minutes)Add a $1 "Sync test" spend on the phone and close the app. Open the desktop app: it's on Transactions. Delete it there, close the app, let it sync, and open the phone app: it's gone there too.

9. Investment prices

The phone shows your last saved prices straight away, then fetches new ones in the background when you're connected and says when they're from. Offline, it shows the last prices it or your computer fetched.

Things to check, at the end of the Investments sheet on Nest, shows only when something is open. Tidy up investment rows there offers rows saved before the add box had a kind for them a clearer one (a promotion saved as a bond coupon, free shares counted as money put in): tap Review, untick any to leave, then Apply. A backup is made first, and Undo puts them back. It also lists a deposit the bank side doesn't have, or a bank transfer the broker's records don't, since each deposit is matched with the bank side and counted once; Add it on the broker side records the matching Money in or out for it. If the check can't run, it says Couldn't check your investments instead of showing nothing.

Count my eggs on a bank, savings or card account: on Nest, open Cash or What You Owe and tap Count my eggs, then the account. Type what your bank app shows (for a card, what you owe) and the day. If it differs, Ownbook lists what it can find, then asks what the rest is: interest, a fee or charge (or a refund), Just match it (one dated Balance adjustment, in or out of Ready to place, neither spending nor income), or It was wrong from the start (the starting balance changes instead). Later changes that stop a count matching are listed under things to check, never asked about while you type: Take the adjustment out when a change explains it, otherwise Adjust by the difference, Count again or Leave it.

Count my eggs: on Nest, the Savings & investments group says how many things are open (2 to check) while folded; open it and tap 2 things to check to see them in the Investments sheet. A count due is one of them, one line per account: a match is waiting, holds nothing yet, or not matched with the broker in over a year (Not now hides that one for 3 months). A trade that doesn't add up also offers Match with the broker. Every open investment account's sheet has a Count my eggs button too, so you can count one any time; it's dark when a count is due. The account's sheet also has Uses a category: on for savings and investments you fund from a budget category, off for everyday accounts like your bank. On an account with no trades, add what you hold: one line per holding with its units, the price that day filled in, and the cash. Pick Coin for crypto, and set Counted on for an earlier day. An account with only a balance is counted once with Replace the balance and save (a backup is taken first). Later, match my broker: Ownbook's figures are filled in, change what differs, then go through each difference on its own screen, cash last, and Save all. When Ownbook can tell the reason (a coin's reward, network fees), it comes picked, with why; Something else shows the rest. Type 0 for a holding the broker no longer has (an empty box isn't read as none). Things to check appears in your investments when a trade doesn't add up.

Troubleshooting