Obzorarr

Year in Review for Plex Media Server

---

What is Obzorarr?

Obzorarr is a "Wrapped for Plex" application that syncs viewing history from your Plex Media Server and generates yearly statistics with an animated slideshow presentation - similar to Spotify Wrapped. It doesn't require Tautulli; it only relies on the Plex API.

Features

• Yearly Statistics — Total watch time, top movies, shows, and genres
• Animated Slideshow — Beautiful, interactive presentation of your viewing habits
• Watch Patterns — Monthly and hourly distribution charts
• Percentile Rankings — See how you compare to other users on your server
• Plex OAuth — Secure authentication with your Plex account
• Automatic Sync — Scheduled background sync of viewing history
• AI Fun Facts — Optional AI-generated personalized insights

Issues & Support

Found a bug or have a feature request? Please submit issues and feature requests to the obzorarr-docker repository rather than this repository. This ensures your report reaches the maintainers monitoring issue tracking across the project.

Screenshots

Admin Dashboard

Dashboard	Settings	Sync Management

Wrapped Presentation

Total Time	Top Movies

Top Shows	Genres

Percentile Ranking	Fun Facts

Summary	Share

Tech Stack

Component	Technology
Runtime	Bun
Framework	SvelteKit + Svelte 5
Database	SQLite (Drizzle ORM)
Styling	UnoCSS + shadcn-svelte
Animation	GSAP + Motion

Quick Start

Docker (Recommended) — Image Repo

services:
  obzorarr:
    container_name: obzorarr
    image: ghcr.io/engels74/obzorarr-docker
    ports:
      - 3000:3000
    environment:
      - PUID=1000
      - PGID=1000
      - UMASK=002
      - TZ=Etc/UTC
      - PLEX_SERVER_URL=http://plex-url-here:32400
      - PLEX_TOKEN=your-plex-token-here
    volumes:
      - /<host_folder_config>:/config

Replace /<host_folder_config> with your desired config path. Access the web UI at http://localhost:3000 to complete setup.

From Source

git clone https://github.com/engels74/obzorarr.git
cd obzorarr
cp .env.example .env
bun install
bun run dev

License

This project is licensed under the GNU Affero General Public License v3.0.