跨平台 M8 跟踪器无头客户端
m8c is a remote display client for the Dirtywave M8 Tracker. It mirrors the M8’s display, enables keyboard/gamepad control, and can route audio to your computer—useful for recording, streaming, larger screens, or alternative input methods. The application is cross‑platform and can be built on Linux, Windows (MSYS2/MINGW64), and macOS.
The Dirtywave M8 Tracker is a portable sequencer and synthesizer featuring eight tracks of assignable instruments (using engines like FM, waveform synthesis, virtual analog, sample playback, and MIDI output). It is inspired by the Game Boy tracker Little Sound DJ.
m8c works with the M8 hardware over USB. It also supports the M8 Headless firmware running on a Teensy microcontroller. If you enjoy the M8 and its tracker workflow, please support Dirtywave by purchasing the hardware. You can check availability here. You can also support the creator, Trash80 via Patreon.
Many thanks to:
There are prebuilt binaries available in the releases section for Windows.
When running the program for the first time on Windows, Windows Defender may show a warning about an unrecognized app. Click "More info" and then "Run anyway" to proceed.
There are prebuilt binaries available in the releases section for recent versions of macOS.
There are packages available for NixOS, an AppImage for easy installation, or you can build the program from source.
An AppImage is available for Linux in the releases section. To use it:
.AppImage file from the releaseschmod +x m8c-*.AppImage./m8c-*.AppImageThe AppImage is portable and doesn't require installation—it can be run directly from the file.
nix-env -iA m8c -f https://github.com/laamaa/m8c/archive/refs/heads/main.tar.gzOr if you're using flakes and the nix command, you can run the app directly with:
nix run github:laamaa/m8cYou will need git, gcc, pkg-config, make and the development headers for SDL3 and libserialport.
For Ubuntu 25.04 and later, SDL3 packages are available in the official repositories:
sudo apt update && sudo apt install -y git gcc pkg-config make libserialport-dev libsdl3-devFor older Ubuntu versions, there is no official SDL3 package yet in the Ubuntu repositories. You'll likely need to build the library yourself. https://github.com/libsdl-org/SDL/blob/main/docs/README-cmake.md#building-sdl-on-unix
This assumes you have MSYS2 installed:
pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-pkg-config mingw-w64-x86_64-make mingw-w64-x86_64-SDL3 mingw-w64-x86_64-libserialportThis assumes you have installed brew
brew update && brew install git gcc make sdl3 libserialport pkg-configmkdir code && cd code
git clone https://github.com/laamaa/m8c.gitcd m8c
makeConnect the M8 or Teensy (with headless firmware) to your computer and start the program. It should automatically detect your device.
./m8cIf the stars are aligned correctly, you should see the M8 screen.
When you have multiple M8 devices connected, and you want to choose a specific one or launch m8c multiple times, you can get the list of devices by running
./m8c --listExample output:
2024-02-25 18:39:27.806 m8c[99838:4295527] INFO: Found M8 device: /dev/cu.usbmodem124709801
2024-02-25 18:39:27.807 m8c[99838:4295527] INFO: Found M8 device: /dev/cu.usbmodem121136001You can specify the preferred device by using the --dev option:
./m8c --dev /dev/cu.usbmodem124709801Note: The --dev option can force detection of any serial device by name. This is useful if libserialport cannot
get the correct USB identifiers, like on some Windows 11 setups, for example. You may need to look up the correct device
name from Device Manager, if --list does not give you any results, for example.
Default keys for controlling the program:
Additional controls:
Keyjazz allows entering notes with a keyboard, old school tracker-style. The layout is two octaves, starting from keys Z and Q. When keyjazz is active, regular a/s/z/x keys are disabled. The base octave can be adjusted with numpad star/divide keys and the velocity can be set
The program uses SDL's game controller system, which should make it work automatically with most gamepads. On startup,
the program tries to load a SDL game controller database named gamecontrollerdb.txt from the same directory as the
config file. If your joypad doesn't work out of the box, you might need to create custom bindings to this file,
with SDL2 Gamepad Tool, for example.
To configure your gamepad:
gamecontrollerdb.txtconfig.ini filem8c supports audio routing from the M8 device to your computer's audio output.
key_toggle_audio in configaudio_buffer_size in config (0 = SDL default)audio_device_name in config for specific device selectionYou can change the most common options without editing config.ini using the in-app settings overlay.
Changes take effect immediately; use Save if you want them persisted to disk.
Application settings and keyboard/game controller bindings can be configured via config.ini.
The keyboard configuration uses SDL Scancodes, a reference list can be found at https://wiki.libsdl.org/SDL2/SDLScancodeLookup
If the file does not exist, it will be created in one of these locations:
C:\Users\\AppData\Roaming\m8c\config.ini/home//.local/share/m8c/config.ini/Users//Library/Application Support/m8c/config.iniYou can choose to load an alternate configuration with the --config command line option. Example:
m8c --config alternate_config.iniThis looks for a config file with the given name in the same directory as the default config. If you specify a config file that does not exist, a new default config file with the specified name will be created, which you can then edit.
An in-app log overlay is available for platforms where reading console output is inconvenient.
config.ini under [keyboard] using
key_toggle_log=.SDL_Log* messages.Enjoy making some nice music!
$ ./m8c
INFO: Looking for USB serial devices.
INFO: Found M8 in /dev/ttyACM1.
INFO: Opening port.
ERROR: Error: Failed: Permission deniedThis is likely caused because the user running m8c does not have permission to use the serial port. The easiest way to fix this is to add the current user to a group with permission to use the serial port.
On Linux systems, look at the permissions on the serial port shown on the line that says "Found M8 in":
$ ls -la /dev/ttyACM1
crw-rw---- 1 root dialout 166, 0 Jan 8 14:51 /dev/ttyACM0In this case the serial port is owned by the user 'root' and the group 'dialout'. Both the user and the group have read/write permissions. To add a user to the group, run this command, replacing 'dialout' with the group shown on your own system:
sudo adduser $USER dialoutYou may need to log out and back in or even fully reboot the system for this change to take effect, but this will hopefully fix the problem.
Some distributions have also had conflicts with the kernel version and libserialport packaging, please see this issue for more details.
--list to see detected devices暂无开放 Issues,或尚未同步最近议题。