Skip to content

References

RhYMe provides several reference windows accessible from the Help menu. This chapter also includes a table of the periods that play each note.

Every reference window has a search box above its table. Typing in it shows only the rows that contain the text in any column; clearing it shows every row again. The search box is ready for typing as soon as the window opens.

The arrow keys, PageUp / PageDown and Home / End scroll the list, even while you type in the search box.

Tracker Effect Reference

Opened from Help > Tracker Effect Reference or Ctrl+Shift+E.

This window lists the effect commands with their parameter format and behavior. Besides the name and the description, the search finds an effect as you write it in a pattern, such as QNnn.

The window lists the effects of the features in view. In Novice mode, and for a feature the song's Features boxes switch off, it leaves out the effects that belong to it: the arpeggio table (QNnn), the vibrato table (QVnn) and the sample effects (Y, M and Z). A window left open follows along when the features in view change.

Complete Effect Reference

Letter Effect Parameter Description
A Arpeggio xy- Cycles through the base note and the notes x and y semitones above it, for chord-style playback
B Extended Arpeggio xyz Cycles through the base note and the notes x, y and z semitones above it, for chord-style playback
D Pattern Break nn- D00 ends the pattern after this row and advances to the next song position. Dnn skips the nn rows below this one and continues after them
E Pitch Bend Down nnn Lowers the pitch every tick at rate nnn. E000 reuses the previous rate
F Pitch Bend Up nnn Raises the pitch every tick at rate nnn. F000 reuses the previous rate
G Portamento nnn Slides the pitch toward the target note at rate nnn and stops on it. G000 reuses the previous rate
H Vibrato xy- Vibrates the pitch: x sets the speed and y the depth (0h–Fh). H00 stops the vibrato
I Semitone Bend Down nnn Lowers the pitch every tick by nnn 256ths of a semitone, so I100 bends a semitone a tick at every note. I000 reuses the previous rate
J Semitone Bend Up nnn Raises the pitch every tick by nnn 256ths of a semitone, so J100 bends a semitone a tick at every note. J000 reuses the previous rate
K Mute Note M-- Silences the playing note while its instrument, its effects and its timer run on unheard. A new note ends the mute
K Unmute Note U-- Lets the note the mute (KM) silenced be heard again from where it had reached, without starting it again
K Set Fader Vn- Sets the channel's fader to n (0h silent to Fh full) at once, lowering everything the channel plays over its own volumes. Stops a fade
K Fade In Inn Raises the fader by nn 128ths of a volume step every tick until it is full, over the volumes the rows set. KI00 reuses the previous rate
K Fade Out Onn Lowers the fader by nn 128ths of a volume step every tick until it is silent, over the volumes the rows set. KO00 reuses the previous rate
K Set Detune Tnn Plays everything the channel plays nn semitones higher (01h–7Fh) or lower (FFh–80h, F4h an octave down) at once, and stops a detune slide. KT00 returns to the notes' own pitch
K Detune Down Lnn Lowers the pitch of everything the channel plays by nn 64ths of a semitone every tick, across notes, until RZ stops it. KL00 reuses the previous rate
K Detune Up Hnn Raises the pitch of everything the channel plays by nn 64ths of a semitone every tick, across notes, until RZ stops it. KH00 reuses the previous rate
K Return Detune Rnn Brings the detune back by nn 64ths of a semitone every tick and stops exactly on the notes' own pitch. KR00 reuses the previous rate
L Semitone Portamento nnn Slides the pitch toward the target note by nnn 256ths of a semitone every tick and stops on it, so L100 glides a semitone a tick at every note. L000 reuses the previous rate
M Sample Offset nnn Jumps the instrument's sample playing on this channel to position nnn and plays on from there
N Note Retrigger xy- Plays the note again every x ticks and changes the volume by y each time: 1–7 quieter, 9–F louder, 0 or 8 unchanged. It keeps going until a new note, an OFF, XX, RS or N00
O Row Length nn- Makes this row last nn ticks longer (01h–7Fh) or shorter (FFh–80h) than the speed, on every channel, so the song stays on the row longer or moves on sooner. O00 changes nothing
P Instrument Step nnr Moves the instrument on this channel to step nn without playing the note again (FF keeps the current step). It plays that step r more times, or keeps it there when r is F
Q Arpeggio Table Nnn Plays arpeggio table nn (01h–FFh) at the table's own speed. QN00 stops the running table
Q Vibrato Table Vnn Plays vibrato table nn (01h–FFh) at the table's own speed. QV00 stops the running table
R Reset S-- Resets all trailing effects and sets channel volume to full (Fh)
R Freeze Slides Z-- Stops the pitch bends, the portamento, the volume slides, the fades and the detune where they are, keeping what they reached. Their rates are remembered
R Continue Slides Y-- Starts the slides the last freeze (RZ) stopped again, each at its own rate, from the pitch and volume where the freeze left them
S Song Speed Snn Sets the song speed to nn (01h–FFh) ticks per row, from this row on
S Swing Wxy Plays this row at x ticks per row and the next at y (1h–Fh each), the rows taking turns until the next SSnn or SWxy. SW00 ends the swing
S Arpeggio Speed Nnn Plays the arpeggio on this channel at nn (01h–FFh) ticks per note instead of the arpeggio's speed. SN00 returns it to the arpeggio's speed
S Instrument Speed Inn Runs the instrument on this channel at nn ticks per step instead of the instrument's speed: 01h–7Fh step forwards, 81h–FFh step backwards. SI80 keeps the current step, and SI00 returns to the instrument's own speed
T Transpose nn- Plays the notes on this channel nn semitones higher (01h–7Fh) or lower (FFh–80h) from this row on, moving the note already playing on a row without one. T00 ends it
U Volume Slide Up nnn Slides channel volume up by rate nnn (001h–FFFh). U000 stops the slide
V Volume Set n-- Sets the channel volume directly to n (0h–Fh). Cancels any active volume slide
W Volume Slide Down nnn Slides channel volume down by rate nnn (001h–FFFh). W000 stops the slide
X Note Delay Lnn Plays the row on this channel nn ticks late: its note, instrument and other effects. XL00 delays nothing
X Note Cut Xnn Cuts the note on this channel nn ticks into the row, as an OFF (===) would. XX00 cuts it at once
Y Sample Trigger mnn Plays sample nn (01h–7Fh) from the sample bank on this channel. Mode m sets what happens to the note: X ends it, M pauses it until the sample ends, T plays the sample over it
Z Sample Retrigger xxy Every xx ticks, returns the instrument's sample playing on this channel to where it was on this row, y times, or until a reset (RS) when y is F

