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 (WebShare, FastShare, Přehraj.to…). 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ň úložiště nebo účty 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ň úložiště nebo účty, 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.

Heslo správce a profily kamarádů¶

Od verze 9.12.0 aplikace pozná svého majitele podle hesla správce, ne podle sítě. Funguje tak stejně doma, na VPS i za vlastní doménou.

První spuštění. Když heslo ještě není nastavené, stránka nastavení (/configure) ukáže jen kartu Heslo správce. Zadej heslo (aspoň 6 znaků) dvakrát a dej Nastavit heslo správce. Kdo stránku otevře první, stane se správcem. Na veřejné adrese (VPS, vlastní doména) ji proto otevři hned po instalaci.

Co vidí správce:

všechny profily v aplikaci, i ty, které si založili kamarádi,
sekci ⚙ Aplikace: přepínač profilů, změna hesla správce, odhlášení a kontrola aktualizací,
povolování zařízení.

Co vidí ostatní (kamarád na sdílené instanci, druhý člen domácnosti v jiném prohlížeči):

heslo nepotřebují, profil si založí a doplněk přidají jako dřív,
v seznamu vidí jen profily, které si sami uložili v tomhle prohlížeči,
sekci Aplikace ani cizí profily neuvidí.

Doplněk ve Stremiu ani v Nuviu heslo nechce, adresa doplňku se nemění.

Přihlášení v jiném prohlížeči. Dole na stránce nastavení rozbal Jsi správce aplikace? Přihlas se a zadej heslo. Přihlášení vydrží rok.

Změna hesla. V sekci ⚙ Aplikace vyplň Nové heslo správce a dej Uložit volby aplikace. Ostatní přihlášení správce tím skončí.

Zapomenuté heslo. V datové složce aplikace otevři soubor aplikace.json, smaž z něj položku spravce a aplikaci restartuj. Pak jde heslo nastavit znovu. 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).

Po 20 špatných heslech za 10 minut aplikace další pokusy 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.