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 8ccb6a6e60 pubbot: Post prize names 2 days ago
.github/workflows Use cache in readonly mode for PRs in forked repos 2 weeks ago
api_ping upgrade to alpine 3.19 5 days ago
backfiller upgrade to alpine 3.19 5 days ago
bus_analyzer Bug fixed 4 days ago
buscribe Update buscribe/buscribe/buscribe.py 5 days ago
buscribe-web rename buscribe-api to buscribe_api 3 weeks ago
buscribe_api upgrade to alpine 3.19 5 days ago
chat_archiver upgrade to alpine 3.19 5 days ago
common Make ensure_directory() work with paths with no directory component 3 days ago
cutter Fix wrong variable names in archive cutting 3 days ago
db_scripts use a UTC timestamp 5 years ago
downloader upgrade to alpine 3.19 5 days ago
graphs corrected shift names 1 year ago
monitoring grafana: Disable analytics 1 year ago
nginx nginx: buscribe_api, like thrimshim, should be forwarded to 3 weeks ago
playlist_manager upgrade to alpine 3.19 5 days ago
postgres Fix modifying manually-uploaded links 3 days ago
restreamer upgrade to alpine 3.19 5 days ago
segment_coverage upgrade to alpine 3.19 5 days ago
sheetsync upgrade to alpine 3.19 5 days ago
thrimbletrimmer drive clock: Avoid using "sky" tag ids as uBO blocks them 2 days ago
thrimshim thrimshim: Read template attribution, not description 4 days ago
zulip_bots pubbot: Post prize names 2 days ago
.gitignore improve gitignore for local python installs 1 year ago
.gitmodules chat-archiver: Early work and basic archival 2 years ago
.prettierrc.yaml Auto-format JS files with prettier 3 years ago
.travis.yml Add ability to explicitly pull and re-use layers from other commits when building 5 years ago
DATABASE.md Make video transition durations floats, not intervals 3 months ago
INSTALL.md Fix all old references to github.com/ekimekim/wubloader 1 year ago
LICENSE Update LICENSE 5 years ago
README.md Update k8s.jsonnet file to support 2023 changes to images 12 months ago
SecurityModel.md Update SecurityModel.md 5 years ago
build Refactor build script to actually have a working cache using buildah 2 weeks ago
docker-compose.jsonnet prizebot fixes 2 days 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
k8s.jsonnet Proper example for edit_url 12 months ago
playlist-audit playlist-audit: Script to help with playlist auditing 2 weeks 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.
  • 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.