Home Assistant Integration

[soloam]

Hello, I'm making a Home Assistant Integration to pull data from firefly into Home Assistant. I would like to ask if it's OK to use names and logos from firefly in the integration! I'll make links and references in the repo to this repo!

Thank you

[JC5]

I thought there already is a Home Assistant integration?

[lucaslgr]

Very interesting, now I got it! thank you!!

[soloam]

I'm looking for beta testers to help me target bugs and potencial features prior to release on HACS. If you would like to test it out, or anyone else, say something so that I can provide the link to add to HACS custom repositories!

[diamant-x]

I would do it happily, but only have one instance of FF3, with nearly a decade of data working with so can't allow myself to loose it so I won't risk it. If FF3 had some easy way to export-import data to a new instance I would do it happily (that would also help to migrate from one DB engine to another, say moving from a MariaDB i'm sharing with other apps, to a SQLite instance so i can back it up in a single file.
Sorry!

[soloam]

The interface only reads data, it does not write! The only way to the interface to write is with the services that will allow to create transfers and bills!

[soloam]

The first version of the integration is on my github! You can add it to HACS custom repositories as integration and after reboot you can install it on the UI!

Please note that I’ll not be retrofitting configs to versions until its final! So on some releases of beta I’ll add to the release notes a information to delete the integration and add it again. No need to remove from HACS, just remove from Home Assistant and make the config again!

At the moment I have accounts and categories working. Feedbacks are more than welcome, also feature requests. But do it on the github issues of my repo, not here!

Please expect bugs, this is a very early Beta!

https://github.com/soloam/ha-fireflyiii-integration

[JC5]

Ah yes, I see.

In that case, please read: https://docs.firefly-iii.org/explanation/more-information/logo/

You have my permission to use the logo for the context of this integration, and I would suggest a name like "HA integration for Firefly III".

[soloam]

Thank you! Before I submit it to the store I'll show you for you approval!

[diamant-x]

Just my two cents here. FF3 has webhooks option (although i haven't read yet how it works) and Home Assistant supports automations triggered by webhooks calls.
That would allow for automations based on FF3 transactions.

But if you just mean sensors for balances and such then I guess an integration is needed yes (or manual sensor with the API and the REST integration).

Just couple ideas that may work with HA as-is. Haven't thought of any use case for FF3 in HA though. Maybe I can think of leveraging the HA rule engine (Which is veery strong) to handle complex scenarios in FF3 through the API.

[soloam]

The idea is to bring Accounts, Budgets, Invoices, Piggy Banks, and Categories into Home Assistant as sensors, then you can use in automations, also services to create and edit transactions, this would allow to do just what you say... use Home Assistant to process more complex scenarios. At the moment I do some complex logic with nodered, but with a integration like this, it would allow Home Assistant Users to do some automations to edit or notify.

[soloam]

@JC5 when I pull from the api of categories I can get the final value of that category (the spent + the earned). Whats the best way to get the same information to "No Category"? I'm using search to get all transactions without category, and doing the math! Is there a better way to get that?

Tks

[soloam]

The integration is ready to push to HACS (Home Assistant Integration Store), I'm just waiting for approval from Home Assistant. I added references to fireflyiii in the readme, but stated that the project was independent from the FireflyIII app.

I have to improve the readme with more information, but for now it's ok to publish:
https://github.com/soloam/ha-fireflyiii-integration

Thank you all that supported the tests in the beta.

[JC5]

Very cool! Thanks for building this! I will add it to the documentation for sure!

[soloam]

Tks @JC5 . It was only possible because of your excellent work with the app and api! Thank you for adding to your documentation, it will help people know that the integration is available!

Best regards