Firefly III: a personal finances manager
Go to file
2018-01-10 14:37:40 +01:00
.github Expand issue template 2017-12-19 05:19:54 +01:00
.sandstorm Update Sandstorm file list. 2018-01-07 12:29:18 +01:00
app Add routes to ignore. [skip ci] 2018-01-10 12:42:32 +01:00
bootstrap Update copyright [skip ci] 2017-12-17 14:44:46 +01:00
config Clean up binders. 2018-01-10 07:51:47 +01:00
database Remove Spectre table. 2017-12-28 18:26:08 +01:00
docker New docker related files. 2017-12-15 09:16:41 +01:00
public Strings for #1116 (help text) 2018-01-10 08:03:37 +01:00
resources Strings for #1116 (help text) 2018-01-10 08:03:37 +01:00
routes Remove unused route [skip ci] 2018-01-10 12:42:17 +01:00
storage Various updated files. 2017-09-09 22:32:11 +02:00
tests Small extension on import account, for testing mostly. 2018-01-06 09:33:28 +01:00
.dockerignore Docker: Use working directory instead of hardcoded dist version 2017-09-09 12:51:37 +02:00
.env.docker Make env files more readable. 2018-01-10 14:37:40 +01:00
.env.example Make env files more readable. 2018-01-10 14:37:40 +01:00
.env.heroku Make env files more readable. 2018-01-10 14:37:40 +01:00
.env.sandstorm Make env files more readable. 2018-01-10 14:37:40 +01:00
.env.testing Remove reference to incomplete translations [skip ci] 2017-12-02 07:53:23 +01:00
.gitattributes First step towards Laravel 5.5 2017-09-09 21:57:24 +02:00
.gitignore Update gitignore. 2017-09-12 18:24:19 +02:00
.htaccess Add warning message to index. 2018-01-06 10:25:21 +01:00
.scrutinizer.yml Update scrutiniser configuration. 2017-01-03 17:26:31 +01:00
.travis.yml Experimental support for CodeCov. 2018-01-09 17:52:18 +01:00
app.json Update links to new site. 2017-12-13 14:15:44 +01:00
artisan First step towards Laravel 5.5 2017-09-09 21:57:24 +02:00
changelog.md Lower case some file names. 2018-01-09 19:27:12 +01:00
code_of_conduct.md Lower case some file names. 2018-01-09 19:27:12 +01:00
composer.json Update composer files. 2018-01-04 10:25:24 +01:00
composer.lock Updated composer file. 2018-01-07 12:28:43 +01:00
crowdin.yml Update language config. 2017-11-15 07:18:02 +01:00
docker-compose.yml Clean up docker compose file. 2017-12-15 10:05:37 +01:00
Dockerfile Update languages and language config. 2017-12-23 22:02:29 +01:00
index.php Add warning message to index. 2018-01-06 10:25:21 +01:00
LICENSE New copyright notice. 2017-10-21 08:40:00 +02:00
nginx_app.conf Various Heroku related fixes. 2017-11-29 19:15:44 +01:00
package.json First step towards Laravel 5.5 2017-09-09 21:57:24 +02:00
phpunit.coverage.specific.xml Attempt to cover all cases in amount converter, this fixes #840 2017-10-02 16:25:48 +02:00
phpunit.coverage.xml Remove wrong copyright blocks [skip ci] 2017-12-10 08:56:11 +01:00
phpunit.xml Various small fixes. 2017-09-12 18:24:42 +02:00
Procfile Configure nginx [skip ci] 2017-04-27 02:49:06 +02:00
readme.md Small rewrite in readme [skip ci] 2018-01-10 12:42:01 +01:00
server.php First step towards Laravel 5.5 2017-09-09 21:57:24 +02:00
test.sh Remove twig clean from test script 2017-10-09 20:30:57 +02:00
webpack.mix.js First step towards Laravel 5.5 2017-09-09 21:57:24 +02:00

Firefly III

Packagist License

Introduction

"Firefly III" is a (self-hosted) manager for your personal finances. It can help you keep track of your expenses and income, so you can spend less and save more. Firefly III supports the use of budgets, categories and tags. It can import data from external sources and it has many neat financial reports available. Here are some screenshots:

