https://github.com/sanjeeviraju/expense-tracker
A modern expense tracking application built with Python & Tkinter featuring real-time data visualization, and comprehensive financial analytics.
https://github.com/sanjeeviraju/expense-tracker
expense-tracker python tkinter
Last synced: 3 months ago
JSON representation
A modern expense tracking application built with Python & Tkinter featuring real-time data visualization, and comprehensive financial analytics.
- Host: GitHub
- URL: https://github.com/sanjeeviraju/expense-tracker
- Owner: sanjeeviraju
- License: mit
- Created: 2025-03-05T07:27:50.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-03-05T07:47:38.000Z (4 months ago)
- Last Synced: 2025-03-05T08:32:14.290Z (4 months ago)
- Topics: expense-tracker, python, tkinter
- Language: Python
- Homepage:
- Size: 22.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Expense Tracker
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
[](https://github.com/psf/black)
[](https://github.com/yourusername/expense-tracker/graphs/commit-activity)
A sophisticated expense tracking solution with data visualization and analysis capabilities.
## 🌟 Features
### 🎨 Modern Interface
- Adaptive themes (Light/Dark/AMOLED)
- Responsive design
- Real-time data visualization
- Cross-platform compatibility
### 💰 Financial Management
- Quick expense entry
- Category-based organization
- Multi-column sorting and filtering
- Comprehensive expense history
### 📊 Analytics & Insights
- Interactive pie charts
- Monthly summaries
- Category-wise analysis
- Financial trends visualization
### ⚙️ Technical Highlights
- JSON-based persistent storage
- CLI support for automation
- Modular architecture
- Theme-aware visualization engine
## Preview
## 🚀 Quick Start
### Prerequisites
```bash
Python 3.8+
pip (Python package manager)
```
### Installation Steps
1. Clone & Navigate
```bash
git clone https://github.com/yourusername/expense-tracker.git
cd expense-tracker
```
2. Virtual Environment
```bash
python -m venv venv
source venv/bin/activate # Unix
venv\Scripts\activate # Windows
```
3. Dependencies
```bash
pip install -r requirements.txt
```
4. Launch
```bash
python src/main.py # GUI Mode
python src/main.py --cli # CLI Mode
```
## 🎯 Usage
### Dashboard Layout
| Section | Purpose | Features |
|---------|---------|----------|
| Left Panel | Input & Controls | • Expense entry
• Category selection
• Analysis tools |
| Center Panel | Expense History | • Sortable columns
• Edit/Delete functions
• Quick filters |
| Right Panel | Analytics | • Pie charts
• Category breakdown
• Total summaries |
### Key Operations
#### Adding Expenses
1. Enter amount
2. Provide description
3. Select category
4. Click "Add Expense"
#### Managing Records
- **Edit**: Double-click or right-click → Edit
- **Delete**: Select + Delete key or context menu
- **Sort**: Click column headers
- **Filter**: Use quick filter buttons
#### Theme Customization
Choose your preferred visual style:
- **☀️ Light**: Professional day mode
- **🌙 Dark**: Reduced eye strain
- **⚫ AMOLED**: Maximum contrast, power-efficient
## 🏗️ Architecture
```
expense_tracker/
├── src/ # Source code
│ ├── __init__.py
│ ├── main.py # Application entry point
│ ├── gui.py # Graphical user interface
│ ├── expense.py # Core expense models
│ ├── storage.py # Data persistence
│ ├── analytics.py # Analysis functionality
│ └── themes.py # UI theme definitions
├── data/ # Data storage
│ └── expenses.json # Expense records
├── docs/ # Documentation
│ └── user_guide.md # Detailed user instructions
├── tests/ # Unit tests
│ ├── __init__.py
│ ├── test_expense.py
│ └── test_storage.py
├── .gitignore # Git ignore rules
├── LICENSE # MIT License
├── README.md # Project information
└── requirements.txt # Dependencies
```
## 📄 License
This project is licensed under the [MIT License](https://opensource.org/licenses/MIT)