Matomo Analytics - custom integration for Home Assistant

Share your Projects!
1

Hi,

I’ve been running Matomo (self-hosted web analytics) for a while and wanted to have the stats visible in my HA dashboard. Couldn’t find any existing integration beyond basic REST sensors, so I wrote a proper one with config flow and decided to share it.

What it does:

  • Tracks unique visitors, page views, visits, and actions for today, this week, and this month
  • Shows live visitor count (last 30 minutes)
  • Optional aggregate stats across all Matomo sites
  • Supports multiple sites (one config entry per site)
  • Config flow UI, no YAML needed
  • English and Polish translations

It connects to the Matomo Reporting API using POST for token authentication (compatible with Matomo 4.x+).

Right now it’s available as a custom HACS repository. Official HACS default submission is pending.

Repo: GitHub - abnvle/ha-matomo: Integration to display matomo statistics in home assistant

Installation:

  1. HACS > Custom repositories > add the repo URL as Integration
  2. Install Matomo Analytics
  3. Restart HA
  4. Settings > Devices & Services > Add Integration > Matomo Analytics
  5. Enter your Matomo URL and API token, select the site

Any feedback or issues welcome - feel free to open them on GitHub.

Thanks!

1 Like
2

Hi

Thanks a lot for that as I was using the REST sensors but your integration gives a lot more access.
Going to try it and can translate it in french too if you want :wink: File ready for french translation, wanted to submit a PR on your repo but declined by github :frowning: Did you block it ?

Vincèn

1 Like
3

Hi Vincen,

Thanks for the french translation, that’s great! Nothing is blocked on my side - the repo is public and PRs should work fine.

Could you share the exact error message you’re getting? Also, make sure you’re doing it through a fork:

  1. Fork the repo (button in the top right)
  2. Add your fr.json file in your fork under custom_components/matomo/translations/
  3. Open a Pull Request from your fork to my repo

Let me know if you still run into issues.

4

Looks like it was a temporary glitch on github as now it works, I think I have done it properly but please check if you got the PR with the extra file and let me know if there is any issues :wink:

Thanks

5

Yes, your PR looked good — I’ve already merged it. French translation is now included in release v1.0.1.

Thanks for the contribution! :slight_smile:

1 Like
6

Hello :slight_smile:
If anyone would like to add a translation of this integration to another language- feel free to do so.

I would really appreciate any help in making the project more accessible to users from different countries. If you’d like to contribute a new translation, you can:

  • create the appropriate language file,
  • open a pull request,
  • or simply write here — I’ll be happy to help and guide you through the process.

Any contribution is very welcome :slight_smile:

Thank you!