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 f193bd0f54 Re-write downloader to be resilient to failures as much as possible
This makes the code crazy complicated and messy, but means we can be persistent about
not giving up, while still retrying at the same time, and trying multiple urls at once
until we find one that works.

See docstrings for a full discussion on some of the failures we're trying to work around.
6 years ago
common common: Fix bugs and issues with bustime utils 6 years ago
downloader Re-write downloader to be resilient to failures as much as possible 6 years ago
.gitignore gitignore: ignore config file 6 years ago
README.md Fix readme internal link 6 years ago
build Add a simple build script to build docker images and a basic dockerfile 6 years ago
config.example.yaml common: Basic config and bustime code 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
  • 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.

Configuration

Configuration is built into the docker images, and set during build by specifying a YAML file config.yaml in the repository root directory.

See the provided example file for documentation of options.