The sample effects M, Y and Z are described in full in Samples.

Mode Letters

Six effect letters have a mode letter right after the effect letter, before any digits. The mode letter says which form of the effect you mean:

Effect Mode letters
Q N plays an arpeggio table (QN05), V a vibrato table (QV05)
S S sets the song speed (SS06), W swings it (SW64), N the arpeggio speed (SN06), I the instrument speed (SI06)
Y X ends the note (YX05), M pauses it (YM05), T plays the sample over it (YT05)
R S resets every running effect (RS), Z freezes the slides (RZ), Y continues them (RY)
K M mutes the note (KM), U unmutes it (KU); V sets the fader (KVA), I and O fade it in and out (KI10, KO10); T sets the detune (KT05), L and H slide it down and up (KL04, KH04), R returns the detune (KR04)
X L delays the note (XL03), X cuts it (XX03)

A mode letter is always one of the letters G to Z, so it is never mistaken for a hex digit. To change the mode, move the cursor to the second place of the effect, right after the effect letter, and type the mode letter. The cursor then moves on to the first digit, unless it moves to the next row. Only that effect's mode letters work there: a hex digit or any other letter typed in that place does nothing. A new Q starts with mode N, a new S with mode S, a new R with mode S, a new K with mode M and a new X with mode L; typing Q, S, R, K or X again over an effect with that letter keeps its mode, so you can retype the letter without losing it.

Songs from earlier versions of RhYMe load and play exactly as before, with their effects shown as this reference writes them. A sample trigger with a digit in place of its mode letter does nothing, and the pattern editor warns about it.

Effect Details

  • E, F Pitch bends: the rate counts 256ths of a tone period per tick, so F100 shortens the period by one unit a tick. Because a period unit is a small step on a low note and a large one on a high note, the same rate bends high notes faster than low ones. A buzzer counts the same units on its own, shorter period, so a buzzer tuned up to the note (envelope Oct 4) bends about sixteen times as far as the square; use I and J to bend both by the same interval. How far the square, the envelope and the timer each follow a bend is set in the instrument's effect matrix. In Non-trailing effects mode, E000 or F000 on the next row continues the bend.
  • I, J Semitone bends: the rate counts 256ths of a semitone per tick, so J100 rises a semitone a tick and twelve ticks of it raise any note by exactly an octave; JFFF rises almost sixteen semitones a tick. They follow the same row of the instrument's effect matrix as E and F, keep their own memory (J000 reuses the last J rate, not an F rate), and an I or J with a value stops a running portamento. In Non-trailing effects mode, I000 or J000 on the next row continues the bend.
  • Choosing between them: use E and F for fine, precise movements, and I and J for wide sweeps, dives and risers that should sound the same on every note. All four continue one bend on the channel, so you can follow one with another, even on the next row, and the pitch carries on from where it got to without a jump. On one row, a later bend replaces an earlier one. A bend stops at the highest or lowest pitch the chip can play, and turns back at once when you bend the other way.
  • G Portamento: the slide starts from the pitch you hear, a pitch bend or semitone bend included, and stops a pitch bend that is still running. The rate counts 16ths of a tone period per tick, so like E and F it glides high notes faster than low ones. A buzzer glides by the same interval as the square, whatever octave it is tuned to, and lands on the note with it. In Non-trailing effects mode, G000 on the next row continues the slide.
  • L Semitone Portamento: works as G does, but the rate counts 256ths of a semitone per tick, so L100 glides a semitone a tick and a glide between two notes takes as many ticks in every octave. G and L continue one glide on the channel toward the same note, so you can follow one with the other and the pitch carries on from where it got to. L keeps its own memory (L000 reuses the last L rate, not a G rate) and follows the same row of the instrument's effect matrix as G. In Non-trailing effects mode, L000 on the next row continues the slide.
  • H Vibrato: the vibrato follows a sine. The instrument's effect matrix sets how far the square, the envelope and the timer each follow it.
  • SInn Instrument Speed: 01h–7Fh step forwards at 1 to 127 ticks per step, and 81h–FFh step backwards at 127 to 1 ticks per step (FFh every tick). Stepping back past the first step, or the loop start, continues from the last step when the instrument loops, and ends it when it does not. It stays in force across notes and instruments until SI00 or RS.
  • SNnn Arpeggio Speed: it applies to the inline arpeggios (A, B) and to arpeggio tables (QNnn), stays in force across notes and for arpeggios you start later, and RS also returns the arpeggio to its own speed.
  • XL Note Delay: a speed or pattern break on the row still applies from the start of the row. A delay as long as the row or longer leaves the row out, and the pattern editor warns about it.
  • N Note Retrigger: each restart plays the instrument again from its first step, as a new row with the instrument would, except that a note muted with KM stays muted. It keeps the same rhythm on the rows after it, so N2F alone fades a note out in echoes. An OFF on the same row wins: nothing is left to play again. To send the instrument to another step without playing the note again, use P.
  • O Row Length: only its own row changes length; the next row lasts as long as the speed again. Slides, vibratos, arpeggios and instruments keep moving while the song waits, so O stalls the song without stalling the sound. Written on any channel, it applies to the whole song; if several channels have it, the last one (A to C) wins. A curve of O over a run of rows slows the song down or speeds it up (see Drawing an Effect Curve).
  • P Instrument Step: steps are numbered as in the step grid, 00h–FEh, and a step the instrument does not have is ignored. r = 0 lets the instrument move on as usual, 1h–Eh plays the step that many more times, and F keeps it there until the instrument is played again or another P lets it go. To play the note again on a rhythm, use N.
  • RZ Freeze Slides: the slides stop where they are, and nothing else changes: unlike RS it leaves the volume, the arpeggios, the vibratos and the other effects alone. Each slide keeps its rate, so F000 on a later row bends on from the frozen pitch. A portamento stopped part way keeps the pitch it reached and the note it was heading for, so G000 on a later row without a note glides on toward it.
  • RY Continue Slides: the slides the last RZ stopped start again, each at the rate it ran at: a bend in its own direction, a portamento toward the note it was heading for and a volume slide in its own direction. A slide written again since the freeze, a volume (V) for the volume slide, a new note without a portamento for the bends and the portamento, or a reset (RS) replaces the frozen slide, which then does not start again. A second RY starts nothing until another RZ.
  • KM Mute Note: the note goes silent from the next tick, but keeps playing unheard: its instrument steps on, its effects keep running, and a timer effect keeps going. A sample stops while the note is muted, and starts again at the unmute from the place it would have reached had it played on. Nothing else changes. The mute lasts until KU or the next note on the channel; a note retrigger (N) and RS leave it alone. Written on the row of a note, it starts that note silent.
  • KU Unmute Note: the muted note is heard again from where it had reached, as if it had been playing all along; it is not played again. A sample carries on from the place it has reached.
  • K Fader and detune: the fader and the detune belong to the channel rather than to its notes, so a new note, a volume (V) and a reset (RS) leave them where they are. A fade in under rows that each set their own volume raises them all together, and a detune slowly lowered and brought back with KR sounds like a record slowing down and coming back up to speed, the notes keeping their intervals. Every side of the instrument follows the detune, its samples included. KVF puts the fader back at full, and KT00 the detune back to zero. KTnn sets the detune at once, a quick way to play a whole channel in another key. The fader lowers what the channel's volume reaches, so it leaves two sounds at their own level, as the volume effect V does: a sample played by the sample trigger (Y), and a sound played through the hardware envelope, such as a buzzer. A fade out at the end of a song therefore fades the rest of the channel but leaves those at full volume.
  • SW Swing: the rows take turns as they play, across patterns and pattern breaks, so write it on the first row of a pattern to start each pass on x. Both speeds apply to the whole song, whichever channel the effect is on. SSnn ends the swing, and RS leaves it alone. SW00 ends the swing and returns to the song speed: the speed of the last SSnn before the swing, or the song's own speed if there was none. A speed of 0 in only one place sets nothing: the effect is ignored, and the pattern editor warns about it.
  • T Transpose: it moves the note on its own row and every note after it. TFF is a semitone down and TF4 an octave down. Written on a row without a note, it moves the note already sounding, which carries on as a legato note does; T00 and RS end it, and move the sounding note back.
  • XX Note Cut: the note sounds for nn ticks. A cut as long as the row or longer does nothing, and the pattern editor warns about it.

Trailing Effects

Effects differ in whether they continue across subsequent rows or only apply to the row they are written on:

Effects Behavior
A, B (Arpeggio) Continue each tick until A00/B000 or RS; a new note restarts the cycle
U, W (Volume slides) Continue each tick until a new U/W, U000/W000, V or RS
QNnn (Arpeggio table) Continue across rows, notes, and instrument changes. QN00 stops
QVnn (Vibrato table) Same as QNnn but for vibrato. QV00 stops
H (Vibrato) Continues each tick across rows, notes, and instruments. H00 stops
E, F (Pitch bends) Continue each tick at the stored rate until a new note, a G, L or RS
I, J (Semitone bends) Continue each tick at the stored rate until a new note, a G, L or RS
G, L (Portamento) Continues gliding until the target is reached
Z (Sample retrigger) Keeps returning the sample until done, RS, a new sample or another Z
SInn (Instrument speed) Stays in force across rows and notes. SI00 or RS stops it
SNnn (Arpeggio speed) Stays in force across rows and notes. SN00 or RS stops it
T (Transpose) Moves the notes from its own row on. T00 or RS stops it
N (Note retrigger) Restarts across rows until N00, a new note, OFF, XX or RS
KM (Mute note) Keeps the note silent until KU or a new note, in either effects mode
KI, KO (Fades) Run until the fader is full or silent. KV or RZ stops them
KL, KH (Detune) Run across notes until RZ, KT, KR or the other one, either mode
KR (Return detune) Runs until the detune is back at zero, in either mode
SWxy (Swing) Stays in force across rows until SSnn or another SWxy, in either mode
All others Take effect on the row they appear and do not carry forward

Effects mode

With the song's Effects mode set to Non-trailing, none of these effects carry forward: each applies only to its own row. Written on consecutive rows they still sound continuous, and 000h on E, F, G, I, J or L reuses the previous rate.

Effect Evaluation Order

A row is applied to its channel in this order:

  1. In Non-trailing effects mode, every trailing effect on the channel ends first. Then the row's note delay (XL) is read: a delayed row takes only its speed, pattern break and row length here, and plays the rest later in the row.
  2. The note becomes the channel's pitch, or the target of a portamento (G, L) on the row. The channel's transposition, which the row's own T and RS settle first, moves it.
  3. The instrument column: an OFF ends the instrument, a number starts the instrument from its first step, and a note without a number carries on with the instrument the channel already plays.
  4. The effects, left to right. Where two effects on the row set the same thing, the one further right wins. A sample triggered with Y is always the last thing the row applies, whatever its column.
  5. A speed change (SSnn) applies at once, so its own row already lasts the new number of ticks, lengthened or shortened by a row length effect (O) on the row; a pattern break (D00) moves on to the next song position at the end of the row, and a row skip (Dnn) moves on past the nn rows below it.

Instrument Step Parameter Reference

Opened from Help > Instrument Step Parameter Reference or Ctrl+Shift+I.

This window lists every instrument step field with its column header, display format, valid range, and behavior.

Complete Parameter Reference

