Skip to content

BETA

Input Guide

Tip

See the user manual (Help > User Manual) for details, and the Keyboard Shortcut Reference (Ctrl+Shift+K) for every shortcut; its Cheat Sheet (PDF) button opens a printable copy.

How Input Works

RhYMe can be used almost entirely from the keyboard, but most people combine mouse and keyboard.

  • Focus decides what keys do. The note keys enter notes when the pattern grid has focus, but preview sounds when the instrument list has focus. Click a panel, or use its focus shortcut, to direct your keys to it.
  • Modifiers are consistent. Shift, Ctrl, and Alt have the same general meaning everywhere:
Modifier General meaning
Shift Extend a selection, or a secondary variant of the plain action
Ctrl The primary command modifier, an alternate action, or multi-selection
Alt An alternate action, usually tied to values or channels

Tooltips on toolbar buttons and menu items always show the shortcut for that action, so you can pick up the keys gradually.

Pattern Editor

The pattern editor is where you compose. Each row of a channel contains a note, an instrument number, and up to five effects.

Edit Mode

Typing into the grid works only while Edit Mode is on; toggle it with Enter or the toolbar button. With it off, typing, Backspace, Delete, Insert and pasting do nothing, and the grid signals that the edit was blocked; menu commands such as Transform still work. To stay in Edit Mode for good, turn on Always stay in Edit Mode in General Settings.

Entering Notes

With Edit Mode on and the pattern grid focused, notes are played from a two-octave piano layout on the QWERTY keys:

Upper octave, sharps     2  3     5  6  7
Upper octave           Q  W  E  R  T  Y  U
Lower octave, sharps       S  D     G  H  J
Lower octave             Z  X  C  V  B  N  M

The layout follows the physical key positions, so it is the same on QWERTY, QWERTZ, and AZERTY keyboards.

With Polyphonic previewing on, note keys held together sound together, but a computer keyboard can report only a limited number of keys at once; a MIDI keyboard has no such limit.

