Go to file
Christopher Usher b4ce8fdbb6 Update INSTALL.md
backfiller fixes based on ekimekims suggestions
common moved flask monitoring to its own module
cutter transcode checker: longer retry while waiting for videos to finish
downloader fix a few remaining usages of StreamWorker.stream instead of .quality
monitoring fix dashboards for channel/quality naming
nginx Fix nginx when some services are disabled
restreamer moved flask monitoring to its own module
sheetsync sheetsync: Log more information on HTTPError
thrimshim moved flask monitoring to its own module
.gitignore Add some existing scripts for setting up prometheus
.travis.yml travis.yml: Make script into individual lines
DATABASE.md database: Add constraints on edit inputs that they must be non-NULL if state != UNEDITED
INSTALL.md Update INSTALL.md
LICENSE Licence under MIT
README.md Set up a docker compose file to run all images
build Add nginx service that provides a frontend to all the other services
docker-compose.jsonnet typo in a comment
generate-docker-compose generate-docker-compose: Clean up the container afterwards
generate-flamegraph generate-flamegraph: Script to create a flamegraph by querying prometheus
initial-design-doc.pdf Add initial design doc

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.