Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/range-of-motion/budget
Get a grip on your finances.
https://github.com/range-of-motion/budget
accounting bookkeeping finance financial laravel money mysql personal-finance php phpunit spending spending-tracker vue vuejs web web-app web-application
Last synced: 3 days ago
JSON representation
Get a grip on your finances.
- Host: GitHub
- URL: https://github.com/range-of-motion/budget
- Owner: range-of-motion
- License: mit
- Created: 2017-07-20T16:53:54.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-12-10T01:12:26.000Z (about 1 month ago)
- Last Synced: 2025-01-02T23:05:01.349Z (10 days ago)
- Topics: accounting, bookkeeping, finance, financial, laravel, money, mysql, personal-finance, php, phpunit, spending, spending-tracker, vue, vuejs, web, web-app, web-application
- Language: PHP
- Homepage: https://usebudget.com
- Size: 3.44 MB
- Stars: 1,007
- Watchers: 31
- Forks: 176
- Open Issues: 28
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-fintech - Budget - a web application that helps you keep track of your finances by organizing and visualizing transactions (Personal finance)
- jimsghstars - range-of-motion/budget - Get a grip on your finances. (PHP)
README
# Budget
[](https://travis-ci.com/range-of-motion/budget)
[](https://codecov.io/gh/range-of-motion/budget)
[](https://github.com/range-of-motion/budget/blob/master/LICENSE)
Budget is an open-source web application that helps you keep track of your finances.
You can use Budget by hosting it yourself, or using [the instance hosted by us](https://usebudget.com).
## Features
* Insertion and management of transactions
* Ability to organize transactions using tags
* Facilitate uploading and organizing of receipts
* Support for importing transactions (CSV format)
* Reports that visualize financials (showing weekly balance and most expensive tags, for example)
* Supports multiple currencies
* Available in multiple languages
* Weekly summary available through e-mail
## Requirements
* PHP 8.2 or higher
* HTTP server (for example Apache or NGINX)
* MySQL
* Composer
* Node.js
## Installation
* Clone the repository (`git clone https://github.com/range-of-motion/budget.git`)
* You should always check out a tag, since the `master` branch might not always be stable (`git checkout TAG`)
* Install dependencies (`composer install --no-dev -o`)
* Run installation command (`php artisan budget:install`)
* Configure additional services in `.env` (database or mail, for example)
* Run migrations for database (`php artisan migrate`)
* Head over to your list of crons (`crontab -e`) and add `* * * * * cd /path-to-budget && php artisan schedule:run >> /dev/null 2>&1`
*Note that in order for certain features to work properly, the jobs queue needs to be watched. This can be done by either running `php artisan queue:work` or using [Supervisor](https://laravel.com/docs/7.x/queues#supervisor-configuration).*
## Updating
Use the command below to update to the latest version.
```
php artisan budget:update
```
## Docker
You can get set-up with Budget using Docker and Docker Compose. The advantage of using Docker Compose is that it will set you up with a MySQL database.
### Docker
You can either build the Docker image yourself, or use the ones available on [Docker Hub](https://hub.docker.com/r/rangeofmotion/budget).
### Docker Compose
Assuming you already have Docker Compose installed, simply run `docker-compose up -d` and you're good to go.
## Contact
* [Discord](https://discord.gg/QFQdvy3)