Skip to content
Revisor01Public

About

Native iOS app for Umami and Plausible Analytics

Resources

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

StatFlow

StatFlow

Die iPhone-App für Umami und Plausible —
die Zahlen der eigenen Websites, ohne Umweg über den Browser.

Deutsch · English

Plattform Version im App Store Swift Lizenz

Worum es geht

Umami und Plausible zählen Besuche, ohne ihre Besucher:innen zu verfolgen. Beide haben ein Dashboard im Browser — auf dem Handy ist das mühsam.

StatFlow holt dieselben Zahlen auf den Sperrbildschirm: Wie läuft die Website heute, woher kommen die Leute, was lesen sie. Mehrere Konten und beide Anbieter nebeneinander, in einer App. Die Zugangsdaten bleiben im Schlüsselbund des Geräts, die Daten auf dem eigenen Server — es gibt keinen Dienst dazwischen.

Funktionen

  • Übersicht — Besuche, Aufrufe, Absprungrate und Verweildauer, auch in Echtzeit
  • Auswertungen — Seiten, Verweise, Länder, Geräte, Browser und eigene Ereignisse
  • Vergleiche — beliebige Zeiträume gegeneinander, Woche gegen Woche, Jahr gegen Jahr
  • Vermerke — Notizen im Verlauf („Newsletter verschickt", „Relaunch"), die im Nachhinein erklären, warum die Zahlen ausschlagen
  • Widgets — die wichtigsten Zahlen auf dem Home-Bildschirm
  • Mitteilungen — Zusammenfassung täglich oder wöchentlich
  • Ohne Netz — zuletzt geladene Zahlen bleiben lesbar
  • Mehrere Konten — verschiedene Anbieter und Instanzen nebeneinander
  • Deutsch und Englisch, Hell und Dunkel

Installation

Im App Store laden »

Im App Store heißt die App StatsFlow — StatFlow war dort schon vergeben. Im Quelltext heißt sie StatFlow, das Xcode-Ziel InsightFlow.

Zum Loslegen braucht es ein Konto bei Umami oder Plausible: in der App die Adresse des Servers und die Zugangsdaten eintragen, Websites auswählen, fertig.

Welche Server passen

Anbieter Nötig Zuletzt geprüft gegen
Umami ab 3.0, selbst betrieben oder Cloud 3.3.0, 3.4.0 und 3.4.1
Plausible ab CE 2.1 oder Cloud CE 3.2.1

Umami 2.x antwortet in einem anderen Format und wird nicht unterstützt. Einige Auswertungen setzen neuere Stände voraus — Vermerke und die Anmeldung per API-Schlüssel etwa Umami 3.4. Die App erkennt selbst, was ein Server kann, und blendet den Rest aus.

Was bei welchem Anbieter geht und woran es liegt, steht in docs/kompatibilitaet.md.

Bildschirmfotos

Übersicht Website
Übersicht Website
Echtzeit Widgets und Mitteilungen
Echtzeit Widgets und Mitteilungen

Versionen

Was sich wann geändert hat, steht in CHANGELOG.md — nach Keep a Changelog, aus Sicht der Nutzer:innen geschrieben. Die Releases fassen jede Version zusammen.

Selbst bauen

git clone https://github.com/Revisor01/StatFlow.git
cd StatFlow
open InsightFlow.xcodeproj

Xcode 26 oder neuer, Ziel ist iOS 18. In den Signierungs-Einstellungen das eigene Team eintragen, dann auf Gerät oder Simulator starten. Die App kommt ohne fremde Bibliotheken aus, es gibt nichts nachzuladen.

Aufbau

StatFlow
├── InsightFlow/
│   ├── Views/          — SwiftUI nach Bereich: Dashboard, Detail,
│   │                     Reports, Events, Realtime, Settings …
│   │                     das ViewModel liegt jeweils daneben
│   ├── Services/       — UmamiAPI und PlausibleAPI als Actors,
│   │                     Konten, Schlüsselbund, Zwischenspeicher
│   └── Models/         — Antworten der APIs, anbieterunabhängig
├── InsightFlowWidget/  — Home-Bildschirm-Widgets
├── InsightFlowTests/   — 126 Tests, laufen bei jedem Pull Request
└── docs/

Worauf es beim Bauen ankommt:

  • Ein Protokoll für beide Anbieter. AnalyticsProvider verdeckt die Unterschiede zwischen Umami und Plausible; die ViewModels wissen nicht, womit sie gerade reden.
  • Zugangsdaten gehören in den Schlüsselbund, je Konto getrennt — nie in die Einstellungen.
  • Keine fremden Bibliotheken. Nur was Apple mitliefert.
  • Ältere Server dürfen nicht brechen. Neue Auswertungen werden geprüft und bei Bedarf ausgeblendet, statt einen Fehler zu zeigen.

Mitmachen

Fehlermeldungen und Vorschläge sind willkommen — gern als Issue; die Vorlage fragt nach App- und Server-Version. Sicherheitslücken bitte vertraulich melden, wie in SECURITY.md beschrieben. Pull Requests laufen durch Tests und einen Secret-Scan; siehe CONTRIBUTING.md.

Datenschutz

StatFlow sammelt nichts. Keine Analyse, keine Werbung, keine fremden Bausteine, kein Server dazwischen. Die App spricht ausschließlich mit den Instanzen, die man selbst einträgt; Zugangsdaten liegen im Schlüsselbund des Geräts und verschwinden mit der App.

Die vollständige Erklärung steht unter simonluthe.de/apps/statsflow/datenschutz.

Lizenz

StatFlow steht unter der GNU Affero General Public License v3.0. Wer StatFlow verändert und anderen zur Verfügung stellt, auch als Webdienst, legt seinen Quelltext unter derselben Lizenz offen. Für Beiträge gilt CONTRIBUTING.md.

Die Fassungen im App Store verteilt der Urheber als Rechteinhaber selbst.

Hinweis

StatFlow ist eine unabhängige App. Sie ist kein offizielles Produkt von Umami Software, Inc. oder Plausible Insights OÜ und wird von keinem der beiden Unternehmen unterstützt oder geprüft.

Dank an Umami und Plausible dafür, dass es datenschutzfreundliche Analytik überhaupt gibt.

Kontakt

Pastor Simon Luthe · mail@simonluthe.de · simonluthe.de

About

Native iOS app for Umami and Plausible Analytics

Resources

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages