44d0c0269a
The restreamer spends most of its time iterating through segments (parsing them, determining the best one for each start time) to serve large time ranges. Since this only depends on the list of filenames read from disk, we can cache it for a given hour as long as that list is identical. This is a little trickier than it sounds because best_segments_by_start is an iterator and in most cases it won't be fully consumed. So we introduce a `CachedIterator` abstraction that will both remember the previously yielded values, and keep track of the live iterator so it can be resumed again if a previous invocation only partially consumed it. This also has the nice side effect of merging simultaneous operations - if two requests come in for the same hour at the same time, they'll share one iterator and both consume the results as they come in. |
3 years ago | |
|---|---|---|
| .github/workflows | 3 years ago | |
| api_ping | 3 years ago | |
| backfiller | 3 years ago | |
| common | 3 years ago | |
| cutter | 3 years ago | |
| db_scripts | 5 years ago | |
| downloader | 3 years ago | |
| monitoring | 3 years ago | |
| nginx | 3 years ago | |
| playlist_manager | 3 years ago | |
| postgres | 3 years ago | |
| restreamer | 3 years ago | |
| segment_coverage | 3 years ago | |
| sheetsync | 3 years ago | |
| thrimbletrimmer | 3 years ago | |
| thrimshim | 3 years ago | |
| .gitignore | 6 years ago | |
| .prettierrc.yaml | 3 years ago | |
| .travis.yml | 5 years ago | |
| DATABASE.md | 3 years ago | |
| INSTALL.md | 4 years ago | |
| LICENSE | 5 years ago | |
| README.md | 4 years ago | |
| SecurityModel.md | 5 years ago | |
| build | 3 years ago | |
| docker-compose.jsonnet | 3 years ago | |
| generate-docker-compose | 5 years ago | |
| generate-flamegraph | 6 years ago | |
| get-build-tag | 5 years ago | |
| initial-design-doc.pdf | 6 years ago | |
| k8s.jsonnet | 3 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:
downloadergrabs segments from twitch and saves them to diskrestreamerserves segments from disk as well as playlist files allowing them to be streamedbackfillerqueries restreamers of other servers in order to pick up segments this server doesn't have already, ie. it replicates missing segments.cutterinteracts with a database to perform cutting jobssheetsyncsyncs specifc database columns to a google doc which is the primary operator interface.thrimshimacts as an interface between thethrimbletrimmereditor and the database.thrimbletrimmeris a browser based video editor.segment_coverageregularly checks whether there is complete segment coverage for each hour.playlist_manageradds videos to youtube playlists depending on tags.databasehosts a Postgres database to store events to be edited.nginxprovides a webserver through which the other components are exposed to the outside world.commonprovides code shared between the other components.monitoringprovides 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 supports replication nodes. See k8s.jsonnet for details.
Further details of installing and configuring the backfiller are provided in INSTALL.md.