Group Column Label Range Description
Step 00h–FFh Step number (display only)
Global Mode Tone mode 0h–5h Tone mode: 0h off, 1h square, 2h envelope, 3h square drives envelope, 4h envelope drives square, 5h both
Global Vol Volume 0h–Fh Channel volume (0h=silent, Fh=full)
Global Noise Noise period 00h–1Fh Noise period: the higher the value, the lower the noise. Enables noise when set; -- disables
Square Per Square period 000h–FFFh Forced square period. Overrides note pitch when set; Pitch still fine-tunes it
Square Oct Square octave −8h–+8h Octave offset for the square side's pitch (twelve semitones per octave)
Square Trans Square transposition −60h–+60h Semitone offset for square side pitch
Square Pitch Square pitch −FFFh–+FFFh Pitch offset in period units for square side
Envelope Shape Envelope shape 0h–Fh Hardware envelope shape
Envelope Per Envelope period 0000h–FFFFh Forced envelope period. Overrides note pitch when set. Hover to see the pitch it produces and how far off the nearest note it lands
Envelope Oct Envelope octave −8h–+8h Octave offset for the envelope side's pitch (twelve semitones per octave)
Envelope Trans Envelope transposition −60h–+60h Semitone offset for envelope side pitch
Envelope Pitch Envelope pitch −FFFh–+FFFh Pitch offset in period units for envelope side
Envelope Ratio Envelope ratio 0h–Fh Envelope ratio for the drive modes: the driven side's period is the other side's halved or doubled this many times
Envelope Ret Envelope retrigger R = on, - = off Retrigger hardware envelope on this step
Envelope Fol Follow envelope F = on, - = off Put the channel in envelope mode without taking the envelope generator, so its volume follows the envelope another channel plays
Sample Ofs Sample offset 000h–FFFh Place in the instrument's own sample to jump to when the step is reached, as M does. --- lets the sample play on
Sample Pause Sample pause P = on, - = off Pause the instrument's own sample, until the next step without the pause plays it on from where it stopped
Timer Mode Timer mode 0h–4h Timer mode: 0h=Off, 1h=PWM, 2h=ESY (envelope synchronization), 3h=EVM (envelope volume modulation), 4h=WVT (wavetable)
Timer Per Timer period 0000h–FFFFh Forced timer period. Overrides square period when set
Timer Oct Timer octave −8h–+8h Octave offset for the timer rate (twelve semitones per octave)
Timer Trans Timer transposition −60h–+60h Timer transposition in semitones
Timer Pitch Timer pitch −FFFh–+FFFh Timer pitch offset in period units
Timer Vol PWM volume 0h–Fh Level of the quiet half of a pulse width, PWM mode only. - leaves that half silent
Timer Wave Wavetable 01h–7Fh Number of the wavetable the step plays in wavetable mode, from the Wavetables tab. -- plays none

Parameter Matrix

Not every parameter is heard on every step: the tone mode decides which generators run, the timer mode whether an audio-rate effect runs, and a period written on a step replaces some of the parameters around it. This matrix shows which parameter is heard in which tone mode, and which use a sound source the three channels share. The columns are the values of the Mode column, listed in full under Tone Modes below.

Group Column 0h 1h 2h 3h 4h 5h Shared Notes
Global Mode ● ● ● ● ● ● -
Global Vol ○ ● ○ ○ ○ ○ - 2
Global Noise ● ● ● ● ● ● N
Square Per · ● · ● ● ● - 1
Square Oct · ○ · ○ ○ ○ - 3, 4
Square Trans · ○ · ○ ○ ○ - 3, 4
Square Pitch · ● · ● ○ ● - 4
Envelope Shape · · ● ● ● ● E
Envelope Per · · ● ● ● ● E 1
Envelope Oct · · ○ ○ ○ ○ E 3, 5
Envelope Trans · · ○ ○ ○ ○ E 3, 5
Envelope Pitch · · ● ● ● ● E
Envelope Ratio · · · ○ ○ · E 6
Envelope Ret · · ○ ○ ○ ○ E 7
Envelope Fol ● ● ○ ○ ○ ○ E 14
Sample Ofs ○ ○ ○ ○ ○ ○ T 13
Sample Pause ○ ○ ○ ○ ○ ○ T 13
Timer Mode ○ ● ● ● ● ● T 8, 11
Timer Per ○ ● ● ● ● ● T 1, 8, 11
Timer Oct ○ ● ● ● ● ● T 8, 11
Timer Trans ○ ● ● ● ● ● T 8, 11
Timer Pitch ○ ● ● ● ● ● T 8, 11
Timer Vol · ○ · ○ ○ · T 8, 10
Timer Wave ○ ○ ○ ○ ○ ○ T 8, 11

Legend

Symbol Meaning
● The parameter is heard in this tone mode
○ Heard in this tone mode only where the numbered note applies
· No effect in this tone mode, whatever the parameter is set to
N Shared: sets the one noise generator, which all three channels hear
E Shared: sets the one envelope generator, which only one channel can use at a time
T Shared: needs one of the machine's timers, which the channels take in turn
- Not shared: this side of the sound is the channel's own

The Timer rows show only that some timer effect runs in that tone mode. Which one does is the next table.

Which Timer Mode Runs in Which Tone Mode

The columns are the tone modes, as above.

# Timer mode 0h 1h 2h 3h 4h 5h Notes
1 Pulse-width modulation · ● · ● ● ● 8, 9
2 Envelope synchronization · · ● ● ● ● 8
3 Envelope volume modulation · · ● ● ● ● 8, 12
4 Wavetable ● ● ● ● ● ● 8, 11

