Mutenix Host Application
Mutenix is a host application designed to translate the button presses of the hardware device into something usefull.
It consists of basically those parts
- HID Device Communication: General communication with the device
- Update: Updating the device firmware (via USB HID)
- Teams Websocket Communication: Connect with teams using the local api
- Virtual Keypad: Offers a virtual keypad to play around without the hardware.
Mutenix is ideal for software teams looking to enhance their project management and collaboration capabilities.
Tray Icon & Menu
![images/tray_icon.png]
- Open Virtual Macroboard: Opens a virtual Macroboard in the browser, same functionalities as the hardware one.
- Teams connected: Status information if teams connection has been established.
- Device connected: Status information if the device connection has been established.
- Help: Opens the help page in the browser.
- About: Opens the about page in the browser.
- Debug Options: Set some debug options persistent
- Activate Serial Console: Activates the serial console (Circuitpython)
- Deactivate Serial Console: Deactivates the serial console (Circuitpython)
- Enable Filesystem: Enables the filesystem. This cannot be undone using the tray icon. It has to be done by yourself on the filesystem. The file you need to alter is
debug_on.py. Reason for this is, that the device cannot mount the drive writeable the same time the host has it mounted.
- Quit: Quit Mutenix
Installation
The prefered way is to use uv. The packages tend to not work without hassle.
Executable
Download the executable here: Releases Run it.
Using uv
Get uv
uv tool mutenix
or
uvx mutenix
Command Line options
NB: Command line options may not work on the executable version.
--list-devices: lists HID devices--config <your config file>: Use that config file--update-file <firmware archive>: perform an update with that file
Configuration
Using the configuration file several things could be configured:
- actions of the buttons
- led states/colors
- virtual keypad binding (address and port)
- device identification to connect to
- logging
Mutenix tries to find a file called mutenix.yaml in the directory it is run from or $HOME/.config/. It it does not find one, it will create one in the current directory.
Please see Configuration.md.
Teams it not working
In teams the Third Pary API must be enabled.
Contributing
Setting up pre-commit hooks
To set up pre-commit hooks for this project, run the following commands:
pip install pre-commit
pre-commit install
pre-commit run --all-files
Links
1 maintainer
Metadata
1 maintainer
Release files for mutenix 0.7.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mutenix-0.7.0.tar.gz | 3.5 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mutenix-0.7.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 6.9 MB
Release files / mutenix-0.7.0.tar.gz
| Download URL | mutenix-0.7.0.tar.gz |
|---|---|
| Size | 3.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
00811839f4cab24d9f1e7141aa36fef10f445877cb3f5c110b2059c755ae4d19
|
|
BLAKE2b-256 checksum How to use checksums |
9e003afe41953800ea24041ea8062232908d7b4b42f0b2beff7b54c1504d595f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Feb 9, 2025.
Transparency logRelease files / mutenix-0.7.0-py3-none-any.whl
| Download URL | mutenix-0.7.0-py3-none-any.whl |
|---|---|
| Size | 3.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9d8d10c49ee8023802277cf7066e7e65412f148e025f3c8b8dbb95c829945e2b
|
|
BLAKE2b-256 checksum How to use checksums |
28970fd46a684015bb4503a7ec056096a61c87c164ca0ebf39dca3e877651a8e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Feb 9, 2025.
Transparency log
