Matomo

Bar widget for Omarchy that shows live Matomo visitors and a visit sparkline. Click the pill for the overview, pick which sites to include, and switch Today / 7d / 30d.

Install

omarchy plugin add https://github.com/roymckenzie/omarchy-matomo.git --enable

Then open the panel (or press S) and enter your Matomo URL plus a view-only API token.

Configure

Connection details live in ~/.local/state/omarchy/settings/matomo.json (mode 600), not in shell.json. The settings form writes that file for you.

{
  "url": "https://analytics.example.com",
  "token": "",
  "siteIds": ["1"],
  "period": "today",
  "lastMinutes": 5,
  "showLiveCount": true
}

Create the token in Matomo under Administration → Personal → Security. Do not use a superuser token.

Setting	Meaning
showLiveCount	Bar shows the live number. Off uses a chart icon instead.
lastMinutes	Window used for “live now” (default 5).
period	today, 7d, or 30d.

Unique visitors are shown for Today only. Matomo does not report true uniques for custom ranges.

Usage

• Left click opens the panel
• Middle click refreshes
• Refresh and cog buttons are in the panel header
• 1 / 2 / 3 switch Today / 7d / 30d
• S opens settings, R refreshes

Live users refresh about every 30 seconds. Visit totals and the chart refresh when the panel opens and after site or period changes.

Remove

omarchy plugin remove io.github.roymckenzie.omarchy-matomo

License

MIT