budgetcli 1.1.2

A simple async budgeting app to manage expenses and budgets in google spreadsheets

Budget CLI

A simple terminal app written in Python to manage budgets and expenses in Google Sheet.

Features

• Add income transactions
• Add outcome transactions
• List transactions by month
• Add spending categories

Installation

pip install budgetcli

In order to use the app you need first to enable Google Spreadsheet API and to generate app credentials with a client_id and a client_secret.

Please follow the following link for more details: Authorize credentials for a desktop application

Configuration

Before start adding transactions and data, you need to do the following steps:

Provide Google spreadsheet id

budgetcli config spreadsheet-id ID

Copy the client_secret_XXX.json to app config

budgetcli config credentials-file-path /path/to/client_secret.json

Authorize the app access to spreadsheet data

budgetcli auth

Init sheet tables headers

budgetcli init

Usage

The commands follow the below structure.

budgetcli <VERB> <OBJECT> <OPTIONS>

Incomes

To add an income you need to provide only an amount and a category. By default, all the income transactions are added with default today date and without no description.

Add an income

Add an income with description

Add an income with date and description

Outcomes

Same for outcome transactions, you need to provide only an amount and a category. By default, all the outcome transactions are added with default today date and without no description.

Add an outcome

Add an outcome with description

List transactions

List first 100 transactions

List only first 10 transactions

List transactions for a specific month

budgetcli list transactions --month April