FiTui

A lightweight terminal-based personal finance tracker. Record transactions, track spending, and view financial insights from your terminal.

Version: 0.3.0

---

Features

• Transaction management: add, edit, and delete credit/debit entries
• Stats view with totals and spending breakdowns by tag
• Recurring transactions for bills, salary, and subscriptions
• Local SQLite storage with configurable tags and currency
• Keyboard-driven interface

Screenshots

Main Interface

Stats View

---

Installation

Via Cargo

cargo install fitui

Build from Source

Requires Rust.

cargo build --release

Binary: target/release/fitui (Windows: fitui.exe)

Linux / macOS

mkdir -p ~/.local/bin
cp target/release/fitui ~/.local/bin/
chmod +x ~/.local/bin/fitui
fitui

Ensure ~/.local/bin is in your $PATH:

export PATH="$HOME/.local/bin:$PATH"

Windows

1. Copy fitui.exe to a permanent location (e.g. C:\Users\<you>\bin\)
2. Add that folder to your PATH via System Properties
3. Run fitui from any terminal

Termux (Android)

pkg install rust
cargo build --release
cp target/release/fitui ~/.local/bin/
fitui

Note: first build may take 10-15 minutes on mobile.

---

Configuration

Config is created automatically on first run.

OS	Database	Config
Linux	~/.local/share/fitui/budget.db	~/.config/fitui/config.yaml
macOS	~/Library/Application Support/com.ayan.fitui/budget.db	~/Library/Preferences/com.ayan.fitui/config.yaml
Windows	AppData\Roaming\ayan\fitui\data\budget.db	AppData\Roaming\ayan\fitui\config\config.yaml

config.yaml

currency: "$"  # $, EUR, GBP, JPY, INR, etc.

tags:
  - food
  - travel
  - shopping
  - bills
  - salary
  - other

---

Planned

• CSV import from bank statements and payment apps
• Budget limits per tag
• Search and filter by amount, date, or tag
• Export to CSV/PDF
• Custom date range stats
• Multi-currency support
• Transaction notes
• Data backup and sync

Feature request or bug? Open an issue.

---

Changelog

[0.3.0] - 2026-02-27

Added

• Tab-based navigation across views
• Active tab indicator
• Transaction date grouping
• Ratio-based column constraints for consistent table layout
• Improved empty state messaging

Changed

• Transactions list refactored to table layout
• UI formatting and spacing improvements
• Cleaner tab rendering

Fixed

• Quit now works regardless of current mode

---

License

MIT