volux 0.8.14

Audio Control Interface

[](https://pypi.python.org/pypi/volux/)
[](https://GitHub.com/DrTexxOfficial/volux/releases/)
[](https://github.com/DrTexxOfficial/volux/blob/master/LICENSE)
[](https://GitHub.com/DrTexxOfficial/volux/releases/)
[](#)

Table of contents
=================
<!--ts-->
* [Volux](#volux)
* [Purpose](#purpose)
* [What does it do?](#what-does-it-do)
* [What <em>will</em> it do?](#what-will-it-do)
* [Screenshots](#screenshots)
* [Supported platforms](#supported-platforms)
* [Installation](#installation)
* [Requirements](#requirements)
* [Install via pip](#install-via-pip)
* [Install via wheel (.whl)](#install-via-wheel-whl)
* [Build from source](#build-from-source)
* [Using Volux](#using-volux)
* [Modes](#modes)
* [Volume/brightness](#volumebrightness)
* [Exit](#exit)
* [Issues and bugs](#issues-and-bugs)
<!--te-->
_( generated by [gh-md-toc](https://github.com/ekalinin/github-markdown-toc) )_

# Volux
| BRANCH | BUILD | COVERAGE | REQUIREMENTS | ISSUES | OPEN PRs |
| --- | --- | --- | --- | --- | --- |
| Master | [](https://travis-ci.org/DrTexxOfficial/volux) | [](https://codecov.io/gh/DrTexxOfficial/volux) | [](https://requires.io/github/DrTexxOfficial/volux/requirements/?branch=master) | [](https://GitHub.com/DrTexxOfficial/volux/issues/) | [](https://GitHub.com/DrTexxOfficial/volux/pull/) |
| Develop | [](https://travis-ci.org/DrTexxOfficial/volux) | [](https://codecov.io/gh/DrTexxOfficial/volux) | [](https://requires.io/github/DrTexxOfficial/volux/requirements/?branch=develop)


## Purpose
Volux is an application written in Python 3 aimed at media powerusers.

### What does it do?
Volux allows you to perform many media operations quickly using just your mouse/touchpad.

All interactions are registered when hovering over the Volux bar on your screen.

- Increase/decrease volume using scroll
- Mute/unmute using middle-click

### What _will_ it do?
Features in development / planned for development
- Brightness control via mouse wheel
- Interface customisation

### Screenshots

| Mode | State | Image |
| :---: | :---: | :---: |
| Volume (active) | active | <img src="docs/volume-active.jpg"/> |
| Volume (inactive) | inactive | <img src="docs/volume-inactive.jpg"/> |
| Mute (active) | active | <img src="docs/mute-active.jpg"/> |
| Brightness (active) | active | <img src="docs/brightness-active.jpg"/> |

### Supported platforms

<img src="docs/Platform_Windows.svg" width="14pt"/>&nbsp;&nbsp; Windows 7 or later

<img src="docs/Platform_Mac.svg" width="14pt"/>&nbsp;&nbsp; MacOS _(WIP)_

<img src="docs/Platform_Linux.svg" width="14pt"/>&nbsp;&nbsp; Linux (most distributions)

## Installation
### Requirements
| Platform | External Requirements |
| --- | --- |
| Windows | _no external requirements_ |
| Darwin (MacOS) | _no external requirements_ |
| Linux | ```$ sudo apt-get install python3-tk python3-xlib python3-dbus libasound2-dev``` |

### Installation
| Installation Method | Command/s |
| --- | --- |
| pip (as user) ***recommended!*** | ```$ pip3 install volux --user``` |
| pip (as root) | ```$ sudo pip3 install volux``` |
| wheel (.whl) (as user) | ```$ pip3 install volux-*-py3-none-any.whl --user``` |
| wheel (.whl) (as root) | ```$ sudo pip3 install volux-*-py3-none-any.whl``` |

_note: Under some linux distros all references to 'pip' must be replaced with 'pip3'. Debian is an example of this. This is often the case to prevent confusion between Python 2.7.x interpreters and Python 3.x interpreters_

### Build from source
Clone this repository:

$ git clone https://github.com/DrTexxOfficial/volux.git

Install pip requirements:

$ cd volux
$ pip3 install -r requirements.txt --user

Build:

$ python3 setup.py bdist_wheel

## Using Volux
All interactions with Volux are only valid when hovering over the bar Volux produces. This allows you to interact with Volux without loosing your ability to use your scroll bar in other applications.

### Modes
To cycle between modes in Volux, right-click the main bar. By default, a green bar signifies volume mode and a blue bar signifies brightness mode (wip).

### Volume/brightness
While in volume or brightness mode, scroll up/down to increase/decrease volume or brightness while hovering over the main bar.

### Exit
To exit Volux, double right-click the bar at any time.

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

- Your OS
- Your desktop environment (if using Linux)
- Your python version
- A Summary of issues experienced
- Any relevant screenshot/s

Volux is developed under Debian 9 Stretch (Linux) using GNOME 3.22.2 and Python 3.5. Providing you've correctly installed all dependencies, Volux is almost guranteed to work under these conditions.

Additional testing has been done under these conditions:

| Architecture | Operating System | Desktop Env | Python | Status | Notes |
| --- | --- | --- | --- | --- | --- |
| 64 bit | Debian 9 Stretch | Gnome 3.22.2 | 3.5 | Working | Development conditions |
| 64 bit | Ubuntu _ver=?_ | Gnome _ver=?_ | 3.6 | Working | |
| 64 bit | Windows 10 | N/A | 3.7 | Working | Reimplementation successful! |
| 64 bit | Mac OS | N/A | 3.x | Broken | Dependencies missing |

<br/>

[](https://www.python.org/)