Skip to content

About

Monitoring, Organisierung, Kontrolle, Kategorisierung & Analyse – Das Haushaltsbuch für volle Finanzkontrolle!

Topics

Resources

Stars

2 stars

Watchers

2 watching

Forks

Repository files navigation

Language: English · Deutsch


Logo

MOKKA Budget

Monitoring, Organization, Control, Categorization & Analysis – The household budget app for full financial control!

Table of Contents
  1. About the Project
  2. Installation
  3. Roadmap
  4. Contributing
  5. License
  6. Contact

About the Project

MOKKA-Budget-MainView

With so many subscriptions and widespread card payments, it is easy to lose track of your spending. This household budget app helps you stay on top of things by letting you track – via import or manual entry –, plan, and analyze your expenses.

Features:

  • Planning of recurring expenses (and income) (fixed costs)
  • Tracking of actual expenses (and income) through import or manual entry
  • Categorization of expenses (and income)
  • Management of budgets per category
  • Analysis showing the development of an expense category over time

And the best part: No cloud or data-hungry services. Your data is processed locally on your computer and stored encrypted. Encryption is available from version 1.1.0 and can be disabled.

(back to top)

Screenshots

MOKKA-Budget-AnnualOverview MOKKA-Budget-AnalysisView

Built With

OpenJDK Maven Hibernate SQLite Lombok Dagger2 SonarQube

(back to top)

Installation

The application is available for download with the latest release: https://github.com/tpoerschke/mokka-budget/releases

Instructions for Mac:

  1. Download and extract the latest release (.dmg)
  2. Move the app to your Applications folder
  3. Launch the app

Note: You may need to explicitly allow execution if macOS reports that it cannot (yet) verify the application for malware or similar. In System Settings (System Settings > Privacy & Security), you can allow the app to run after you have attempted to launch it once.

(back to top)

Roadmap

  • Monthly overview
  • Annual overview
  • Transaction management
  • Category system
  • Transaction import
  • Budgets
  • Basic analysis (bar chart per category)
  • Support of multiple bank accounts (with transfer)
  • Import of digital receipts (e.g. Lidl or Globus)
  • Burn-up chart per category / budget
  • (Further milestones in planning)

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

Development

You can set up the project locally as follows:

  1. Clone the repo

    git clone https://github.com/tpoerschke/mokka-budget.git
  2. Start the app

    VS Code: mvn clean javafx:run or mvn clean javafx:run@debug and attach via Visual Studio Code (.vscode/launch.json)

    IntelliJ: Run configuration Launch

  3. Start developing :)

Building

Use the shell script build_app.sh to build the application for your current operating system. Windows, macOS, and Linux are supported.

Windows

The following packages are required to build a Windows installer locally:

  • Wix Toolset

Linux (RPM)

The following packages are required to build an RPM file locally:

  • rpmbuild

Your feature or enhancement

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the GNU General Public License v3.0. See LICENSE for more information.

(back to top)

Contact

Tim Poerschke - post@timkodiert.de

Project Link: https://github.com/tpoerschke/mokka-budget

(back to top)

About

Monitoring, Organisierung, Kontrolle, Kategorisierung & Analyse – Das Haushaltsbuch für volle Finanzkontrolle!

Topics

Resources

Stars

2 stars

Watchers

2 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages