v1.14.1

microSAMPLER Editor / Librarian v1.14.1

A maintenance release.
The editor works exactly as it did in v1.14.0, there are no changes to features or behaviour.
This release is housekeeping under the hood, plus a much-expanded documentation site.

Under the hood

• The browser app's source was reorganised into a clearer component structure (a folder per feature, shared functions and styles split out), with no change to how anything runs.
• Modules now import through stable aliases, so the layout is easier to maintain going forward.
• Small code cleanup: A couple of unused parameters were removed.

These are internal only. The downloaded app builds and behaves identically to v1.14.0.

Documentation

The online documentation at https://benjamindehli.github.io/microsampler-editor-librarian/ was rebuilt into a multi-page guide:

• A focused Home page, step-by-step Getting started, the full Guide, a new How it works page explaining the microSAMPLER's banks, sample vs keyboard mode, BPM-sync, effects and sequencer, and a Troubleshooting & FAQ page.
• Polish across the board: clearer navigation, better search-engine metadata, and per-page social preview images.

Install

1. Download the ZIP below and unzip it.
2. macOS: open the macOS folder and run microSAMPLER Editor Librarian.command (device mode) or microSAMPLER Library.command (no hardware needed).
   On first run, approve the unsigned launcher in System Settings, Privacy and Security.
3. Linux and Windows launchers live in their own folders.

You only need Python 3 installed.
pyusb and libusb are bundled.

Full Changelog: v1.14.0...v1.14.1

v1.14.0

microSAMPLER Editor / Librarian v1.14.0

This release adds playheads to pattern playback and gives the whole interface a polish pass for clarity, feedback and legibility.

Playheads for patterns

• The pattern editor preview now shows a playhead sweeping across the piano roll while it plays, the same way the sample waveform does.
• Each pattern card gets a playhead sweeping its mini piano-roll while that pattern plays on the device.
• Both loop along with the device and clear when you stop.

Interface polish

• Recorded patterns stand out:
  • Empty pattern slots now recede so the patterns that actually have notes are easy to spot at a glance (they come back to full strength on hover).
• See what the hardware knobs control:
  • On the Effect page, the two parameters mapped to the device's FX EDIT 1 / 2 knobs are now badged and ringed, so the physical-knob targets are obvious.
  • The effect panel also no longer leaves a large empty area below its parameters.
