Skip to content

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.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages