CZ Streams

Stremio addon pre streamovanie filmov a seriálov z českých a slovenských zdrojov.

Zdroje

Zdroj	Vyžaduje login	Status
WebShare	Áno	✅ Aktívny (s prihlásením)
HellSpy	Nie	✅ Aktívny — API hellspy.to/gw
Prehraj.to	Voliteľný (premium)	✅ Aktívny

Inštalácia

npm install
npm start        # bežné spustenie
npm run start:install  # spustenie + vyžiada inštaláciu

Addon beží na porte 52932 (alebo $PORT).

Verejná inštancia

https://czstreams.judzim.my.id/manifest.json

Do Stremia pridaj:

https://czstreams.judzim.my.id/manifest.json

Konfigurácia cez Stremio

Addon je configurable — v Stremio UI vieš nastaviť:

• PrehrajTo username/password — pre premium streamy
• WebShare username/password — pre prístup k WebShare
• Zoradenie výsledkov — Default / Podle velikosti / Podle kvality
• Skryť z globálneho vyhľadávania — checkbox pre vypnutie z celosietového vyhľadávania

Prehraj.to funguje aj anonymne (obmedzenejšie výsledky). WebShare vyžaduje prihlásenie. HellSpy funguje bez prihlásenia.

Ako to funguje

1. Stremio pošle IMDb ID (tt1234567) na /stream endpoint
2. Addon načíta meta z Cinemeta + TMDB (názvy, rok, sezóna/epizóda)
3. Všetky aktívne resolvery paralelne prehľadávajú svoje zdroje
4. Výsledky sa ohodnotia scoring systémom (názov, epizóda, rok, runtime, veľkosť, kľúčové slová)
5. Najlepšie výsledky sa vrátia do Stremia (5-minútová cache pre opakované dotazy)
6. Po kliknutí na stream addon presmeruje klienta priamo na CDN URL (301 redirect)

Addon podporuje aj textové vyhľadávanie priamo zo Stremio katalógu.

Technické detaily

• TypeScript, Node.js 18+, Express 5
• stremio-addon-sdk pre kompatibilitu
• linkedom pre HTML parsing (rýchlejší ako JSDOM)
• crypto-js pre AES dešifrovanie (WebShare)
• moviedb-promise pre TMDB API
• In-memory cache s TTL pre vyhľadávanie a metadata
• Každý zdroj je samostatný resolver s jednotným rozhraním (search → score → resolve)
• Scraping HTML (PrehrajTo, WebShare) + JSON API (HellSpy)
• Stremio dostáva video cez 301 redirect (priame streamovanie z CDN, server len presmeruje)

Deployment

Lokálne

npm start

Beamup

npm run deploy

Cloudflare Tunnel (Raspberry Pi)

Addon beží na Raspberry Pi cez Cloudflare Tunnel — dostupný na czstreams.judzim.my.id.

Vlastný server

Nastav $PORT a spusti:

node --experimental-strip-types server.ts

Endpointy

Endpoint	Účel
/configure	Konfiguračné UI v prehliadači
/media/<resolver>/<id>	301 redirect na CDN URL (video streamuje priamo z CDN, server len presmeruje)
/test/?q=<query>	Debug endpoint pre testovanie resolverov
/clean/	Manuálne vyčistenie cache

📄 Licencia

Tento projekt je licencovaný pod GNU Affero General Public License v3.0 — pozri LICENSE pre viac informácií.