Go to file
Mike Lang d37cca52c9 review: Avoid race conditions if called multiple times
By always using unique filepaths (except for the final result, which is written atomically)
we turn multiple simultanious calls into at worst wasted effort, instead of garbled results.
api_ping Add file and make as build dependencies
backfiller Add dependencies required to install psycopg2 from source
common wip:
cutter Add dependencies required to install psycopg2 from source
db_scripts use a UTC timestamp
downloader and get it working
monitoring overview.jsonnet: Use a template variable to allow restricting to certain nodes
nginx nginx: SSL server should have same options as non-SSL
playlist_manager Fix typo in making playlist manager case insensitive
postgres postgres: Changes to work with version 12
restreamer review: Avoid race conditions if called multiple times
segment_coverage segment_coverage: Raise default check interval to 5min
sheetsync Add dependencies required to install psycopg2 from source
thrimbletrimmer Change wording on edit submitted alert()
thrimshim Add an alternate manual upload mode specifically for youtube
.gitignore Add some existing scripts for setting up prometheus
.travis.yml Add ability to explicitly pull and re-use layers from other commits when building
DATABASE.md Add tags and video_tags database columns
INSTALL.md Add playlist manager to all the various other places
LICENSE Update LICENSE
README.md Add playlist manager to all the various other places
SecurityModel.md Update SecurityModel.md
build Add playlist manager to all the various other places
cut_races.py update for condor x2
cut_review.py Finish adapting cut_review for restreamer
docker-compose.jsonnet and get it working
downloader-simple Simple script for running downloader with correct args and given channels
generate-docker-compose replace readlink -f with realpath in build scripts
generate-flamegraph generate-flamegraph: Script to create a flamegraph by querying prometheus
get-build-tag replace readlink -f with realpath in build scripts
initial-design-doc.pdf Add initial design doc
k8s.jsonnet Actually fix serviceName for segment_coverage ingress
list_races.py list_races: don't crash if racers aren't set

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.
  • segment_coverage regularly checks whether there is complete segment coverage for each hour.
  • playlist_manager adds videos to youtube playlists depending on tags.
  • 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.

There is also a kubernetes-based option, but it is less configurable and only supports replication nodes. See k8s.jsonnet for details.

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