Editor

Overview

The MechvibesDX editor lets you create a sound pack from scratch or from an existing one: assign sounds to individual keys, then export a V2-standard .zip for use in the app.

  • Pack name (clickable) — opens the pack info dialog (mode, name, description, tags).
  • New — creates a new pack and clears the current configuration.
  • Import — loads an existing sound pack .zip into the editor.
  • Export — exports the current pack as a V2-standard .zip.

Selecting Keys

  • Click a key to select or deselect it.
  • Drag to select an area of keys.
  • Ctrl + Click (Windows/Linux) or Cmd + Click (macOS) to add or remove individual keys.
  • Esc clears the whole selection.

Keys that already have a sound show a small dot badge in the corner.

Operating Modes

Change the mode by clicking the pack name and choosing Mode in the dialog.

  • Time segments — uses one audio file; each key plays a time range (start–end) within it.
  • Sound file per key — each key plays the entire audio file.

In time segments mode, load a longer file, then drag on the waveform to pick a sound (drag its edges to resize). Press Test to preview it, select the keys you want, then Apply. Use Quick select to grab a whole group of keys at once, and Zoom / Auto detect to fine-tune the waveform.

Using a Video File

You can load a video (.mp4, .webm) instead of an audio file — the editor uses the video's audio track.

  1. Load the video: drag & drop or click to browse.
  2. A video preview fills the source panel on the left. The waveform beside it shows the video's audio track.
  3. Pick a sound as usual — drag on the waveform, or type Start (ms) / End (ms). The video automatically seeks to the start time so you can see the exact frame that matches each sound.
  4. Apply to assign that sound to the selected keys.

On Export, the editor extracts the audio track, cuts out the unselected parts, concatenates the selected segments into one file, and encodes it to OGG Vorbis. Video export works best with MP4.

Importing a Sound Pack

  1. Press Import and choose a .zip file.
  2. The editor reads config.json, resolves the audio file, and maps the definitions onto each key.
  3. The name, description, mode, and assigned segments are applied immediately.

The pack must include config.json and at least one audio file (.mp3, .wav, .ogg, .flac).

Exporting a Sound Pack

  1. Press Export.
  2. The editor generates a V2-standard config.json plus the audio file, packages them into a .zip, and downloads it.

Uncompressed audio (.wav) is re-encoded to OGG Vorbis in the background, the file is downloaded as <slug>-<uuid>.zip, and a loading indicator is shown while exporting. You can import the exported file directly into MechvibesDX (Settings → Soundpacks → Import Soundpack).