Skip to content

v1.8.0

Choose a tag to compare

@github-actions github-actions released this 07 Apr 15:04
· 98 commits to main since this release

Stable Release

What's New

  • Support for MIDI Captain ONE and DUO (#87)
  • Fix MIDI channel regression in v1.7.0 (#95, #71)
  • Update deploy.ps1 to match features of deploy.sh
  • Fix link to Helmut Keller's site https://www.helmutkelleraudio.de/
  • Add caching to speed up CI builds
  • Create a "complete" download artifact with firmware and GUI for all OSes

Full Changelog: v1.7.0...v1.8.0

First: Backup!

Before doing any of this, if you haven't already, please back up your existing config and firmware in a safe place for recovery or to revert to OEM firmware:

  1. Mount the device to your computer. You may have to hold down Button 1/0 to force it to mount.
  2. Copy all of the content to a safe place on your computer.

Installation

Download MIDI-Captain-MAX-v1.8.0-complete.zip from the Assets section below.

GUI Config Editor

The "complete" package contains installers for Mac and Windows. Use the appropriate installer for your OS.

MIDI Captain Firmware

  1. Connect your MIDI Captain via USB and power it on.
    • The device will mount as CIRCUITPY or MIDICAPTAIN.
    • If the drive mounts as read-only, hold switch 1 (top-left footswitch) while plugging in USB to enable write access.
  2. Extract the firmware.zip in the downloaded "complete" package.

Note: The scripts auto-detect your device type (STD10, Mini6, NANO4, DUO2, or ONE) and preserve your config.json unless you pass --fresh / -Fresh (Mac/Win)

macOS / Linux

Run the included deploy.sh script from the extracted zip folder:

# Quick update (preserves your existing config.json)
./deploy.sh

# First-time install — also installs required CircuitPython libraries
./deploy.sh --install

# Deploy and eject for a clean reload
./deploy.sh --eject

# Overwrite config.json with the default - resets your button mappings
./deploy.sh --fresh

# Deploy to a device with a custom drive name, see Custom Drive Names below
./deploy.sh /Volumes/<device-name> # Mac 
./deploy.sh /path/to/mount # Linux

Windows

Run the included deploy.ps1 script from the extracted zip folder in PowerShell:

# Quick update (preserves your existing config.json)
.\deploy.ps1

# First-time install — also installs required CircuitPython libraries
.\deploy.ps1 -Install

# Deploy and eject for a clean reload
.\deploy.ps1 -Eject

# Overwrite config.json with the default (resets your button mappings)
.\deploy.ps1 -Fresh

# Specify a drive letter manually, see Custom Drive Names below
.\deploy.ps1 -MountPoint E:\

Manual install (any platform)

  1. Open the extracted zip folder.
  2. Copy all files and folders to the device drive (CIRCUITPY or MIDICAPTAIN), replacing existing files.
    • If you have a custom config.json with your own button mappings, keep your existing one.
  3. First-time install on non-STD10: delete config.json on the device and rename config-<deviceType>.json to config.json.

Eject and reconnect the device to reload the firmware. If anything goes wrong, it's fully recoverable: mount the device, erase the contents, and copy your backed-up files back.