Connect Jellystat
Add Jellystat to Kochab to read Jellyfin watch history and library play totals from your phone.
Jellystat records playback for a Jellyfin server. Kochab reads that record; it does not change Jellyfin settings through Jellystat.
What Kochab exposes through Jellystat
- Library totals: play count and total playback duration, summed across your libraries
- Item history: the watch history for a single title, shown on that title’s screen
- Overview: top users, top watched titles, per-library plays, and the playback-method split
- Analytics charts: plays over time, by hour, by day of week, top platforms, and the transcode split
Not exposed through Jellystat
- Per-user history (Jellystat is queried per item, not per user)
- Plays-per-month, stream-types-by-user, and peak-concurrency charts
- Editing Jellystat’s own settings, or administering Jellyfin users and libraries
- Anything about a Plex or Emby server. Jellystat only knows Jellyfin
Before you start
Jellystat authenticates differently from most services: you sign in with the Jellystat administrator account, and Kochab then obtains an API key for you. Have the admin username and password to hand.
Kochab stores the resulting key in the device’s secure storage.
Default connection
| Field | Typical value |
|---|---|
| Port | 3000 |
| Scheme | http by default, https if you have set it up |
| Auth | Administrator sign-in, then an API key |
Port 3000 is also a common default for other tools. Make sure the URL you enter really is Jellystat.
Add in Kochab
- Open More > Stacks & Services > + > Add service and choose Jellystat.
- Enter the host or IP, set Port to 3000 (or your configured port), and set Use HTTPS to match the address.
- Sign in with your Jellystat administrator account.
- Tap Test & Add. Kochab completes the API key step for you.
TLS
Self-signed certificates use the same trust flow as other services. See Certificate trust.
Tips
- Add Jellyfin as well. Jellystat supplies the statistics; Jellyfin supplies the library, playback, and artwork.
- Jellystat only reports what it has recorded, so a fresh install shows very little until it has watched Jellyfin for a while.