Examples¶

Runnable scripts live in the examples folder. Each one runs against a real stream.

Minimal publish¶

import time
import tgrtmp

player = tgrtmp.publish("movie.mp4", url, key, log=print)

while not player.stopped:
    time.sleep(1)

player.stop()

24/7 channel with a dashboard¶

loop=True restarts the file at EOF on the same timeline; the dashboard reads stats.

player = tgrtmp.publish("movie.mp4", url, key, loop=True, log=print)

while not player.stopped:
    s = player.stats
    print(f"{s['position']:6.1f}s  loop {s['loops']}  {s['bitrate_kbps']:.0f} kbit/s")
    time.sleep(1)

Relay a live source¶

Any growing .read(n) handle, with the DVR window sized in megabytes:

handle = urllib.request.urlopen("http://example.org/live.ts")

player = tgrtmp.publish(handle, url, key, buffer_size=48_000_000)

Keyboard-driven player¶

Space pauses, m mutes, i prints stats, q quits; the full control surface from a terminal. See examples/interactive_player.py.

The low level¶

connect + Publisher + Source, driven by hand. See examples/lowlevel_manual.py and low level.