You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Go to file
Mike Lang 9af7795f34 Add gevent.backdoor as an optional arg to all services
Backdoor allows the operator to telnet into the given port, and get a python shell
running inside the process, from which you can debug, modify state (eg. set the log level),
or whatever. This is extremely useful for debugging weird states that you encounter randomly
but can't easily reproduce, without restarting the process and needing to wait until it happens again.
6 years ago
backfiller Add gevent.backdoor as an optional arg to all services 6 years ago
common
downloader Add gevent.backdoor as an optional arg to all services 6 years ago
restreamer Add gevent.backdoor as an optional arg to all services 6 years ago
.gitignore
.travis.yml
LICENSE
README.md
build
docker-compose.jsonnet
generate-docker-compose
initial-design-doc.pdf

README.md

Wubloader is a system for saving, re-serving and cutting into videos of a target twitch (or probably other HLS, but some twitch specifics are assumed) stream.

It was designed to serve the needs of the Video Strike Team as part of Desert Bus For Hope.

A full design doc can be read at initial-design-doc.pdf, but a brief overview of the components:

  • Downloader grabs segments from twitch and saves them to disk
  • Restreamer serves segments from disk as well as playlist files allowing them to be streamed
  • Backfiller queries restreamers of other servers in order to pick up segments this server doesn't have already, ie. it replicates missing segments.
  • Cutter interacts with a database to perform cutting jobs
  • Sheet Sync syncs specifc database columns to a google doc which is the primary operator interface.

Usage

All components are built as docker images. Components which access the disk expect a shared directory mounted at /mnt.

A docker-compose file is provided to run all components. See docker-compose.jsonnet to set configuration options, then generate the compose file with ./generate-docker-compose. Then run docker-compose up.