moomoolah 0.1.0

MooMoolah - Personal Budget Planner

MooMoolah

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

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 & Setup

This project uses uv for dependency management.

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>
   

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.

Running Tests

uv run pytest

Development Dependencies

uv sync --dev