I now edit videos gammagecreative.com →
Benjamin Gammage
Say hello →
home/page
Writing

gbudget

A personal CLI budget app for tracking income and expenses from the terminal.

Overview

gbudget is a personal CLI budget application that lets you track income and expenses directly from the terminal. It optionally generates monthly markdown statements in your Obsidian vault.

Data Storage

All data is stored locally using SQLite. The database and config file locations vary by platform.

  • Linux/Mac - ~/.local/share/gbudget/budget.db
  • Windows - %APPDATA%/gbudget/budget.db

Installation

Clone the repo and run gbudget directly, or install globally via pip install -e ..

Commands

  • gbudget init - First-time setup.
  • gbudget add AMOUNT DESC - Add a transaction.
  • gbudget list - Show transactions.
  • gbudget summary - Show totals.
  • gbudget export - Regenerate a monthly statement.

View on GitHub ↗