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
Hubbe a1337b2d0a
Try updating buildah package
6 days ago
.github/workflows Try updating buildah package 6 days ago
api_ping
backfiller
bus_analyzer
buscribe
buscribe-web
buscribe_api Fixing pip installing wheels 1 week ago
chat_archiver
common Another typo fix 1 week ago
cutter
db_scripts
downloader
graphs
monitoring
nginx
playlist_manager
postgres Bug fixes and improvements in response to comments on the PR 1 week ago
restreamer
segment_coverage
sheetsync Added parser to default_template column 1 week ago
thrimbletrimmer Fix uploading a new thumbnail image when updating a thumbnail 7 days ago
thrimshim Fix name duplicate check to only run when the template name is changed 1 week ago
zulip_bots blogbot: can't hash strings 1 week ago
.gitignore
.gitmodules
.prettierrc.yaml
.travis.yml
DATABASE.md
INSTALL.md
LICENSE
README.md
SecurityModel.md
build TYPOS AGAIN 7 days ago
docker-compose.jsonnet Bug fixes and improvements in response to comments on the PR 1 week ago
generate-docker-compose
generate-flamegraph
get-build-tag
initial-design-doc.pdf
k8s.jsonnet
playlist-audit

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.
  • chat_archiver records twitch chat messages and merges them with records from other nodes.
  • 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 fully supports replication and editing nodes. Basic support for running the database and playlist_manager has been added, but not tested. See k8s.jsonnet for details.

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