A Python application that allows you to control your computer's master volume using the Behringer X-Touch Mini MIDI controller. This app specifically maps the volume slider on layer A (controller 9 on MIDI channel 11) to adjust system volume.
- Control system volume directly from your Behringer X-Touch Mini
- System tray integration for easy access
- Keyboard shortcuts for quick connection/disconnection
- Automatic connection to the X-Touch Mini
- Visual feedback on volume changes
- Python 3.6+
- Behringer X-Touch Mini MIDI controller
- Required Python packages:
- mido
- pycaw
- comtypes
- keyboard
- pystray
- Pillow (PIL)
- Make sure you have Python installed on your system
- Install the required packages:
pip install mido python-rtmidi pycaw comtypes keyboard pystray pillow
- Download or clone this repository to your local machine
To make the application start automatically when Windows boots:
- Press
Win + R
and typeshell:startup
to open the Windows Startup folder - Right-click in the folder and select "New > Shortcut"
- For the location, enter the following command:
pythonw.exe "[PATH_TO_YOUR_SCRIPT]\midi.py"
- Replace
[PATH_TO_YOUR_SCRIPT]
with the actual path to where you saved the midi.py file
- Replace
If the shortcut doesn't work without specifying the full path to pythonw.exe:
- Open Command Prompt and type:
where pythonw
- This will show the full path to pythonw.exe on your system
- Use the full path in your shortcut:
C:\Path\To\Your\pythonw.exe "[PATH_TO_YOUR_SCRIPT]\midi.py"
pythonw.exe
runs Python scripts without showing a console window- This allows the application to run silently in the background
- Only the system tray icon will be visible, providing a cleaner user experience
- The application will still function normally and can be controlled via the system tray icon
- Connect your Behringer X-Touch Mini to your computer via USB
- Run the application:
python midi.py
- The application will start and appear in the system tray
- Use the volume slider on layer A of your X-Touch Mini to adjust system volume
- Right-click the system tray icon to access the application menu
- Ctrl+Page Up: Reconnect the X-Touch Mini
- Ctrl+Page Down: Disconnect the X-Touch Mini
This application is preconfigured to work with the X-Touch Mini in default mode:
- The volume slider on layer A (identified as controller 9 on channel 11 in MIDI)
- Make sure your X-Touch Mini is set to layer A for proper functionality
- No custom configuration is needed - the application works with the default X-Touch Mini settings
If you have trouble connecting to your X-Touch Mini:
- Make sure your X-Touch Mini is properly connected via USB
- Check if you need to install the X-Touch Mini drivers from Behringer's website
- Try running the program as administrator
- Check Windows Device Manager to see if the device is recognized
- Ensure no other application is using the X-Touch Mini MIDI device
- Try unplugging and reconnecting the X-Touch Mini
- Connected status: Shows whether the X-Touch Mini is currently connected
- Connect MIDI: Manually connect to the X-Touch Mini
- Disconnect MIDI: Manually disconnect from the X-Touch Mini
- Exit: Close the application
The application automatically connects to the first available MIDI device, assuming it's the X-Touch Mini. If you have multiple MIDI devices connected, you may need to modify the source code to select the correct device.
This project is licensed under the MIT License - see the LICENSE file for details.