Return (guild, author_voice_channel, bot_voice_client) for guild and DM contexts. Voice state is read directly from guild._voice_states rath

Return the highest Role that applies to *user_id*. Evaluated in priority order: admin > friend > guild member > none. Accepts any object that

Split 'show name s02e01' into ('show name', 2, 1). Returns (query, None, None) if no match.

Return a human-readable label for a Jellyfin item.

Build a guild whose voice client sits in vc_channel with given members.

Wait up to 10 s for the user to reply with a number in [1, max_val]. Returns None on timeout or if the user starts a new command. New

Run ffprobe on a stream URL and return video + audio stream info. Returns a dict with codec, fps, profile, has_b_frames, width, height, and h

Mirrors the inline filter in the channels command.

Return a context-manager mock that yields a response with JSON body.

Output frame rate. STREAM_FPS (1-60) overrides the STREAM_QUALITY preset. Matching the source fps avoids wasteful frame duplication.

(resolution, fps, bitrate) selected by STREAM_QUALITY (720p/1080p/4k); defaults to 1080p — the historical hardcoded profile.

Output size as 'W:H' for the scaler. STREAM_RESOLUTION (accepts '1280:720' or '1280x720') overrides the STREAM_QUALITY preset.

Return a voice client that is *actually connected* to ``voice_channel``. ``guild.voice_client`` can linger as a disconnected client after the bot

Format a Unix timestamp as a human-readable time in the configured timezone.

Fraction of the frame interval to spread each frame's RTP packets across, instead of bursting them (see _DEFAULT_PACKET_PACE). STREAM_PACKET_PACE,

Target video bitrate for -b:v/-maxrate/-bufsize (e.g. '2500k'). STREAM_VIDEO_BITRATE overrides the STREAM_QUALITY preset.

yt-dlp format selector used to download `!play <URL>` VODs. Defaults to `_DEFAULT_YT_FORMAT` (best available video+audio). Override via the

Stop the go-live stream and release all resources.

If master_url is an HLS master playlist, fetch it and return the URL of the highest-bandwidth variant stream. Otherwise return master_url unc

Start a Jellyfin playback session and return the HLS stream URL. Uses POST /Items/{id}/PlaybackInfo with a DeviceProfile that requests

Return (channel, the_vc_its_connect_yields).

Return a context-manager mock that yields a response with the given text body.

Cancel any active camera stream and video player for a guild.

Called by gateway.py with (ProposalsOperationType, msg[4:]). discord.py-self extracts the proposals_op_type byte from msg[3] and

Fetch and cache the first Jellyfin user ID. PlaybackInfo requires a UserId even with API key auth — without it Jellyfin returns 400.

Probe, validate, and start an IPTV stream. Always transcodes to baseline H.264 (live=True) so Discord receives a compatible bitstream

Return True if FFmpeg can actually use this encoder (device/driver check). Mirrors the real encode pipeline: hardware encoders (notably VA-API) r

Find a specific episode by series name, season number, and episode number. Searches for the series by name first, then walks seasons → episod

Search the TV guide by show title. If the show is on now, switches to it immediately. If it's coming up (within 24 h), offers

SIGTERM then SIGKILL if needed, then reap.

Resolve voice, probe the Jellyfin HLS stream, and start streaming.

Whether TVheadend should be queried for the current request. True only when a client is configured (credentials present) and the sour

Signal go-live to Discord, negotiate the stream voice connection, and start the background WebSocket heartbeat task.

DAVE-encrypt an Opus frame before transport encryption.

Return all episodes for a season, ordered by IndexNumber.

Return all channels from enabled sources with a 'source' field added.

Return all seasons for a series, ordered by IndexNumber.

Return a shallow copy of the sources list.

Connect to voice and begin a go-live screenshare stream. Unlike start_stream() which uses the camera/self-video path, this function send

Return the url-tvg / x-tvg-url attribute from the #EXTM3U header, if present.

Build the set of string user IDs that libdave should trust. Always includes the bot itself; adds current voice-channel members

libopenh264 software encoder config — the primary on machines without a working GPU encoder, and the runtime fallback (see _SW_ENCODER) when a

Parse an XMLTV datetime string such as '20260519120000 +0000'.

List episodes for a season and ask the user to pick one.

Fetch seasons for a series, prompt for one (or skip if only one), then pick an episode.

Pull our own key ratchet from the MLS session → give it to Encryptor.

Strip credentials (user:pass and api_key= query param) for safe logging.

Rewrite H.264 SPS NAL unit to force bitstream_restriction_flag=1 and max_num_reorder_frames=0. Discord requires both or rejects with Error 2

Search Jellyfin for movies, series, and episodes matching query.

Send a raw RTP packet to the go-live stream server.

A/V lip-sync offset in milliseconds (STREAM_AV_SYNC_MS, default 0). Audio and video are sent on independent threads with no shared clock, so a

Pick the best available H.264 encoder. Returns None if nothing works.

Encrypt one audio RTP packet using the negotiated voice encryption mode. Mirrors _encrypt() in video_player.py but takes the nonce as an int

Re-insert emulation prevention bytes so 0x00 0x00 0x{00-03} never appears raw.

Strip emulation prevention bytes (0x00 0x00 0x03 → 0x00 0x00).