Notes

  1. A period written on the step replaces the note for that side. Only the step's pitch offset still fine-tunes it (see note 3).
  2. In the four envelope modes the envelope sets the level, so the step's volume is heard only while another channel has the envelope generator, or in envelope volume modulation, where it sets how far the envelope rises. In Envelope only and Off, it is heard only where the step also sets a noise period. In wavetable mode it is heard in every tone mode, making the whole wavetable quieter.
  3. The octave and the transposition are not applied to a period written on the step for the same side; that period plays as it stands. The pitch offset is still applied to it.
  4. In envelope-drives-square the square's pitch is worked out from the envelope whenever the ratio is anything but 0, so the square's own octave, transposition and pitch offset are not heard. Write a square period to play the square as stated instead.
  5. In square-drives-envelope the envelope's pitch is worked out from the square whenever the ratio is anything but 0, so the envelope's own octave and transposition are not heard. Write an envelope period to play the envelope as stated instead.
  6. The ratio works only in the two drive modes, and only on the side left to be worked out: it is ignored once the step writes an envelope period in square-drives-envelope, or a square period in envelope-drives-square. A drive mode with a ratio of 0 plays as square and envelope (5h).
  7. Restarts the envelope only on the channel that currently has the envelope generator, and does nothing at all while the timer mode is envelope synchronization or envelope volume modulation, which restart it already.
  8. An effect that needs a timer takes one of the song's timers for as long as it sounds: three to begin with, four when the song adds Timer C, and fewer when it reserves some. A channel that starts an effect when none is free sounds without it.
  9. Pulse-width modulation runs in every tone mode that plays the square, whatever the envelope shape. Beside the envelope, the loud half follows the envelope and the quiet half stays at the PWM volume.
  10. The PWM volume is heard only where pulse-width modulation runs, as the level of its quiet half.
  11. A wavetable writes the channel's volume itself, so it plays in every tone mode, Off included, and is the only timer mode that runs in Off. The Wave column is heard only in wavetable mode. A step playing a wavetable leaves the whole Envelope group unheard, whatever its tone mode.
  12. Envelope volume modulation sets the envelope's shape and period itself and takes the timer's rate from the envelope side, so the step's envelope Shape and Per and the timer's own Per, Oct, Trans and Pitch are not heard. The step volume sets how far each restarted envelope rises.
  13. The sample offset and the sample pause move and pause the instrument's own sample, which plays through every tone mode. Both act as the instrument reaches the step. An offset starts the sample again if it has run out or was paused, and a step without the pause plays a paused sample on from where it stopped.
  14. Follow envelope lets a channel's volume be shaped by the envelope another channel plays, without taking the envelope generator for itself. In the four envelope modes it is heard only while the channel is denied the generator, which it then follows instead of playing at its own volume; a wavetable sets the volume itself and ignores it.

Reading the shared column at a glance

Only one channel at a time gets the envelope generator, and timer effects compete for the song's timers. Compare the E and T rows of your instruments with your pattern to spot such clashes.

Tone Modes

Value Mode Description
0h Off No generators active. Noise may still be active, and the step's volume then sets its level
1h Square only Square wave generator only. Fixed volume
2h Envelope only Envelope generator only. Envelope-controlled volume
3h Square drives envelope Square period drives envelope period via ratio
4h Envelope drives square Envelope period drives square period via ratio
5h Square and envelope Both generators active independently

Note Period Table

The square period that plays each note, in hexadecimal, as written in an instrument step's square Per column. A-4 is 440 Hz; the frequency in hertz is 125,000 divided by the period. A song with its own tuning table, and the instrument's Tuning, play other periods. See Notes and Periods.

Note Octave 1 Octave 2 Octave 3 Octave 4 Octave 5 Octave 6 Octave 7
C- EEEh 777h 3BCh 1DEh 0EFh 077h 03Ch
C# E18h 70Ch 386h 1C3h 0E1h 071h 038h
D- D4Dh 6A7h 353h 1AAh 0D5h 06Ah 035h
D# C8Eh 647h 324h 192h 0C9h 064h 032h
E- BDAh 5EDh 2F6h 17Bh 0BEh 05Fh 02Fh
F- B2Fh 598h 2CCh 166h 0B3h 059h 02Dh
F# A8Fh 547h 2A4h 152h 0A9h 054h 02Ah
G- 9F7h 4FCh 27Eh 13Fh 09Fh 050h 028h
G# 968h 4B4h 25Ah 12Dh 096h 04Bh 026h
A- 8E1h 470h 238h 11Ch 08Eh 047h 024h
A# 861h 431h 218h 10Ch 086h 043h 022h
B- 7E9h 3F4h 1FAh 0FDh 07Fh 03Fh 020h

