{"id":16690871,"url":"https://github.com/wichtounet/budgetwarrior","last_synced_at":"2025-04-05T09:08:54.932Z","repository":{"id":9010809,"uuid":"10765040","full_name":"wichtounet/budgetwarrior","owner":"wichtounet","description":"Personal finance manager, command-line interface, in C++","archived":false,"fork":false,"pushed_at":"2025-03-02T06:53:29.000Z","size":2876,"stargazers_count":114,"open_issues_count":1,"forks_count":17,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-29T08:08:49.407Z","etag":null,"topics":["accounts","budget-manager","c-plus-plus","cpp"],"latest_commit_sha":null,"homepage":"","language":"C++","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/wichtounet.png","metadata":{"files":{"readme":"README.rst","changelog":"ChangeLog","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":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-06-18T14:19:19.000Z","updated_at":"2025-03-02T06:53:32.000Z","dependencies_parsed_at":"2023-10-27T06:45:06.856Z","dependency_job_id":"87173cdd-3926-445a-8659-ba21e0317f9a","html_url":"https://github.com/wichtounet/budgetwarrior","commit_stats":{"total_commits":1667,"total_committers":9,"mean_commits":"185.22222222222223","dds":0.07498500299940014,"last_synced_commit":"5e30a9c4dffdf53a8ef169445dda34cf0b5d87bf"},"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wichtounet%2Fbudgetwarrior","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wichtounet%2Fbudgetwarrior/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wichtounet%2Fbudgetwarrior/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wichtounet%2Fbudgetwarrior/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wichtounet","download_url":"https://codeload.github.com/wichtounet/budgetwarrior/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247312081,"owners_count":20918344,"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":["accounts","budget-manager","c-plus-plus","cpp"],"created_at":"2024-10-12T16:05:55.521Z","updated_at":"2025-04-05T09:08:54.190Z","avatar_url":"https://github.com/wichtounet.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"budgetwarrior 1.1.0\n===================\n\n.. image:: https://github.com/wichtounet/budgetwarrior/actions/workflows/make.yml/badge.svg\n   :target: https://github.com/wichtounet/budgetwarrior/actions/workflows/make.yml\n   :alt: Linux Build\n\n.. image:: https://github.com/wichtounet/budgetwarrior/actions/workflows/cmake.yml/badge.svg\n   :target: https://github.com/wichtounet/budgetwarrior/actions/workflows/cmake.yml\n   :alt: Mac OS Build\n\n.. image:: https://github.com/wichtounet/budgetwarrior/actions/workflows/sonar.yml/badge.svg\n   :target: https://github.com/wichtounet/budgetwarrior/actions/workflows/sonar.yml\n   :alt: Sonar Build\n\n.. image:: https://sonarcloud.io/api/project_badges/measure?project=wichtounet_budgetwarrior\u0026metric=alert_status\n   :target: https://sonarcloud.io/summary/new_code?id=wichtounet_budgetwarrior\n   :alt: SonarSource analysis\n\n.. image:: https://img.shields.io/badge/License-MIT-yellow.svg\n   :target: https://opensource.org/licenses/MIT\n   :alt: MIT License\n\nSimple command line utility to helps keeping track of your expenses and the\nstate of your budget.\n\n.. image:: https://github.com/wichtounet/budgetwarrior/blob/master/screenshots/budget_report.png?raw=true\n   :align: center\n\nPersonal accounting method\n--------------------------\n\nNot everyone manages its money the same way. budgetwarrior is based on my way of managing my money. It may not be adapted to everyone. I'm separating all my expenses in several \"accounts\" and I give each of them a certain amount of money each month.\n\n**Accounts are recipients for your expenses and earnings. They are not bank accounts, they only are logical recipients**. Think of them as categories. The sum of the accounts should be equivalent to your salary.\n\nFor instance, if you have 1000$ per month, you could have three accounts:\n\n* Food (200$)\n* Car (300$)\n* House (500$)\n\nThat means you allow yourself to spend 200$ on food each month. Of course, some month you'll be lower or higher.\nAnd the tool will indicate you how well your accounts are doing, month by month and by year.\n\nFeatures\n--------\n\nbudgetwarrior has several features:\n\n* Manages a set of account with a monthly limit\n* Keeps track of your expenses and earnings in each of your accounts\n* Gives you the state of your budget by month and by year\n* Keeps track of your debts\n* Manages recurring expenses that are automatically created monthly\n* Keeps track of your wishes\n* Keeps track of your current fortune\n\nOn the other hand, budgetwarrior:\n\n* Has no notion of bank, cash, credit card\n* Will not communicate with your ebanking tool to extract information\n\nStarting guide\n-------------\n\nThe wiki contains a guide for starting using budgetwarrior: `Start-Tutorial \u003chttps://github.com/wichtounet/budgetwarrior/wiki/Start-tutorial\u003e`_\n\nInstallation\n------------\n\nA Gentoo ebuild is available on this overlay: https://github.com/wichtounet/wichtounet-overlay\n\nArch Linux packages are also available on AUR: https://github.com/StreakyCobra/aur\n\nFor other systems, you'll have to install from sources.\n\nBuild from source\n-----------------\n\nA modern compiler is necessary. I am working with GCC 14 and clang 18. You need to set the\n$CXX variable before executing make.\n\nLinux\n=====\n\nThe tool is developed for Linux.  You need libcurl and libuuid installed on your computer to build this project.\n\nYou just have to use make to build it::\n\n    $ git clone --recursive git://github.com/wichtounet/budgetwarrior.git\n    $ cd budgetwarrior\n    $ make\n    $ sudo make install\n\nIf you want to install the man pages and the shell completion files, you can\ndo so with::\n\n    $ sudo make install_extra\n\nMacOS\n=====\n\nMacOS support is experimental.  Using CMake and Homebrew, you can build from sources.\n\n1. First, install Xcode compiler toolchain via `xcode-select --install` if needed.\n\n2. Use Homebrew to install required dependencies. Download and install brew from\n   https://docs.brew.sh if you don't already have it::\n\n    $ brew install cmake\n    $ brew install git\n    $ brew install openssl\n\nNow build using the provided script after cloning repository::\n\t\n    $ git clone --recursive git://github.com/wichtounet/budgetwarrior.git\n    $ cd budgetwarrior\n    $ ./build_macos.sh\n\nTo install the resulting, compiled program::\n\n    $ cd ./build \u0026\u0026 make install\n\nWindows\n=======\n\nIf there is some interest on using it on Windows, it\nshould not take too much work to port it to Windows. Just let me know (or\nmake a Pull Request with the changes ;) ). .\n\nUsage\n-----\n\nMan pages and ZSH/Bash completions are also available.\n\nThe executable is named 'budget' and allows to perform all the commands.\n\nUse::\n\n    $ budget help\n\nOr::\n\n    $ man budget\n\nif you have installed the man pages to see all the available commands.\n\nIf you want to use the web interface, you will need to use another project: https://github.com/wichtounet/budgetwarrior_web\n\nContributors\n------------\n\nRead *AUTHORS*\n\nRelease Notes\n-------------\n\nRead *ChangeLog*\n\nContribute\n----------\n\nThe project is open for any kind of contribution : ideas, new features, bug fixes, tests, ...\n\nIf you want to contribute to this project, you can contact me by `email \u003cbaptiste.wicht@gmail.com\u003e`_ or via my `website  \u003chttp://baptiste-wicht.com/\u003e`_. You can also directly fork the project and make a pull request.\n\nTroubleshooting\n---------------\n\nPlease consider using `Github issues tracker \u003chttp://github.com/wichtounet/budgetwarrior/issues\u003e`_ to submit bug reports or feature requests. You can also contact me via my `website \u003chttp://baptiste-wicht.com/\u003e`_.\n\nLicense\n-------\n\nThis project is distributed under the MIT License. Read *LICENSE* for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwichtounet%2Fbudgetwarrior","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwichtounet%2Fbudgetwarrior","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwichtounet%2Fbudgetwarrior/lists"}