avbroadcast - republish media streams for mass consumption
Please note some of its functionality is based on the new HTTP upload feature of Shaka Packager which is a work in progress. It is currently living in the http-upload branch and is being tracked at issue #149.
Please use the beta-build packager-linux for your own experiments, which is also available through the corresponding Docker baseline image.
If you know your way around Python, installing this software is really easy:
pip install avbroadcast
Please refer to the virtualenv page about further guidelines how to install and use this software.
Ingest media stream:
avbroadcast ingest \ --stream="rtmp://188.8.131.52/vod/mp4:bigbuckbunny_450.mp4?reuse=1" \ --base-port=50000 \ --verbose
Package using HLS and publish to HTTP server:
avbroadcast publish \ --name="bigbuckbunny" \ --base-port=50000 \ --target="http://localhost:6767/hls-live" \ --verbose
avbroadcast io \ --name="bigbuckbunny" \ --stream="rtmp://184.108.40.206/vod/mp4:bigbuckbunny_450.mp4?reuse=1" \ --target="http://localhost:6767/hls-live" \ --verbose
Watch output directory:
avbroadcast watch --path=/var/spool/hls-local
Usage with Docker
Build Docker image "mediatoolbox/avbroadcast:analyzer":
You might want to skip this step as Docker images are already available at https://hub.docker.com/r/mediatoolbox/avbroadcast
Make alias for easy access:
# Use avbroadcast shipped with Docker image. alias avbroadcast='docker run --name avb --interactive --tty --rm mediatoolbox/avbroadcast:analyzer avbroadcast' # Alternatively, use avbroadcast from working tree. alias avbroadcast='docker run --name avb --volume `pwd`:/avbroadcast --interactive --tty --rm mediatoolbox/avbroadcast:analyzer avbroadcast'
Attach to running transcoder:
docker exec --interactive --tty avb /bin/bash
Usage with tmux
avbroadcast ... --tmux --analyze
Attach to Docker container and tmux manager at once:
docker exec --interactive --tty avb tmux attach -t avb
Quit pipeline either by detaching from tmux:
or exit each program individually by typing:
In both cases, the Docker container will stop - and also self-destroy when running with --rm.
The software has been tested on Python 3.5 and Python 3.7.
If you’d like to contribute you’re most welcome! Spend some time taking a look around, locate a bug, design issue or spelling mistake and then send us a pull request or create an issue.
Thanks in advance for your efforts, we really appreciate any help or feedback.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size avbroadcast-0.8.0.tar.gz (10.7 kB)||File type Source||Python version None||Upload date||Hashes View|