Emby Wrapped - Jahresrückblick für die eigene Emby-Bibliothek

≈ 2 min
medien

Emby Wrapped - Jahresrückblick für die eigene Emby-Bibliothek

Emby Wrapped generiert einen personalisierten Jahresrückblick über die eigene Emby-Nutzung — ähnlich wie Spotify Wrapped, aber für den selbst gehosteten Medienserver.

Was ist Emby Wrapped?

Inspiriert vom populären Spotify-Wrapped-Format liest Emby Wrapped die Wiedergabehistorie aus der Emby-API aus und erstellt daraus eine visuell aufbereitete Statistik: meistgesehene Filme, häufigste Genres, aktivste Nutzer und Gesamtwiedergabezeit des Jahres. Das Tool richtet sich an alle, die ihren Medienkonsum einmal im Jahr auswerten und als anschaulichen Bericht präsentieren möchten. Da es direkt gegen die lokale Emby-API kommuniziert, verlassen keine Nutzungsdaten den eigenen Server.

Voraussetzungen

  • Docker 20.10+ / Docker Compose
  • Laufender Emby-Server mit aktivierter API
  • Emby API-Schlüssel (unter Dashboard → Erweitert → API-Schlüssel)

Compose-Beispiel

services:
  emby-wrapped:
    image: ghcr.io/johnpc/emby-wrapped:latest
    container_name: emby-wrapped
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - EMBY_SERVER_URL=http://emby:8096
      - EMBY_API_KEY=dein_api_schluessel_hier
      - YEAR=2023

Hinweise

  • API-Schlüssel sicher aufbewahren: Den Schlüssel nicht im Compose-File committen — stattdessen eine .env-Datei verwenden und diese in .gitignore eintragen.
  • Netzwerk beachten: Läuft Emby im selben Docker-Netzwerk, kann EMBY_SERVER_URL den Container-Namen als Hostname verwenden; andernfalls die Host-IP oder den externen Hostnamen angeben.
  • Jahresauswahl: Über die YEAR-Variable lässt sich der Rückblick auf ein beliebiges zurückliegendes Jahr einstellen.
  • Einmaliger Einsatz: Das Tool muss nicht dauerhaft laufen — nach der Auswertung kann der Container mit docker compose down gestoppt werden.