moomoolah 0.2.0

MooMoolah - Personal Budget Planner

MooMoolah

A terminal-based personal budget planning application built with Python and Textual.

Your data is stored locally in a JSON file, keeping your financial information private and accessible offline.

Features

• 12-month forecast view - Shows projected expenses, income, and balance for the next 12 months
• Expense and Income management - Add, edit, and delete expense/income entries
  • Recurring entries - Support for one-time, monthly, and yearly recurring transactions
  • Category tracking - Organize entries by categories

Screenshots

Main screen:

Adding an expense:

Installation

Install MooMoolah using pip:

pip install moomoolah

Usage

Run the application with:

moomoolah <state_file.json>

The state file will be created if it doesn't exist.

Usage

Navigation

• Main screen: e (manage expenses), i (manage income)
• Entry screens: Insert (add entry), Delete (remove entry), click row to edit
• Global shortcuts: Ctrl+S (save), Ctrl+Q (quit), Escape/Backspace (back)

Entry Management

Each entry includes:

• Description and amount
• Category for organization
• Recurrence type (once, monthly, yearly)
• Start date and optional end date
• Frequency interval (e.g., every 2 months)

Development

See plan.md for current development roadmap and planned features.

This project uses uv for dependency management.

Setup

1. Install uv if you haven't already:

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. Install dependencies:

   uv sync
   

3. Run the application:

   uv run moomoolah <state_file.json>
   

Running Tests

uv run pytest