firefly-iii/README.md

98 lines
5.0 KiB
Markdown
Raw Normal View History

2015-05-09 08:13:14 -05:00
# Firefly III
2015-05-18 11:23:01 -05:00
#### v3.4.0.7
2014-07-02 06:23:03 -05:00
2014-12-20 08:30:48 -06:00
[![Build Status](https://travis-ci.org/JC5/firefly-iii.svg?branch=develop)](https://travis-ci.org/JC5/firefly-iii)
2014-12-16 02:15:04 -06:00
[![Project Status](http://stillmaintained.com/JC5/firefly-iii.png?a=b)](http://stillmaintained.com/JC5/firefly-iii)
2015-01-02 02:06:44 -06:00
[![SensioLabsInsight](https://insight.sensiolabs.com/projects/d44c7012-5f50-41ad-add8-8445330e4102/mini.png)](https://insight.sensiolabs.com/projects/d44c7012-5f50-41ad-add8-8445330e4102)
2015-01-30 15:09:47 -06:00
[![Code Climate](https://codeclimate.com/github/JC5/firefly-iii/badges/gpa.svg)](https://codeclimate.com/github/JC5/firefly-iii)
2015-03-31 12:21:49 -05:00
[![Coverage Status](https://coveralls.io/repos/JC5/firefly-iii/badge.svg?branch=master)](https://coveralls.io/r/JC5/firefly-iii?branch=master)
2014-07-15 03:58:46 -05:00
[![Latest Stable Version](https://poser.pugx.org/grumpydictator/firefly-iii/v/stable.svg)](https://packagist.org/packages/grumpydictator/firefly-iii)
2015-05-09 03:43:37 -05:00
![GA](https://ga-beacon.appspot.com/UA-58172398-6/firefly-iii/readme)
2015-05-08 12:34:03 -05:00
## About
"Firefly III" is a financial manager. It can help you keep track of expenses, income, budgets and everything in between. It even supports credit cards, shared
2015-05-09 02:15:39 -05:00
household accounts and savings accounts! It's pretty fancy. You should use it to save and organise money.
2015-05-08 12:34:03 -05:00
2015-05-14 02:21:12 -05:00
_Firefly is a system you'll have install yourself on webhosting of your choosing._
2015-05-08 12:34:03 -05:00
Personal financial management is pretty difficult, and everybody has their own approach to it. Some people
2015-05-14 02:21:12 -05:00
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 works on the principle that if you know where you're money is going, you can stop it from going there.
2015-05-08 12:34:03 -05:00
To get to know Firefly, and to see if it fits you, check out these resources:
- The screenshots below on this very page.
- The featurelist below, also on this very page.
- The [full description](https://github.com/JC5/firefly-iii/wiki/full-description), which will tell you how Firefly works,
and the philosophy behind it.
2014-11-10 00:55:52 -06:00
2015-05-14 02:21:12 -05:00
#### About the name (if you care)
2014-07-02 06:23:03 -05:00
2015-05-08 12:34:03 -05:00
It's III, or 3, because [version 2](https://github.com/JC5/Firefly) and version 1 (not online) preceded it. It has been growing steadily ever since.
2015-03-27 12:57:49 -05:00
2014-09-09 13:57:23 -05:00
## Current features
2015-04-03 00:44:44 -05:00
- [A double-entry bookkeeping system](https://en.wikipedia.org/wiki/Double-entry_bookkeeping_system);
2015-05-09 02:11:54 -05:00
- You can store, edit and remove [withdrawals, deposits and transfers](https://en.wikipedia.org/wiki/Financial_transaction). This allows you full financial management;
2015-05-18 09:59:01 -05:00
- You can manage different types of accounts;
2015-05-09 02:11:54 -05:00
- [Asset](https://en.wikipedia.org/wiki/Asset) accounts
- Shared [asset accounts](https://en.wikipedia.org/wiki/Asset) ([household accounts](https://en.wikipedia.org/wiki/Household))
2015-04-03 00:44:44 -05:00
- Saving accounts
- Credit cards
- It's possible to create, change and manage money using _[budgets](https://en.wikipedia.org/wiki/Envelope_system)_;
2014-09-09 13:57:23 -05:00
- Organize transactions using categories;
2015-05-09 02:11:54 -05:00
- Save towards a goal using [piggy banks](https://en.wikipedia.org/wiki/Piggy_bank);
- Predict and anticipate [bills](https://en.wikipedia.org/wiki/Invoice);
- View income / expense [reports](https://en.wikipedia.org/wiki/Financial_statement);
2015-05-08 12:34:03 -05:00
- Organize expenses using tags;
- Lots of help text in case you don't get it.
2014-09-09 13:57:23 -05:00
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;
2015-05-18 09:59:01 -05:00
- Lots of charts because we all love them;
- Financial reporting showing you how well you are doing.
2014-09-09 13:57:23 -05:00
2014-11-09 04:08:53 -06:00
## Screenshots
2015-05-09 02:17:09 -05:00
_Please note that everything in these screenshots is fictional and may not be realistic._
2015-05-09 02:15:39 -05:00
2015-05-08 10:34:54 -05:00
![Index](https://i.nder.be/c09vfw90)
2014-11-09 04:08:53 -06:00
2015-05-08 10:34:54 -05:00
![Accounts](https://i.nder.be/hkn0vhcg)
2014-11-09 04:10:57 -06:00
2015-05-08 10:34:54 -05:00
![Budgets](https://i.nder.be/h2snx2mw)
2014-11-09 04:10:57 -06:00
2015-05-08 10:34:54 -05:00
![Reports 1](https://i.nder.be/c9f8zy5c)
![Reports 2](https://i.nder.be/ghvs5png)
![Bills](https://i.nder.be/h58kh00p)
![Piggy banks](https://i.nder.be/hkud0h53)
2014-11-09 04:10:57 -06:00
2015-05-17 02:18:44 -05:00
## Running and installing
If you're still interested please read [the installation guide](https://github.com/JC5/firefly-iii/wiki/Installation),
[the upgrade guide](https://github.com/JC5/firefly-iii/wiki/Upgrade-instructions) (if applicable)
and the **[first use guide](https://github.com/JC5/firefly-iii/wiki/First-use)**.
If you want to try out Firefly III, you can do so on [this dedicated website](https://geld.nder.be/).
This site always runs the latest version of Firefly III. If you want to use it, please read the [privacy considerations](https://github.com/JC5/firefly-iii/wiki/Privacy-on-demo-site) for this demo-site.
2014-07-02 06:31:38 -05:00
## Current state
2014-07-09 07:10:54 -05:00
2015-05-09 02:11:54 -05:00
Firefly III is pretty much all grown up. Full test coverage (nerd alert!) is coming. One of the things on the todo-list
is adding translations.
2015-05-08 12:34:03 -05:00
Questions, ideas, bugs or other things to contribute? [Let me know](https://github.com/JC5/firefly-iii/issues/new)!
2015-05-09 08:08:56 -05:00
If you like this tool, feel free to [donate me some beer money](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=2ZMV952UUSCLU&lc=NL&item_name=Development%20of%20Firefly&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted).