Nokturno pro Stremio – aplikace¶

Doplněk na cizím serveru dostává tvoje přihlašovací údaje

Každý doplněk pro Stremio, který běží na cizím serveru, dostává tvoje přihlašovací údaje ke zdrojům (vlastní úložiště, WebShare, FastShare…). Jsou totiž v adrese doplňku a s každým požadavkem procházejí přes ten server. Jeho provozovatel je tak může vidět a uložit a musíš mu věřit. Jistotu, že je nemá nikdo jiný, máš jen tehdy, když doplněk běží u tebe: na televizi, počítači, Home Assistantu, Raspberry Pi nebo na vlastním VPS.

Nokturno pro Stremio a Nuvio je malá aplikace, která běží u tebe. Stremio i Nuvio pak jen zadají adresu doplňku a ptají se aplikace jako každého jiného doplňku. Aplikace musí běžet, kdykoli se díváš. Doma ji pustíš na televizi s Androidem, na počítači, na Raspberry Pi nebo NAS, nebo jako doplněk Home Assistantu, pokud Home Assistant doma máš.

Kde ji pustit¶

Co máš	Kde aplikace běží	Postup
Android TV, Google TV nebo Android box	přímo na televizi nebo boxu	Android TV a Android box
Počítač s Windows, macOS nebo Linuxem	na počítači, doplněk funguje jen, když počítač běží	Počítač
Home Assistant (HA OS)	jako doplněk Home Assistantu	Home Assistant
Raspberry Pi, NAS nebo jiný malý linuxový počítač	na něm, běží pořád	Raspberry Pi a NAS
Starý Android telefon, Docker na NASu, MikroTik, starý notebook	nápady a příklady, na čem to doma rozjet	Kde doma pustit Nokturno pro Stremio
Mobil nebo TV mimo domov, aplikace zůstane doma	doma, přístup přes Tailscale nebo VPN	Nokturno pro Stremio mimo domov – Tailscale a VPN
VPS s vlastní doménou, přístup odkudkoli bez VPN	na VPS	Nokturno pro Stremio na VPS s vlastní doménou

Nejlíp je pustit aplikaci na zařízení, které je pořád zapnuté (box, Raspberry Pi, NAS), nebo přímo na tom, kde Stremio pouštíš.

Android TV a Android box¶

Povol instalaci z neznámých zdrojů pro aplikaci, přes kterou APK dostaneš do televize, například Downloader nebo Send files to TV.
Stáhni nokturno-<verze>.apk z vydání na GitHubu (v Downloaderu zadej adresu github.com/nokturno-app/nokturno-stremio-app/releases/latest) a nainstaluj ho.
Otevři aplikaci Nokturno. Ukáže adresy pro nastavení. Běží na pozadí s trvalým oznámením „Nokturno běží“, poslouchá na portu 7140 (a 7141 pro HTTPS) a po zapnutí zařízení se spustí sama. Po instalaci ji jednou otevři, jinak ji Android po zapnutí nespustí.
Otevři nastavení: na televizi přímo v aplikaci Nokturno (bez prohlížeče se formulář otevře v ní), nebo pohodlněji z telefonu ve stejné síti na http://<IP adresa televize>:7140/configure. IP adresu ukazuje hlavní obrazovka aplikace.
Založ profil (napiš jeho název a dej Založit nový profil), pak vyplň vlastní úložiště a případně účty zdrojů a dej ✓ Ověřit všechny účty. Postup je v článku Jak přidat Nokturno do Stremia nebo Nuvia.
Přidat do Stremia nebo Přidat do Nuvia. Na téže televizi to jde rovnou z formuláře v aplikaci, na ostatních zařízeních v síti z formuláře otevřeného přes IP adresu.

Počítač¶

Z vydání na GitHubu vyber soubor podle systému:

Zařízení	Soubor
Windows 10 a 11	`nokturno-<verze>-windows-amd64.exe`
Mac s čipem Apple (M1 a novější)	`nokturno-<verze>-macos-arm64`
Mac s procesorem Intel	`nokturno-<verze>-macos-amd64`
Linux	`nokturno-<verze>-linux-amd64`

Spusť ho:

Windows: spusť .exe. Na hlášku „Systém Windows ochránil váš počítač“ dej Další informace → Přesto spustit. Bránu firewall povol pro soukromé sítě. Od verze 9.3.0 běží bez okna. Najdeš ji jako ikonu měsíce v oznamovací oblasti vpravo dole (případně pod šipkou ^): dvojklik otevře nastavení, Ukončit ji vypne. Ať běží pořád, i po restartu a bez přihlášení (od verze 9.5.0): ukonči aplikaci v oznamovací oblasti, v Příkazovém řádku ve složce se staženým souborem spusť nokturno-<verze>-windows-amd64.exe --install a potvrď oprávnění správce. Aplikace se nainstaluje jako služba Nokturno pro Stremio (je ve services.msc), sama si povolí bránu firewall, po pádu se restartuje a nastavení přenese do C:\ProgramData\Nokturno. Odinstalace: C:\ProgramData\Nokturno\nokturno.exe --uninstall (nastavení zůstane). Bez služby jde dát zástupce na .exe do složky shell:startup (Win + R).
macOS: v Terminálu chmod +x nokturno-*-macos-* a xattr -d com.apple.quarantine nokturno-*-macos-*, pak ./nokturno-<verze>-macos-arm64. Bez druhého příkazu spuštění zablokuje Gatekeeper, protože aplikace není podepsaná (jde to i přes Nastavení systému → Soukromí a zabezpečení → Přesto otevřít). Ať běží pořád, i po restartu a bez přihlášení (od verze 9.5.0): sudo ./nokturno-<verze>-macos-arm64 --install. Aplikace se nainstaluje jako služba do /Library/Application Support/Nokturno a okno Terminálu pak můžeš zavřít. Odinstalace: sudo "/Library/Application Support/Nokturno/nokturno" --uninstall.
Linux: chmod +x nokturno-*-linux-* a ./nokturno-<verze>-linux-amd64. Jak ji pouštět jako službu, je v části Raspberry Pi a NAS.

Pak otevři http://127.0.0.1:7140/configure, vyplň vlastní úložiště, případně volitelné účty zdrojů a dej Přidat do Stremia nebo Přidat do Nuvia. Ostatní zařízení v síti otevřou http://<IP adresa počítače>:7140/configure, IP adresu vypíše aplikace při startu.

Doplněk funguje jen, když počítač běží a aplikace je spuštěná. Na televizi a telefonu taky.

Home Assistant¶

Nokturno pro Stremio jde nainstalovat jako doplněk Home Assistantu (HA OS nebo Supervised, jen 64bit systémy amd64 a aarch64; Raspberry Pi s 32bit systémem ne). Běží pak doma pořád, dokud běží Home Assistant.

Přidej úložiště doplňků: tlačítkem, nebo ručně Nastavení → Doplňky → Obchod s doplňky → ⋮ → Úložiště a vlož https://github.com/nokturno-app/nokturno-stremio-ha.
Nainstaluj Nokturno pro Stremio a dej Spustit.
Otevřít webové rozhraní, nebo z telefonu či počítače ve stejné síti http://<IP Home Assistantu>:7140/configure.
Založ profil s názvem, vyplň vlastní úložiště, případně volitelné účty zdrojů, dej ✓ Ověřit všechny účty a pak Přidat do Stremia nebo Přidat do Nuvia.

Doplněk používá síť hostitele: port 7140 (nastavení a doplněk pro Nuvio) a 7141 (HTTPS přes local-ip.co pro Stremio). V záložce Konfigurace jde vypnout statistiky (stats), hlášení o pádech (crash_reports) a HTTPS (enable_https), zadat vlastní klíč TMDB (tmdb_key). Nové verze si doplněk stahuje sám. Home Assistantu nastav v routeru pevnou IP.

Popis doplňku a jeho zdrojový kód jsou v repozitáři nokturno-app/nokturno-stremio-ha.

Raspberry Pi a NAS¶

Platí pro Raspberry Pi, NAS s Linuxem a jiný malý počítač se systemd. Aplikace na něm běží pořád, i když ostatní zařízení vypneš.

Zjisti architekturu příkazem uname -m a vyber soubor:

`uname -m`	Soubor
`aarch64`	`nokturno-<verze>-linux-arm64`
`armv7l`, `armv6l`	`nokturno-<verze>-linux-arm`
`x86_64`	`nokturno-<verze>-linux-amd64`

Stáhni ho a připrav uživatele a složku (číslo verze najdeš na stránce vydání):

sudo mkdir -p /opt/nokturno
sudo curl -L -o /opt/nokturno/nokturno \
  https://github.com/nokturno-app/nokturno-stremio-app/releases/download/v<verze>/nokturno-<verze>-linux-arm64
sudo chmod +x /opt/nokturno/nokturno
sudo useradd --system --create-home --home-dir /var/lib/nokturno --shell /usr/sbin/nologin nokturno

Vytvoř službu /etc/systemd/system/nokturno.service:

[Unit]
Description=Nokturno pro Stremio
After=network-online.target
Wants=network-online.target

[Service]
User=nokturno
ExecStart=/opt/nokturno/nokturno --data /var/lib/nokturno
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Zapni ji: sudo systemctl daemon-reload a sudo systemctl enable --now nokturno. Výpis uvidíš přes journalctl -u nokturno -f.
Z telefonu nebo počítače ve stejné síti otevři http://<IP adresa zařízení>:7140/configure, vyplň úložiště nebo účty a dej Přidat do Stremia nebo Přidat do Nuvia.

Nastavení aplikace je pak v /var/lib/nokturno/nokturno.json. Aktualizace se stahují do téže složky, soubor /opt/nokturno/nokturno se proto při nové verzi měnit nemusí.

Jak to rozjet¶

V domácí síti¶

Stremio přijme doplněk přes obyčejné http jen z téhož zařízení. Na ostatních zařízeních chce HTTPS. Když formulář otevřeš přes IP adresu, dá do doplňku adresu https://<IP s pomlčkami>.my.local-ip.co:7141 sám, Proč, je vysvětleno níž v části o adrese local-ip.co.
Nuvio vezme i adresu přes http://<IP adresa>:7140.
Zařízení s aplikací nastav v routeru pevnou IP (rezervace DHCP). Jinak se po restartu routeru adresa změní a doplněk přestane fungovat.

Mimo domov přes VPN¶

Aplikace zůstane doma, do internetu se nic neotevírá a zařízení venku (mobil, televize u rodičů) se k ní dostane přes Tailscale nebo jinou VPN. Postup krok za krokem je v článku Nokturno pro Stremio mimo domov – Tailscale a VPN.

Mimo domov na vlastní doméně¶

Adresa přes local-ip.co funguje jen v domácí síti. Kdo chce doplněk i na mobilu mimo domov nebo na televizi u rodičů, pustí aplikaci na VPS s vlastní doménou: Nokturno pro Stremio na VPS s vlastní doménou.

Adresu doplňku nikomu neposílej: hesla v ní od verze 9.6.0 nejsou, ale kdo ji má a dostane se k aplikaci, používá tvoje účty. Podrobnosti o přidání v článku Jak přidat Nokturno do Stremia nebo Nuvia.

Správce, režimy a účty¶

Aplikace pozná správce podle jména a hesla, ne podle sítě. Funguje tak stejně doma, na VPS i za vlastní doménou. Doplněk ve Stremiu ani v Nuviu heslo nechce, adresa doplňku se nemění.

První spuštění. Dokud aplikace nemá správce, stránka nastavení (/configure) ukáže jen kartu Správce aplikace: jméno, heslo (aspoň 6 znaků) dvakrát a e-mail. E-mail uvidí každý na přihlašovací stránce jako kontakt pro zapomenuté heslo, aplikace e-maily neposílá. Když stránku neotevřeš přes adresu z domácí sítě (127.0.0.1, 192.168.…), ale přes doménu nebo proxy, chce navíc kód, který aplikace při startu vypíše do výpisu na řádek „Aplikace zatím nemá správce“ (journalctl, docker logs). Na VPS otevři /configure hned po instalaci, ještě než aplikaci pustíš ven: nginx s holým proxy_pass vypadá jako požadavek z téhož počítače a kód nechce.

Obnovovací kód. Po založení správce se jednou ukáže obnovovací kód. Ulož si ho do správce hesel nebo na papír. S ním si na přihlašovací stránce v Obnovovací kód správce nastavíš nové heslo. Každé použití vydá nový kód.

Správce z verze před 11.0.0 se přihlásí jen heslem a hned potom doplní jméno a e-mail. Dostane přitom obnovovací kód.

Tři režimy¶

Režim vybírá správce v sekci ⚙ Aplikace:

Bez profilů – nastavení v adrese. Jako před verzí 9.6.0: adresa doplňku nese celé nastavení včetně hesel a kdo ji má, hesla zná. Po každé změně se doplněk přidává znovu.
Profily (výchozí). Nastavení je uložené v aplikaci, adresa nese jen klíč profilu. Profily zakládá, upravuje a maže jen správce. Kdo zná adresu, jen přehrává.
Uživatelské účty. Správce zakládá uživatele (jméno a heslo), každý se přihlásí a spravuje jen svoje profily. Správce vidí všechny profily a u každého vybere, komu patří.

Po aktualizaci zůstává dosavadní režim a nic nepřestane hrát. Klíče profilů se při přepnutí nemění. Při přechodu na účty patří stávající profily správci, ten je předá uživatelům výběrem v seznamu profilů.

Vypnout staré adresy s nastavením. Adresy, které nesou celé nastavení (/c/eyJ…), jde v sekci Aplikace vypnout. Nikdo si pak nesestaví adresu s vlastními účty a nebude aplikaci používat bez profilu. V režimu s účty je volba zapnutá hned po přepnutí. Ve Stremiu se místo streamů ukáže řádek s odkazem na uložení profilu.

Hesla ve formuláři¶

Uložená hesla se do stránky nastavení nikdy nevrací, ani správci. Pole zůstane prázdné s poznámkou Uloženo – nech prázdné, pokud ho neměníš. Když u účtu změníš jméno, e-mail nebo adresu úložiště, uložené heslo se nepoužije a pole ukáže Účet se změnil – zadej heslo znovu. Tak si nikdo s adresou doplňku nepřesměruje úložiště na svůj server, aby mu aplikace heslo poslala. Totéž platí pro Ověřit účet.

Uživatelé¶

V sekci ⚙ Aplikace → Uživatelé správce přidává uživatele a u každého vidí počet profilů, poslední aktivitu a počet přehrání za 7 a 30 dní, bez názvů titulů. Může změnit heslo, zablokovat (přestanou fungovat i adresy profilů uživatele) nebo smazat i s profily. Zapomenuté heslo uživatele mění správce, přihlašovací stránka ukazuje jeho e-mail.

Přihlášení a zapomenuté heslo¶

Přihlášení vydrží rok. V režimu bez profilů je nad formulářem volba Jsi správce aplikace? Přihlas se.
Změna hesla správce: sekce ⚙ Aplikace → Nové heslo správce → Uložit volby aplikace. Ostatní přihlášení správce tím skončí.
Zapomenuté heslo správce bez kódu: v datové složce aplikace otevři aplikace.json, smaž položku spravce a aplikaci restartuj. Pak jde správce založit znovu, uživatelé i profily zůstanou. Datovou složku najdeš v sekci Nastavení aplikace a statistiky, u aplikace pro Android se k souboru dostaneš jen přes smazání dat aplikace (zmizí tím i profily).
Tovární nastavení v sekci Aplikace smaže správce, uživatele i profily (potvrzuje se opsáním slova SMAZAT). Statistiky a hlášení pádů zůstanou.

