Getting Started
Welcome to Mutenix! This guide will help you get started with your Mutenix macropad.
Frequently Asked Questions
How do I update the firmware?
What should I do if my macropad is not recognized?
If your macropad is not recognized, try the following troubleshooting steps:
- Ensure the USB cable is properly connected.
- Try connecting to a different USB port.
- Restart your computer and try again.
- Run Mutenix with
--list-devices
to see if the device is recognized. - If you find the device, add the device (PID, VID) to the configuration:
device_identifications
see here
Why is my macropad not working with Teams?
If your macropad is not working with Microsoft Teams, ensure that you have enabled third-party integration in the Teams settings:
- Open Microsoft Teams.
- Go to Settings.
- Select Permissions.
- Enable third-party integration.

Special Modes
You can enter special modes by holding specific buttons while plugging the device in:
- Enable Filesystem: Hold down button 1. Mutenix functionality will also be available.
- Enable Serial Console: Hold down button 2. Mutenix functionality will also be available.
- Force update mode: Hold down button 3.
- Jump to UF2 Bootloader Hold down button 4.
NB: Serial Console and Filesystem can be combined.
Manual Update
If you enable the filesystem, you can also perform a manual update by deleting all the .py files and copy the content of the folder of to the drive
Contact Support
If you need further assistance, please create a ticket on our GitHub Issues page.