Skip to content

A simple command-line tool to manage your daily expenses. Add, view, and calculate total spending with ease.

License

Notifications You must be signed in to change notification settings

anshumanjadiya1102/ExpenseTracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 

Repository files navigation

💰 Expense Tracker (Java CLI)

A fast, no-nonsense expense tracker you can run anywhere.
Single-file Java, no frameworks, persists to disk, does filters, reports, and CSV.


✨ Features

  • ➕ Add expenses with date, amount, category, description, payment method, note
  • 🔍 List & filter by month, date range, category, or search text
  • 📊 Monthly report: total + category breakdown with percentages
  • 💾 Persistent storage in a simple TSV file
  • 📤 Export to CSV, 📥 Import from CSV
  • 🧰 Single-file Java 11+, no external libraries

Downloads

Download My GitHub Project ---

🚀 Quick Start

# 1) Compile
javac ExpenseTracker.java

You’ll see a prompt like:

===== Expense Tracker (CLI) =====
Storage: expenses.tsv
>

🧭 Commands

add <amount> <description> [/date yyyy-mm-dd] [/cat category] [/pay method] [/note text]
list [all | month yyyy-mm | today | range yyyy-mm-dd..yyyy-mm-dd] [/cat name] [/sort date|amt|cat] [/rev]
edit <id> [/amt number] [/t new description] [/date yyyy-mm-dd] [/cat category] [/pay method] [/note text]
del <id>
search <text>
report month <yyyy-mm>
export [filename.csv]
import <filename.csv>
save | exit

Examples

> add 249.99 Headphones /cat electronics /pay upi /date 2025-08-27
> add 120.50 Groceries at LocalMart /cat food /pay cash
> list month 2025-08 /cat food
> search headphones
> report month 2025-08
> export my_expenses.csv

📊 Sample Output

ID   Date         Amount      Category         Description                      Payment    Note
---- ------------ ----------- ---------------- -------------------------------- ---------- ------------------------
1    2025-08-27   249.99      electronics      Headphones                       upi
2    2025-08-27   120.50      food             Groceries at LocalMart           cash
Total: 370.49

🧱 Data Files

  • expenses.tsv – human-readable storage

  • expenses.tsv.meta – tracks next ID

  • expenses_export.csv – default export name (override in command)

🛠 Requirements

Java 11+

📜 License

MIT – free to use and modify. PRs welcome! 🚀

💰 A simple Java CLI app to track, view, and manage your daily expenses with local file storage.

About

A simple command-line tool to manage your daily expenses. Add, view, and calculate total spending with ease.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

No packages published

Languages