Po 20 špatných heslech nebo kódech z jedné adresy za 10 minut aplikace další pokusy z ní na chvíli odmítá.

Aktualizace¶

Aplikace se aktualizuje sama: při startu a pak každých 6 hodin. Novou verzi ověří a když nenaběhne, vrátí předchozí. Na Androidu se aktualizace stahuje při spuštění aplikace nebo po zapnutí zařízení. Nový instalační soubor stahovat nemusíš.

Nechceš čekat? Na stránce nastavení (/configure) je dole v sekci ⚙ Aplikace (od verze 9.12.0 ji vidí jen správce) tlačítko Zkontrolovat aktualizace (od verze 9.0.7). Ukáže nainstalovanou a nejnovější verzi a novější hned stáhne. Stejně poslouží restart aplikace: na počítači ji zavři a spusť znovu, na VPS sudo systemctl restart nokturno, v Home Assistantu restart doplňku, na Androidu zavření a nové spuštění aplikace.

Časté problémy¶

Co se děje	Co udělat
Nastavení se z jiného zařízení neotevře	obě zařízení musí být ve stejné síti a aplikace musí běžet. Na Windows povol aplikaci ve firewallu pro soukromé sítě (porty 7140 a 7141).
Stremio doplněk nepřidá, adresa s `my.local-ip.co` nefunguje	router blokuje jména, která vedou na domácí IP (ochrana proti DNS rebinding). Povol v routeru výjimku pro `local-ip.co`, nebo v zařízení se Stremiem nastav DNS `1.1.1.1`.
Doplněk přestal fungovat po restartu routeru	změnila se IP adresa zařízení s aplikací. V routeru mu nastav pevnou IP (rezervace DHCP) a doplněk přidej znovu.
Na Windows se po dvojkliku na `.exe` jen otevře nastavení	Nokturno už běží jako služba (`--install`), další kopie se nespouští.
Při startu „Address already in use“	port 7140 používá jiný program. Spusť aplikaci s `--port 7150 --https-port 7151`.
Stream s „⚠️ Ve webovém přehrávači se nepřehraje“	řádek ukazuje jen starší aplikace (do 9.6.0), aktualizuj ji; ve webovém přehrávači záleží na formátu souboru, viz „⚠️ Ve webovém přehrávači se nepřehraje“
U filmu nejsou streamy	viz U filmu nejsou streamy Nokturna

Proč adresa `https://…my.local-ip.co`¶

Stremio přijme doplněk přes obyčejné http jen z téhož zařízení. Z jiného zařízení chce HTTPS s platným certifikátem. Aplikace proto otevře i port 7141 s adresou třeba https://192-168-1-10.my.local-ip.co:7141. Služba local-ip.co takové jméno přeloží zpátky na tvoji domácí IP, data tečou jen po tvé síti. Stejně to dělá Luna. Když nastavení otevřeš přes IP adresu, formulář dá tuhle adresu do doplňku sám.

Nastavení aplikace a statistiky¶

Při prvním spuštění vznikne soubor nokturno.json (Windows %APPDATA%\Nokturno, jako služba Windows C:\ProgramData\Nokturno, jako služba macOS /Library/Application Support/Nokturno, macOS ~/Library/Application Support/Nokturno, Linux ~/.local/share/nokturno, jako služba ve složce z parametru --data). V něm jde změnit porty, vypnout HTTPS, zadat vlastní klíč TMDB pro katalogy TMDB (tmdb_key) a vypnout anonymní statistiky ("stats": false) a hlášení o pádech ("crash_reports": false). Po úpravě aplikaci restartuj. Popis všech voleb je v README aplikace.