---
feature: "StreamCinema"
description: "Stream Cinema katalog a browsing přes KRA.sk API"
files:
  - wcs/streamcinema/SCClient.py
  - wcs/streamcinema/SCBrowser.py
  - wcs/streamcinema/__init__.py
parent: true
children:
  - "SCClient"
  - "SCBrowser"
created: "2026-04-04"
updated: "2026-04-05"
status: "complete"
---

# StreamCinema

Integrace s katalogem Stream Cinema – databází filmů a seriálů dostupných přes KRA.sk. SCClient komunikuje s API pro získávání streamů a identů. SCBrowser umožňuje procházení katalogu po kategoriích (filmy, seriály, dokumenty, anime, sport...) se stránkováním. Obohacuje položky o TMDb metadata.

## Soubory

| Soubor | Velikost | Účel |
|--------|----------|------|
| `wcs/streamcinema/SCClient.py` | 11 KB | Stream Cinema API klient |
| `wcs/streamcinema/SCBrowser.py` | 12 KB | Browsing katalogu |
| `wcs/streamcinema/__init__.py` | 0.4 KB | Package init |

## Child funkce

### SCClient

- **Co dělá**: API klient pro Stream Cinema službu. Komunikuje s SC API pro vyhledávání filmů/seriálů, získávání seznamu streamů a resolve identů na skutečné video identifikátory pro KRA.sk. Obsahuje retry logiku (3 pokusy s 1s pauzou) pro odolnost vůči intermitentním 5xx chybám SC serveru. Podporuje filtrování a výběr nejlepšího streamu podle kvality a jazyka.
- **Klíčové metody**:
  - `search_movies(query, addon)` – vyhledávání filmů přes SC katalog
  - `search_series(query, addon)` – vyhledávání seriálů přes SC katalog
  - `get_streams(sc_path, addon)` – získání dostupných streamů pro titul
  - `get_ident(provider_path, addon)` – resolve SC cesty na skutečný ident
  - `select_best_stream(streams, prefer_quality, prefer_lang)` – výběr optimálního streamu
  - `resolve_stream(stream, addon)` – kompletní resolve streamu na finální URL (get_ident → KraskaClient.resolve)
  - `get_auth_token(addon, kraska_session_id)` – autentizace přes KRA.sk session
- **Vstupy**: SC cesta (URL path), vyhledávací dotazy, addon instance
- **Výstupy**: Seznam streamů (kvalita, jazyk, velikost, provider URL), video ident, finální stream URL
- **Závislosti**: `requests`, `sc_auth_token` z nastavení, [010-kraska.md](010-kraska.md) (KraskaClient pro resolve)
- **Settings**: `sc_auth_token`, `kraska_token`

### SCBrowser

- **Co dělá**: Browsing modul pro procházení Stream Cinema katalogu. Zobrazuje kategorie (Filmy, Seriály, Dokumentární, Anime, Sport, Koncerty...) a umožňuje navigaci do podkategorií. Parsuje SC API odpovědi (menu items), rozpoznává složky a video položky, a obohacuje videa o TMDb metadata (poster, popis, rating).
- **Klíčové metody**:
  - `browse_root(addon)` – hlavní menu kategorií
  - `browse_path(sc_path, addon)` – procházení konkrétní cesty
  - `parse_sc_item(item)` – parsování SC položky na standardní formát
  - `enrich_with_tmdb(parsed_item, addon)` – obohacení o TMDb metadata
  - `create_list_item(parsed_item, addon)` – vytvoření Kodi ListItem
- **Vstupy**: SC API cesta, addon instance
- **Výstupy**: Kodi ListItems s tmdb metadaty, navigační struktura
- **Závislosti**: [006-metadata.md](006-metadata.md) (TMDb pro obohacení), [001-router-core.md](001-router-core.md) (utils)
- **Settings**: `sc_auth_token`
