PHPackages grumpydictator/firefly-iii - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. grumpydictator/firefly-iii ActiveProject[Utility & Helpers](/categories/utility) grumpydictator/firefly-iii ========================== Firefly III: a personal finances manager. v6.5.9(1mo ago)22.8k69.3kโ€”0%2.1k[144 issues](https://github.com/firefly-iii/firefly-iii/issues)AGPL-3.0-or-laterPHPPHP >=8.5CI passing Since Aug 28Pushed 2mo ago167 watchersCompare [ Source](https://github.com/firefly-iii/firefly-iii)[ Packagist](https://packagist.org/packages/grumpydictator/firefly-iii)[ Docs](https://github.com/firefly-iii/firefly-iii)[ GitHub Sponsors](https://github.com/sponsors/JC5)[ Patreon](https://www.patreon.com/JC5)[ RSS](/packages/grumpydictator-firefly-iii/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (87)Versions (420)Used By (0)Security (24) [![Packagist](https://camo.githubusercontent.com/b10cd89fab8635ffc78e026943e1a91f0ea948ba68dcd0530d51bf0526d1b342/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6772756d70796469637461746f722f66697265666c792d6969692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/grumpydictator/firefly-iii)[![License](https://camo.githubusercontent.com/3182d03041f3cf1767504165dd83abd36afe06c7c5c567c2fcdd27f9b286d039/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f66697265666c792d6969692f66697265666c792d6969692e7376673f7374796c653d666c61742d737175617265)](https://www.gnu.org/licenses/agpl-3.0.html)[![Stargazers](https://camo.githubusercontent.com/37738ac5bb9e7f37e4e80418f733ab9f07a22e7a5b225cada3453a2406541000/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f66697265666c792d6969692f66697265666c792d6969692e7376673f7374796c653d666c61742d737175617265)](https://github.com/firefly-iii/firefly-iii/stargazers)[![Donate](https://camo.githubusercontent.com/ad850c153222b6e190d4f1904b898c8029dd0ae2c05b848e39eaa2a5cc73cb47/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f6e6174652d2532342532302545322538322541432d627269676874677265656e3f7374796c653d666c61742d737175617265)](#support-the-development-of-firefly-iii) [ ![Firefly III](https://raw.githubusercontent.com/firefly-iii/firefly-iii/develop/.github/assets/img/logo-small.png) ](https://firefly-iii.org/) Firefly III =========== [](#firefly-iii) A free and open source personal finance manager [**Explore the documentation**](https://docs.firefly-iii.org/) [View the demo](https://demo.firefly-iii.org/) ยท [Report a bug](https://github.com/firefly-iii/firefly-iii/issues) ยท [Request a feature](https://github.com/firefly-iii/firefly-iii/issues) ยท [Ask questions](https://github.com/firefly-iii/firefly-iii/discussions) - [About Firefly III](#about-firefly-iii) - [Purpose](#purpose) - [Features](#features) - [Who's it for?](#whos-it-for) - [The Firefly III eco-system](#the-firefly-iii-eco-system) - [Getting Started](#getting-started) - [Contributing](#contributing) - [Support the development of Firefly III](#support-the-development-of-firefly-iii) - [License](#license) - [Do you need help, or do you want to get in touch?](#do-you-need-help-or-do-you-want-to-get-in-touch) - [Acknowledgements](#acknowledgements) About Firefly III ----------------- [](#about-firefly-iii) [![Firefly III on iMac](https://raw.githubusercontent.com/firefly-iii/firefly-iii/develop/.github/assets/img/imac-complete.png)](https://raw.githubusercontent.com/firefly-iii/firefly-iii/develop/.github/assets/img/imac-complete.png) "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 [](#purpose) [![Firefly III on iPad](https://raw.githubusercontent.com/firefly-iii/firefly-iii/develop/.github/assets/img/ipad-complete.png)](https://raw.githubusercontent.com/firefly-iii/firefly-iii/develop/.github/assets/img/ipad-complete.png) 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](https://docs.firefly-iii.org/). Features -------- [](#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: - Create [recurring transactions to manage your money](https://docs.firefly-iii.org/explanation/financial-concepts/recurring/). - [Rule based transaction handling](https://docs.firefly-iii.org/how-to/firefly-iii/features/rules/) with the ability to create your own rules. Then the things that make you go "yeah OK, makes sense". - A [double-entry](https://en.wikipedia.org/wiki/Double-entry_bookkeeping_system) bookkeeping system. - Save towards a goal using [piggy banks](https://docs.firefly-iii.org/explanation/financial-concepts/piggy-banks/). - View [income and expense reports](https://docs.firefly-iii.org/how-to/firefly-iii/finances/reports/). And the things you would hope for but not expect: - 2 factor authentication for extra security ๐Ÿ”’. - Supports [any currency you want](https://docs.firefly-iii.org/how-to/firefly-iii/features/currencies/). - There is a [Docker image](https://docs.firefly-iii.org/how-to/firefly-iii/installation/docker/). 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](https://docs.firefly-iii.org/explanation/firefly-iii/about/introduction/). Who's it for? ------------- [](#whos-it-for) [![Firefly III on iPhone](https://raw.githubusercontent.com/firefly-iii/firefly-iii/develop/.github/assets/img/iphone-complete.png)](https://raw.githubusercontent.com/firefly-iii/firefly-iii/develop/.github/assets/img/iphone-complete.png) 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 -------------------------- [](#the-firefly-iii-eco-system) Several users have built pretty awesome stuff around the Firefly III API. [Check out these tools in the documentation](https://docs.firefly-iii.org/references/firefly-iii/third-parties/apps/). Getting Started --------------- [](#getting-started) There are many ways to run Firefly III 1. There is a [demo site](https://demo.firefly-iii.org) with an example financial administration already present. 2. You can [install it on your server](https://docs.firefly-iii.org/how-to/firefly-iii/installation/self-managed/). 3. You can [run it using Docker](https://docs.firefly-iii.org/how-to/firefly-iii/installation/docker/). 4. You can [deploy via Kubernetes](https://firefly-iii.github.io/kubernetes/). 5. You can [install it using Softaculous](https://www.softaculous.com/softaculous/apps/others/Firefly_III). 6. You can [install it using AMPPS](https://www.ampps.com/). 7. You can [install it on Cloudron](https://cloudron.io/store/org.fireflyiii.cloudronapp.html). 8. You can [install it on Lando](https://gist.github.com/ArtisKrumins/ccb24f31d6d4872b57e7c9343a9d1bf0). 9. You can [install it on Yunohost](https://github.com/YunoHost-Apps/firefly-iii). Contributing ------------ [](#contributing) You can contact me at , you may open an issue in the [main repository](https://github.com/firefly-iii/firefly-iii) or contact me through [gitter](https://gitter.im/firefly-iii/firefly-iii) and [Mastodon](https://fosstodon.org/@ff3). Of course, there are some [contributing guidelines](https://docs.firefly-iii.org/explanation/support/#contributing-code) and a [code of conduct](https://github.com/firefly-iii/firefly-iii/blob/main/.github/code_of_conduct.md), which I invite you to check out. I can always use your help [squashing bugs](https://docs.firefly-iii.org/explanation/support/), thinking about [new features](https://docs.firefly-iii.org/explanation/support/) or [translating Firefly III](https://docs.firefly-iii.org/how-to/firefly-iii/development/translations/) into other languages. [Sonarcloud](https://sonarcloud.io/dashboard?id=firefly-iii_firefly-iii) 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](https://camo.githubusercontent.com/a091b0d000c6e911ffc004e4a01eaae41d0b615bd77636a854650c5e0cf5215c/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d66697265666c792d6969695f66697265666c792d696969266d65747269633d616c6572745f737461747573)](https://sonarcloud.io/dashboard?id=firefly-iii_firefly-iii) [![Bugs](https://camo.githubusercontent.com/a7886d22b95818c8535d8c5a626956d7c29dffde2f8e271e163fd3e05c428fe4/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d66697265666c792d6969695f66697265666c792d696969266d65747269633d62756773)](https://sonarcloud.io/dashboard?id=firefly-iii_firefly-iii) [![Code Smells](https://camo.githubusercontent.com/af0b9ffaf4e5a550df928e716f866c2e3aab3677aee49feae5f23a68b41f5ca2/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d66697265666c792d6969695f66697265666c792d696969266d65747269633d636f64655f736d656c6c73)](https://sonarcloud.io/dashboard?id=firefly-iii_firefly-iii) [![Vulnerabilities](https://camo.githubusercontent.com/6664a9f40320b9c98d310d3f54d981e0c94fa47b9308e16cebbb5601749a7630/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d66697265666c792d6969695f66697265666c792d696969266d65747269633d76756c6e65726162696c6974696573)](https://sonarcloud.io/dashboard?id=firefly-iii_firefly-iii) There is also a [security policy](https://github.com/firefly-iii/firefly-iii/security/policy). [![CII Best Practices](https://camo.githubusercontent.com/deee7c9f1edc7ff1699937bee503cb4bb82f9bdf6b21c96491d7d0e80649b627/68747470733a2f2f626573747072616374696365732e636f7265696e6672617374727563747572652e6f72672f70726f6a656374732f363333352f6261646765)](https://bestpractices.coreinfrastructure.org/projects/6335) Support the development of Firefly III -------------------------------------- [](#support-the-development-of-firefly-iii) Firefly III is a side gig. With your sponsorship or support, I can spend more time on Firefly III. So, 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. But for real, when you feel Firefly III made your life better, please consider contributing as a sponsor. Please check out my [Patreon](https://www.patreon.com/jc5) and [GitHub Sponsors](https://github.com/sponsors/JC5) page for more information. You can also [buy me a โ˜•๏ธ coffee at ko-fi.com](https://ko-fi.com/Q5Q5R4SH1) or send something my way using [Liberapay](https://liberapay.com/JC5). Thank you for your consideration. ### Sponsorships [](#sponsorships) Firefly III is sponsored by TestMu AI. Their support allows me to test Firefly III more easily and introduce even fewer bugs with every release. Browser testing via: [![Testmu](.github/assets/img/testmu.png)](https://www.testmuai.com/?utm_source=fireflyiii&utm_medium=sponsor)License ------- [](#license) This work [is licensed](https://github.com/firefly-iii/firefly-iii/blob/main/LICENSE) under the [GNU Affero General Public License v3](https://www.gnu.org/licenses/agpl-3.0.html). Do you need help, or do you want to get in touch? ------------------------------------------------- [](#do-you-need-help-or-do-you-want-to-get-in-touch) Do you want to contact me? You can email me at or get in touch through one of the following support channels: - [GitHub Discussions](https://github.com/firefly-iii/firefly-iii/discussions/) for questions and support - [Gitter.im](https://gitter.im/firefly-iii/firefly-iii) for a good chat and a quick answer - [GitHub Issues](https://github.com/firefly-iii/firefly-iii/issues) for bugs and issues - [Mastodon](https://fosstodon.org/@ff3) for news and updates Acknowledgements ---------------- [](#acknowledgements) Over time, [many people have contributed to Firefly III](https://github.com/firefly-iii/firefly-iii/graphs/contributors). I'm grateful for their support and code contributions. The Firefly III logo is made by the excellent Cherie Woo. ### Health Score 77 โ€” ExcellentBetter than 100% of packages Maintenance86 Actively maintained with recent releases Popularity65 Solid adoption and visibility Community40 Growing community involvement Maturity100 Battle-tested with a long release history Bus Factor1 Top contributor holds 90.7% of commits โ€” single point of failure How is this calculated?**Maintenance (25%)** โ€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** โ€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** โ€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** โ€” Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~10 days Recently: every ~2 days Total 411 Last Release 57d ago Major Versions 3.10.4 โ†’ 4.0.02016-09-26 4.8.3-alpha.1 โ†’ 5.0.0-alpha.12019-12-27 5.8.0-alpha.1 โ†’ 6.0.0-alpha.12023-01-15 PHP version history (12 changes)3.6.0PHP >=5.6.4 4.0.0PHP >=7.0.0 4.6.4PHP >=7.1.0 4.7.7PHP >=7.2.0 4.8.1PHP >=7.3.0 5.3.0-alpha.1PHP >=7.4.0 5.6.0-alpha.1PHP >=8.0.0 5.6.1PHP >=8 5.8.0-alpha.1PHP >=8.2 v6.1.x-devPHP >=8.3 v6.2.x-devPHP >=8.4 v6.5.0PHP >=8.5 ### Community Maintainers ![](https://www.gravatar.com/avatar/48108cc08b6a55e32067a7344558f8fd3169797407b7ebc28b16b82e726c3638?d=identicon)[TheGrumpyDictator](/maintainers/TheGrumpyDictator) --- Top Contributors [![JC5](https://avatars.githubusercontent.com/u/5889984?v=4)](https://github.com/JC5 "JC5 (20247 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (796 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (661 commits)")[![mergify[bot]](https://avatars.githubusercontent.com/in/10562?v=4)](https://github.com/mergify[bot] "mergify[bot] (146 commits)")[![SDx3](https://avatars.githubusercontent.com/u/16149559?v=4)](https://github.com/SDx3 "SDx3 (120 commits)")[![sephrat](https://avatars.githubusercontent.com/u/34862846?v=4)](https://github.com/sephrat "sephrat (52 commits)")[![roberthorlings](https://avatars.githubusercontent.com/u/1818378?v=4)](https://github.com/roberthorlings "roberthorlings (44 commits)")[![lguima](https://avatars.githubusercontent.com/u/1562097?v=4)](https://github.com/lguima "lguima (40 commits)")[![Sobuno](https://avatars.githubusercontent.com/u/3593183?v=4)](https://github.com/Sobuno "Sobuno (27 commits)")[![michaelhthomas](https://avatars.githubusercontent.com/u/18223295?v=4)](https://github.com/michaelhthomas "michaelhthomas (18 commits)")[![bnw](https://avatars.githubusercontent.com/u/2411799?v=4)](https://github.com/bnw "bnw (17 commits)")[![hamuz](https://avatars.githubusercontent.com/u/550499?v=4)](https://github.com/hamuz "hamuz (16 commits)")[![tonicospinelli](https://avatars.githubusercontent.com/u/966337?v=4)](https://github.com/tonicospinelli "tonicospinelli (13 commits)")[![zjean](https://avatars.githubusercontent.com/u/441924?v=4)](https://github.com/zjean "zjean (13 commits)")[![tasnim0tantawi](https://avatars.githubusercontent.com/u/101149675?v=4)](https://github.com/tasnim0tantawi "tasnim0tantawi (10 commits)")[![GeoffreyFrogeye](https://avatars.githubusercontent.com/u/1685403?v=4)](https://github.com/GeoffreyFrogeye "GeoffreyFrogeye (9 commits)")[![rubenverhoef](https://avatars.githubusercontent.com/u/9071284?v=4)](https://github.com/rubenverhoef "rubenverhoef (9 commits)")[![patrickkostjens](https://avatars.githubusercontent.com/u/2632266?v=4)](https://github.com/patrickkostjens "patrickkostjens (8 commits)")[![ctrl-f5](https://avatars.githubusercontent.com/u/485346?v=4)](https://github.com/ctrl-f5 "ctrl-f5 (8 commits)")[![pkoziol](https://avatars.githubusercontent.com/u/3846677?v=4)](https://github.com/pkoziol "pkoziol (7 commits)") --- Tags accountingbudgetbudgetingbudgetscash-flowcashflowcredit-carddockerexpensesfinancefinancesfinanciallinuxmoneypaycheckpersonal-financephpphp7laravelhelpermoneycurrencytoolmanagermanagementadministrationfinancetransactionshelpplanningtransfersfinancialself hostedfinancestoolingeurodollarassistantfinancialsbudgetsorganizingbillspersonal financebudgetingbudgeting toolbudgeting application ### Code Quality TestsPHPUnit Static AnalysisPHPStan, Rector Type Coverage Yes ### Embed Badge ![Health badge](/badges/grumpydictator-firefly-iii/health.svg) ``` [![Health](https://phpackages.com/badges/grumpydictator-firefly-iii/health.svg)](https://phpackages.com/packages/grumpydictator-firefly-iii) ``` ### Alternatives [firefly-iii/data-importer Firefly III Data Import Tool. 7545.8k](/packages/firefly-iii-data-importer)[statamic/cms The Statamic CMS Core Package 4.8k3.2M720](/packages/statamic-cms)[bagisto/bagisto Bagisto Laravel E-Commerce 26.2k161.6k7](/packages/bagisto-bagisto)[unopim/unopim UnoPim Laravel PIM 9.4k1.8k](/packages/unopim-unopim)[blair2004/nexopos The Free Modern Point Of Sale System build with Laravel, TailwindCSS and Vue.js. 1.2k2.3k](/packages/blair2004-nexopos) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)