💾 Get the current version of Volux over at 🦊 the GitLab repository here.
📢 This repository contains an unmaintained legacy version of the Volux project from 2019...
The latest version of Volux doesn't have any publicly released modules yet. This legacy repo is being left open so that you can give Volux a test and still play around with the modules available in the legacy version.
I'll announce public releases of modules on Twitter.
I'll provide links to public modules in the new GitLab repository.
Please feel free to ask me any other questions over on Twitter.
NEW REPOSITORY: https://gitlab.com/volux/volux
Volux is a high-level media/entertainment workflow automation platform.
Demo Video
Please note that pyaudio - a requirement of the voluxaudio module - does not support python versions above 3.6.9 on windows 10. Any version of Python 3.6.x should work fine.
PACKAGE | OPERATING SYSTEM | REQUIREMENTS |
---|---|---|
Volux | Any | Python 3.x.x * |
Volux Audio | Any | - Python 3.6.8 * - Portaudio19 * - Libasound2 * |
Volux Gui | Any | - Tkinter ** |
* may already be installed on your OS, only install if install fails
** normally installed by default with python 3
To install Volux, enter the following into your operating system's CLI
- Windows users, use powershell
- Mac/Linux users, use terminal *
* note for Linux users: install in a virtual environment to avoid heartache
PACKAGE | INSTALL COMMAND |
---|---|
Volux | pip install volux |
Volux Audio | pip install voluxaudio |
Volux Gui | pip install voluxgui |
Volux Light | pip install voluxlight |
Enter the following in your operating system's CLI
ACTION | COMMAND |
---|---|
Launch Volux | volux launch * |
List commands | volux --help |
* make sure voluxgui is installed first or you'll get an error!
For more information on how to use volux and how it works, check out the documentation here.
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.
These modules can read/write data of the associated aspects in coordination with each other to create seamless workflows.
See here.
- Import the framework + essentials
import volux
- Import modules for use
from voluxcliprint import VoluxCliPrint
from voluxaudio import VoluxAudio
from voluxGui import VoluxGui
- Create operator object
vlx = VoluxOperator()
- Load the modules into the operator
vlx.add_module(VoluxCliPrint())
vlx.add_module(VoluxAudio())
vlx.add_module(
VoluxGui(shared_modules=[vlx.audio,vlx.cli]),
req_permissions=[
volux.RequestNewConnection,
volux.RequestGetConnections,
volux.RequestStartSync
]
)
- Launch the GUI!
vlx.gui.init_window()
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.18 | Working | Development conditions |
64 bit | Ubuntu 18.04 | N/A | 3.5 | 0.9.17 | Working | CI Conditions |
64 bit | Ubuntu 18.04 | N/A | 3.6 | 0.9.17 | Working | CI Conditions |
64 bit | Ubuntu 18.04 | N/A | 3.7 | 0.9.17 | Working | CI Conditions |
64 bit | Ubuntu 18.04 | N/A | 3.8 | 0.9.17 | Working | CI Conditions |
64 bit | Windows 10 | N/A | 3.7.8 | 0.9.17 | Working | - |
64 bit | OSX 10.13.5 | N/A | 3.7.3 | 0.9.17 | Unsupported | Ironing out the creases |