Skip to main content

avbroadcast - republish media streams for mass consumption

Project description

https://img.shields.io/badge/Python-3.5,%203.6,%203.7,%203.8-green.svg https://img.shields.io/pypi/v/avbroadcast.svg https://img.shields.io/github/tag/media-toolbox/avbroadcast.svg

avbroadcast

About

avbroadcast republishes media streams for mass consumption. It is a wrapper around the fine ffmpeg and packager programs, so it is standing on the shoulders of giants.

Getting started

Install

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.

Usage

Ingest media stream:

avbroadcast ingest \
    --stream="rtmp://184.72.239.149/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

Altogether now:

avbroadcast io \
    --name="bigbuckbunny" \
    --stream="rtmp://184.72.239.149/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":

make build-docker-image

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 usage:

# 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'

Pre-flight check:

avbroadcast --version

Attach to running transcoder:

docker exec -it avb /bin/bash

Usage with tmux

avbroadcast ... --tmux --analyze

Attach to tmux:

tmux attach

Quit pipeline either by detaching from tmux:

CTRL+B, D

or exit each program individually by typing:

4x CTRL+C

In both cases, the Docker container will stop - and also self-destroy when running with --rm.

Project information

avbroadcast is released under the terms of the GNU AGPL 3.0 license. The code and documentation live on GitHub, the Python package is published to PyPI.

The software has been tested on Python 3.5 and Python 3.7.

Contributing

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.

License

This software is copyright (c) 2018-2019 The avbroadcast authors. All rights reserved.

It is and will always be free and open source software.

Use of the source code included here is governed by the GNU Affero General Public License and the European Union Public License.


Have fun!

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

avbroadcast-0.6.0.tar.gz (9.1 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page