Magyar · English
Saját gépen futó médiaszerver filmekhez és sorozatokhoz – a Jellyfin és a Plex alternatívája, magyar, angol és német webes felülettel. A neve az 1890-es évek kézi „mozgókép-nézegetőjéből” jön.
Egyetlen Go bináris, beágyazott webes klienssel; SQLite adatbázis; az ffmpeg végzi az átkódolást. Az elsődleges telepítési mód a Docker.
# docker-compose.yml
services:
kinora:
image: ghcr.io/scotylucas/kinora:latest
container_name: kinora
ports: ["8096:8096"]
environment:
- TZ=Europe/Budapest
- PUID=1000
- PGID=1000
volumes:
- ./config:/config
- ./cache:/cache
- /path/to/movies:/media/movies:ro
- /path/to/shows:/media/shows:ro
# Intel/AMD hardveres gyorsítás:
# devices: ["/dev/dri:/dev/dri"]
# group_add: ["video", "render"]
restart: unless-stoppeddocker compose up -dEzután nyisd meg: http://<szerver-ip>:8096. Az első indításkor egy varázsló kéri a szerver nevét és az admin fiókot,
majd az Admin → Könyvtárak oldalon add hozzá a /media/movies és /media/shows mappát (a mappaválasztó eleve a /media mappában nyílik meg).
| Mappa a konténerben | Mire való | Mentsd? |
|---|---|---|
/config |
adatbázis (kinora.db), poszterek és képek |
igen |
/cache |
átkódolt szegmensek, letöltések, feliratcache | nem kell |
/media/... |
a filmjeid, csak olvasható (:ro) – a Kinora soha nem ír ide |
– |
Minden beállítás megadható környezeti változóval is. Ilyenkor az admin felületen a mező zárolva van („környezeti változóból beállítva”).
| Változó | Alapérték | Leírás |
|---|---|---|
KINORA_ADDR |
:8096 |
figyelt cím |
KINORA_DATA |
/config (natívan ./data) |
adatbázis, képek |
KINORA_CACHE |
/cache (natívan <data>/cache) |
átkódolás, letöltések |
KINORA_PUBLIC_URL |
– | nyilvános cím (meghívó linkekhez, QR-kódokhoz) |
KINORA_TMDB_KEY |
– | TMDB API kulcs (v3 kulcs vagy v4 token) |
KINORA_TMDB_API |
https://api.themoviedb.org/3 |
TMDB API-cím (proxy vagy tükör esetén) |
KINORA_METADATA_LANG |
hu-HU |
alapértelmezett metaadat-nyelv (a kliensek a saját felületi nyelvükön kapják a címeket, ha az eltér) |
KINORA_WATCH_REGION |
a metaadat-nyelv országa | a Felfedezés streaming-kínálatának országa (kétbetűs kód, pl. HU) |
KINORA_ENCODER |
auto |
auto, h264_nvenc, h264_qsv, h264_vaapi, libx264 … |
KINORA_VIDEO_CODEC |
auto |
auto: HEVC/AV1 kimenet, ha a kliens jelzi és a hardveres encoder működik; h264: csak H.264 |
KINORA_VAAPI_DEVICE |
/dev/dri/renderD128 |
VA-API eszköz |
KINORA_SCAN_INTERVAL_MIN |
15 |
periodikus szkennelés (perc, 0 = ki) |
KINORA_SERVER_NAME |
Kinora |
szerver neve |
KINORA_LOG_FORMAT |
szöveg | json esetén JSON naplózás (a docker logs mindkettőt mutatja) |
KINORA_LOG_LEVEL |
info |
debug |
KINORA_FFMPEG, KINORA_FFPROBE |
ffmpeg, ffprobe |
saját ffmpeg útvonala |
KINORA_QUICKCONNECT |
1 |
belépés 6 jegyű kóddal TV-ről/telefonról (0 = ki) |
KINORA_DISCOVERY |
1 |
szerverkeresés a helyi hálózaton (0 = ki) |
KINORA_DISCOVERY_PORT |
7359 |
a felderítés UDP-portja (0 = a figyelés sem indul el) |
KINORA_CORS_ORIGINS |
– | további app-originek tokenes CORS-hoz, vesszővel elválasztva |
KINORA_ACCENT |
– | akcentszín (#rrggbb), az appok is használják |
KINORA_LOGO |
– | logófájl (pl. /config/logo.png); induláskor átveszi, ha változott (PNG/JPG/WebP/SVG, max. 2 MB) |
KINORA_INITIAL_SERVER_NAME, KINORA_INITIAL_LOGO, KINORA_INITIAL_MEDIA |
– | csak az első induláskor: szervernév, logó, kezdő médiamappák (Név=/út;/út2); utána az adminfelületen módosíthatók – ezeket a telepítők állítják be |
KINORA_INTRO_DETECTION, KINORA_INTRO_WINDOW_MIN |
1, 10 |
intró-/stáblista-felismerés be/ki, és hány percben keresse az intrót |
TZ, PUID, PGID |
UTC, 1000, 1000 |
időzóna, a fájlok tulajdonosa |
| Tag | Mit tud | Méret (tömörítve / kicsomagolva) | Mikor válaszd |
|---|---|---|---|
latest (és vX.Y.Z, edge) |
szoftveres kódolás, Intel VA-API/Quick Sync (amd64), NVIDIA NVENC | ~165 MB / ~615 MB | Az esetek többségében: Intel iGPU-s NAS vagy mini PC, NVIDIA kártya, Raspberry Pi, vagy ha nincs GPU. |
latest-amd (és vX.Y.Z-amd, edge-amd) |
ugyanez, plusz AMD Radeon VA-API (Mesa radeonsi) | ~225 MB / ~855 MB | Csak AMD GPU-hoz vagy AMD APU-hoz (Ryzen iGPU), ha hardveres kódolást akarsz. |
Mindkettő amd64-re és arm64-re is elérhető (multi-arch manifest). Ha nem tudod, melyik kell, indítsd a latest-et, és nézd meg az
Admin → Átkódolás oldalon az encoder-önteszt eredményét. Ha AMD géped van, és a VA-API ott „nem elérhető”, válts latest-amd-re.
- Intel / AMD (VA-API, Quick Sync): AMD GPU-hoz a
latest-amdimage kell. Vedd ki a kommentet adevices: ["/dev/dri:/dev/dri"]sor elől. Az entrypoint automatikusan belép abba a csoportba, amelyiké a/dev/dri/*eszköz (a render/video GID rendszerenként más), így agroup_addsor el is hagyható. - NVIDIA: NVIDIA driver + NVIDIA Container Toolkit kell, majd:
docker compose -f docker-compose.yml -f docker-compose.nvidia.yml up -d - Az Admin → Átkódolás oldalon a Kinora minden encoderrel ténylegesen lekódol egy 1 másodperces tesztklipet, és megmutatja,
melyik működik, mennyi idő alatt, és ha nem, mi a hibaüzenet. Az automatikus választás sorrendje: a beállított encoder, ha működik → az első működő
hardveres encoder → szoftveres libx264.
KINORA_VIDEO_CODEC=automellett ugyanannak a hardvernek a HEVC (vagy AV1) encodere megy helyette, ha a kliens jelzi a kodeket és az encoder átment a próbán; a HEVC/AV1 fMP4 HLS-szegmensekbe kerül.
- Unraid: Docker → Add Container, repository
ghcr.io/scotylucas/kinora:latest, port 8096, path-ok:/config→/mnt/user/appdata/kinora,/media→/mnt/user/media(read only).PUID=99,PGID=100(nobody:users). Intel iGPU-hoz: Extra Parameters:--device=/dev/dri. - TrueNAS SCALE: Custom App, a dataseteket hostPath-ként csatold,
PUID/PGIDlegyen annak a felhasználónak az azonosítója, akié a dataset (általában568:568– apps). GPU: „GPU Configuration” → Intel/AMD. - Synology (Container Manager): a
PUID/PGIDértékét SSH-n azid <felhasználó>paranccsal kérdezd le. A/dev/dricsak olyan modelleken érhető el, amelyekben Intel processzor van (pl. a „+” sorozat egy része). A@eaDirés#recyclemappákat a szkenner automatikusan kihagyja. - Hálózati megosztás (SMB/NFS) esetén ha a megosztás leesik, a Kinora nem töröl semmit: a szkennelés hibával leáll, a hiányzó fájlok csak „hiányzó” jelölést kapnak, és visszatéréskor megmarad a megnézett állapotuk.
curl -fsSL https://raw.githubusercontent.com/ScotyLucas/kinora/main/install.sh | bashA telepítő letölti és ellenőrzi (SHA-256 + ed25519 aláírás) a legfrissebb kiadást, telepíti az ffmpeg-et, és systemd szolgáltatást készít,
amely a saját felhasználódként vagy dedikált kinora felhasználóként fut. Így a Kinora bármelyik mappát látja, amit a szolgáltatás olvashat,
és új mappát bármikor hozzáadhatsz. Ha egy mappát nem tud olvasni, a felület megmondja, miért, és megadja a javító parancsot.
Van .deb és .rpm csomag is. Részletek, jogosultságok, SMB/NFS-csatolás: docs/LINUX.md.
Dockerben utólag bármelyik mappa: a docker-compose.host.yml csak olvashatóan becsatolja a /home, /mnt, /media és /srv mappát a /host alá
(docker compose -f docker-compose.yml -f docker-compose.host.yml up -d). A biztonsági mérlegelés a docs/LINUX.md-ben van.
Windowson (Windows Serveren is) a Kinora natívan, Windows-szolgáltatásként fut, Docker nélkül, automatikus frissítéssel
(csak kiadott verziókra, hiba esetén visszaállással). Minden kiadáshoz tartozik egy kinora-windows-amd64.zip, a telepítés
egy PowerShell-parancs: docs/WINDOWS.md. Asztali Windowson a Docker Desktop is megfelelő (lásd fent).
Az Admin → Beállítások → Megjelenés oldalon tölthetsz fel logót sötét és világos háttérre (PNG, JPG, WebP vagy SVG, legfeljebb 2 MB).
A faviconét és az app-ikonokat a Kinora készíti el belőle, és az appok is ezt mutatják a belépő- és a kezdőképernyőn. Az SVG-t csak szkript
és külső hivatkozás nélkül fogadja el, és kizárólag képként szolgálja ki. Az első indítás varázslója is kér logót (nem kötelező).
Dockerben: KINORA_LOGO=/config/logo.png. A Linux-telepítő (install.sh --logo) az első induláskor adja át.
Szükséges: Go 1.24+, C fordító (a sqlite miatt cgo kell), valamint ffmpeg és ffprobe a PATH-on.
go build -o kinora ./cmd/kinora
./kinora --data ./data # http://localhost:8096| Jellyfin-panasz | A Kinora megoldása |
|---|---|
| Nagy könyvtárnál lassú a szkennelés, és közben belassul a felület | Inkrementális szkenner: egy változatlan fájl egyetlen stat(); ffprobe csak az új vagy változott fájlokra fut, legfeljebb 6 szálon; SQLite WAL mód és rövid tranzakciók, így böngészés közben semmi nem blokkol. A második szkennelés a tesztkönyvtáron kb. 200 ms. |
| Átnevezés vagy áthelyezés után elveszik a megnézett állapot | Áthelyezés-felismerés: egy eltűnt fájl és egy új, azonos méretű fájl ugyanaz az elem, így megmarad az azonosítója és a megnézett állapota is. |
| SMB/NFS kiesésekor eltűnik a könyvtár | Ha a gyökérmappa nem érhető el, vagy hirtelen üres lett, a szkennelés leáll és nem nyúl semmihez. Egy eltűnt fájl csak missing jelölést kap, nem törlődik. |
| „Rejtélyes” transzkóder-hibák | Valódi encoder-önteszt, valamint a lejátszóban egy „Miért így megy?” panel: magyar nyelvű indokok (pl. „a böngésző nem tudja lejátszani a(z) hevc videót”), a használt encoder, a forrás és a böngésző képességei. Hiba esetén az ffmpeg utolsó hibasora jelenik meg. |
| Nincs átkódolt letöltés offline nézéshez | Letöltés 1080p/720p/480p/360p minőségben vagy eredeti fájlként, a háttérben, előrehaladás-jelzéssel. Faststart MP4, 7 napig marad meg. |
| A SyncPlay akadozik | Watch party szerver oldali órával: NTP-szerű óraszinkron, kis eltérésnél playbackRate 0,95/1,05, nagy eltérésnél ugrás. Ha valaki pufferel, mindenki megvárja, de legfeljebb 12 másodpercig. Van chat és emoji-reakciók is. |
| Nincs saját címke, gyűjtemény, értelmes szűrés | Saját címkék, kézi gyűjtemények sorrenddel, szabályalapú smart gyűjtemények (18 mező, all/any), összetett szűrés és rendezés. A részletes oldalon látszik, mely gyűjteményekben szerepel az elem. |
| Smart lista csak pluginnel | Beépített szabálymotor, a szerkesztőben élő előnézettel; a gyűjtemények a kezdőlapra is kitűzhetők. |
| Nincs „Mert megnézted…” | Teljesen helyi, magyarázható ajánló: „Neked ajánljuk” („mert szereted: Sci-Fi, Drama”), „Mert megnézted: X”, „Rejtett kincsek”, valamint „Hasonló” sor a részletes oldalon. |
| Egy sorozatot csak megnézettnek jelölve lehet eltüntetni a Next Up-ból | Elrejtés megnézettnek jelölés nélkül. Ha újra elkezded nézni, magától visszakerül. |
| Nincsenek igazi profilok és gyerekmód | Fiókonként 8 profil, opcionális PIN, gyerekprofil korhatár-szinttel. A szűrés minden végponton érvényes: listában, részleteken, keresésben, ajánlóban, streamen, feliratnál, letöltésnél, képeknél és a watch partyban. |
| Bonyolult felhasználófelvétel | Meghívólink felhasználásszámmal és lejárattal, QR-kóddal. |
| Bonyolult távoli elérés | „Csatlakozás” oldal: az összes LAN- és Tailscale-cím QR-kóddal, valamint útmutató Tailscale-hez, Cloudflare Tunnelhez és reverse proxyhoz. |
| A feliratlista tele van felesleges nyelvekkel | Profilonként felirat- és hangsávnyelv-prioritás; a menü alapból csak ezeket mutatja, az „Összes nyelv mutatása” kapcsolóval jön a többi. |
| Nincs „Következő rész” felugró | A stáblista kezdetét fejezetcímekből ismeri fel (credits, stáblista, end titles…), ennek híján az utolsó 30 másodpercben jelez. Visszaszámlálással indítja a következő részt. |
A magyar .srt ékezetei elromlanak |
A nem UTF-8 külső feliratot CP1250-ként olvassa be („Árvíztűrő tükörfúrógép” helyesen jelenik meg). |
| Gyenge mentés | Egy kattintásos, konzisztens adatbázis-mentés (VACUUM INTO) futás közben is. |
Movies/
Blade Runner 2049 (2017)/Blade Runner 2049 (2017).mkv ← a mappanév az elsődleges
Blade Runner 2049 (2017)/movie.nfo, poster.jpg, fanart.jpg
Blade Runner 2049 (2017)/Blade Runner 2049 (2017).hu.srt ← <videónév>.<nyelv>[.forced].srt|vtt|ass
The.Matrix.1999.1080p.BluRay.x264.mkv ← „The Matrix” (1999)
Shows/
Breaking Bad (2008)/tvshow.nfo, poster.jpg
Breaking Bad (2008)/Season 01/Breaking.Bad.S01E02.mkv
Dark/Staffel 2/03 - Ghosts.mkv ← évadmappa + sorszám
Aranyélet/2. évad/Aranyelet.S02E04.mkv
Futurama/Specials/Futurama.S00E01.mkv ← 0. évad
Seinfeld.S03E10.The.Old.Man.mkv ← lapos elrendezés is működik
- Felismert minták:
S01E02,S01E01E02(dupla rész),1x05, évadmappa +03 - Cím. Évadmappák:Season 01,S1,Staffel 2,Évad 2,2. évad,Specials/Extras(= 0. évad). - Kimarad: rejtett mappák,
@eaDir,#recycle,trailers,featurettes,behind the scenes, valamint a 300 MB alattisample/-trailerfájlok. - Helyi metaadat: Kodi/Jellyfin-kompatibilis NFO (
movie.nfo,<videó>.nfo,tvshow.nfo). Képek:poster/folder/cover,fanart/backdrop/background,<videó>-poster,<videó>-thumb,season01-poster.jpg. Ha nincs kép, a Kinora a videó kb. 20%-ánál készít egy képkockát. - Online metaadat (opcionális): Admin → Metaadat, TMDB kulccsal. A helyi NFO-t és a kézzel javított elemeket soha nem írja felül. Rossz találat esetén a részletes oldalon a „Találat javítása” gombbal választhatsz másikat.
Tailscale (a legegyszerűbb, nem kell portot nyitni): egy sidecar konténer csatlakozik a tailnetedhez, és a Kinora annak a hálózatán fut.
TS_AUTHKEY=tskey-... docker compose -f docker-compose.yml -f docker-compose.tailscale.yml up -dA tailneten ezután http://kinora:8096 címen éred el (MagicDNS), a helyi hálózaton továbbra is a megszokott címen.
Cloudflare Tunnel (saját domain, HTTPS): a Zero Trust felületén hozz létre egy tunnelt, a public hostname mutasson a http://kinora:8096 címre, majd:
CF_TUNNEL_TOKEN=... KINORA_PUBLIC_URL=https://kinora.pelda.hu \
docker compose -f docker-compose.yml -f docker-compose.cloudflared.yml up -dFigyelem: a Cloudflare felhasználási feltételei korlátozhatják a nagy mennyiségű videóforgalmat a tunnelen.
Reverse proxy: a watch party WebSocketet használ, ezért add tovább az Upgrade és Connection fejléceket. Caddy-vel ehhez elég ennyi:
reverse_proxy 127.0.0.1:8096. Nginx-re kész példát találsz az Admin → Csatlakozás oldalon. A Kinora követi az X-Forwarded-Proto
fejlécet: HTTPS mögött a session cookie Secure jelzést kap.
- Android (telefon + Android TV), Samsung Tizen, LG webOS, iOS: az
apps/mappában, egy közös felülettel. Építés és telepítés:apps/README.md, a mai kipróbálás lépésről lépésre, Windowsról:docs/TESZTELES_MA.md. - iPhone ma, Mac nélkül: a webkliens telepíthető webes app (PWA): Safari → Megosztás → „Főképernyőhöz adás”. Teljes képernyőn, saját ikonnal fut.
- Belépés kóddal (Quick Connect): a TV egy 6 jegyű kódot mutat; egy bejelentkezett eszközön (profil menü → Eszköz csatlakoztatása) jóváhagyod, és kiválasztod, melyik profillal lépjen be. A kód 5 percig él, egyszer használható; a próbálkozások IP-nként és felhasználónként korlátozottak.
- Eszközök: a Fiók oldalon látszanak a bejelentkezett eszközeid (név, platform, appverzió, IP, utolsó aktivitás), egyenként vagy egyszerre kiléptethetők; az admin az Admin → Eszközök oldalon mindet látja.
- Szerverkeresés: az appok UDP-broadcasttal (7359) vagy a helyi alhálózat pásztázásával találják meg a szervert. Dockerben a broadcast nem megy át
a bridge hálózaton: ehhez
network_mode: hostkell (vagy a címet kézzel kell megadni).
Az appok a POST /api/login (vagy a Quick Connect) után kapott tokent Authorization: Bearer <token> fejlécben küldik. A CORS csak az app-originekre
(capacitor://localhost, http(s)://localhost, null) és csak tokenes kérésekre engedélyezett, Access-Control-Allow-Credentials nélkül.
A <video>/<img> számára a lejátszási válasz rövid életű, aláírt stream-tokent (?st=) tesz az URL-ekbe; ez elemre, felhasználóra és eszközre szól.
Admin → Beszerzés: rákeresel egy filmre, kiválasztasz egy kiadást (vagy a Kinora választja ki a minőségprofil alapján), a qBittorrent letölti, a Kinora pedig hardlinkkel beteszi a filmkönyvtárba (Cím (Év) {imdb-tt…}/Cím (Év) - 1080p BluRay.mkv) és beolvassa. Alapból ki van kapcsolva, és nem tartalmaz trackert vagy indexert: a Torznab-forrásokat (egy tracker saját API-ja, Jackett vagy Prowlarr) az admin adja meg.
A Kinora és a qBittorrent ugyanazt a /data mappát lássa (benne downloads/ és media/), így a hardlink működik, és a torrent tovább seedelhet. Ha a qBittorrent más útvonalon látja a letöltéseket, az adminban útvonal-leképezés állítható. Felfedezés: a felhasználók (gyerekprofil kivételével) filmet és sorozatot (évadonként) kérhetnek; az admin jóváhagyja (vagy minden kérés automatikus), a szerver pedig magától letölti, és szól, ha megérkezett. Letöltőkliens: qBittorrent, Transmission, Deluge, SABnzbd vagy NZBGet; indexer: Torznab vagy Newznab. Interaktív keresés, saját minőségprofilok és csere jobb minőségre is van. Sorozatok: a figyelt sorozatok hiányzó részeit (évadcsomagként is) és az új részeket magától letölti. A teljes terv és a mérföldkövek: docs/BESZERZES.md.
- Admin → Beállítások → Adatbázis-mentés letöltése: konzisztens pillanatkép (
VACUUM INTO), futás közben is biztonságos. - Visszaállítás: állítsd le a konténert, másold a mentést
config/kinora.dbnéven a helyére, töröld akinora.db-wal/-shmfájlokat, majd indítsd újra. A képeket (config/images) a következő szkennelés újra legenerálja, ha hiányoznak.
A kép a Debian trixie saját ffmpeg csomagját használja (7.1, libzimg/zscale tónusleképezéssel, VA-API, QSV (libmfx), NVENC (ffnvcodec)).
Mellette van az intel-media-va-driver-non-free (amd64, Gen8+ Intel iGPU), az -amd változatban pedig a mesa-va-drivers (AMD) is. Miért nem a jellyfin-ffmpeg?
- Ugyanabból a Debian-tárolóból jön amd64-re és arm64-re is, így a multi-arch build egyszerű és reprodukálható.
- A Kinora csak H.264 kimenetet és a szabványos
zscale+tonemapláncot használja, ehhez nem kell a jellyfin-ffmpeg saját OpenCL/Vulkan tónusleképezése. - A Kinora encoder-öntesztje úgyis megmutatja, mi működik az adott gépen.
Ha a jellyfin-ffmpeg kell (pl. újabb Intel Arc GPU-khoz), egy saját képben telepítsd, és add meg a
KINORA_FFMPEG=/usr/lib/jellyfin-ffmpeg/ffmpeg és KINORA_FFPROBE=/usr/lib/jellyfin-ffmpeg/ffprobe változót.
Képméret. A Debian ffmpeg-je a libavdevice → libgl1 → … → mesa-libgallium → libllvm19 láncon keresztül behúzza a Mesa OpenGL-drivereit
és az LLVM-et (kb. 140 MB). Az ffmpeg parancssori eszköz soha nem hoz létre OpenGL kontextust, ezért az alap (latest) image-ből a build
dpkg --force-depends-szel eltávolítja a libgl1-mesa-dri, mesa-libgallium, libllvm* és libz3-4 csomagot. Rögtön utána egy tesztkódolás is lefut,
ami ellenőrzi, hogy az ffmpeg ép. Ennek az ára, hogy az image-en belül az apt hiányzó függőséget jelez; a konténert nem is erre szánták.
A latest-amd image-ben ezek megmaradnak, mert az AMD VA-API driver (radeonsi) valóban használja az LLVM-et.
Maga a Kinora bináris kb. 10 MB.
Saját build: docker build --target runtime . (alap) vagy docker build --target runtime --build-arg AMD=1 . (AMD).
go run ./cmd/kinora --data ./data --web ./web/static # a webkliens a forrásból, frissítés után azonnal látszik
docker compose -f docker-compose.yml -f docker-compose.dev.yml up --buildHa nincs helyi Go vagy C fordító, a scripts/go.sh a toolchaint konténerben futtatja:
scripts/mkmedia.sh testmedia # generált tesztkönyvtár (ffmpeg kell hozzá)
scripts/go.sh go vet ./...
scripts/go.sh go test ./... # unit- és integrációs tesztek valódi médiafájlokkal
scripts/smoke.sh # image build + konténer + curl-ös végigjárás (setup → szkennelés → lejátszás → HLS)
BASE=http://127.0.0.1:18097 node scripts/e2e.mjs # böngészős E2E (Playwright + Edge/Chrome), képernyőképekkelFelépítés:
cmd/kinora/ belépési pont, flagek/env, graceful shutdown, healthcheck alparancs
internal/store/ SQLite séma és migrációk, auth/profilok/meghívók, elemek, szabálymotor, gyűjtemények, ajánló
internal/scanner/ fájlnév-felismerés, inkrementális szkenner, NFO, képek
internal/media/ ffprobe, lejátszási döntés, encoder-önteszt, HLS sessionök, WebVTT, letöltések
internal/meta/ opcionális TMDB metaadat
internal/party/ watch party hub (WebSocket)
internal/server/ HTTP API, middleware, webkliens kiszolgálása
web/static/ vanilla JS SPA (index.html, app.js, style.css, vendor/hls.js, vendor/qrcode-generator)
A webkliens többnyelvű (magyar, angol, német). A szövegek a web/static/i18n/<nyelv>.js fájlokban vannak; a magyar az alap, a hiányzó kulcsok arra esnek vissza. A nyelvet a böngésző beállítása adja, és a profilmenüben, a fiókoldalon vagy a bejelentkezésnél át lehet váltani (a választás a böngészőben marad meg). A szerver magyar üzeneteit (hibák, ajánlássorok, lejátszási indokok, watch party üzenetek) a kliens a nyelvi fájlok srv/srvRe táblájával fordítja. Hiányzó angol kulcsoknál a nem magyar nyelvek először az angolra esnek vissza.
Nyelvek az adminban (Admin → Nyelvek):
- Exportálás: bármelyik nyelv letölthető JSON-fájlként, az összes kulccsal együtt. A le nem fordított kulcsok a tartalék nyelv szövegével szerepelnek benne.
- Importálás: egy lefordított fájl visszatölthető. Ha a nyelv már létezik, a felület megerősítést kér a felülírás előtt.
- Új nyelv: megadod a kódot (pl.
fr,pt-br), a nevet és a locale-t (pl.fr-FR; ez dönti el a számok formátumát és a többes számot). Indulhat üresen, vagy egy meglévő nyelv másolatából. - Szerkesztő: kulcsonként mutatja a referenciaszöveget és a fordítást. Van kereső és „csak a fordítatlanok” szűrő; az üresen hagyott mező a tartalék nyelv szövegét használja.
- Visszaállítás: a beépített nyelvek (hu, en, de) módosításai felülírásként tárolódnak, és egy gombbal visszaállíthatók. A hozzáadott nyelvek törölhetők.
A mentett nyelvek a <data>/i18n/<kód>.json fájlokban vannak, és a kliens a /i18n/custom.js címről tölti be őket. A fájlformátum: {"kinora_language": 1, "code": "fr", "name": "Français", "strings": {…}}.
- A sablonokban
{0},{1}… jelöli a paramétereket, a{0:00}két számjegyre egészít ki. - A többes szám egy objektum,
one/few/many/other(és=0,=1…) kulcsokkal. - A formátum részletes leírása a beépített
web/static/i18n/*.jsfájlok elején található.
Az iPhone/iPad és az Apple TV app ugyanezeket a nyelveket használja. Az appok saját szövegei a nyelvi fájlok app táblájában vannak; a kulcs az app magyar szövege, mint az srv-nél, így az adminban felvett új nyelv az appokat is fordítja, és a szerkesztő ezeket is mutatja. A szerver a GET /api/languages (lista verzióval) és a GET /api/languages/<kód> címen adja ki őket, bejelentkezés nélkül, a felülírásokkal és az angol tartalékkal együtt, csak a locale, app, srv, srvRe részt. Az app minden szerverhez csatlakozáskor szinkronizál: letölti az új vagy megváltozott nyelveket, és mindet megtartja az eszközön, akkor is, ha a szerver nem érhető el, vagy a nyelvet később törölték róla. A nyelv az app Beállítások → Nyelv oldalán (Apple TV-n a Beállítások fülön) választható; az „Automatikus” a készülék nyelvét követi, és ha az nincs meg, angolra, végül magyarra esik vissza. A widgetek és a Top Shelf ugyanazt a nyelvet használják. Ami magyar marad: a Siri/Parancsok rögzített szövegei és a rendszer engedélykérő szövegei.
Ha egy fordítást a projektbe is beküldenél, az exportált strings objektumból készíts új web/static/i18n/<kód>.js fájlt, és vedd fel az index.html-be.
Beépített relay/NAT-áttörés, offline letöltés az appokba, watch party az appokból, intro-felismerés audio-ujjlenyomattal, trickplay előnézeti képek, zenei könyvtár, élő TV, hiányzó gyűjteményelemek TMDB-ből, Postgres, a natív appok fordítása.
A felület a „kivilágított mozihomlokzat” gondolatára épül: a poszterek megvilágított plakáttartókban ülnek, az egyetlen akcentszín (borostyán) csak annak jár, ami éppen „él” – a fókuszált kártya, a lejátszás, a haladás, az egyetlen elsődleges gomb. Két regiszter van ugyanazokból a tokenekből: az előcsarnok (böngészés: a kép vezet, a felület hátralép) és a vetítőfülke (admin, szerkesztők: hajszálvonalak, táblák, tabuláris számok).
- Minden érték design token a
style.csselején (:root): színskála, 4/8-as térköz-skála, betűméret-skála, két lekerekítés, 44 px-es érintési minimum, mozgás-időzítés. - Betűk saját kiszolgálásból (
web/static/fonts, SIL OFL): Big Shoulders Display a címekhez és számokhoz, Atkinson Hyperlegible a szövegekhez – mindkettő tartalmazza az ő/ű-t. - Távirányító/billentyűzet: a nyilak térben mozgatják a fókuszt a sorok és rácsok között, a fókuszált plakáttartó kigyullad, és a kezdőlap homlokzata arra a filmre vált; Enter nyit, Esc visszalép.
- Kép nélküli könyvtárnál a kártya tipográfiai címkártya (cím + év), nem üres doboz.
- A régi felület képei összehasonlításhoz:
docs/screenshots/before/.
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
MIT. A vendorolt hls.js (Apache-2.0) és qrcode-generator (MIT) saját licence a web/static/vendor/ mappában van.








