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 f0d9aa82c2 Ignore segments that are marked as ads
* Checks for the SCTE35-OUT/SCTE35-IN marks in the HLS stream that indicate an ad start/end
* Ignores those segments completely
* Doesn't mark the StreamWorker as up until it sees the first non-ad segment

Some other operational notes:
* The main risk this adds is that re-connecting / refreshing master playlist takes longer.
  If all downloaders are doing this at the same time (ie. because the stream only just came up,
  or during a deployment rollout), all downloaders might be waiting for ads to finish and
  you'll miss segments.
* We should run more downloaders to compensate. This also increases the chance at least one of
  them won't get any ads, so we get everything right from stream-up.
* The other mitigation we can do is have geographically diverse downloaders. This decreases the risk
  that they all get served an ad, and at least at time of writing it seems that no in-stream ads
  are served outside of these regions:

> US, Canada, Germany, France, Sweden, Belgium, Poland, Norway, Finland, Denmark, Netherlands, Italy, Spain, Switzerland, Austria, Portugal, UK, Australia, New Zealand
6 years ago
backfiller Add stacksampler to all services 6 years ago
common get_best_segments: Let other things run 6 years ago
downloader Ignore segments that are marked as ads 6 years ago
restreamer restreamer: Use correct name for dateutil 6 years ago
.gitignore Set up a docker compose file to run all images 6 years ago
.travis.yml travis.yml: Make script into individual lines 6 years ago
DATABASE.md Updates to database states and columns 6 years ago
LICENSE Licence under MIT 6 years ago
README.md Set up a docker compose file to run all images 6 years ago
build Adding in stuff to hopefully get this to run 6 years ago
docker-compose.jsonnet Enable backdoor in all services, and add telnet to containers 6 years ago
generate-docker-compose generate-docker-compose: Clean up the container afterwards 6 years ago
generate-flamegraph generate-flamegraph: Script to create a flamegraph by querying prometheus 6 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
  • Sheet Sync syncs specifc database columns to a google doc which is the primary operator interface.

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.