Firefly III: a personal finances manager
Go to file
2020-11-29 09:29:38 +01:00
.ci Remove deprecated call 2020-11-08 14:07:59 +01:00
.deploy/heroku Updated meta-files & translations for upcoming release. 2020-10-02 08:46:41 +02:00
.github Extra instructions in GitHub templates. 2020-11-19 06:31:09 +01:00
app Export meta data, fix #3717 2020-11-29 07:58:24 +01:00
bootstrap Expand search. 2020-08-22 12:24:01 +02:00
config Config for webhooks. 2020-11-29 09:15:27 +01:00
database First attempt at webhooks table. 2020-11-29 09:29:38 +01:00
frontend Rebuild front 2020-11-29 07:06:55 +01:00
public Expand frontend. 2020-11-27 06:14:10 +01:00
resources Fix #4098 2020-11-29 07:07:08 +01:00
routes Rebuild front 2020-11-29 07:06:55 +01:00
storage Fix for #1766 2018-11-16 15:26:37 +01:00
tests Expand tests 2020-11-07 14:05:53 +01:00
.env.example Config for webhooks. 2020-11-29 09:15:27 +01:00
.gitattributes Update attributes 2020-09-18 12:25:41 +02:00
.gitignore First set of code for new layout based on AdminLTE 3.0 2020-06-14 15:51:20 +02:00
.htaccess Add warning message to index. 2018-01-06 10:25:21 +01:00
.scrutinizer.yml Update .scrutinizer.yml 2018-01-19 08:23:31 +01:00
.travis.yml Remove plugin from Travis script. 2020-11-08 07:07:20 +01:00
app.json Fix https://github.com/firefly-iii/firefly-iii/issues/3545 2020-07-11 07:01:29 +02:00
artisan First step towards Laravel 5.5 2017-09-09 21:57:24 +02:00
changelog.md Cleanup changelog. 2020-11-07 17:42:00 +01:00
composer.json update packages. 2020-11-04 19:05:35 +01:00
composer.lock Update composer to catch some passport related problems. 2020-11-28 05:36:56 +01:00
COPYING More fixes for #2607 2019-10-03 20:19:29 +02:00
crowdin.yml Refactor script locations to clear up root directory. 2019-02-20 07:04:24 +01:00
index.php Update email address. 2020-02-16 14:00:57 +01:00
LICENSE Update copyright of Firefly III to the GNU Affero General Public License as suggested by @nxxxse in #2607. This applies to all code in this commit from this moment onwards. 2019-10-02 06:45:10 +02:00
nginx_app.conf Update some code for Heroku. 2018-08-01 07:24:19 +02:00
package.json Bump axios from 0.20.0 to 0.21.0 2020-10-26 05:18:49 +00:00
phpunit.xml Create some new test code. 2020-10-04 10:56:10 +02:00
Procfile Configure nginx [skip ci] 2017-04-27 02:49:06 +02:00
readme.md Slight reorder of shields. 2020-10-18 12:52:16 +02:00
releases.md Code changes for v540 2020-09-18 12:16:47 +02:00
server.php Update email address. 2020-02-16 14:00:57 +01:00
sonar-project.properties Update sonar rules. 2020-11-15 14:02:12 +01:00
webpack.mix.js New and optimised Vue code, courtesy of @GaryQ 2020-02-19 17:13:01 +01:00
yarn.lock Rebuild frontend 2020-11-21 12:06:43 +01:00

Packagist License Stargazers Donate


Logo

Firefly III

A free and open source personal finance manager
Explore the docs »

View Demo · Report Bug · Request Feature

Travis Build Status

About Firefly III

"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. Using a bunch of external tools, you can import data. It also has many neat financial reports available.

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 money, not having money, paying bills with money, you get the idea. But no more. I want to feel "safe", whatever my balance is. And I hope this tool can help you. I know it helps me.

Purpose

Firefly III on iPad

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 your 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 the purpose of Firefly III in the documentation.

Features

Firefly III is pretty feature packed. Some important stuff first:

  • It is completely self-hosted and isolated, and will never contact external servers until you explicitly tell it to.
  • It features a REST JSON API that covers almost every part of Firefly III.

The most exciting features are:

Then the things that make you go "yeah OK, makes sense".

And the things you would hope for but not expect:

And to organise everything:

  • Clear views that should show you how you're doing
  • Easy navigation through your records
  • Lots of charts because we all love them

Many more features are listed in the documentation.

Who's 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.


The Firefly III eco-system

Several users have built pretty awesome stuff around the Firefly III API. Check out these tools in the documentation.

Getting 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 install it using Softaculous.
  5. You can install it using AMPPS.
  6. You can install it on Cloudron.
  7. You can install it on Lando.
  8. You can install it on Yunohost

Contributing

Your help is always welcome! Feel free to open issues, ask questions, talk about it and discuss this tool. You can use the community forum over at reddit or interact on Twitter.

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

I can always use your help squashing bugs, thinking about new features or translating Firefly III into other languages.

Sonarcloud scans the code of Firefly III. If you want to help improve Firefly III, check out the latest reports and take your pick!

Quality Gate Status Bugs Code Smells Vulnerabilities

There is also a security policy.

Support the development of Firefly III

If you like Firefly III and if it helps you save lots of money, why not send me a dime for every dollar saved! 🎉

OK that was a joke. You can donate using the GitHub Sponsors Program or Patreon. If you wish to make a one-time donation just cancel your patronage after the first withdrawal.

Thank you for considering donating to Firefly III!

License

This work is licensed under the GNU Affero General Public License v3.

Contact

You can contact me at james@firefly-iii.org, you may open an issue or contact me through the various social media pages there are: reddit and Twitter.

Acknowledgements

Over time, many people have contributed to Firefly III. I'm grateful for their your support and code contributions.