Action Keys
Set the entry octave (0–8) F1–F4 (1–4), Shift+F1–Shift+F4 (5–8), ` (0); or step with = / - (Numpad + / -)
Set the edit step (rows advanced after each note) Shift+= / Shift+- (or Shift+Numpad + / Shift+Numpad -)
Choose where the cursor moves after each entry (Auto-cursor advance) Ctrl+U turns it off and on; Alt+Shift+1 single line, Alt+Shift+2 edit step, Alt+Shift+3 hop over gaps
Enter an OFF note (===, silences the channel) Shift+O
Preview a note without writing it Play any note key with Edit Mode off

The edit step decides how far the cursor drops after each note while Auto-cursor advance is set to Advance by Edit Step, the default: 0 keeps it on the same row (handy for stacking chords across channels), 1 steps down a row, and larger values leave gaps. During live recording (entering notes while playback runs) the cursor does not step.

Auto-instrument and the Shift Flip

Whether a note also writes an instrument number is governed by the Auto-instrument toggle in the toolbar (Ctrl+I):

  • Auto-instrument on (the default) — each note is written together with the currently selected instrument.
  • Auto-instrument off — only the note is written; the instrument column is left untouched.

Hold Shift while pressing a note key to flip the toggle for that one note. So with Auto-instrument on, Shift enters the note without an instrument (legato entry); with Auto-instrument off, Shift writes the instrument along with the note. Shift flips Auto-cursor advance for that note too, so with the advance on, a Shift note leaves the cursor on its row. MIDI note entry follows the same toggle but has no Shift flip.

Tip

Select the OFF instrument (number 0) in the toolbar or instrument list to make every entered note an OFF note (===), without reaching for Shift+O each time.

Entering Effects

On an effect's first place, type the effect's letter; then type its hex digits. Six effects have a mode letter right after the effect letter, before any digits: Q (N arpeggio table, V vibrato table), S (S song speed, W swing, N arpeggio speed, I instrument speed), Y (X, M or T), R (S reset, Z freeze slides, Y continue them), K (M mute the note, U unmute it) and X (L note delay, X note cut). Move the cursor to the second place, right after the effect letter, and type the mode letter; a hex digit there does nothing. The cursor then moves on to the first digit, unless it moves to the next row. A new Q starts with N, a new S with S, a new R with S, a new K with M and a new X with L, and retyping the letter keeps the mode.

Moving Around

Action Keys
Move the cursor one cell Arrow keys
Move to the start of the previous / next cell Ctrl+Left / Ctrl+Right
Move down a row, to the start of the cell Shift+Enter
Extend a selection while moving Shift + arrow keys
Next / previous channel Tab / Shift+Tab, or Alt+Right / Alt+Left
Scroll the view without moving the cursor Ctrl+Up / Ctrl+Down
Move the cursor 16 rows PageUp / PageDown
Jump to first / last row Home / End

Transposing Notes

With the cursor on a note field (or a block selection active), transpose in place:

Action Keys
Down / up one semitone [ / ], or Alt+Down / Alt+Up
Down / up one octave Shift+[ / Shift+], or Alt+Ctrl+Down / Alt+Ctrl+Up

A block selection transposes every note it covers. Empty note cells are left alone — transposing never creates a note. Each transpose also previews the resulting note, and changing a note's instrument number plays the note with its new instrument.

Editing

Action Keys
Undo / redo Ctrl+Z / Ctrl+Shift+Z (redo also Ctrl+Y)
Cut / copy / paste Ctrl+X / Ctrl+C / Ctrl+V
Paste and advance (cursor lands below, spaced by the Step) Ctrl+Shift+V
Paste overlay / underlay / insert Ctrl+Alt+O / Ctrl+Alt+U / Ctrl+Alt+I
Louder / quieter: Volume effects in the selection or on the cursor's row Ctrl+Shift+Up / Ctrl+Shift+Down
Stretch or compress the selection, track, pattern or song Ctrl+G
Reverse the selected rows, or the whole pattern Ctrl+Shift+R
Draw an effect as a slope across the selection or track Ctrl+K
Delete row / delete on all channels Del / Shift+Del
Insert blank line / on all channels Ins / Shift+Ins
Clear the current field Backspace

A selection can be as small as a single field (drag a little way inside one cell, or Shift-select it), and cut, copy, clear, and transpose then act on just that field. With no selection, cut and copy take the whole channel row at the cursor.

Mouse in the Pattern Grid

Action Effect
Click Move the cursor to that cell
Click and drag Select a range of cells, or a single cell by dragging a little way inside it (drag near the top or bottom edge to auto-scroll)
Right-click Open the context menu (cut, copy, paste, transpose, and more)
Double-click a note Hear it with the instrument and volume in force at that row (Alt+/ does the same for the note at the cursor)
Ctrl+double-click a row Play the song from that row
Alt+double-click a row Play the pattern from that row, looping it
Mouse wheel Scroll the grid — or move the cursor, if Move Cursor with Wheel is on in the View Options menu
Ctrl+wheel Change the grid font size (the Reset Zoom button beside the grid's zoom buttons puts it back)
Alt+wheel Adjust the value under the pointer (add Shift for larger steps)

Instrument Editor

An instrument is a sequence of steps that reshape the YM2149 registers over time. The Instruments tab shows the instrument list on the left and the step grid on the right.

Instrument List

Action How
Preview an instrument Double-click it, or use the Preview button
Preview a pitch on the selected instrument Play a note key while the list is focused
Add / duplicate / delete Toolbar buttons
Select every unused instrument Select Unused button
Replace this instrument with another throughout the song Ctrl+H, or Replace Instrument… on the right-click menu

The list always begins with a fixed 00 OFF entry; selecting it hides the editor and makes entered notes become OFF notes.

Step Grid

Each step can set any combination of register fields, grouped into Global, Square, Envelope, Sample and Timer columns.

Action Keys
Move between cells Arrow keys
Move to the start of the next / previous cell Ctrl+Right / Ctrl+Left
Scroll the grid without moving the cursor Ctrl+Up / Ctrl+Down
Next group / start of the group, then previous group Tab / Shift+Tab, or Alt+Right / Alt+Left
Select a rectangular block Drag, or Shift + arrow keys
Cut / copy / paste (values stay in their own column) Ctrl+X / Ctrl+C / Ctrl+V
Select every step Ctrl+A
Add / insert / duplicate / delete a step + / Ins / Ctrl+D / Shift+Del
Copy the current cell down one row Ctrl+Shift+D
Reverse the selected steps, or every step Ctrl+Shift+R
Draw the column under the cursor as a slope across the steps Ctrl+K, or double-click a cell
Toggle the loop start at the cursor step Ctrl+L
Preview the current step (or selected range) in isolation Shift+/ (Ctrl+/ to loop it)
Preview the instrument looped, until you stop it Alt+/

On the Ret (envelope retrigger) column, press R to toggle the field, and on the Pause (sample pause) column press P; any hex digit toggles either too. To play a wavetable, set the timer Mode to 4 and type the wavetable's number into the Wave column. A cell showing -- means "not set on this step": the step uses the note or the default (no noise, no offset, no forced period), not what an earlier step set.

Mouse in the Instrument Editor

Action Effect
Click the waveform strip Jump to that step
Double-click a Mode, Shape or Wave cell Open its list of values
Ctrl+click or middle-click a Mode cell Step the tone mode on to the next one
Double-click a waveform step Preview that step on its own
Ctrl+double-click a waveform step Preview that step on its own, repeating
Alt+click a cell in the step graphs Set the value straight from the graph
Drag across the graph or step grid Select a block (shared between the two)
Mouse wheel over the grid Scroll the grid; the cursor stays where it is
Right-click Open the same edit context menu as the grid

Playlist

While a playlist is open, its list replaces the editor, and everything in it has a key. The transport keys are the same as in the editor.

Action Keys
Play the selected song Enter, Space, or F6
Open it in the editor Ctrl+Enter
Play the set from the top F5
Pause / resume the song Space, or F7
Space, in short Plays what is selected, pauses what is playing, resumes a paused song
Stop F8, or Escape
Previous / next song Ctrl+[ / Ctrl+]
Add songs / add the song in the editor Ctrl+Shift+A / Ctrl+Alt+A
Remove the selected song Del
Move it up / down the set Alt+Up / Alt+Down
Order the whole set by name Ctrl+Alt+S
Play through / shuffle Alt+T / Alt+S
Browse to the song's folder Ctrl+B
New playlist / close the playlist Ctrl+Alt+N / Ctrl+W

Handy Elsewhere

A few shortcuts are worth knowing wherever you are:

Action Keys
Focus the pattern grid F9, or Ctrl+Enter
Focus the song editor Ctrl+`
Move focus to the next / previous control Ctrl+Tab / Ctrl+Shift+Tab
Start / stop playback Space (and F5–F7 variants)
Panic-stop all sound Escape
Mute channels A / B / C, from the pattern grid or the playlist Alt+Z / Alt+X / Alt+C
Metronome / count-in on or off Alt+M / Alt+N