{"id":26737441,"url":"https://github.com/fahadelahikhan/smartbudget-tracker","last_synced_at":"2025-06-11T03:34:45.856Z","repository":{"id":254475707,"uuid":"846646525","full_name":"fahadelahikhan/SmartBudget-Tracker","owner":"fahadelahikhan","description":"A Python-based app for tracking expenses, managing budgets, and maintaining financial balance.","archived":false,"fork":false,"pushed_at":"2025-03-13T09:47:39.000Z","size":1,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-13T10:35:00.632Z","etag":null,"topics":["budget-planner","budget-tracking","expense-manager","expense-tracking","finance-tracker","financial-app","financial-planning","money-management","open-source","personal-finance","python-app","saving-tracker"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fahadelahikhan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-23T16:44:25.000Z","updated_at":"2025-03-13T09:47:43.000Z","dependencies_parsed_at":"2024-08-23T18:46:56.142Z","dependency_job_id":"5da47350-fa3f-4e5e-b2ad-0a1883bda682","html_url":"https://github.com/fahadelahikhan/SmartBudget-Tracker","commit_stats":null,"previous_names":["fahadelahikhan/smartbudget-tracker"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fahadelahikhan%2FSmartBudget-Tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fahadelahikhan%2FSmartBudget-Tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fahadelahikhan%2FSmartBudget-Tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fahadelahikhan%2FSmartBudget-Tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fahadelahikhan","download_url":"https://codeload.github.com/fahadelahikhan/SmartBudget-Tracker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245960690,"owners_count":20700780,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["budget-planner","budget-tracking","expense-manager","expense-tracking","finance-tracker","financial-app","financial-planning","money-management","open-source","personal-finance","python-app","saving-tracker"],"created_at":"2025-03-28T02:50:47.364Z","updated_at":"2025-03-28T02:50:47.951Z","avatar_url":"https://github.com/fahadelahikhan.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SmartBudget Tracker 💰\r\n\r\n![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)\r\n![License](https://img.shields.io/badge/license-MIT-green)\r\n\r\nA command-line budget tracking application that helps users manage their expenses and monitor their budget.\r\n\r\n## 📜 About\r\nThis project implements a simple budget tracking system that allows users to add expenses, view their budget details, and track their remaining balance. It's an excellent example of basic financial management principles and data persistence using JSON files.\r\n\r\n## ✨ Features\r\n- Add expenses with descriptions and amounts\r\n- Track total spending and remaining budget\r\n- Persistent data storage using JSON\r\n- Simple command-line interface\r\n- Budget details display with expense breakdown\r\n\r\n## 🚀 Quick Start\r\n\r\n### Installation\r\n1. Clone the repository:\r\n   ```bash\r\n   git clone https://github.com/fahadelahikhan/SmartBudget-Tracker.git\r\n   cd SmartBudget-Tracker\r\n   ```\r\n\r\n2. Run the application:\r\n   ```bash\r\n   python main.py\r\n   ```\r\n\r\n### Basic Usage\r\n```python\r\n# Initialize budget and expenses\r\ninitial_budget = 1000.0\r\nexpenses = []\r\n\r\n# Add an expense\r\nadd_expense(expenses, \"Groceries\", 150.0)\r\n\r\n# Calculate remaining budget\r\nremaining = get_balance(initial_budget, expenses)\r\nprint(f\"Remaining budget: {remaining}\")  # Output: Remaining budget: 850.0\r\n\r\n# Display all budget details\r\nshow_budget_details(initial_budget, expenses)\r\n```\r\n\r\n### Example Budget Management\r\n```python\r\n# Load existing budget data\r\ninitial_budget, expenses = load_budget_data('budget_data.json')\r\n\r\n# Add multiple expenses\r\nadd_expense(expenses, \"Rent\", 500.0)\r\nadd_expense(expenses, \"Utilities\", 100.0)\r\nadd_expense(expenses, \"Dining\", 75.0)\r\n\r\n# Calculate and display remaining budget\r\nremaining = get_balance(initial_budget, expenses)\r\nprint(f\"Remaining budget after expenses: {remaining}\")\r\n\r\n# Save updated budget data\r\nsave_budget_details('budget_data.json', initial_budget, expenses)\r\n```\r\n\r\n## 📖 How It Works\r\nThe budget tracker works by:\r\n1. Loading existing budget data from a JSON file\r\n2. Allowing users to add expenses with descriptions and amounts\r\n3. Calculating total expenses and remaining budget\r\n4. Displaying budget details including all expenses\r\n5. Saving updated budget data back to the JSON file\r\n\r\nThe application uses simple arithmetic operations to track expenses and calculate remaining budget:\r\n```\r\nremaining_budget = initial_budget - sum_of_all_expenses\r\n```\r\n\r\n## ⚖️ License\r\nDistributed under the MIT License. See [LICENSE](LICENSE) for details.\r\n\r\n---\r\n\r\n\u003e **Note**: This implementation is for educational and personal finance management purposes. For more complex financial tracking needs, consider using established accounting software with robust security and backup features.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffahadelahikhan%2Fsmartbudget-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffahadelahikhan%2Fsmartbudget-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffahadelahikhan%2Fsmartbudget-tracker/lists"}