Each octave halves the period of the octave below. Notes below B-0 are deeper than the square can play and sound at its longest period, FFFh. The envelope's pitch works in coarser steps; hover the envelope Per column to see the pitch a period produces (see Envelope Tuning).

Keyboard Shortcut Reference

Opened from Help > Keyboard Shortcut Reference or Ctrl+Shift+K.

This window lists all available keyboard shortcuts grouped by usage area.

The search finds a shortcut by its keys as well as by its action and description.

A Cheat Sheet (PDF) button opens the keyboard cheat sheet that comes with RhYMe, a PDF of every shortcut for the platform you are using.

The tables below are a selection of the shortcuts you will use most. The Keyboard Shortcut Reference window and its cheat sheet list every one, including those of the playlist, the song editor, the instrument browser and the mouse.

File Shortcuts

Key Action
Ctrl+N New song
Ctrl+O Open song
Ctrl+S Save song
Ctrl+Shift+S Save song as
Ctrl+Shift+O Open Last Song (no effect when there is no last song to load)
Ctrl+Shift+X Export WAV (opens the export dialog pre-selected to WAV); nothing while a playlist is showing
Ctrl+Shift+M Export MP3 (opens the export dialog pre-selected to MP3); nothing while a playlist is showing
Ctrl+Shift+H Export SNDH Container (.sndh): the song, or every song of the playlist while its list is showing
Ctrl+Shift+P Export Atari ST Program (.prg): the song, or every song of the playlist while its list is showing

Playlist Shortcuts

These work while the playlist is showing. They are the same keys that walk the instrument list in the editor, which is not on screen then.

Shortcut Action
Ctrl+[ Move to the song before the selected one, playing it if the set is playing
Ctrl+] Move to the song after the selected one, playing it if the set is playing

Playback Shortcuts

Key Action
F5 / Shift+Space Play song from beginning
Space Play song from current position (when nothing is playing)
F6 / Ctrl+Space Play pattern (loop current pattern)
Shift+F6 Play the pattern from the cursor and loop it; while something is playing, jumps to the cursor
Ctrl+F6 Play the selected rows in a loop (at least two rows)
Shift+F7 / Ctrl+Shift+Space Play from cursor; while something is playing, switches it to this mode
F7 / Alt+Shift+Space Pause the song where it stands, or resume it
F8 / Esc / Space Stop playback, a held song or a preview (Space only while playing or held)
Ctrl+F5 Play song (ignore temp loop)
Alt+Z / Alt+X / Alt+C Toggle mute for channel A/B/C, in the pattern grid or the playlist
Alt+Shift+Z / Alt+Shift+X / Alt+Shift+C Toggle solo for channel A/B/C, in the pattern grid or the playlist
Alt+0 Mute or unmute all channels. In the editor, when the song has a tenth instrument, it selects that instrument instead (see Instrument Shortcuts)
Alt+M Turn the metronome on or off
Alt+N Turn the count-in on or off
Key Action
Arrow keys Move cursor; hold Shift to extend selection
Alt+Left / Alt+Right In the pattern grid, Alt+Left goes to the start of the channel the cursor is on, and to the start of the channel before it when already there, and Alt+Right jumps to the next channel, or to the right edge of the last one; in the step grid they move by step group in the same way; in the arpeggio and vibrato grids, move to the start of the previous/next cell
Tab / Shift+Tab Next/previous channel; next/previous step group in the step grid
PageUp / PageDown Move the cursor 16 rows
Home / End Jump to first/last row (pattern editor) or first/last slot (song editor)
Ctrl+Left / Ctrl+Right Move to the start of the previous/next cell in the pattern grid and the step grid, skipping the digits in between
Shift+Enter Move down one row, onto the start of the cell, in the pattern grid
Ctrl+Up / Ctrl+Down Scroll the pattern view, or the step grid, without moving the cursor
Ctrl+Shift+Left / Ctrl+Shift+Right Extend the selection by one cell to the left/right in the pattern grid and the step grid
Alt+Shift+Left / Alt+Shift+Right The same movement as Alt+Left / Alt+Right in the pattern grid and the step grid, extending the selection as it goes, so whole channels or step groups can be selected from either side
Alt+Shift+Up / Alt+Shift+Down Extend a full-row selection up/down by one row
Ctrl+Alt+Shift+Up / Ctrl+Alt+Shift+Down Extend a full-row selection up/down by the edit step
Ctrl+, / Ctrl+. Previous/next song position
Ctrl+Shift+, / Ctrl+Shift+. First/last song position
F9 / Ctrl+Enter Focus pattern editor
Ctrl+` Focus song editor
Ctrl+Tab / Ctrl+Shift+Tab Move focus to the next/previous control, from anywhere including the pattern grid

Edit Mode and Entry

Key Action
Enter Toggle Edit Mode (when pattern editor focused)
Shift+O Enter OFF note (===) at cursor; on an effect's letter it types O, and elsewhere in an effect it does nothing
Shift + Note Key Flip the Auto-instrument toggle and Auto-cursor advance for that note (legato, and staying on the row, when both are on)
= / - (or Numpad + / -) Increase/decrease keyboard entry octave
Shift+= / Shift+- (or Shift+Numpad + / Shift+Numpad -) Increase/decrease edit step
` Set octave to 0
F1–F4 Set octave to 1–4
Shift+F1–Shift+F4 Set octave to 5–8
[ / ] Decrement/increment note by one semitone
Alt+Down / Alt+Up Alternate binding for [ / ], easier to reach on compact macOS keyboards
Alt+Ctrl+Down / Alt+Ctrl+Up Transpose down/up by one octave (-12/+12)
Shift+[ / Shift+] Transpose by one octave

