Skip to content

v1.7.0

Choose a tag to compare

@benjamindehli benjamindehli released this 14 Jun 17:18

microSAMPLER Editor / Librarian — v1.7.0

This release is all about getting started faster and connecting more reliably.
The USB dependencies are now bundled, so the only thing you install is Python 3, and the bridge recovers from more stuck-connection situations on its own.

Highlights

  • Only Python 3 to install
    • pyusb and libusb now ship with the app, so there's no more pip install or brew install step.
  • More reliable reconnects
    • the bridge now attempts a USB reset to recover a wedged connection before asking you to power-cycle the device.

Simpler setup — no pip, no Homebrew

pyusb (the USB library) and libusb (its native driver) used to be separate installs, a pip3 install pyusb and, on macOS, a brew install libusb.
Both are now bundled with the app (native-tools/vendor/), covering macOS (Intel + Apple Silicon), Linux (x86-64 + ARM64) and Windows (64-bit).
So a fresh machine only needs Python 3.8+ and you're ready to launch.

If you already have your own pyusb/libusb installed, those are used in preference, the bundled copies are just a fallback.
In particular a newer system libusb (e.g. brew install libusb) tends to be a bit more robust across repeated reconnects, so it's still worth having if you connect and
disconnect a lot.

More reliable device reconnects

The microSAMPLER occasionally leaves its USB connection in a stuck state after the bridge stops, previously the only fix was to power-cycle the unit.
The bridge now drains and retries the connection and, if that's not enough, performs a USB port reset to bring the device back without a power-cycle.
It's not a complete cure, heavy connect/disconnect churn can still wedge the device at the firmware level, where a power-cycle is genuinely the only reset, but it clears many cases automatically, and the "power-cycle it" message now only appears when one is actually needed.

Install

Download microsampler-editor-librarian-v1.7.0.zip from the assets below, unzip it, and double-click the launcher for your platform, it starts the bridge and opens the editor.
macOS/Linux will ask for your password (root is needed to claim the USB interface from the OS MIDI driver).
The only prerequisite is Python 3.8+.

Full guide: https://benjamindehli.github.io/microsampler-editor-librarian/#install.

The bundled libraries are open source: pyusb (BSD), libusb (LGPL-2.1), with the libusb binaries packaged from the Apache-2.0 libusb-package project — see native-tools/vendor/ for licenses and provenance.

This is an independent, unofficial project, not affiliated with or endorsed by
Korg.

Back up your bank (Utility → Backup) before bulk operations.

Full Changelog: v1.6.0...v1.7.0