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
Christopher Usher 1dbe585837 retry database connection if it fails 5 years ago
backfiller logging fix 5 years ago
common comments 5 years ago
cutter retry database connection if it fails 5 years ago
db_scripts moving stuff around 5 years ago
downloader fix a few remaining usages of StreamWorker.stream instead of .quality 5 years ago
monitoring fix dashboards for channel/quality naming 5 years ago
nginx Fix nginx when some services are disabled 5 years ago
postgres allow nodes and editors to be read from csv files on start up 5 years ago
restreamer moved flask monitoring to its own module 5 years ago
sheetsync retry database connection if it fails 5 years ago
thrimshim retry database connection if it fails 5 years ago
.gitignore Add some existing scripts for setting up prometheus 5 years ago
.travis.yml travis.yml: Make script into individual lines 6 years ago
DATABASE.md database: Add constraints on edit inputs that they must be non-NULL if state != UNEDITED 5 years ago
INSTALL.md allow nodes and editors to be read from csv files on start up 5 years ago
LICENSE Licence under MIT 6 years ago
README.md Update readme 5 years ago
build Add nginx service that provides a frontend to all the other services 5 years ago
docker-compose.jsonnet allow nodes and editors to be read from csv files on start up 5 years ago
generate-docker-compose generate-docker-compose: Clean up the container afterwards 6 years ago
generate-flamegraph generate-flamegraph: Script to create a flamegraph by querying prometheus 6 years ago
initial-design-doc.pdf Add initial design doc 6 years ago

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 editor (assumed to be the Thrimbletrimmer) and the database.
  • 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.