Plex: működés, hibakeresés, fejlesztés – egy helyen

Transzkódolási módok összehasonlítása

Plex API alapok

A szerver alap URL-je: http://SERVER_IP:32400. Minden híváshoz szükséges a X-Plex-Token fejléc (vagy query paraméter). A válasz XML vagy JSON (az Accept: application/json fejléccel).

import requests

BASE = "http://192.168.1.10:32400"
TOKEN = "YOUR_PLEX_TOKEN"
headers = {"X-Plex-Token": TOKEN, "Accept": "application/json"}

# Könyvtárak
r = requests.get(f"{BASE}/library/sections", headers=headers)
sections = r.json()["MediaContainer"]["Directory"]
for s in sections:
    print(s["key"], s["title"], s["type"])

# Egy könyvtár összes eleme
r = requests.get(f"{BASE}/library/sections/1/all", headers=headers, params={"X-Plex-Container-Start": 0, "X-Plex-Container-Size": 50})
items = r.json()["MediaContainer"].get("Metadata", [])
for m in items:
    print(m.get("title"), m.get("year"))

const BASE = "http://192.168.1.10:32400";
const TOKEN = "YOUR_PLEX_TOKEN";

async function plex(path) {
  const r = await fetch(`${BASE}${path}`, {
    headers: { "X-Plex-Token": TOKEN, "Accept": "application/json" }
  });
  return r.json();
}

const sections = await plex("/library/sections");
console.log(sections.MediaContainer.Directory.map(s => s.title));

const items = await plex("/library/sections/1/all?X-Plex-Container-Size=50");
console.log(items.MediaContainer.Metadata?.map(m => m.title));

$base = "http://192.168.1.10:32400"
$token = "YOUR_PLEX_TOKEN"
$h = @{ "X-Plex-Token" = $token; "Accept" = "application/json" }

# Könyvtárak
$sections = Invoke-RestMethod -Uri "$base/library/sections" -Headers $h
$sections.MediaContainer.Directory | Select-Object key, title, type

# Aktív munkamenetek
$sessions = Invoke-RestMethod -Uri "$base/status/sessions" -Headers $h
$sessions.MediaContainer.Metadata | Select-Object title, User, Player

Webhookok

A PMS webhook eseményeket küld HTTP POST-tal egy megadott URL-re. Az események: media.play, media.stop, media.pause, media.resume, media.scrobble, library.new, admin.started stb. A payload JSON, tartalmazza a felhasználót, az elemet és a munkamenetet.

{
  "event": "media.play",
  "user": true,
  "owner": true,
  "Account": { "id": 1, "title": "user" },
  "Server": { "title": "MyPlex", "uuid": "..." },
  "Player": { "title": "Plex Web", "uuid": "..." },
  "Metadata": { "type": "movie", "title": "Film címe", "year": 2020 }
}

Beállítás: Settings → Webhooks → „Add Webhook”. Használható saját endpoint, Tautulli, n8n, Home Assistant stb.

Ajánlott kiegészítők

Saját script ötletek

• Automatikus könyvtár-szkennelés ütemezve (cron).
• Hiányzó metaadatok jelentése e-mailben.
• Korhatár-besorolás szinkronizálása (lásd: plex-rating-sync projekt).
• Duplikátumok keresése és jelentése.
• Backup: DB + config mentése naponta.
• Webhook → Telegram/Discord értesítés új tartalomról.

Fejlesztési tippek

• Használj a Accept: application/json fejlécet a könnyebb feldolgozáshoz.
• Token tárolása: környezeti változó, soha ne commitold.
• Pagináció: X-Plex-Container-Start és X-Plex-Container-Size.
• Rate limit: a PMS nem korlátoz, de a külső API-k (TMDb) igen.
• Debug: curl -v vagy Postman/Insomnia.
• Verziózás: a /identity endpoint adja a szerver verzióját.