SelfMediaHub

SelfMediaHub

Docker app from S3lfcod3r's Repository

Read-only analysis and overview layer for existing media libraries (Emby, Jellyfin, Plex).

Requirements

An existing Emby, Jellyfin or Plex server (or local media folders). Sources are added in the web UI under Settings.
Overview
Read-only analysis and overview layer for existing media libraries (Emby, Jellyfin, Plex). Not a media server - a smart view of what you already have. Reads movies and shows read-only into its own database and never writes back to the media server (optional exception: age ratings / FSK to Emby). Cover and configurable list view, filters by library, type and rating, completeness check, tags and rules, notifications. Sources are added in the web UI and stored encrypted. DE: Read-only Analyse- und Übersichtsschicht für bestehende Mediatheken (Emby, Jellyfin, Plex). Kein Medienserver - eine intelligente Sicht auf das, was du schon hast.
SelfMediaHub logo

Read-only analysis, monitoring & quality-control layer for your media library — never a media server, never writes back.
Nur lesende Analyse-, Monitoring- & Qualitätskontroll-Schicht für deine Mediathek — nie ein Medienserver, schreibt nie zurück.

Build Version License Backend Web Database Deploy Ko-fi

🇬🇧 English · 🇩🇪 Deutsch

📰 What's new / Neuigkeiten → CHANGELOG.md


🇬🇧 English

SelfMediaHub is a standalone analysis, monitoring and quality-control layer on top of the media library you already have — Emby, Jellyfin and Plex, enriched with TMDb and TheTVDB. It is deliberately not a media server and not a manager: it reads your libraries read-only through their APIs, stores everything in its own database, and never touches your originals. The goal: see at a glance what you have, what's missing, what can be improved, and what's new.

Part of the Self family (SelfMailer, SelfDashboard, SelfArchiver …) — same design system, same deploy style (GHCR → Unraid).

TL;DR — read-only layer over Emby/Jellyfin/Plex · cover + list views with rich filters · per-title detail with episodes, tracks & file paths · exact resolutions · FSK ratings you can set from the cover · own tag system + rule engine · background scans & webhook alerts · one container, own SQLite DB.

📑 Table of contents

Features · Views & interaction · Interface & account · Age ratings (FSK) · Tags & rules · Monitoring · Architecture · Quick start · Unraid · Configuration · API · Security · Tech stack · Development · Roadmap

✨ Features

📥 Sources — all read-only

  • Emby, Jellyfin and Plex via their APIs
  • Several sources at once — even several of the same type (e.g. two Emby servers); a broken source never stops the others
  • Own SQLite database under /data — fully independent from your media servers

🔎 Analysis & enrichment

  • Technical data: exact resolution, HDR / Dolby Vision, video codec, audio & subtitle tracks, file size, runtime
  • TMDb and TheTVDB enrichment: German age rating, genres, season/episode counts, series status
  • Completeness per season: present vs. released episodes, missing-episode detection, season badges on the cover
  • Episode order Aired / DVD / Absolute per series
  • Real resolutions — an 800p downscale shows 800p, not rounded to 720p; only true UHD is 4K

🖥️ Views & interaction

  • Cover view (poster grid) with rating, resolution and season badges + tag chips
  • List view with toggleable, sortable columns
  • Filters: search · library · type (movie/series) · rating (incl. no rating & FSK suspicious) · resolution (incl. under 720p and every real height) · codec · audio language · subtitles · tags · series status
  • Stat tiles: total · films · series · 4K/UHD · incomplete · without rating
  • Detail window (click a poster/title): resolution W × H, HDR, codec, size, runtime, audio & subtitle languages, genres, metadata and the file path
  • For series: the full episode list per season — every episode expandable with its own resolution, codec, size, languages, subtitles and path; missing episodes are highlighted

🌐 Interface & account

  • Bilingual interface (German / English) — pick the UI language under Settings → General; every screen, filter and message is fully translated
  • Optional single-account login — protect the instance with username + password; toggle it on/off under Settings → Account
  • Update check — shows when a newer GitHub release is available (Settings → About & updates)

