Skip to main content

Soundcraft Notepad control utilities

Project description

Linux Utilities for Soundcraft Mixers

Soundcraft Notepad mixers are pretty nice small-sized mixer boards with Harmon USB I/O built-in. While the USB audio works great in alsa without any additional configuration needed, there are some advanced features available to the Windows driver that have no Linux equivalent. Most importantly, the USB routing for the capture channels is software-controlled, and requires an additional utility. For example, by default the Notepad-12FX sends inputs 3 and 4 to USB capture channels 3 and 4, but can be changed to input 5&6, input 7&8, or the Master L&R outputs. This tool aims to give this same software control of the USB capture channel routing to Linux users.

Supported models:

  • Notepad-12FX


The dbus service relies on PyGObject which is not available via pypi without a lot of dev libraries for it to compile against. It is usually easier to install separately using your distribution's package installation tools. Under Ubuntu, the following should work:

sudo apt install python3-gi


Install from pip:

sudo pip install soundcraft-utils

It is not recommended to use --user mode and install this system-wide so that the dbus service auto-start can reliably find the right python libs.

Set up the DBUS service so it can access the system bus and be auto-started on demand:

sudo soundcraft_dbus_service --setup

The dbus service will run as root, providing access to the underlying USB device so the soundcraft_ctl user-facing part can be run by an unprivileged account.





List possible channel routing choices:

soundcraft_ctl [--no-dbus] -l

Set channel routing:

soundcraft_ctl [--no-dbus] -s <number>

When using the --no-dbus, write access to the underling USB device is required. Normally only root can do this, unless you've added some custom udev rules.


  • Polkit restrictions on the dbus service
  • Multiple device support
  • Add additional model support
    • Notepad-8FX should be easy, once I know what the USB idProduct field is (plus I'd need help from someone with a Notepad-8FX for testing)
    • Notepad-5 likewise, same constraints
  • Auto-duck feature
  • Firmware upgrade

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for soundcraft-utils, version 0.3.0
Filename, size File type Python version Upload date Hashes
Filename, size soundcraft_utils-0.3.0-py3-none-any.whl (12.3 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size soundcraft-utils-0.3.0.tar.gz (10.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page