Repolode
Submit
CyferShepard

CyferShepard/Jellystat

A free, open source statistics app for Jellyfin that tracks sessions, watch history, and per-user and per-library activity.

View on GitHub
Stars
2,502
Forks
102
Open issues
187
Last commit
28 days ago

What is it?

Jellystat is a statistics dashboard for Jellyfin media servers. It records playback sessions and watch history, then presents statistics for each library and user, including an overview of user activity and viewing patterns.

The app runs as a Node.js backend with a React frontend and stores its data in a PostgreSQL database. It also includes backup and restore of its data, automatic syncing of library items, and an integration with the Jellyfin Statistics plugin. Setup is configured through environment variables, and it can be deployed with Docker.

The project notes that it is still in development and that the author plans a ground-up rebuild, so updates are currently limited to fixes for major bugs. Emby is supported through an environment variable setting.

Key features

  • 01Session monitoring and logging for playback activity
  • 02Statistics for all libraries and users
  • 03Watch history and per-user activity overview
  • 04Backup and restore of stored data
  • 05Automatic library item sync and Jellyfin Statistics plugin integration

Use cases

  • Tracking what each user watches on a home or shared Jellyfin server
  • Reviewing which libraries get the most playback activity
  • Keeping a backup of playback statistics stored in PostgreSQL

Quick start

  1. 1

    Set the required environment variables, including the Postgres settings

  2. 2

    Install the packages

    npm install
  3. 3

    Build the local files

    npm run build
  4. 4

    Run the backend and frontend together

    npm run start-app

Things to know

  • The project is still in development and may behave unexpectedly.
  • The author has announced a rebuild, so the project is not being actively updated for now.
  • It requires a PostgreSQL database and several required environment variables.

In collections

Self-hosted appsDatabases & SQL toolsData science courses & tools

Topics

#jellyfin#media-server#statistics#nodejs#react#postgresql#self-hosted#docker

FAQ

What is Jellystat?
A free, open source statistics app for Jellyfin that tracks sessions, watch history, and per-user and per-library activity. Jellystat is a statistics dashboard for Jellyfin media servers. It records playback sessions and watch history, then presents statistics for each library and user, including an overview of user activity and viewing patterns.
Is Jellystat free to use? What license does it have?
Jellystat is open source under the MIT license. Check the license terms before using it in commercial products.
Is Jellystat still maintained?
Actively maintained. The last commit to Jellystat was on Sep 26, 2026.
What can I use Jellystat for?
Tracking what each user watches on a home or shared Jellyfin server Reviewing which libraries get the most playback activity Keeping a backup of playback statistics stored in PostgreSQL
How do I install Jellystat?
Set the required environment variables, including the Postgres settings Install the packages: npm install Build the local files: npm run build Run the backend and frontend together: npm run start-app
Where can I get Jellystat?
The source code and installation instructions are on GitHub: https://github.com/CyferShepard/Jellystat

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects