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, andAlthave 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 |