Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

High-level media/entertainment workflow automation platform

Project description

PyPI Version GitHub release Documentation Status GitHub license Github all releases Platform: Windows,Mac,Linux


Master Build Status codecov Requirements Status GitHub issues GitHub pull-requests
Develop Build Status codecov Requirements Status


Volux is a high-level media/entertainment workflow automation platform.


Volux uses for it's documentation.

Read it here.

Getting Started


Install system requirements

OS Command
Debian 10 $ sudo apt install python3 python3-tk python3-dev python3-venv libasound2-dev portaudio19-dev

Install the latest stable build

$ pip3 install volux

List available commands

$ volux --help

Launch GUI (in alpha)

$ volux launch


Run the volume/light bar demo

$ volux demo bar

About volux

What does it do?

Volux operates using an Operator object and various instances of VoluxModule subclasses.

Each aspect of your media/entertainment setup is represented by it's own volux module.

The operator object acts as a hub for a standard method of communication between Volux modules added to it.

Official Modules

Module Aspect Controls
VoluxBar GUI Element display values, display colors, increase/decrease values, set values
VoluxDemoModule CLI messages set value, get value
VoluxDisplay Monitor get monitor size (wip)
VoluxLight LIFX bulb set color, set power, get color, get power
VoluxVolume Computer Volume set volume, get volume, set muted, get muted

These modules can read/write data of the associated aspects in coordiation with each other to create seamless workflows.

Installing from source

See here.

Demo script

See here

While hovering over the bar:

Bar color Action Result
any right-click change bar color
any double right-click exit volux
📗 green scroll up 🔉 increase volume
📗 green scroll down 🔉 decrease volume
📗 green middle-click 🔇 mute
🔴 red scroll up 🔉 increase volume
🔴 red scroll down 🔉 decrease volume
🔴 red middle-click 🔇 unmute
📘 blue scroll up 💡 increase bulb brightness
📘 blue scroll down 💡 decrease bulb brightness
📘 blue middle-click 💡 toggle bulb power

Features in development

  • Settings GUI
  • Interface customisation

Supported platforms

   Windows 7 or later

   MacOS (WIP)

   Linux (most distributions)

External Requirements

Platform External Requirements
Darwin (MacOS) $ brew install tcl-tk $ brew link tcl-tk --force

Issues and bugs

If you have any problems running Volux, please kindly post an issue to this repository. Issues can be solved much faster if you can provide:

  • Operating system
  • Desktop environment (if using Linux)
  • Python version
  • Summary of issues experienced
  • Relevant screenshot/s (if applicable)

Additional testing has been done under these conditions:

Archi. Operating System Desktop Env Python Verison Status Notes
64 bit Debian 10 Buster Gnome 3.30.2 3.7.3 0.9.4 Working Development conditions
64 bit Ubuntu 16.04 N/A 3.7 0.9.4 Working CI Conditions
64 bit Windows 10 N/A 3.7.3 0.9.4 Working
64 bit Windows 10 N/A 3.7.2 0.8.16 Working
64 bit OSX 10.13.5 N/A 3.7.3 0.8.16 Broken Ironing out the creases

forthebadge made-with-python

Acknowledgments of work | pencil icon

Project details

Download files

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

Files for volux, version 0.9.15
Filename, size File type Python version Upload date Hashes
Filename, size volux-0.9.15-py3-none-any.whl (51.7 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size volux-0.9.15.tar.gz (31.2 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page