Skip to main content

Exposes the audio levels of a stream to Prometheus

Project description


Monitors an RTMP stream and reports the audio levels to Prometheus


Installing from source is done as follows

python3 install


Production Install

Helios is available from PyPi as helios-monitor. It can be installed using

sudo apt install ffmpeg
pip install helios-monitor

Helios exposes a Prometheus metrics endpoint with the volume of the stream that can be scraped.

Helios can then be run using

helios <stream_url>

Development Install

When developing Helios, it is useful to use a virtual environment to avoid poluting your desktop with unnecessary libraries. This is done using VirtualEnv.

Once VirtualEnv is installed, fork, clone the repo and create a virtual environment:

sudo apt install ffmpeg
git clone
cd helios
virtualenv -p python3 pyenv
pyenv/bin/pip install -e .

Then the project can be edited and finally run as follows:

pyenv/bin/helios <stream url>

Project details

Download files

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

Source Distribution

helios-monitor-2.0.1.tar.gz (16.5 kB view hashes)

Uploaded source

Built Distribution

helios_monitor-2.0.1-py3-none-any.whl (17.1 kB view hashes)

Uploaded py3

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