mf-cli

mf-cli is a lightweight Linux command-line utility and kernel module written in Rust and C for controlling hardware features of the Arturia MiniFuse 1/2 audio interface. It allows you to toggle hardware settings that are normally only accessible via the proprietary "MiniFuse Control Center" software on Windows or macOS.

By default, manipulating USB interfaces from userspace interrupts the active audio stream. mf-cli ships with a custom DKMS kernel module that perfectly integrates with the Linux kernel to send commands to the device seamlessly, without any audio dropouts!

Key Features

• Phantom Power (+48V)
• Direct Mono
• Instrument Mode (INST)
• Seamless control without audio interruption (via DKMS kernel module)
• Non-Sudo Operation (both native and via fallback)
• Chain multiple commands at once

⚠️ Important Note on Secure Boot

To achieve seamless, interruption-free audio toggling, this tool utilizes a custom DKMS kernel module. If you have Secure Boot enabled in your BIOS, the Linux kernel will block this unsigned module from loading.

You will either need to disable Secure Boot or sign the DKMS module with your own Machine Owner Key (MOK). If the module cannot be loaded, mf-cli will gracefully fall back to standard userspace USB commands (which may cause a brief interruption to your audio stream).

Installation

Arch Linux (AUR) - Recommended

The AUR package automatically builds both the CLI tool and the DKMS kernel module. Install using your favorite AUR helper:

yay -S mf-cli

Manual build

Ensure you have cargo, libusb, systemd-libs, make, and your system's Linux kernel headers installed.

1. Build the Rust CLI:

git clone https://github.com/nolight132/mf-cli
cd mf-cli
cargo build --release
sudo cp target/release/mf-cli /usr/bin/

2. Build the seamless Kernel Module (Optional, but highly recommended):

cd kmod
make
sudo make install
sudo modprobe minifuse_mod

Configuration (Permissions)

mf-cli is designed to be used without sudo.

• If using the kernel module: No configuration is required! The module automatically creates a character device at /dev/minifuse_cmd with the proper permissions.
• If using the userspace fallback (no kernel module): You must install the provided udev rule to avoid permission denied errors. (The AUR package does this automatically). If installing manually:

1. Copy 99-minifuse.rules to /etc/udev/rules.d/.

2. Reload rules:

sudo udevadm control --reload-rules && sudo udevadm trigger

Usage

The syntax is straightforward: mf-cli <target> <on|off>[<target> <on|off> ...]

mf-cli will automatically detect if the kernel module is loaded. If it is, it will route commands seamlessly. If not, it will print a warning and fall back to userspace USB control.

Examples:

Toggle Phantom +48V Power

mf-cli 48v on
mf-cli 48v off

Toggle Direct Monitoring Mono:

mf-cli monitor on
mf-cli monitor off

Toggle Instrument Mode:

mf-cli inst on
mf-cli inst off

Chain Multiple Commands:

mf-cli inst on 48v on monitor off

License

This project consists of two components, which are licensed separately to comply with Linux kernel standards:

• The Rust CLI utility (userspace code) is licensed under the MIT License.
• The Linux Kernel Module (kmod/ directory) is licensed under the GNU General Public License v2.0 (GPL-2.0).