{"id":22537844,"url":"https://github.com/khaledashrafh/fintracker","last_synced_at":"2026-04-27T21:31:56.236Z","repository":{"id":254026562,"uuid":"845256430","full_name":"KhaledAshrafH/FinTracker","owner":"KhaledAshrafH","description":"FinTracker is a command-line application designed to empower you with control over your finances. It streamlines the process of recording, tracking, and analyzing your financial transactions, providing valuable insights into your spending habits.","archived":false,"fork":false,"pushed_at":"2024-09-04T00:52:28.000Z","size":15,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-28T16:17:27.540Z","etag":null,"topics":["cmd","command-line","command-line-application","financial","fintech","java","management","personal-finances","tracker","tracker-application","tracking","transaction","transaction-management"],"latest_commit_sha":null,"homepage":"","language":"Java","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/KhaledAshrafH.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-20T22:36:17.000Z","updated_at":"2024-10-11T14:53:32.000Z","dependencies_parsed_at":"2025-02-02T07:36:54.808Z","dependency_job_id":null,"html_url":"https://github.com/KhaledAshrafH/FinTracker","commit_stats":null,"previous_names":["khaledashrafh/fintracker"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/KhaledAshrafH/FinTracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhaledAshrafH%2FFinTracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhaledAshrafH%2FFinTracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhaledAshrafH%2FFinTracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhaledAshrafH%2FFinTracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KhaledAshrafH","download_url":"https://codeload.github.com/KhaledAshrafH/FinTracker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhaledAshrafH%2FFinTracker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32356598,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-27T20:07:02.737Z","status":"ssl_error","status_checked_at":"2026-04-27T20:07:00.910Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["cmd","command-line","command-line-application","financial","fintech","java","management","personal-finances","tracker","tracker-application","tracking","transaction","transaction-management"],"created_at":"2024-12-07T11:09:00.038Z","updated_at":"2026-04-27T21:31:56.217Z","avatar_url":"https://github.com/KhaledAshrafH.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FinTracker\n\n## Introduction\n\nFinTracker is a command-line application designed to empower you with control over your finances. It streamlines the process of recording, tracking, and analyzing your financial transactions, providing valuable insights into your spending habits.\n\n## Key Features\n\n- **Transaction Management:** Effortlessly add new transactions with descriptions, amounts (positive for income, negative for expenses), and categories.\n- **Historical Record:** Maintain a historical record of all your transactions for easy reference.\n- **Transaction Viewing:** Display a clear and concise list of all your transactions, formatted for readability.\n- **Sorting Options:** Optionally sort transactions by amount to prioritize transactions.\n- **Financial Summary:** Gain a quick overview of your financial health with a comprehensive summary including total income, total expenses, and current balance.\n- **Spending Insights:** Delve deeper into your spending patterns with detailed category-based insights to optimize your spending.\n\n## Getting Started\n\n### Prerequisites\n- Java Development Kit (JDK) version 8 or later [Download JDK](https://www.oracle.com/java/technologies/javase-downloads.html)\n- A text editor or IDE of your choice (e.g., Notepad++, Visual Studio Code)\n\n### Cloning the Repository\nUse Git to clone this repository to your local machine:\n```bash\ngit clone https://github.com/KhaledAshrafH/FinTracker.git\n```\n\n### Compiling and Running\n1- Navigate to the FinTracker directory using your terminal or command prompt.\n2- Compile the Java code:\n```bash\njavac Main.java\n```\n2- Run the application:\n```bash\njava Main\n```\n\n## Using FinTracker\n\nThe application presents a user-friendly menu that guides you through various functionalities:\n\n- **Input Transactions**: Add new transactions by entering a description, amount, and category.\n- **View Transactions**: Display a list of all transactions, with the option to sort them by amount.\n- **View Summary**: Get a summary of your total income, total expenses, and current balance.\n- **Get Insights**: Analyze your spending patterns by category to understand where your money is going.\n- **Exit**: Close the application.\n\n## Example Workflow\n\n1. Add a transaction (e.g., description: \"Dinner\", amount: \"-30.00\", category: \"Food\").\n2. View transactions (optional: sort by amount).\n3. Review your financial summary (income, expenses, balance).\n4. Gain insights into your spending by category (identify areas for potential optimization).\n5. Exit the application when you're finished.\n\n## Future Enhancements\n\n- **Persistence**: Implement data persistence to save transactions across application sessions.\n- **Budgeting**: Introduce budgeting features to set spending goals and track progress.\n- **Visualization**: Explore graphical visualizations to depict financial data more intuitively.\n- **Search and Filtering**: Allow users to search for specific transactions or filter based on criteria.\n- **Multi-Currency Support**: Expand functionality to handle transactions in multiple currencies.\n\n## Contribution\n\nWe welcome contributions to improve FinTracker. Feel free to fork the repository, make changes, and submit pull requests. Please adhere to our coding style guidelines (if any) and provide clear documentation for your modifications.\n\n## License\n\nThis project is licensed under the MIT [LICENSE](LICENSE). You are free to use, modify, and distribute the code under the terms of this license.\n\n## Contact\nFor questions, feedback, or suggestions regarding PetPal Simulation, please contact me at 5aleda4rf@gmail.com.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhaledashrafh%2Ffintracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkhaledashrafh%2Ffintracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhaledashrafh%2Ffintracker/lists"}