Editing Shortcuts

Key Action
Ctrl+R Rename selected list item (when an instrument, sample, wavetable, arpeggio, or vibrato list is focused)
Ctrl+Z / Ctrl+Shift+Z Undo / Redo
Ctrl+X / Ctrl+C / Ctrl+V Cut / Copy / Paste
Ctrl+Shift+V Paste and Advance
Ctrl+Alt+O Paste Overlay
Ctrl+Alt+U Paste Underlay
Ctrl+Alt+I Paste Insert
Del Delete selection or current row
Shift+Del Delete row on all channels
Ins Insert blank row
Shift+Ins Insert blank row on all channels
Ctrl+Backspace Clear track row, then move the cursor as Auto-cursor advance does
Ctrl+Shift+Backspace Clear pattern row, then move the cursor as Auto-cursor advance does
Alt+Backspace Clear current track
Alt+Shift+Backspace Clear current pattern
Ctrl+D Duplicate (context-sensitive)
Ctrl+Shift+D Stamp Down
Ctrl+Shift+R Reverse Content
Ctrl+G Transform (stretch or compress)
Ctrl+K Draw an effect as a curve
Ctrl+Shift+N Add new (context-sensitive)
Ctrl+L Select row
Ctrl+T Select track
Ctrl+Shift+T Select column
Ctrl+A Select pattern

Instrument Shortcuts

Key Action
Ctrl+[ / Ctrl+] Select previous/next instrument
Alt+1–Alt+9 Select instrument 1–9 directly, in the pattern grid too
Alt+0 Select instrument 10 directly, when the song has one; otherwise, and always in the playlist, it mutes or unmutes all channels
/ Preview the selected instrument
Shift+/ Preview the current instrument step
Ctrl+/ Preview the current instrument step on loop
Alt+/ Preview the note at the pattern editor cursor
Alt+/ Away from the pattern editor: preview the selected instrument looped, or on the Samples tab the selected sample looped
Ctrl+H Replace this instrument with another (scope follows what has focus)
Ctrl+K Draw the step parameter under the cursor as a curve
Ctrl+/ In the instrument browser and the curve editor: preview the selected instrument looped
`, F1–F4, Shift+F1–Shift+F4, = / - In the instrument browser and the curve editor: choose or step the octave the note keys play in, as in the main window

View Shortcuts

Ctrl+F, Ctrl+E, Ctrl+I, Ctrl+U and Ctrl+J work while the pattern grid has the keyboard; the others work anywhere in the window.

Key Action
Ctrl+F Toggle Follow Playback
Ctrl+E Toggle Center Scroll during Playback
Ctrl+I Toggle Auto-instrument
Ctrl+U Turn Auto-cursor advance off, or back on
Ctrl+J Toggle Enter chords as arpeggios (while a MIDI device is active)
Alt+Shift+1 Auto-cursor advance by single line
Alt+Shift+2 Auto-cursor advance by edit step
Alt+Shift+3 Auto-cursor advance hopping over gaps
Ctrl+P Collapse / expand the pattern editor
Ctrl+Shift+G Show / hide the song editor's event strip
Ctrl+- Zoom the interface out
Ctrl+= Zoom the interface in
Ctrl+0 Reset the interface zoom to 100%
Ctrl+1 … Ctrl+6 Open an editor tab: Song, Instruments, Arpeggios, Vibratos, Samples, Wavetables

Reference Shortcuts

Key Action
Ctrl+Shift+E Open Tracker Effect Reference
Ctrl+Shift+I Open Instrument Step Parameter Reference
Ctrl+Shift+K Open Keyboard Shortcut Reference