stb-reader 0.2.1

Python client library for Ministra/Stalker STB portals

stb-reader

Python client library and CLI for Ministra/Stalker STB portals. Browse live TV channels, VOD content, and series, or resolve stream URLs — from Python code or straight from the terminal.

Install

pip install stb-reader

Requires Python 3.11+.

Quick start — CLI

stb init                       # save portal URL and MAC address once
stb live channels              # browse channels
stb stream --type live <cmd>   # get a stream URL

See the CLI reference for all commands.

Quick start — Python

from stb_reader import STBClient

client = STBClient(
    base_url="http://your-portal.example.com",
    mac="00:1A:79:XX:XX:XX",
)
client.authenticate()

# Live TV
channels = client.live_tv.get_channels(genre_id="*", page=1)
stream_url = client.live_tv.get_stream_url(channels.items[0].cmd)

# VOD
content = client.vod.get_content(category_id="*", page=1)

# Series
seasons = client.vod.get_seasons(series_id="123")
episodes = client.vod.get_episodes(series_id="123", season_id=seasons[0].id)
stream_url = client.vod.get_stream_url_by_first_file(
    series_id="123",
    season_id=seasons[0].id,
    episode_id=episodes[0].id,
)

Documentation

• CLI reference — stb command-line tool
• Getting started — installation, configuration, first call
• Authentication — token lifecycle, auto-reauth, error handling
• Live TV — genres, channels, stream URLs
• VOD — Movies — categories, content listing, movie streams
• Series — seasons, episodes, quality selection
• Pagination — PagedResult, fetch-all-pages pattern
• Error handling — all exceptions, recovery patterns
• API reference — complete method, model, and exception reference

License

MIT