Merik suite Merik Merik Studio Viewer QSheets

File names and format

The reference for the files QSheets reads and the MIDI patch notation. You only need this when you want to go beyond the basic steps: your files can live in any folder, in iCloud Drive or On My iPad.

File types

Supported files

FileWhat QSheets does
.txtShows the text as large as possible without wrapping. UTF-8 and older Windows/Latin-1 files both work. Light on dark by default; switch it in the settings.
.mdMarkdown at the same maximum size, with headings, bold, italic, lists, quotes, code blocks and colours.
.pdfShows the PDF full screen; left and right turn the pages.
.jpg .jpeg .png .heicShows the image as large as possible, keeping its shape.
.mp3Not a button of its own: it is the backing track of the sheet with the same name.
.patchNot a button: extra MIDI patch lines for the sheet with the same name (see MIDI).

Upper or lower case extensions both work. A folder can hold up to 500 items. Songs are sorted alphabetically, so start names with 01, 02… to set the order of a set list.

Example of a QSheets folder
Markdown sheets (.md) with colours

A .md file is shown like a text sheet: monospaced, as large as fits, so chords above lyrics stay aligned. You can use:

# Heading         ## Smaller heading
**bold**  *italic*  ~~strike~~  `code`
- bullet          > quote          ---  (rule)
{red}Am7{/}       {#ff8800}orange{/}
<font color="red">red</font>
<span style="color:blue">blue</span>

Colour names: red, green, blue, yellow, orange, purple, pink, cyan, magenta, white, black, gray, brown, teal, lime, navy, gold, or #rgb / #rrggbb. Fenced blocks (three backticks) keep their spacing, which is handy for bar lines.

Editing tip. Any text editor works. On Windows and Mac, Visual Studio Code (free, live preview with Ctrl/Cmd+Shift+V) and Obsidian (free) are good choices, and Typora is a paid WYSIWYG editor. MarkEdit (free, Mac) and Notepad++ (free, Windows) are fine for quick edits. The colour tags only show as colours in QSheets; other editors show them as plain text.
Markdown source next to its rendering
A chord chart in Markdown next to its rendering
MIDI patches

Connecting

Use the USB (camera connection) adapter with a class-compliant USB MIDI interface or a USB hub with several keyboards, Bluetooth MIDI, or a host app that offers a virtual MIDI port. By default QSheets sends every message to all connected devices; give devices a number (below) to address them one by one.

Notation

Put the patch between square brackets (angle brackets are not allowed in Windows file names; old files that use < > still work). Everything is 1-based, as shown on the synth:

song[1p12]                channel 1, program 12
song[1p12b0.32]           + bank select MSB 0 / LSB 32
song[1p12,2p5]            two channels
song[3c7=100c11=64]       channel 3: CC 7 = 100 and CC 11 = 64
song[5@1p12]              only to device 5: channel 1, program 12
song[5@p12]               device 5 on its default channel
song[1@1p3,5@1p12b0.32]   device 1 and device 5

Channel 1-16, program 1-128 (sent as 0-127), bank, CC number and CC value 0-127. A message without n@ goes to all connected devices.

Edit and learn

Open a song and tap ✎ Patches. Each message is a row you can change, test (tap the row) or delete (swipe left). Turn on Learn from MIDI input and choose a sound on your synth: the program change, bank select and any controllers you move are added as rows. Save writes the patch into the file name. This needs the synth to send MIDI out, which many synths can switch on in their MIDI settings.

MIDI devices

In ☰ → MIDI devices you can give up to 16 devices a number. Choose the MIDI port (the one that ends in Input), a name, and optionally a default channel, so [5@p12] works without a channel. The list is saved as QSheets-devices.json in your iCloud folder and shared by all your iPads. Use Send test note to check that the right device reacts.

Long patches

When a patch would make the file name longer than 60 characters, Save writes it to song.patch next to the sheet instead: one message per line, the same notation, and # starts a comment.

# QSheets patch file
1@1p12b0.32c7=100c11=64
5@1p3b0.1c7=90c74=80
2@p5

Both the tag and the .patch file are read. If the patch becomes short again, the file is removed.

Older notations

These keep working and the editor leaves them untouched.

TypeParametersExample
PCCH channel 1-16, PC program 0-127 (raw). Optional bank select: BM MSB and BL LSB, 0-127, both needed.PC-CH11-PC32
PC-CH2-PC32-BM2-BL0
NS3 NW2CH channel 1-16 and the program as shown on the Nord Stage 3 or Nord Wave 2, like A43.NS3-CH1-A21
NW2-CH2-B31
NS4CH channel 1-16 and the program as shown on the Nord Stage 4, like I88.NS4-CH11-E88
MTMIDI thru: notes and CC coming in on this channel (1-16) are sent on to all outputs while the song is open.MT13

Quick format for Nord keyboards. Only the program numbers, three characters each, without dashes. The position is the MIDI channel: the first program goes to channel 1, the second to channel 2, and so on. Use upper case for Nords with 5-based numbers (Nord Stage 3, Nord Wave 2, Nord Piano 5) and lower case for 8-based numbers (Nord Stage 4), for example Mustang Sally[C11B23a11].txt.

The buttons simply read the song name: the part between brackets is hidden.

Tip: switch on Show MIDI data in status bar in the settings and press a program button on your synth. QSheets shows the channel, bank and program number it receives.
The patch editor