Skip to main content

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 the Master L&R outputs to USB capture channels 3 and 4, but this routing can be changed to input 3&4, input 5&6, or input 7&8. This tool aims to give this same software control of the USB capture channel routing to Linux users.

Supported models:

  • Notepad-12FX
  • Notepad-8FX
  • Notepad-5

Prerequisites

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

Installation

Installation

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.

Upgrading

Simply update your package from pip, and rerun the 'setup' to ensure the dbus service is upgraded to the latest version:

sudo pip install -U soundcraft-utils
sudo soundcraft_dbus_service --setup

Uninstallation

You can remove the dbus and xdg files first by running the following as root:

sudo soundcraft_dbus_service --uninstall

Then remove the package with pip:

sudo pip uninstall soundcraft-utils

Prepared Packages

Arch Linux, Manjaro

soundcraft-utils are available in AUR:

yay -S soundcraft-utils

Usage

GUI

soundcraft_gui
  • Select the desired input using the up and down arrow keys or using the mouse
  • Apply the selection by clicking "Apply" (ALT+A)
  • Instead of applying the selection, clicking "Reset" (ALT+R) will set the selection back to the current state of the mixer (if known)

CLI

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.

TODO

  • Polkit restrictions on the dbus service
  • Multiple device support
  • Auto-duck feature
  • Firmware upgrade

Metadata

Release files for soundcraft-utils 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for soundcraft-utils 0.4.0
File Size Uploaded Provenance Actions
soundcraft-utils-0.4.0.tar.gz 27.0 kB Without provenance Details for soundcraft-utils-0.4.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for soundcraft-utils 0.4.0
File Interpreter ABI Platform Actions
soundcraft_utils-0.4.0-py3-none-any.whl Python 3 none any Details for soundcraft_utils-0.4.0-py3-none-any.whl

Total release size: 54.8 kB

Release files / soundcraft-utils-0.4.0.tar.gz

Download URL soundcraft-utils-0.4.0.tar.gz
Size 27.0 kB
Tags Source
SHA-256 checksum
How to use checksums
772a217b986eca88fb6688b131b03da313c2d8cc9777a06132da0c29e8d6bd3e
BLAKE2b-256 checksum
How to use checksums
84551b0dfc5080cfdbff9e97b81024c4c5bc84b999f0f3257a685324c69716e8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.5

Release files / soundcraft_utils-0.4.0-py3-none-any.whl

Download URL soundcraft_utils-0.4.0-py3-none-any.whl
Size 27.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c2c008aab1b1187f7b648a40c2aeb2a4b085cda81a79765fd12022036085fede
BLAKE2b-256 checksum
How to use checksums
520bf83978bd622997a2286abd30b4ddfcb2164c6b59cb68d00b91f1722a6141
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.5

Security for soundcraft-utils 0.4.0

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page