Merik suite Merik Merik Studio Viewer QSheets

The .merik format (audio stems)

A .merik file is a normal zip file with a different extension. There is no manifest to write: Merik Studio recognises the files by their name. Whatever is present is used; whatever is missing falls back to the MIDI file or to Merik Studio's own click.

My Song.merik
├── song.mid          MIDI: tempo, time signature, lyrics, chords and MIDI parts
├── 1-drums.flac      audio stems (wav, flac, mp3), one or more per family
├── 2-bass.flac
├── 7-live vocals.wav   a second stem in the same family is mixed in
├── click.wav         your own click track (optional)
├── delay.json        recording delay in ms (optional, see below)
├── chords.json       chords (optional, replaces the chords from the MIDI file)
└── lyrics.json       lyrics (optional, replaces the lyrics from the MIDI file)

Stems may also be placed in a stems/ folder inside the zip. Names are not case sensitive.

What is used, in order

What If the file exists Otherwise
A family's sound the audio stem(s) of that family the MIDI parts of that family (SoundFont or MIDI out)
Click click.wav / click.flac / click.mp3 the internal click, generated from tempo and time signature
Chords chords.json chords found in the MIDI file
Lyrics lyrics.json lyrics found in the MIDI file
Audio delay delay.json: the stems are played that much earlier none
Tempo / time signature the MIDI file, or tempo.json / manifest.json (see below) unknown: no internal click and no beat display (a 8-click stem still plays)

So a hybrid song is normal: for example all MIDI plus one extra stem 7-live vocals.wav. Audio wins per family: a family with an audio stem does not play its MIDI notes.

Examples

File names

Recommended: number-name, for example 1-drums.flac, 7-void.mp3. The number (1–7, 8 = click) selects the family and the name is shown on the family button (the first 8 characters): 7-void.mp3 shows 7 void. A family has one name; with several stems the first named one is shown.

A file with only a family name (drums.wav) is accepted as well, and then the family keeps its default name.

Keep the original order of the families: the fader or switch of a family may already be set for the evening (for example Bass off because a bassist plays live). Put extra tracks such as backing vocals in 7 (Others).

A stem file is recognised by a number at the start (1–8) or by the family name:

Family Number Name
Drums 1 drums
Bass 2 bass
Guitars 3 guitars
Keys 4 keys
Strings 5 strings
Winds 6 winds
Others 7 others
Click 8 click

Examples: 1-drums.flac, drums.wav, 7 live vocals.mp3, others_choir.wav, click.wav. Extensions: wav, flac, mp3, aif/aiff.

chords.json

Times are in seconds from the start of the song.

[
  { "time": 0.0, "chord": "Am" },
  { "time": 2.4, "chord": "F" },
  { "time": 4.8, "chord": "C/E" }
]

lyrics.json

One entry per line. words is optional; with words the lyrics light up word by word, without it a line is shown at once.

[
  { "time": 10.0, "text": "Hello from the demo",
    "words": [ { "time": 10.0, "text": "Hello" }, { "time": 10.6, "text": "from" },
               { "time": 11.0, "text": "the" },   { "time": 11.3, "text": "demo" } ] },
  { "time": 14.8, "text": "A line without word times" }
]

tempo.json (optional)

For a package without a MIDI file: { "bpm": 96, "timeSignature": [4, 4] }. Merik Studio then plays its internal click and shows the beat. Without a MIDI file and without this there is no internal click.

delay.json (optional)

For stems that were recorded through external hardware (for example a MIDI file played through a sound module and recorded back). The sound then arrives a little late compared with the MIDI. delay.json says how late, so Merik Studio plays the stems earlier by that amount and MIDI and audio run together:

{ "audioDelayMs": 37.3 }

manifest.json (optional)

Only needed for things the file names cannot say:

{
  "bpm": 100,
  "timeSignature": [4, 4],
  "durationSeconds": 215.0,
  "timing": { "audioOffsetSeconds": 0.0 },
  "stems": [ { "family": 2, "file": "bassline.wav", "gainDb": -1.5 } ]
}

