{"id":13522070,"url":"https://github.com/CyferShepard/Jellystat","last_synced_at":"2025-03-31T22:30:36.623Z","repository":{"id":151560932,"uuid":"611092287","full_name":"CyferShepard/Jellystat","owner":"CyferShepard","description":"Jellystat is a free and open source Statistics App for Jellyfin","archived":false,"fork":false,"pushed_at":"2024-05-19T08:25:11.000Z","size":13006,"stargazers_count":810,"open_issues_count":58,"forks_count":28,"subscribers_count":12,"default_branch":"main","last_synced_at":"2024-05-19T14:59:00.669Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CyferShepard.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"ko_fi":"cyfershepard"}},"created_at":"2023-03-08T04:50:05.000Z","updated_at":"2024-05-21T07:52:39.381Z","dependencies_parsed_at":"2024-02-07T20:29:50.699Z","dependency_job_id":"51bb7dad-613e-4bd9-91cf-fac4ebee8bc5","html_url":"https://github.com/CyferShepard/Jellystat","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CyferShepard%2FJellystat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CyferShepard%2FJellystat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CyferShepard%2FJellystat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CyferShepard%2FJellystat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CyferShepard","download_url":"https://codeload.github.com/CyferShepard/Jellystat/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246552045,"owners_count":20795756,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T06:00:41.866Z","updated_at":"2025-03-31T22:30:31.615Z","avatar_url":"https://github.com/CyferShepard.png","language":"JavaScript","funding_links":["https://ko-fi.com/cyfershepard"],"categories":["JavaScript","👾 Companion Apps \u0026 Tools"],"sub_categories":["📊 Statistics \u0026 Watch History"],"readme":"\u003cp align=\"center\"\u003e\n\n**Jellystat** is a free and open source Statistics App for Jellyfin! (This project is still in development - expect some weirdness)\n\n## Current Features\n\n- Session Monitoring and logging\n- Statistics for all Libraries and Users\n- Watch History\n- User Overview and activity\n- Watch statisitcs\n- Backup and restore Data\n- Auto sync library items\n- Jellyfin Statistics Plugin Integration\n\n## Required Development\n\n- Responsive UI\n- Code Optimizations\n- Security Testing\n- More Validations and Error Handling\n- Multi-Server support\n- More to come\n\n## Environmental Variables\n\n| Env                             | Default  | Example                         | Description                                                                                                                              |\n| ------------------------------- | -------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |\n| POSTGRES_USER `REQUIRED`        | `null`   | `postgres`                      | Username that will be used in postgres database                                                                                          |\n| POSTGRES_PASSWORD `REQUIRED`    | `null`   | `postgres`                      | Password that will be used in postgres database                                                                                          |\n| POSTGRES_IP `REQUIRED`          | `null`   | `jellystat-db` or `192.168.0.5` | Hostname/IP of postgres instance                                                                                                         |\n| POSTGRES_PORT `REQUIRED`        | `null`   | `5432`                          | Port Postgres is running on                                                                                                              |\n| JWT_SECRET `REQUIRED`           | `null`   | `my-secret-jwt-key`             | JWT Key to be used to encrypt JWT tokens for authentication                                                                              |\n| JS_BASE_URL                     | `/`      | `/`                             | Base url                                                                                                                                 |\n| JS_USER                         | `null`   | `User`                          | Master Override User in case username or password used during setup is forgotten (Both `JS_USER` and `JS_PASSWORD` required to work)     |\n| JS_PASSWORD                     | `null`   | `Password`                      | Master Override Password in case username or password used during setup is forgotten (Both `JS_USER` and `JS_PASSWORD` required to work) |\n| POSTGRES_DB                     | `jfstat` | `jfstat`                        | Name of postgres database                                                                                                                |\n| REJECT_SELF_SIGNED_CERTIFICATES | `true`   | `false`                         | Allow or deny self signed SSL certificates                                                                                               |\n| JS_GEOLITE_ACCOUNT_ID           | `null`   | `123456`                        | maxmind.com user id to be used for Geolocating IP Addresses (Can be found at https://www.maxmind.com/en/accounts/current/edit)           |\n| JS_GEOLITE_LICENSE_KEY          | `null`   | `ASDWdaSdawe2sd186`             | License key you need to generate on maxmind to use their services                                                                        |\n\n## Getting Started with Development\n\n- Clone the project from git\n- set your env variables before strating the server (Variable names as per Environmental Variables above).\n- Run `npm install` to install necessary packages\n- Run `npm run start-server` to only run the backend nodejs server\n- Run `npm run start-client` to only run the frontend React UI\n- Run `npm run start-app` to run both backend and frontend at the same time\n\nWhen contributing please ensure to log a pull request on the `unstable` branch\n\n### Launching Jellystat using Docker\n\nCheck out our dockerhub to run Jellystat:\nhttps://hub.docker.com/r/cyfershepard/jellystat\n\n### Environment variables from files (Docker secrets)\n\nYou can set any environment variable from a file by using the prefix `FILE__`\n\nAs an example:\n\n```yaml\njellystat:\n  environment:\n    FILE__MYVAR: /run/secrets/MYSECRETFILE\n```\n\nWill set the environment variable `MYVAR` based on the contents of the `/run/secrets/MYSECRETFILE` file. see [docker secrets](https://docs.docker.com/compose/use-secrets/) for more info.\n\n## Screenshots\n\n\u003cimg src=\"./screenshots/Home.PNG\"\u003e\n\u003cimg src=\"./screenshots/Users.PNG\"\u003e\n\u003cimg src=\"./screenshots/Activity.PNG\"\u003e\n\u003cimg src=\"./screenshots/Libraries.PNG\"\u003e\n\u003cimg src=\"./screenshots/settings.PNG\"\u003e\n\n## Support\n\n- Bug reports and feature requests can be submitted via [GitHub Issues](https://github.com/CyferShepard/Jellystat/issues).\n- Join us in our [Discord](https://discord.gg/9SMBj2RyEe)\n\n## API Documentation\n\nTo-do\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCyferShepard%2FJellystat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCyferShepard%2FJellystat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCyferShepard%2FJellystat/lists"}