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 c9f2e8e0a5 thrimbletrimmer: Preserve trim timings when re-loading playlist
Useful if you've already cut the start
but want to extend the range of times before cutting the end.
5 years ago
backfiller backfiller: Only run one manager, not one per channel 5 years ago
common Remove flask response size tracking 5 years ago
cutter youtube upload: Explicitly set mime type 5 years ago
db_scripts use a UTC timestamp 5 years ago
downloader downloader: Don't check the age of a worker we just spawned 5 years ago
monitoring prometheus: Add scheme to url 5 years ago
nginx nginx: SSL server should have same options as non-SSL 5 years ago
postgres Revert "Merge pull request #155 from ekimekim/mike/manual-uploads" 5 years ago
restreamer Disable mp4 option for restreamer cuts 5 years ago
segment_coverage segment_coverage: Reduce "no hours" warning to info 5 years ago
sheetsync sheetsync: Don't mis-parse blank as bad time 5 years ago
thrimbletrimmer thrimbletrimmer: Preserve trim timings when re-loading playlist 5 years ago
thrimshim Revert "Merge pull request #155 from ekimekim/mike/manual-uploads" 5 years ago
.gitignore Add some existing scripts for setting up prometheus 5 years ago
.travis.yml Add ability to explicitly pull and re-use layers from other commits when building 5 years ago
DATABASE.md Revert "Merge pull request #155 from ekimekim/mike/manual-uploads" 5 years ago
INSTALL.md Update database install instructions 5 years ago
LICENSE Update LICENSE 5 years ago
README.md Update documentation to reflect recent changes 5 years ago
SecurityModel.md Update SecurityModel.md 5 years ago
build Add ability to explicitly pull and re-use layers from other commits when building 5 years ago
docker-compose.jsonnet added a read only user to database setup script 5 years ago
generate-docker-compose replace readlink -f with realpath in build scripts 5 years ago
generate-flamegraph generate-flamegraph: Script to create a flamegraph by querying prometheus 6 years ago
get-build-tag replace readlink -f with realpath in build scripts 5 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 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.
  • 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.