henine
/
wubloader
mirror of https://github.com/ekimekim/wubloader
1
0
Fork 0
Code Issues Releases Wiki Activity
495 Commits
34 Branches
0 Tags
19 MiB
Python 63.5%
JavaScript 18.8%
Jsonnet 8.4%
HTML 3.8%
Dockerfile 1.7%
Other 3.8%
 
 
 
 
 
 
Go to file
Mike Lang 4d5157cdb5 Fix a mistake with allowing reuse of name in @timed()
backfiller backfiller: Only run one manager, not one per channel
common Fix a mistake with allowing reuse of name in @timed()
cutter cutter: Fix lack of info in error handling
db_scripts stupid copying things into docker
downloader downloader: Make a few things quieter for non-important channels
monitoring Provide a rendered version of the dashboard
nginx nginx: Serve the segments directly from the segments dir
postgres database, sheetsync: Add worksheet name column 'sheet_name'
restreamer Merge pull request from ekimekim/mike/build-improvements
segment_coverage Refactor dockerfiles for more shared layers
sheetsync Refactor dockerfiles for more shared layers
thrimbletrimmer Merge pull request from ekimekim/mike/thrimbletrimmer/cancel-upload
thrimshim Merge pull request from ekimekim/mike/build-improvements
.gitignore Add some existing scripts for setting up prometheus
.travis.yml travis.yml: Make script into individual lines
DATABASE.md database, sheetsync: Add worksheet name column 'sheet_name'
INSTALL.md updated INSTALL.md
LICENSE Update LICENSE
README.md Update documentation to reflect recent changes
SecurityModel.md Update SecurityModel.md
build Default to using the current commit, instead of latest
docker-compose.jsonnet docker-compose: Wrap DSN values in quotes so spaces are allowed
generate-docker-compose Default to using the current commit, instead of latest
generate-flamegraph generate-flamegraph: Script to create a flamegraph by querying prometheus
get-build-tag Default to using the current commit, instead of latest
initial-design-doc.pdf Add initial design doc

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.