Skip to content

Data entry app for Beancount plain-text accounting system

License

Notifications You must be signed in to change notification settings

xuhcc/beancount-mobile

Repository files navigation

Beancount Mobile App

GitHub release License: GPL v3

This is a companion mobile application for Beancount plain-text accounting system.

Currently available only on Android. Version 6.0 (Marshmallow) or later is recommended.

Features

  • Add transactions
  • Open accounts
  • Declare currencies
  • View beancount file as plain text
  • Switch between files

Note: Beancount Mobile currently has no file synchronization functionality, but it's possible to use software like Syncthing to sync Beancount file across multiple devices.

Configuration

Beancount Mobile makes use of these configuration options:

  • option "title" "..." - the title of ledger file.
  • option "operating_currency" "..." - default currency for transactions.
  • 1970-01-01 custom "fava-option" "indent" "4" - number spaces for indentation.
  • 1970-01-01 custom "bcm_option" "transaction_flags" "['*', '!']" - allowed transaction flags.
  • 1970-01-01 custom "bcm_option" "account_order" "to_from" - show "to" account before "from" account in transaction form.

Change log

See CHANGELOG.

Development

Prerequisites:

Install required packages:

npm install

Android

Run on emulator:

npm run android

Build APK:

npm run android-debug

Testing

npm run lint
npm run test