How it plays

Stem requirements

Making a .merik

Inside Merik Studio (recommended): Settings → Tools → Create a .merik file from a folder.... Merik Studio recognises the files in a folder by their names (using the rules above), warns about problems (different stem lengths, missing MIDI/tempo, unknown files), converts WAV to FLAC if you want (lossless; 32-bit float becomes 24-bit) and saves the .merik without compression. You can add the result to the current setlist right away. This is much more stable than doing it by hand: the common mistakes (a compressed zip, an extra folder, a wrongly named stem) cannot happen.

A test song is included: docs/demo/Stems Demo.merik (drums, bass, keys, strings and others as audio, a MIDI file whose guitar part plays through the SoundFont, plus chords.json and lyrics.json).

The manual way (advanced)

For the command line and scripts. It works, but it is easier to get wrong: one wrong flag or file name and the song loads slowly or a stem is not recognised.

A .merik is just a zip. The one thing that matters: store the audio without compression (zip -0). Audio files (wav, flac, mp3) are already compressed or do not shrink much, and a stored zip is the only kind Merik Studio can stream: the song is ready in a fraction of a second and uses very little memory. A normal compressed zip has to be unpacked completely first, which is slow.

Put the stems in a folder, named 1-drums.wav, 2-bass.wav, ... (see File names above), optionally with song.mid, click.wav, chords.json, lyrics.json.

macOS (Terminal, cd to the folder):

zip -0 -j "songname.merik" *.wav song.mid
# or, when there is only audio:
zip -0 -j "songname.merik" *.wav

-0 means "store, don't compress" and -j leaves out the folder name. This takes a second or two and the result loads almost instantly. Don't use right-click → Compress in Finder: it compresses the audio (slow to make, slow to load, Merik Studio can't stream it) and adds an extra folder.

Windows (PowerShell, in the folder). The simplest is the tar that ships with Windows 10 and 11:

tar --format zip --options zip:compression=store -cf "songname.merik" *.wav song.mid

or with PowerShell's own zip command (it needs the name .zip first):

Compress-Archive -Path *.wav,song.mid -CompressionLevel NoCompression -DestinationPath songname.zip
Rename-Item songname.zip songname.merik

or with 7-Zip: 7z a -tzip -mx=0 songname.merik *.wav song.mid. Don't use right-click → Send to → Compressed folder in Explorer: that compresses the audio.

(Leave out song.mid if you have none. The Windows commands were not tested on a Windows machine; the tar one works the same way as the macOS tar.)

Converting WAV to FLAC (about half the size, lossless):

macOS: install ffmpeg once with Homebrew, then convert everything in the folder:

brew install ffmpeg
for f in *.wav; do ffmpeg -i "$f" -c:a flac "${f%.wav}.flac"; done

Windows: install ffmpeg once (winget install ffmpeg, then open a new PowerShell), then:

Get-ChildItem *.wav | ForEach-Object { ffmpeg -i $_.Name -c:a flac ($_.BaseName + ".flac") }

Then pack the .flac files as above (zip -0 -j "songname.merik" *.flac song.mid).

The included script does the same in one go: python3 scripts/make-merik.py pack "songname.merik" --folder stems/ --midi song.mid.

More ways with the script (needs only Python 3):

python3 scripts/make-merik.py pack "My Song.merik" --folder stems/ --midi song.mid
python3 scripts/make-merik.py pack "My Song.merik" --stem 1=drums.wav --stem 7=vocals.wav --midi song.mid
python3 scripts/make-merik.py pack "My Song.merik" --folder stems/ --click click.wav --chords chords.json --lyrics lyrics.json
python3 scripts/make-merik.py pack "My Song.merik" --folder stems/ --bpm 96 --sig 4/4     # no MIDI
python3 scripts/make-merik.py demo "Stems Demo.merik"                                       # synthetic test song