PHPackages                             firefly-iii/data-importer - 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. firefly-iii/data-importer

ActiveProject[Utility & Helpers](/categories/utility)

firefly-iii/data-importer
=========================

Firefly III Data Import Tool.

v2.2.2(1mo ago)7545.8k114[1 issues](https://github.com/firefly-iii/data-importer/issues)AGPL-3.0-or-laterPHPPHP >=8.5CI passing

Since Nov 27Pushed 1mo ago6 watchersCompare

[ Source](https://github.com/firefly-iii/data-importer)[ Packagist](https://packagist.org/packages/firefly-iii/data-importer)[ Docs](https://github.com/firefly-iii/data-importer)[ GitHub Sponsors](https://github.com/sponsors/JC5)[ Patreon](https://www.patreon.com/JC5)[ RSS](/packages/firefly-iii-data-importer/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (58)Versions (112)Used By (0)

Firefly III Data Importer
=========================

[](#firefly-iii-data-importer)

[![Packagist](https://camo.githubusercontent.com/ef564a33aa09d49f3d79d3702d0726ae731628709123df9e2e98919f02a49893/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f66697265666c792d6969692f646174612d696d706f727465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/firefly-iii/data-importer)[![License](https://camo.githubusercontent.com/e5ff05567731549f54cb391b2f586fe7bfc010958e85c6354e8827f5bf8fe113/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f66697265666c792d6969692f646174612d696d706f727465722e7376673f7374796c653d666c61742d737175617265)](https://www.gnu.org/licenses/agpl-3.0.html)[![Stargazers](https://camo.githubusercontent.com/2d2e468f709d6ea09947d6602c81757deacd257db83963d24987abe8347c0897/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f66697265666c792d6969692f646174612d696d706f727465722e7376673f7374796c653d666c61742d737175617265)](https://github.com/firefly-iii/data-importer/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 Data Importer
=========================

[](#firefly-iii-data-importer-1)

 Import your transactions into Firefly III
 [**Explore the documentation**](https://docs.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 the data importer
-----------------------

[](#about-the-data-importer)

"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. The **Firefly III Data Importer** is built to help you import transactions into Firefly III. It is separated from Firefly III for security and maintenance reasons.

The data importer does not connect to your bank directly. Instead, it uses [third party data providers](https://docs.firefly-iii.org/how-to/data-importer/import/third-party-providers/) to help you import data into Firefly III. Some of these providers are free of charge, others charge money.

If you do not want to rely on third parties to import your data, you can import data using the following file formats:

- CSV
- CAMT.052
- CAMT.053

Other formats are on my to do list :-).

You can run the data importer once, for a bulk import. You can also run it regularly to keep up with new transactions.

Eager to get started? Go to [the documentation](https://docs.firefly-iii.org/)!

Features
--------

[](#features)

- Import from many banks using third party data providers
- Import over the command line for easy automation
- Import over an API for easy automation
- Use rules and data mapping for transaction clarity

Many more features are listed in the [documentation](https://docs.firefly-iii.org/).

Who's it for?
-------------

[](#whos-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.

Getting Started
---------------

[](#getting-started)

Many more features are listed in the [documentation](https://docs.firefly-iii.org/).

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://github.com/firefly-iii/data-importer/blob/main/.github/contributing.md) and a [code of conduct](https://github.com/firefly-iii/data-importer/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/#contributing-code), thinking about [new features](https://docs.firefly-iii.org/explanation/support/#contributing-code) or [translating Firefly III](https://docs.firefly-iii.org/how-to/firefly-iii/development/translations/) into other languages.

There is also a [security policy](https://github.com/firefly-iii/data-importer/security/policy).

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 LamdaTest. Their support allows me to test Firefly III more easily and introduce even fewer bugs with every release.

Browser testing via [![](https://camo.githubusercontent.com/916f546d68031760b9e3019b74174931ce99ee1e480825499a8feaae872239f3/68747470733a2f2f7777772e6c616d626461746573742e636f6d2f626c75652d6c6f676f2e706e67)](https://www.lambdatest.com/?utm_source=fireflyiii&utm_medium=sponsor)

License
-------

[](#license)

This work [is licensed](https://github.com/firefly-iii/data-importer/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. Issues are collected centrally, in the [Firefly III repository](https://github.com/firefly-iii/firefly-iii).
- [Mastodon](https://fosstodon.org/@ff3) for news and updates

Acknowledgements
----------------

[](#acknowledgements)

The Firefly III logo is made by the excellent Cherie Woo.

###  Health Score

65

—

FairBetter than 99% of packages

Maintenance89

Actively maintained with recent releases

Popularity44

Moderate usage in the ecosystem

Community30

Small or concentrated contributor base

Maturity84

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 60.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 ~16 days

Recently: every ~10 days

Total

100

Last Release

53d ago

Major Versions

0.9.17 → v1.0.02023-01-22

v1.9.1 → v2.0.02026-01-05

PHP version history (5 changes)0.1.0PHP >=8.0

v1.0.0PHP >=8.2

v1.4.0PHP >=8.3

v1.6.0PHP >=8.4

v2.2.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 (1993 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (748 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (342 commits)")[![beatbesmer](https://avatars.githubusercontent.com/u/17173365?v=4)](https://github.com/beatbesmer "beatbesmer (100 commits)")[![mergify[bot]](https://avatars.githubusercontent.com/in/10562?v=4)](https://github.com/mergify[bot] "mergify[bot] (51 commits)")[![barreeeiroo](https://avatars.githubusercontent.com/u/19251112?v=4)](https://github.com/barreeeiroo "barreeeiroo (11 commits)")[![Call-Me-G-Now](https://avatars.githubusercontent.com/u/125204742?v=4)](https://github.com/Call-Me-G-Now "Call-Me-G-Now (4 commits)")[![TomVarga](https://avatars.githubusercontent.com/u/3092675?v=4)](https://github.com/TomVarga "TomVarga (4 commits)")[![yparitcher](https://avatars.githubusercontent.com/u/38916402?v=4)](https://github.com/yparitcher "yparitcher (2 commits)")[![bedesv](https://avatars.githubusercontent.com/u/5328041?v=4)](https://github.com/bedesv "bedesv (2 commits)")[![BerghsJelmer](https://avatars.githubusercontent.com/u/43340072?v=4)](https://github.com/BerghsJelmer "BerghsJelmer (2 commits)")[![diogotcorreia](https://avatars.githubusercontent.com/u/7467891?v=4)](https://github.com/diogotcorreia "diogotcorreia (2 commits)")[![grgar](https://avatars.githubusercontent.com/u/191085?v=4)](https://github.com/grgar "grgar (2 commits)")[![patricksindelka](https://avatars.githubusercontent.com/u/9056550?v=4)](https://github.com/patricksindelka "patricksindelka (2 commits)")[![SDx3](https://avatars.githubusercontent.com/u/16149559?v=4)](https://github.com/SDx3 "SDx3 (2 commits)")[![0xjams](https://avatars.githubusercontent.com/u/1040997?v=4)](https://github.com/0xjams "0xjams (1 commits)")[![ddelbondio](https://avatars.githubusercontent.com/u/180071?v=4)](https://github.com/ddelbondio "ddelbondio (1 commits)")[![JcMinarro](https://avatars.githubusercontent.com/u/4047514?v=4)](https://github.com/JcMinarro "JcMinarro (1 commits)")[![JelmerBerghs](https://avatars.githubusercontent.com/u/22679293?v=4)](https://github.com/JelmerBerghs "JelmerBerghs (1 commits)")[![krehl](https://avatars.githubusercontent.com/u/1944048?v=4)](https://github.com/krehl "krehl (1 commits)")

---

Tags

budgetingcsvdata-managementfireflyfirefly-iiigocardlessimportmoneymoney-trackernordigenpersonal-finance-managerpersonal-financespsd2salt-edgespectrelaravelhelpermoneycurrencycsvtoolimportmanagermanagementadministrationfinancetransactionshelpplanningtransfersfinancialself hostedfireflyfinancestoolingeurodollarassistantfinancialsbudgetsorganizingbillspersonal financebudgetingbudgeting toolbudgeting applicationfirefly iiicomma separated fileimporting

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Type Coverage Yes

### Embed Badge

![Health badge](/badges/firefly-iii-data-importer/health.svg)

```
[![Health](https://phpackages.com/badges/firefly-iii-data-importer/health.svg)](https://phpackages.com/packages/firefly-iii-data-importer)
```

###  Alternatives

[grumpydictator/firefly-iii

Firefly III: a personal finances manager.

22.8k69.3k](/packages/grumpydictator-firefly-iii)[torann/currency

This provides Laravel with currency functions such as currency formatting and conversion using up-to-date exchange rates.

4081.1M6](/packages/torann-currency)[blair2004/nexopos

The Free Modern Point Of Sale System build with Laravel, TailwindCSS and Vue.js.

1.2k2.3k](/packages/blair2004-nexopos)[danielme85/laravel-cconverter

Laravel 5 plug-in for currency conversion

42101.1k](/packages/danielme85-laravel-cconverter)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)