🎫 Age ratings (FSK)

  • Set the rating right on the cover — click the FSK corner → a small popup → pick a value → saved to Emby instantly
  • Or from the detail window (dropdown + save), or on the Ratings page (list, editor, filters)
  • Suggestions from TMDb/TheTVDB (recommended German rating, international ratings translated)
  • Plausibility check flags implausible ratings (e.g. family genre but FSK 18); “It's fine” acknowledges deliberate ones so they stop being reported
  • Lock status & drift detection — shows which ratings are locked in Emby and reports when a rating was changed outside SelfMediaHub
  • Writing to Emby is the one exception to the read-only rule — enabled via ALLOW_EMBY_WRITE=1 (off by default). It powers parental control: set the rating here, and Emby's per-account max-rating does the blocking.

🏷️ Tags & rules

  • Own tag system — name, colour, icon, priority; assigned manually or automatically
  • Rule engine with AND / OR / NOT, multiple conditions & actions, priorities and on/off
  • Rule fields include resolution/height/width, codecs, languages, completeness, rating, genres and more

🔔 Monitoring & notifications

  • Background scan every N hours (SCAN_INTERVAL_HOURS)
  • Webhook notification (Discord / ntfy / Apprise) when new content appears

🧭 Architecture

app/
├── connectors/   emby · jellyfin · plex                                  (read-only)
├── services/     sync · tmdb · tvdb · analysis · completeness · seasons · episode_order
│                 fsk · ratings · rules · tags · scheduler · notify · sources · crypto · auth
├── routes/       pages (HTML) · api (JSON) · auth · health
├── i18n/         de · en
├── templates/    index · fsk · tags · rules · settings · login · setup · _topbar · _modal
├── static/       css/tokens · css/app · js/common · js/app · js/detail · js/fsk · js/settings
├── entrypoint.py drops root → PUID:PGID, then starts the app
└── db.py         SQLite (own data under /data)

🚀 Quick start (Docker)

docker run -d --name selfmediahub -p 8092:8092 \
  -v /path/to/data:/data \
  -e TMDB_API_KEY=YOUR_TMDB_KEY \
  ghcr.io/s3lfcod3r/selfmediahub:latest

# or with the included docker-compose.yml (set TMDB_API_KEY there):
docker compose up -d

Open http://<host>:8092/ → add your media source under Settings → Data sources & libraries (URL + API key, stored encrypted) → click Re-scan in the top right.

📦 Unraid

Template at templates/selfmediahub.xml in s3lfcod3r/unraid-templates (all my templates). Add via Docker → Add Container → Template, map /data to /mnt/user/appdata/selfmediahub, then add your sources in the UI.

⚠️ Permissions: the container starts as root only to hand /data over to PUID:PGID (default 99 / 100 = nobody:users), then the app runs non-root. An existing data folder owned by root is taken over automatically.

⚙️ Configuration

Media sources (Emby/Jellyfin/Plex) are configured in the UI under Settings → Data sources & libraries and stored encrypted in the database — not via environment variables.

Environment variables (no common prefix; security switches start with SMH_).

Variable Required Default Purpose
TMDB_API_KEY – – themoviedb.org v3 — ratings, genres, completeness. Empty = these features off.
TVDB_API_KEY – built-in key Overrides the TheTVDB project key embedded at CI build time (e.g. for tests)
SCAN_INTERVAL_HOURS – 0 Background scan every N hours (0 = off)
NOTIFY_WEBHOOK_URL – – JSON webhook for notifications (Discord / ntfy / Apprise). Empty = off.
ALLOW_EMBY_WRITE – 0 1 = write FSK ratings back to Emby (read-only by default)
PORT – 8092 Web port
DATA_DIR – /data DB location (./data for local development)
DB_PATH – $DATA_DIR/selfmediahub.db SQLite file
LOG_LEVEL – INFO DEBUG / INFO / WARNING / ERROR / CRITICAL
PUID / PGID – 99 / 100 User/group the app runs as
SMH_DISABLE_AUTH – 0 Emergency exit: 1 bypasses the login (e.g. forgotten password)
SMH_COOKIE_SECURE – 0 1 = always send the session cookie HTTPS-only
SMH_TRUSTED_PROXIES – – Comma-separated reverse-proxy IPs whose X-Forwarded-For is trusted
GITHUB_REPO – s3lfcod3r/selfmediahub Repository used for the update check

