Go to file
Christopher Usher a1880b2414 fixes based on ekim's suggestions
backfiller started on the segment_coverage service
common Merge pull request from ekimekim/mike/fixes
cutter Add title and description header/footer in thrimshim instead of cutter
db_scripts stupid copying things into docker
downloader fix a few remaining usages of StreamWorker.stream instead of .quality
monitoring Provide a rendered version of the dashboard
nginx nginx: Nicer formatting for thrimbletrimmer part of config
postgres database, sheetsync: Add worksheet name column 'sheet_name'
restreamer restreamer: Add option to download full cut instead of fast cut
segment_coverage fixes based on ekim's suggestions
sheetsync database, sheetsync: Add worksheet name column 'sheet_name'
thrimbletrimmer thrimbletrimmer: Display edit notes below the video
thrimshim Add /defaults to thrimshim, use it to populate config stuff in thrimbletrimmer
.gitignore Add some existing scripts for setting up prometheus
.travis.yml
DATABASE.md database, sheetsync: Add worksheet name column 'sheet_name'
INSTALL.md changed it back so only the name is checked
LICENSE Update LICENSE
README.md Update readme
SecurityModel.md Update SecurityModel.md
build fixes in response to ekim's comments
docker-compose.jsonnet added coverage to docker-compose
generate-docker-compose
generate-flamegraph
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
  • sheetsync syncs specifc database columns to a google doc which is the primary operator interface.
  • thrimshim acts as an interface between the thrimbletrimmer editor and the database.
  • thrimbletrimmer is a browser based video editor.
  • database hosts a Postgres database to store events to be edited.
  • nginx provides a webserver through which the other components are exposed to the outside world.
  • common provides code shared between the other components.
  • monitoring provides dashboards to allow the wubloader to be monitored.

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.

Further details of installing and configuring the backfiller are provided in INSTALL.md.