Accountant User manual
Contents

Shared ledger

Keep one ledger together with someone who uses a different Google account.

A shared ledger lets two or more people with different Google accounts keep one ledger together, for example a couple, business partners, or a bookkeeper and a client. Everyone sees the same records, and everyone's changes reach everyone else.

Sharing builds on Sync across devices. Each phone shares its ledger file in Google Drive with the other people and reads theirs. There's no server in between.

Shared ledger is Experimental. Adding people may need Premium.

Before you start

Each person needs:

Below, "the person sharing" already syncs the ledger, and "the person joining" joins it.

Set up sharing

Setup takes about two minutes. Nobody types an email address or a file name.

1. Person joining: show your invite code

Open Settings โ€บ Shared ledger (just below Sync across devices) and tap Join someone's ledger. Your phone shows an invite code. Keep this screen open.

2. Person sharing: add the person

  1. Open Settings โ€บ Shared ledger and tap Add a person.
  2. Scan the invite code on the other phone.
  3. Confirm Share this ledger with โ€นtheir emailโ€บ? with Share.

Your phone now shows a ledger code. Keep it open.

3. Person joining: scan the ledger code and pick the file

  1. Tap Scan ledger code and scan the code on the other phone.
  2. A message tells you which file to choose, for example "Ana's phone (3f9a2c1b).db". Tap Choose file.
  3. In the file picker, open Google Drive โ€บ Shared with me and choose that file. If it isn't there yet, wait half a minute and try again.
  4. If your phone already has records, choose:
    • Use the shared copy: your records are replaced by the shared ledger. A copy of yours is saved first; you can bring it back with Undo last import until anything syncs.
    • Keep and combine: your records are added to the shared ledger, and the others will see them. Only offered when both ledgers use the same reporting currency.

You'll see "You joined โ€นemailโ€บ's ledger."

4. Person sharing: connect back

Tap Done. Under People, the new person shows Not connected on this device. Tap their name, choose Connect on this device, and pick their file the same way: Google Drive โ€บ Shared with me.

That's it. Changes now flow both ways.

Why does each side pick a file? For your privacy, Accountant can only open Drive files you created or chose yourself. It never asks for access to your whole Drive. Choosing the other person's file once gives your phone permission to read that one file.

Your other phones

You only need to connect one of your phones to each person. Your other phones on the same Google account get their changes through it, shown as Connected through โ€นphoneโ€บ. You can still connect another phone directly with Connect on this device.

Adding more people

Repeat the setup for each new person. Anyone already in the ledger can add someone.

When changes arrive

Phones sync when you open the app, after you change something, and when you pull down on Transactions. A change usually reaches the other person within a minute or two of their syncs. If they haven't opened the app, their latest changes wait on their phone.

If two people change the same record before syncing, the most recent change wins. Different records never overwrite each other.

The People list

Settings โ€บ Shared ledger lists everyone, you first.

Status What to do
Connected ยท last change โ€นtimeโ€บ Nothing.
Connected ยท waiting for their first change Nothing.
Connected through โ€นphoneโ€บ Nothing. Optionally connect this phone too.
Not connected on this device. Tap to connect. Tap โ€บ Connect on this device.
Can't read their file anymore. Tap to connect again. Tap โ€บ Connect on this device and pick their file again.
Isn't getting your changes. Tap to show them your ledger code again. Usually nothing; your phone shares again right away. If it stays, tap โ€บ Show ledger code and have them scan it.
The Google Drive app is off on this phoneโ€ฆ Tap โ€บ Turn on Google Drive.
Uses another ledger now. Remove them, or ask them to join again.
Their changes can't be added right now (โ€นreasonโ€บ). Update Accountant on both phones.

Tap a person for Connect on this device, Show ledger code or Remove from ledger.

Removing someone

Tap the person โ€บ Remove from ledger โ€บ confirm. Your phones stop sharing with them and stop reading their file, and so does everyone else once they sync.

Who can do what

Everyone in a shared ledger is equal. Anyone can add, edit and delete any record, and add or remove people. Only share with people you trust with your whole ledger.

Leaving

There's no "Leave" button yet. Ask someone in the ledger to remove you, or switch this phone to another Google account (tap Sync across devices โ€บ Change Google account).

Turning Sync across devices off only pauses syncing. You stay in the ledger, and the others can still read the last version your phone uploaded.

What is shared, and what isn't

Shared with everyone in the ledger:

Not shared:

Files are shared view-only and without an email notification.

Messages during setup

Message What happened
That isn't an Accountant sharing code. The QR code is something else.
That's your own code. Scan the code on the other person's phone.
That isn't an Accountant ledger file. Pick the file named in the message.
That file is from another version of Accountant. Update Accountant on both phones.
That file belongs to another ledger. You chose a file from a different ledger.
That file is from another phone or account. Choose the file named in the instructions.
โ€นemailโ€บ isn't in this ledger yet. Someone in the ledger has to add them first. If they were just added, sync and try again.
Couldn't read the file. Check your connection and try again.