Skip to content

Latest commit

 

History

History
159 lines (143 loc) · 6.09 KB

README.md

File metadata and controls

159 lines (143 loc) · 6.09 KB
Raw

Stream-Observer

Stream-Observer (strobs) is a script to observe running voc video streams.
The script opens mpv with all active (currently streaming) streams from Chaos Computer Club made by VOC (video operation center) in a playlist as found at https://streaming.media.ccc.de. Optionally it can also try to open all streams given in a valid playlist.

Execute ./strobs.
If you face error 'Permission denied' and test -x strobs && echo true || echo false returns 'false' make strobs executable with chmod +x strobs.

Requirements

Install mpv if not existing. Install jq if not existing.

Table of contents

Options

Usage: strobs [ -d | -D | -f | -h | -j | -k | -m | -p file | -s | -t | -v | -V | -x]

  • -d debug mode: print commands and arguments while executed
  • -D debug mode: print script lines while read
  • -f forces (with -p / -j) open playlist / download full json
  • -h help shown
  • -j json export to disk
  • -k keys/shortcuts shown (input.conf needed)
  • -m man page shown (strobs.1 needed)
  • -p playlist file with servers in format m3u8
  • -s sort room names alphanumerical
  • -t timetable of running and coming events shown
  • -v verbosity increasing with v
  • -V version print
  • -x exit before mpv, keeps current-playlist.m3u8

Details

The script downloads https://streaming.media.ccc.de/streams/v2.json and searches for active (current streaming) streams. It reads their display names too. With this informations it builds a playlist in m3u8 format and starts mpv with this playlist.

Examples

strobs

opens current streams in mpv.

strobs -p 36c3.m3u8

uses the playlist 36c3.m3u8 for mpv.

strobs -j -f

will download and save current.json, current-playlist.m3u8, status_liveber.xsl (deprecated), status_ingest.xsl (deprecated) and exit before opening mpv. In addition json includes past events.

Files

  • current-playlist.m3u8 - generated playlist while running
  • input.conf - user-defined key bindings for mpv
  • keys.lua - script with key bindings for audio, video and rooms
  • strobs - the shell script to execute
  • strobs.1 - man page
  • voctocat.gif - temporary image used as last playlist item

Only strobs is absolutely necessary to observe running voc video streams.

Keys and shortcuts

defined by lua scripts

  • 1 – 0 room number 1 to 10
  • q select native audio
  • w select translation 1
  • e select translation 2
  • y select video mixer output
  • x select slides

defined defaults by input.conf

  • RIGHT seek 5
  • LEFT seek -5
  • UP seek 60
  • DOWN seek -60
  • Shift+PGUP seek 600
  • Shift+PGDWN seek -600
  • SPACE cycle pause
  • > playlist-next; skip to next room
  • < playlist-previous; skip to previous room
  • i toggle transport osd
  • I (upper i) toggle display stats
  • ctrl++ add audio-delay 100ms; this changes audio/video sync
  • ctrl+- add audio-delay -100ms
  • m cycle mute
  • d cycle deinterlace
  • # cycle audio
  • _ cycle video
  • f cycle fullscreen
  • s screenshot
  • F8 show rooms
  • F9 show list of audio/sub streams

Fixed mpv options

It is starting a playlist in mpv with following options:

  • --fs
    • full screen
  • --no-ytdl
    • disable the youtube-dl hook-script (404 should try next stream immediately)
  • --msg-level=all=error,ffmpeg=fatal
    • all modules just error messages, but ffmpeg/video fatal (because of permanent irrelevant PoC errors)
  • --no-input-default-bindings
    • deactivate all default key bindings
  • --input-conf=${progpath}input.conf
    • look for configuration file in the same directory where strobs is starting
  • --load-scripts=no
    • don't load any scripts from personal config
  • --scripts=keys.lua
    • load these script:${progpath}keys.lua
  • --force-window=immediate
    • create the gui immediately on program start
  • --keep-open=always
    • don't terminate if the current file is ending and playback will never automatically advance to the next file
  • --idle=yes
    • wait idly instead of quitting when there is no file to play
  • --vd-lavc-show-all=yes
    • don't wail until an initial keyframe was decoded for a quicker startup
  • --no-initial-audio-sync
    • audio is started immediately even if start timestamp differs from video, if necessary video timing is gradually adjusted
  • --audio-stream-silence=yes
    • when pausing playback or stop and restart audio on seeks, audio is not stopped and silence is played
  • --demuxer-cache-wait=no
    • don't read data until the demuxer cache has reached maximum capacity
  • --force-seekable=no
    • don't try to seek stream earlier than cache
  • --image-display-duration=inf
    • the image is kept open forever, the player will not pause
  • --screenshot-format=png
    • set the screenshot image file type to png (default: jpg)
  • --script-opts=osc-visibility=always,osc-seekbarstyle=knob
    • visibility mode of on screen controller
    • style of the playback position marker as round knob
  • --osd-duration=5000
    • set the duration of the OSD messages in ms (default: 1000)
  • --osd-msg1="room: 1 – 0       audio: q, w, e - Native, Translated 1, Translated 2       video: y, x - HD, Slides"
    • show this string as message on OSD with OSD level 1 (visible by default)
    • used as minimal manual
  • --no-osd-bar
    • disable display of the OSD bar while seeking
  • --osd-font-size=30
    • specify the OSD font size (default: 55)
  • --osd-spacing=1
    • horizontal OSD font spacing in scaled pixels (default: 0)
  • --osd-border-size=1
    • size of the OSD font border in scaled pixels (default: 3)
  • --osd-margin-x=10
    • left and right screen margin for the OSD in scaled pixels
  • --osd-margin-y=4
    • top and bottom screen margin for the OSD in scaled pixels