🔌 API overview

Base path /api, authentication via the session cookie of the web login (when login is enabled). Interactive docs: http://<host>:8092/docs.

Group Endpoints (excerpt)
Sync sync, sync/status
Items items/{id}/detail, items/{id}/order, items/{id}/tags, image/{id}
Sources sources (CRUD), sources/{id}/test, sources/{id}/libraries, providers
Tags & rules tags (CRUD), rules (CRUD), rules/apply
FSK fsk/write, fsk/write-bulk, fsk/ack, fsk/refresh-locks, fsk/accept-drift
Settings settings, account/*, update, update/check
Health health (open; details only with a valid session)

🛡️ Security

  • Read-only towards all media servers; the only write path (FSK → Emby) is off unless ALLOW_EMBY_WRITE=1
  • Source credentials Fernet-encrypted at rest; login password hashed with PBKDF2-HMAC-SHA256 (240,000 rounds)
  • Signed httpOnly / SameSite=Lax session cookie; Secure automatically behind HTTPS or forced via SMH_COOKIE_SECURE
  • Login throttling: 5 failed attempts per IP → locked for 15 minutes; proxy headers only trusted from SMH_TRUSTED_PROXIES
  • /api/health reveals nothing without a session; error messages are neutral (details go to the log)
  • Page data embedded as escaped JSON (no XSS via media titles or file paths)
  • App runs non-root; dependencies and GitHub Actions pinned to fixed versions
  • Deliberate trade-offs (documented): the encryption key lives in the same database as the encrypted data (no manual key handling); SMH_DISABLE_AUTH=1 switches the login off completely

Security update history → CHANGELOG.md (entries marked 🔒).

🧱 Tech stack

Part Tech
Backend Python 3.12 · FastAPI · Uvicorn · requests · cryptography
Web Jinja2 (server-rendered) · vanilla JS — no Node build step
Data SQLite (own data under /data) · TMDb · TheTVDB
Deploy Docker (drops to non-root) · GHCR · Unraid

🛠️ Development

pip install -r requirements.txt
cp .env.example .env         # fill in values, DATA_DIR=./data
python -m app.main

Tests: there is no automated test suite yet.

🗺️ Roadmap

  • Read-only import from Emby / Jellyfin / Plex into an own DB
  • Cover + list views, technical/quality analysis, TMDb + TheTVDB enrichment
  • Completeness per season, episode order Aired / DVD / Absolute
  • Tag system + rule engine, monitoring & notifications
  • FSK quality control (ported from emby-fsk-manager), lock status, drift detection
  • Source management in the UI: list + add/edit dialog, encrypted credentials, per-source library selection, multiple sources of the same type
  • Bilingual UI, optional login, update check
  • Movie-series / sequel tracking

⬆ back to top


🇩🇪 Deutsch

SelfMediaHub legt sich als eigenständige Analyse-, Monitoring- und Qualitätskontroll-Schicht über deine bestehende Mediathek — Emby, Jellyfin und Plex, angereichert mit TMDb und TheTVDB. Es ist ausdrücklich kein Medienserver und kein Manager: Es liest deine Bibliotheken nur lesend über deren APIs, speichert alles in einer eigenen Datenbank und fasst deine Originaldaten niemals an. Ziel: auf einen Blick sehen, was vorhanden ist, was fehlt, was verbessert werden kann und was neu dazugekommen ist.

Teil der Self-Familie (SelfMailer, SelfDashboard, SelfArchiver …) — gleiches Design-System, gleicher Deploy-Stil (GHCR → Unraid).

Kurz — nur lesende Schicht über Emby/Jellyfin/Plex · Cover- + Listenansicht mit vielen Filtern · Detail je Titel mit Episoden, Spuren & Pfaden · echte Auflösungen · FSK direkt am Cover setzbar · eigenes Tag-System + Regel-Engine · Hintergrund-Scans & Webhook-Meldungen · ein Container, eigene SQLite-DB.

📑 Inhaltsverzeichnis

Funktionen · Ansichten & Bedienung · Oberfläche & Konto · Freigaben (FSK) · Tags & Regeln · Monitoring · Architektur · Schnellstart · Unraid · Konfiguration · API · Sicherheit · Tech-Stack · Entwicklung · Roadmap

✨ Funktionen

📥 Quellen — alle nur lesend

  • Emby, Jellyfin und Plex über deren APIs
  • Mehrere Quellen gleichzeitig — auch mehrere desselben Typs (z. B. zwei Emby-Server); eine defekte Quelle stoppt die anderen nie
  • Eigene SQLite-Datenbank unter /data — komplett unabhängig vom Medienserver

🔎 Analyse & Anreicherung

  • Technik: exakte Auflösung, HDR / Dolby Vision, Video-Codec, Audio- & Untertitelspuren, Dateigröße, Laufzeit
  • Abgleich mit TMDb und TheTVDB: deutsche Freigabe, Genres, Staffel-/Episodenzahl, Serienstatus
  • Vollständigkeit je Staffel: vorhandene vs. veröffentlichte Episoden, Erkennung fehlender Folgen, Staffel-Badges am Cover
  • Episoden-Reihenfolge Ausstrahlung / DVD / Absolut je Serie
  • Echte Auflösungen — ein 800p-Downscale zeigt 800p statt gerundet 720p; nur echtes UHD ist 4K

🖥️ Ansichten & Bedienung

  • Coveransicht (Poster-Raster) mit Freigabe-, Auflösungs- und Staffel-Badges + Tag-Chips
  • Listenansicht mit zuschaltbaren, sortierbaren Spalten
  • Filter: Suche · Bibliothek · Typ (Film/Serie) · Freigabe (inkl. ohne Freigabe & FSK auffällig) · Auflösung (inkl. unter 720p und jede echte Höhe) · Codec · Audiosprache · Untertitel · Tags · Serien-Status
  • Statistik-Kacheln: Gesamt · Filme · Serien · 4K/UHD · unvollständig · ohne Freigabe
  • Detail-Fenster (Klick auf Poster/Titel): Auflösung B × H, HDR, Codec, Größe, Laufzeit, Audio- & Untertitelsprachen, Genres, Metadaten und der Pfad im Verzeichnis
  • Bei Serien: die komplette Episodenliste je Staffel — jede Folge aufklappbar mit eigener Auflösung, Codec, Größe, Sprachen, Untertiteln und Pfad; fehlende Folgen sind markiert

🌐 Oberfläche & Konto

  • Zweisprachige Oberfläche (Deutsch / Englisch) — UI-Sprache unter Einstellungen → Allgemein wählen; alle Ansichten, Filter und Meldungen sind vollständig übersetzt
  • Optionaler Ein-Konto-Login — Instanz mit Benutzername + Passwort schützen; unter Einstellungen → Konto an/aus
  • Update-Prüfung — zeigt an, wenn ein neueres GitHub-Release vorliegt (Einstellungen → Über & Updates)

🎫 Freigaben (FSK)

  • FSK direkt am Cover setzen — Klick auf die FSK-Ecke → kleines Popup → Wert wählen → sofort nach Emby gespeichert
  • Oder im Detail-Fenster (Dropdown + Speichern) oder auf der FSK-Seite (Liste, Editor, Filter)
  • Vorschläge aus TMDb/TheTVDB (empfohlene deutsche Freigabe, internationale Freigaben übersetzt)
  • Plausibilitätscheck markiert unplausible Freigaben (z. B. Familien-Genre, aber FSK 18); „Passt so“ bestätigt bewusste Freigaben, damit sie nicht mehr gemeldet werden
  • Sperr-Status & Drift-Erkennung — zeigt, welche Freigaben in Emby gesperrt sind, und meldet, wenn eine Freigabe außerhalb von SelfMediaHub geändert wurde
  • Das Schreiben nach Emby ist die einzige Ausnahme zur Nur-Lesen-Regel — aktivierbar über ALLOW_EMBY_WRITE=1 (Standard aus). Damit steuerst du die Kindersicherung: hier die Freigabe setzen, die Sperre übernimmt Embys maximale Freigabe je Konto.

🏷️ Tags & Regeln

  • Eigenes Tag-System — Name, Farbe, Icon, Priorität; manuell oder automatisch vergeben
  • Regel-Engine mit UND / ODER / NICHT, mehreren Bedingungen & Aktionen, Prioritäten und aktiv/inaktiv
  • Regel-Felder u. a. Auflösung/Höhe/Breite, Codecs, Sprachen, Vollständigkeit, Freigabe, Genres und mehr

🔔 Monitoring & Benachrichtigungen

  • Hintergrund-Scan alle N Stunden (SCAN_INTERVAL_HOURS)
  • Webhook-Benachrichtigung (Discord / ntfy / Apprise) bei neuen Inhalten

🧭 Architektur

app/
├── connectors/   emby · jellyfin · plex                                  (nur lesend)
├── services/     sync · tmdb · tvdb · analysis · completeness · seasons · episode_order
│                 fsk · ratings · rules · tags · scheduler · notify · sources · crypto · auth
├── routes/       pages (HTML) · api (JSON) · auth · health
├── i18n/         de · en
├── templates/    index · fsk · tags · rules · settings · login · setup · _topbar · _modal
├── static/       css/tokens · css/app · js/common · js/app · js/detail · js/fsk · js/settings
├── entrypoint.py gibt Root ab → PUID:PGID, startet dann die App
└── db.py         SQLite (eigene Daten unter /data)

🚀 Schnellstart (Docker)

docker run -d --name selfmediahub -p 8092:8092 \
  -v /pfad/zu/daten:/data \
  -e TMDB_API_KEY=DEIN_TMDB_KEY \
  ghcr.io/s3lfcod3r/selfmediahub:latest

# oder mit der mitgelieferten docker-compose.yml (TMDB_API_KEY dort eintragen):
docker compose up -d

http://<host>:8092/ öffnen → unter Einstellungen → Datenquellen & Bibliotheken deine Quelle anlegen (URL + API-Key, verschlüsselt gespeichert) → oben rechts „Neu einlesen“ klicken.

📦 Unraid

Vorlage unter templates/selfmediahub.xml in s3lfcod3r/unraid-templates (alle meine Vorlagen). Über Docker → Add Container → Template einbinden, /data auf /mnt/user/appdata/selfmediahub mappen und danach die Quellen in der Oberfläche anlegen.

⚠️ Rechte: der Container startet nur als root, um /data an PUID:PGID zu übergeben (Standard 99 / 100 = nobody:users); danach läuft die App ohne Root. Ein bestehender Datenordner, der root gehört, wird automatisch übernommen.

⚙️ Konfiguration

Datenquellen (Emby/Jellyfin/Plex) werden in der Oberfläche unter Einstellungen → Datenquellen & Bibliotheken angelegt und verschlüsselt in der Datenbank gespeichert — nicht über Umgebungsvariablen.

Umgebungsvariablen (kein gemeinsames Präfix; Sicherheits-Schalter beginnen mit SMH_).

Variable Pflicht Standard Zweck
TMDB_API_KEY – – themoviedb.org v3 — Freigaben, Genres, Vollständigkeit. Leer = diese Funktionen aus.
TVDB_API_KEY – eingebauter Key Überschreibt den beim CI-Build eingebetteten TheTVDB-Projekt-Key (z. B. für Tests)
SCAN_INTERVAL_HOURS – 0 Hintergrund-Scan alle N Stunden (0 = aus)
NOTIFY_WEBHOOK_URL – – JSON-Webhook für Benachrichtigungen (Discord / ntfy / Apprise). Leer = aus.
ALLOW_EMBY_WRITE – 0 1 = FSK-Freigaben nach Emby schreiben (Standard: nur lesend)
PORT – 8092 Web-Port
DATA_DIR – /data DB-Ablage (./data bei lokaler Entwicklung)
DB_PATH – $DATA_DIR/selfmediahub.db SQLite-Datei
LOG_LEVEL – INFO DEBUG / INFO / WARNING / ERROR / CRITICAL
PUID / PGID – 99 / 100 Nutzer/Gruppe, unter dem die App läuft
SMH_DISABLE_AUTH – 0 Notausgang: 1 schaltet den Login ab (z. B. Passwort vergessen)
SMH_COOKIE_SECURE – 0 1 = Sitzungs-Cookie immer nur über HTTPS senden
SMH_TRUSTED_PROXIES – – Kommagetrennte Reverse-Proxy-IPs, deren X-Forwarded-For geglaubt wird
GITHUB_REPO – s3lfcod3r/selfmediahub Repository für die Update-Prüfung

🔌 API-Übersicht

Basispfad /api, Anmeldung über das Sitzungs-Cookie des Web-Logins (wenn der Login aktiv ist). Interaktive Doku: http://<host>:8092/docs.

Bereich Endpunkte (Auszug)
Sync sync, sync/status
Titel items/{id}/detail, items/{id}/order, items/{id}/tags, image/{id}
Quellen sources (CRUD), sources/{id}/test, sources/{id}/libraries, providers
Tags & Regeln tags (CRUD), rules (CRUD), rules/apply
FSK fsk/write, fsk/write-bulk, fsk/ack, fsk/refresh-locks, fsk/accept-drift
Einstellungen settings, account/*, update, update/check
Health health (offen; Details nur mit gültiger Sitzung)

🛡️ Sicherheit

  • Nur lesend gegenüber allen Medienservern; der einzige Schreibweg (FSK → Emby) ist aus, solange ALLOW_EMBY_WRITE=1 nicht gesetzt ist
  • Zugangsdaten der Quellen Fernet-verschlüsselt gespeichert; Login-Passwort mit PBKDF2-HMAC-SHA256 gehasht (240.000 Runden)
  • Signiertes Sitzungs-Cookie mit httpOnly / SameSite=Lax; Secure automatisch hinter HTTPS oder erzwungen über SMH_COOKIE_SECURE
  • Anmelde-Bremse: 5 Fehlversuche je IP → 15 Minuten gesperrt; Proxy-Header werden nur von SMH_TRUSTED_PROXIES geglaubt
  • /api/health verrät ohne Sitzung nichts; Fehlermeldungen sind neutral (Einzelheiten stehen im Log)
  • Seitendaten als maskiertes JSON eingebettet (kein XSS über Medientitel oder Dateipfade)
  • App läuft ohne Root; Pakete und GitHub-Actions auf feste Versionen festgenagelt
  • Bewusste Kompromisse (dokumentiert): der Schlüssel liegt in derselben Datenbank wie die verschlüsselten Daten (kein manuelles Schlüssel-Handling); SMH_DISABLE_AUTH=1 schaltet den Login komplett ab

Verlauf der Sicherheitsupdates → CHANGELOG.md (Einträge mit 🔒).

🧱 Tech-Stack

Teil Technik
Backend Python 3.12 · FastAPI · Uvicorn · requests · cryptography
Web Jinja2 (serverseitig gerendert) · Vanilla-JS — kein Node-Build
Daten SQLite (eigene Daten unter /data) · TMDb · TheTVDB
Deploy Docker (gibt Root ab) · GHCR · Unraid

🛠️ Entwicklung

pip install -r requirements.txt
cp .env.example .env         # Werte eintragen, DATA_DIR=./data
python -m app.main

Tests: eine automatische Test-Suite gibt es noch nicht.

🗺️ Roadmap

  • Nur lesender Import aus Emby / Jellyfin / Plex in eine eigene DB
  • Cover- + Listenansicht, Technik-/Qualitätsanalyse, Abgleich mit TMDb + TheTVDB
  • Vollständigkeit je Staffel, Episoden-Reihenfolge Ausstrahlung / DVD / Absolut
  • Tag-System + Regel-Engine, Monitoring & Benachrichtigungen
  • FSK-Qualitätskontrolle (portiert aus emby-fsk-manager), Sperr-Status, Drift-Erkennung
  • Quellenverwaltung in der Oberfläche: Liste + Anlegen/Bearbeiten-Dialog, verschlüsselte Zugangsdaten, Bibliotheks-Auswahl je Quelle, mehrere Quellen desselben Typs
  • Zweisprachige Oberfläche, optionaler Login, Update-Prüfung
  • Filmreihen-/Sequel-Tracking

⬆ nach oben


☕ Support / Unterstützen

🇬🇧 This project is free for private use and built in my spare time. If it saves you time, a coffee keeps the next update coming. No pressure, a ⭐ on the repo helps too!

🇩🇪 Dieses Projekt ist für private Nutzung kostenlos und entsteht in meiner Freizeit. Wenn es dir Zeit spart, hält ein Kaffee das nächste Update am Laufen. Kein Muss, ein ⭐ auf dem Repo hilft auch!

Support me on Ko-fi


⚖️ Lizenz / License

🇩🇪 Alle Rechte vorbehalten. © 2026 s3lfcod3r / SelfCoder

Du darfst die Software privat und nicht-kommerziell installieren und benutzen (z. B. im Homelab, über Docker oder Unraid).

Ohne schriftliche Erlaubnis verboten: kommerzielle Nutzung · Kopieren · Verändern · Weitergeben · Einbauen in eigene Projekte (auch Closed Source) · Verkaufen.

Details: LICENSE

🇬🇧 All rights reserved. © 2026 s3lfcod3r / SelfCoder

You may install and use the software privately and non-commercially (e.g. in your home lab, via Docker or Unraid).

Not permitted without written permission: commercial use · copying · modifying · redistributing · incorporating into other projects (including closed source) · selling.

Details: LICENSE


SelfMediaHub · part of the Self family · Teil der Self-Familie
made with 🎬 for self-hosting

Categories

Related apps

Links

Details

Repository
ghcr.io/s3lfcod3r/selfmediahub:latest
Last Updated2026-11-16
First Seen2026-11-15

Runtime arguments

Web UI
http://[IP]:[PORT:8092]/
Network
bridge
Shell
sh
Privileged
false
Extra Params
--restart=unless-stopped

Template configuration

Data pathPathrw

Path where SelfMediaHub stores its own database.

Target
/data
Default
/mnt/user/appdata/selfmediahub
Value
/mnt/user/appdata/selfmediahub
WebUI PortPorttcp

Port for the SelfMediaHub web interface.

Target
8092
Default
8092
Value
8092
TMDb API Key (optional)Variable

Optional. themoviedb.org v3 API key. Needed for age-rating suggestions, genres and the completeness check. Empty = these features are off.

Target
TMDB_API_KEY
Scan interval (hours)Variable

Background scan every N hours (0 = off).

Target
SCAN_INTERVAL_HOURS
Default
0
Value
0
Notification webhook (optional)Variable

Optional. Generic JSON webhook (Discord / ntfy / Apprise). Empty = off.

Target
NOTIFY_WEBHOOK_URL
Trusted proxies (optional)Variable

Optional. IP(s) of your reverse proxy, comma-separated. Only then is its X-Forwarded-For header trusted for the login throttling. Leave empty without a proxy.

Target
SMH_TRUSTED_PROXIES
Cookie secureVariable

1 = always send the session cookie HTTPS-only. Default 0: detected automatically per request (HTTPS or X-Forwarded-Proto).

Target
SMH_COOKIE_SECURE
Default
0
Value
0
PUIDVariable

User ID the app runs as (Unraid default 99 = nobody). The container only starts as root to hand over the data folder.

Default
99
Value
99
PGIDVariable

Group ID the app runs as (Unraid default 100 = users).

Default
100
Value
100
Allow Emby write (FSK)Variable

1 = SelfMediaHub may write the age rating (FSK) back to Emby. Default 0 (read-only).

Target
ALLOW_EMBY_WRITE
Default
0
Value
0