• More tactile:
  • Pads and pattern cards lift slightly on hover, and editable spots (the bank display, the sample's BPM) now look editable at rest rather than only on hover.
• Easier to read:
  • Muted labels throughout were lifted for better contrast.
• Smoother:
  • Switching between views now has a gentle transition (respecting reduced-motion settings).
• Clearer first run:
  • Empty views show a centered prompt telling you what to do next, and the top bar wraps gracefully on narrow windows instead of hiding its controls.

Install

1. Download the ZIP below and unzip it.
2. macOS: open the macOS folder and run microSAMPLER Editor Librarian.command
   (device mode) or microSAMPLER Library.command (no hardware needed).
   On first run, approve the unsigned launcher in System Settings, Privacy and Security.
3. Linux and Windows launchers live in their own folders.

You only need Python 3 installed.
pyusb and libusb are bundled.

Full Changelog: v1.13.0...v1.14.0

v1.13.0

microSAMPLER Editor / Librarian v1.13.0

This release lets you play the device from a real MIDI keyboard, and makes a sample's original BPM editable after the fact.

Play from a MIDI keyboard

• A new MIDI IN toggle in the keyboard panel plays the device from a connected MIDI controller.
• It sends velocity, so dynamics come through.
• The pitch bend wheel bends the note (in KEYBOARD mode, the way the device does it).
• The sustain pedal holds notes until you lift the pedal.
• It honors the SAMPLE / KEYBOARD toggle, so each key either triggers its own pad or plays the selected sample pitched.
• It uses your browser's Web MIDI, so the bridge still has the device to itself.
  The toggle only appears in browsers that support Web MIDI (Chrome, Edge and Firefox).

Editable original BPM

• Click the BPM chip on a sample to edit its original tempo (the tempo used for BPM-sync stretching) in a dialog.
• Applying re-uploads the sample to the device, keeping its audio and all of its other settings.
• This was the one sample value that could not be changed before, since the device has no live command for it.

Install

1. Download the ZIP below and unzip it.
2. macOS: open the macOS folder and run microSAMPLER Editor Librarian.command (device mode) or microSAMPLER Library.command (no hardware needed).
   On first run, approve the unsigned launcher in System Settings, Privacy and Security.
3. Linux and Windows launchers live in their own folders.

You only need Python 3 installed.
pyusb and libusb are bundled.

Full Changelog: v1.12.0...v1.13.0

v1.12.0

microSAMPLER Editor / Librarian v1.12.0

This release teaches the on-screen keyboard the microSAMPLER's two play modes, and gives the theme picker a proper colour dropdown with a lot more colours to choose from.

On-screen keyboard

• A new SAMPLE / KEYBOARD toggle picks how the keys play.
• SAMPLE mode triggers a different sample per key, like before.
  The keys that have no sample are now dimmed, so the loaded ones are easy to spot at a glance.
• KEYBOARD mode plays the currently selected sample across the whole keyboard, pitched, the way the device's keyboard mode works.
• In KEYBOARD mode the pads no longer light up when you play,
  since the keys aren't triggering pads.
• The key you play now lights in the current theme colour instead of always amber.

Themes

• The theme picker is now a custom dropdown that previews each accent with a real colour swatch, so you can pick by colour.
  This works in every browser, including Chrome on macOS where the old menu could not show the colours.
• Seven more accent colours, for twelve in total:
  • Red, orange, amber, yellow, lime, green, teal, cyan, blue, violet, magenta and pink
  • Ordered around the colour wheel.
• Amber stays the default, and your choice is remembered.
• The picker no longer changes width when you select a longer colour name, so the toolbar next to it stays put.

Install

1. Download the ZIP below and unzip it.
2. macOS: open the macOS folder and run microSAMPLER Editor Librarian.command (device mode) or microSAMPLER Library.command (no hardware needed).
   On first run, approve the unsigned launcher in System Settings, Privacy and Security.
3. Linux and Windows launchers live in their own folders.

You only need Python 3 installed.
pyusb and libusb are bundled.

Full Changelog: v1.11.0...v1.12.0

v1.11.0

microSAMPLER Editor / Librarian v1.11.0

This release turns the pattern piano roll into a proper editor.
v1.10.0 let you see and play your patterns, and now you can build and reshape them with drawing tools, multi note selection, undo/redo, and copy/paste, all editable from the keyboard.

Pattern editor

Drawing tools

• A tool selector with three modes: Draw, Erase, and Select.
• Draw adds notes and lets you move or resize them, the same as before.
• Erase removes any note you click, and you can drag across the roll to wipe a run of notes in one stroke.
• Select lets you click a note or drag a rectangle to grab several at once.
• The cursor changes to match the active tool,
  so you always know what a click will do.

Selecting and editing

• Select multiple notes, hold Shift or Cmd/Ctrl while clicking to add or remove individual notes.
• Undo and redo every change with Cmd/Ctrl+Z and Cmd/Ctrl+Y.
• Copy and paste notes with Cmd/Ctrl+C and Cmd/Ctrl+V.
  The clipboard stays around between patterns, so you can copy from one pattern and paste into another.
• Select all with Cmd/Ctrl+A, and delete the selection with Delete.
• Nudge the selected note with the arrow keys, and resize it with Shift held.
• Note brightness now reflects velocity, so louder notes read at a glance, and you can still set velocity with the slider or the scroll wheel over a note.

Workflow

• Press Space to play or stop the pattern on the device, from anywhere in the editor, even when a button or the grid selector has focus.
• The Save to Device button now sits in the top right corner.
• Clicking outside the dialog saves your work and closes the editor.
• The header is split into two rows, with the drawing and track tools sitting right above the grid.

Fixes

• Saving a pattern while it was playing could fail with a device error.
  Saving now stops the sequencer first, so it works whether or not playback is running.

Notes

• The docs site has a clearer first run section for macOS, walking through the one time approval an unsigned launcher needs.
• Small docs touches: a back to top button and linkable section headings.

Install

1. Download the ZIP below and unzip it.
2. macOS: open the macOS folder and run microSAMPLER Editor Librarian.command (device mode) or microSAMPLER Library.command (no hardware needed).
   On first run, approve the unsigned launcher in System Settings, Privacy and Security.
3. Linux and Windows launchers live in their own folders.

You only need Python 3 installed.
pyusb and libusb are bundled.

Full Changelog: v1.10.0...v1.11.0

v1.10.0

microSAMPLER Editor / Librarian v1.10.0

This release adds an in-app pattern editor so you can draw and edit patterns without a DAW,
and zero-crossing snap for click-free sample trims.
It also cleans up the pattern view and makes saving patterns a lot snappier.

Pattern editor (piano roll)

Every pattern now has an EDIT button that opens a piano roll for both of the device's tracks: The sample-mode track, where each note triggers a pad, and the keyboard-mode track, where one assigned sample is played at pitch.

• Draw, move, resize, and delete notes, and set each note's velocity.
• Snap to a grid (1/4 down to 1/32), or switch snapping off to place notes freely.
• Set the bar count, the pattern name, and the keyboard track's sample.
• PLAY previews the edit on the device, and CANCEL restores the slot, so nothing sticks until you SAVE.
• It works on an empty pattern too, so you can build one from scratch.

Saving writes through the same hardware-verified converter used by MIDI import,
so the result on the device matches what you drew.

Zero-crossing snap for trims

When you drag the START or END marker on the waveform,
the point now snaps to the nearest zero crossing so the trim does not click.
A ZERO-SNAP toggle sits under the waveform and is on by default.
Typing an exact frame value still gives you precise, unsnapped control when you want it.

Other improvements

• Clearer pattern cards: each one now shows PLAY, EDIT, and INIT on one row and IMPORT and EXPORT on the next, with consistent icons across the app.
• Faster pattern saves: saving, initializing, or importing a pattern now refreshes just that one card instead of re-reading all 16 patterns from the device, so it is instant and never interrupts playback.
• Hardened importing of external backup files, plus more automated tests and a documented script that regenerates the screenshots and demo.

Install

Download microsampler-editor-librarian-v1.10.0.zip below, unzip it,
open the folder for your platform, and double-click a launcher.
The only requirement is Python 3.8+.
pyusb and libusb are bundled, so there is no pip or Homebrew step.

See the README and the full guide for details.

Full Changelog: v1.9.0...v1.10.0

v1.9.0

microSAMPLER Editor / Librarian v1.9.0

This release adds a hardware-free Library mode for recovering samples and patterns from old bank backups, an on-screen / computer-keyboard piano for playing samples, plus quality-of-life touches: update notifications and an in-app connection helper.

Highlights

On-screen keyboard & QWERTY play

A piano below the sample editor mirrors all 36 pads (C3–B5).

• Click any key to play it on the device, with its real envelope/FX.
• Tick ⌨ TYPE TO PLAY to play from your computer keyboard.
  • Home row A S D F G H J K = white keys
  • Top row W E · T Y U = black keys (the piano shows which key is which)
  • Z / X — or the ◀ ▶ buttons — shift the octave.
• Keys for loaded samples are marked, and the selected pad is highlighted.

Library mode (no hardware required)

Browse and extract the contents of bank backups with no microSAMPLER connected, ideal for recovering audio and sequences from old .msmpl_bank files saved by Korg's original editor.

• Import an original Korg .msmpl_bank backup (or a .zip backup made by this app).
• Browse a bank's 36 pads and play each sample in the browser.
• Export samples as WAVs, individually or the whole bank as a ZIP.
• Export patterns as MIDI, any recorded patterns are listed below the pads.
  • Download each as a .mid, or all of them as a .mid ZIP, ready for your DAW.
• Runs on a separate port (8766) and needs no password since it never touches USB.
• Command-line option: python3 native-tools/msmpl_bank.py extract "bank.msmpl_bank".

Update notifications

The app now checks GitHub for newer releases and shows a dismissible notice when one is available (cached, and quietly skipped if offline).

Connection helper

The bridge now keeps serving the UI even if it can't open the device.
Instead of a dead page you get a clear panel explaining the device wasn't found, with a Retry button, distinct from the "bridge unreachable" state.

Launchers

Launchers are now organised into per-OS folders.
macOS/, Linux/, and Windows/, each containing both:

• microSAMPLER Editor Librarian: The full editor for a connected device.
• microSAMPLER Library: The no-hardware librarian (no password needed).

Other improvements

• Documentation: Library mode guide, pattern-export notes, troubleshooting tips, and refreshed screenshots and demo video.
• Hardened the release build (the Library reader is now bundled into dist/).
• Expanded the end-to-end browser test suite (Library import, pattern export, connection retry, and the on-screen keyboard) and wired the .msmpl_bank reader into CI.

Install

Download microsampler-editor-librarian-v1.9.0.zip below, unzip it, open the folder for your platform, and double-click a launcher.
The only requirement is Python 3.8+ (pyusb and libusb are bundled, so there's no pip or Homebrew step).

See the README and the full guide for details.

Full Changelog: v1.8.0...v1.9.0

v1.8.0

microSAMPLER Editor / Librarian — v1.8.0

This release adds two librarian-focused features:
slicing one sample across many pads, and pulling individual samples out of a backup.

Highlights

• Auto-slice
  • Chop a long sample into consecutive pads, by equal pieces or detected transients.
• Cherry-pick restore
  • Copy a single sample out of a backup into any pad, without restoring the whole bank.

Auto-slice

Drop a WAV onto a pad (or open the upload dialog) and press the new SLICE… button.
You can cut the sample two ways:

• Equal: into a number of equal-length pieces you choose.
• Transients: at detected note/hit onsets, with a sensitivity slider; ideal for drum breaks and chopped phrases.

A live preview shows how many slices you'll get and which pads they'll fill.
Each slice is uploaded to consecutive pads and named after the source sample.
The upload audio tools (normalize, trim, gain, fades, mono/stereo) apply to the whole sample before it's sliced.

Cherry-pick restore

Every backup now has a SAMPLES… button.
It lists the samples in that backup by name and lets you copy any one of them into a pad of your choice in the current bank.
The dialog stays open, so you can grab several in a row.
It's the quick way to reach back for "that snare from last month's bank" without overwriting everything.

Other improvements

• Samples imported by slicing, cherry-pick or a multi-WAV drop now load into the app immediately, so their waveforms are instant and the memory meter stays exact, no more lazy loading.
• A new MSMPL_BACKUP_DIR environment variable lets you keep bank backups somewhere other than the default folder, such as an external drive.

Install

Download microsampler-editor-librarian-v1.8.0.zip from the assets below, unzip it, and double-click the launcher for your platform.
The only prerequisite is Python 3.8+ — pyusb and libusb are bundled.

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

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

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

What's Changed

• Add cherry-pick restore for individual samples from backups by @benjamindehli in #14
• Add auto-slice feature to chop samples across multiple pads by @benjamindehli in #15

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

v1.7.0

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

v1.6.0

microSAMPLER Editor / Librarian — v1.6.0

This release makes the editor follow along with what you do on the hardware, loads every sample up front so the interface is instant, adds Linux and Windows launchers, and ships a full documentation site.

Highlights

• Follow the hardware
  • The selected sample now tracks the last sample triggered on the device.
• Instant samples
  • Every sample downloads when you connect, so waveforms open immediately and the memory meter is always exact.
• Hardware edits sync back
  • Start/end trims and bank switches made on the device now show up in the app.
• Documentation site
  • A complete guide with screenshots, a walkthrough video and per-platform setup at https://benjamindehli.github.io/microsampler-editor-librarian/.

New features

Follow the hardware

A new FOLLOW toggle (on by default, in the Samples view) makes the app's selected sample jump to whatever was last triggered on the device, whether you play a pad by hand or a pattern plays it.
Turn it off to keep your selection put.
The setting is remembered between sessions.

All samples preload on connect

Samples are now downloaded automatically as soon as you connect, with a "loading samples" progress indicator.
Waveforms and auditioning are instant, and the memory meter shows exact usage instead of an estimate.
This replaces the previous load-on-demand behaviour.

Black-key pads

Pads for the sharp notes (C♯, D♯, F♯, G♯, A♯) are tinted darker, like a keyboard's black keys, so the 36-pad grid reads at a glance.

Linux & Windows launchers

Alongside the macOS microSAMPLER Editor Librarian.command, there are now microSAMPLER Editor Librarian.sh (Linux) and microSAMPLER Editor Librarian.bat (Windows — experimental, needs the WinUSB driver via Zadig) launchers that start the bridge and open the editor for you.

Fixes & sync improvements

• Start/end points edited on the device
  • Now appear in the app.
  • The device doesn't transmit these live, so they sync on the next bank read, the waveform markers and the numeric readouts refresh when you return to the app window (auto-RECEIVE) or press RECEIVE.
• Switching banks on the device
  • Now picked up when you return to the app.
  • It reloads the new bank and preloads its samples, instead of showing the old bank's data.

Documentation

• A new documentation site covers installation on macOS, Linux and Windows, a feature-by-feature walkthrough, keyboard shortcuts, hardware setup photos, a demo video and screenshots.
• The README now leads with a photo of the hardware running the editor and links to the site, which carries a direct Download button for the latest release.

For developers

• Releasing is now self-maintaining
  • npm version stamps the new version into the docs download link and structured data and folds it into the version commit, and CI fails if the docs version ever drifts from package.json.

Install

Download microsampler-editor-librarian-v1.6.0.zip from the assets below, unzip it, and double-click the launcher for your platform (macOS/Linux will ask for your password — root is needed to claim the USB interface from the OS MIDI driver).
You'll need Python 3.8+ with pyusb, and libusb.
Full instructions: https://benjamindehli.github.io/microsampler-editor-librarian/#install.

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.5.0...v1.6.0