The index of Firefly III The account overview of Firefly III

Overview of all budgets Overview of a category

Purpose

Personal financial management is pretty difficult, and everybody has their own approach to it. Some people make budgets, other people limit their cashflow by throwing away their credit cards, others try to increase their current cashflow. There are tons of ways to save and earn money. Firefly III works on the principle that if you know where you're money is going, you can stop it from going there.

By keeping track of your expenses and your income you can budget accordingly and save money. Stop living from paycheck to paycheck but give yourself the financial wiggle room you need.

You can read more about this on the website.

Features

Most importantly...

  • Firefly can import any CSV file, so migrating from other systems is easy.
  • Firefly runs on your own server, so you are fully in control of your data. It will not contact other sites or servers.
  • If you feel youre missing something you can just ask me and Ill add it!

But actually, it features:

  • A double-entry bookkeeping system;
  • You can store, edit and remove withdrawals, deposits and transfers. This allows you full financial management;
  • You can manage different types of accounts;
  • It's possible to create, change and manage money using budgets;
  • Organize transactions using categories;
  • Save towards a goal using piggy banks;
  • Predict and anticipate bills;
  • View income / expense reports;
  • Rule based transaction handling with the ability to create your own rules.
  • The ability to export data so you can move to another system.
  • The ability to import data so you can move from another system.
  • Organize expenses using tags;
  • 2 factor authentication for extra security 🔒;
  • Supports any currency you want, including crypto currencies such as Bitcoin ₿.
  • Lots of help text in case you dont get it.

Everything is organised:

  • Clear views that should show you how you're doing;
  • Easy navigation through your records;
  • Browse back and forth to see previous months or even years;
  • Lots of charts because we all love them;
  • Financial reporting showing you how well you are doing;
  • Lots of math because we all love it.

Who is it for?

This application is for people who want to track their finances, keep an eye on their money without having to upload their financial records to the cloud. You're a bit tech-savvy, you like open source software and you don't mind tinkering with (self-hosted) servers.

Get started

There are many ways to run Firefly III

  1. There is a demo site with an example financial administration already present.
  2. You can install it on your server.
  3. You can run it using Docker.
  4. You can deploy to Heroku
  5. You can deploy to Sandstorm.io
  6. You can install it using Softaculous. These guys even have made another demo site!
  7. You can install it using AMPPS
  8. Even more options are on the way!

Update your instance

Make sure you check for updates regularly. Your Firefly III instance will ask you to do this. Upgrade instructions can be found with the installation instructions.

Contribute

Your help is always welcome! Feel free to open issues, ask questions, talk about it and discuss this tool. I've create several social media accounts and I invite you to follow them, tweet at them and post to them. There's reddit, Twitter and Facebook just to start. It's not very active but it's a start!

Of course there are some contributing guidelines and a code of conduct, which I invite you to check out.

The goal

Firefly III should give you insight into and control over your finances. Money should be useful, not scary. You should be able to see where it is going, to feel your expenses and to... wow, I'm going overboard with this aren't I?

But you get the idea: this is your money. These are your expenses. Stop them from controlling you. I built this tool because I started to dislike money. Having it, not having, paying bills with it, etc. But no more. I want to feel "safe", whatever my balance is. And I hoop this tool can help. I know it helps me.

Contact

You can contact me at thegrumpydictator@gmail.com, you may open an issue or contact me through the various social media pages there are: reddit, Twitter and Facebook.

Over time, many people have contributed to Firefly III.

Other stuff

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

License

This work is licensed under the GPL v3.

Donate

If you like Firefly III and if it helps you save lots of money, why not send me a dime for every dollar saved (this is a joke, although the Paypal form works just fine, try it!)

Alternatives

If you are looking for alternatives, check out Kickball's Awesome-Selfhosted list which features not only Firefly III but also noteworthy alternatives such as Silverstrike.

Badges

I like badges!

Travis branch Scrutinizer Coveralls github branch Requires PHP7.1 license Donate