/goodbudget_cli

Command line tools to interact with Goodbudget

Primary LanguagePythonMIT LicenseMIT

goodbudget_cli

Command line tool to enter transactions into your Goodbudget account.

Installation

Dependencies

Install with pipx (or pip)

$ pipx install goodbudget-cli

Initialize and edit the configuration file

  1. Run gb to initially create a ~/.config/goodbudget_cli/config.json file.
  2. Edit the config.json file to set the webdriver_path to the location of your Chrome webdriver.
  3. Edit the config.json file to set the Envelopes using the name of your Goodbudget envelopes using the format of {ENVELOPE_NAME: [LIST OF ALIASES]}.

Usage

To enter an expense:

$ gb {Goodbudget household username or email}

To enter income:

$ gb {Goodbudget household username or email}  --income

Demo

$ gb foo@bar.com
Enter your Goodbudget password:
Logging in. Please wait...
Logged in.

Date of transaction (today / yesterday / mm/dd/yyyy): today
Payee: QFC
Amount: 40
Envelope (or type in 'remind'): groceries
Notes (optional):

        Summary of your expense:

            Date: 01/28/2023
            Payee: QFC
            Amount: $40
            Envelope: Groceries (based on your alias of 'groceries')
            Notes: <none>

Is everything correct? (Y/n) Y
Entering expense. Please wait...

Success! Your transaction was entered into Goodbudget.

Do you want to enter another transaction? (Y/n) n

Thank you for using goodbudget_cli! See you next time!