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, ⇞ / ⇟ and ↖ / ↘ scroll the list, even while you type in the search box.
Tracker Effect Reference
Opened from Help > Tracker Effect Reference or ⇧⌘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,FPitch bends: the rate counts 256ths of a tone period per tick, soF100shortens 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 Oct4) bends about sixteen times as far as the square; useIandJto 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,E000orF000on the next row continues the bend.I,JSemitone bends: the rate counts 256ths of a semitone per tick, soJ100rises a semitone a tick and twelve ticks of it raise any note by exactly an octave;JFFFrises almost sixteen semitones a tick. They follow the same row of the instrument's effect matrix asEandF, keep their own memory (J000reuses the lastJrate, not anFrate), and anIorJwith a value stops a running portamento. In Non-trailing effects mode,I000orJ000on the next row continues the bend.- Choosing between them: use
EandFfor fine, precise movements, andIandJfor 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. GPortamento: 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 likeEandFit 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,G000on the next row continues the slide.LSemitone Portamento: works asGdoes, but the rate counts 256ths of a semitone per tick, soL100glides a semitone a tick and a glide between two notes takes as many ticks in every octave.GandLcontinue 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.Lkeeps its own memory (L000reuses the lastLrate, not aGrate) and follows the same row of the instrument's effect matrix asG. In Non-trailing effects mode,L000on the next row continues the slide.HVibrato: the vibrato follows a sine. The instrument's effect matrix sets how far the square, the envelope and the timer each follow it.SInnInstrument Speed:01h–7Fhstep forwards at 1 to 127 ticks per step, and81h–FFhstep backwards at 127 to 1 ticks per step (FFhevery 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 untilSI00orRS.SNnnArpeggio 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, andRSalso returns the arpeggio to its own speed.XLNote 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.NNote Retrigger: each restart plays the instrument again from its first step, as a new row with the instrument would, except that a note muted withKMstays muted. It keeps the same rhythm on the rows after it, soN2Falone 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, useP.ORow 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, soOstalls 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 ofOover a run of rows slows the song down or speeds it up (see Drawing an Effect Curve).PInstrument Step: steps are numbered as in the step grid,00h–FEh, and a step the instrument does not have is ignored.r=0lets the instrument move on as usual,1h–Ehplays the step that many more times, andFkeeps it there until the instrument is played again or anotherPlets it go. To play the note again on a rhythm, useN.RZFreeze Slides: the slides stop where they are, and nothing else changes: unlikeRSit leaves the volume, the arpeggios, the vibratos and the other effects alone. Each slide keeps its rate, soF000on 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, soG000on a later row without a note glides on toward it.RYContinue Slides: the slides the lastRZstopped 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 secondRYstarts nothing until anotherRZ.KMMute 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 untilKUor the next note on the channel; a note retrigger (N) andRSleave it alone. Written on the row of a note, it starts that note silent.KUUnmute 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.KFader 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 withKRsounds 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.KVFputs the fader back at full, andKT00the detune back to zero.KTnnsets 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 effectVdoes: 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.SWSwing: 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 onx. Both speeds apply to the whole song, whichever channel the effect is on.SSnnends the swing, andRSleaves it alone.SW00ends the swing and returns to the song speed: the speed of the lastSSnnbefore the swing, or the song's own speed if there was none. A speed of0in only one place sets nothing: the effect is ignored, and the pattern editor warns about it.TTranspose: it moves the note on its own row and every note after it.TFFis a semitone down andTF4an octave down. Written on a row without a note, it moves the note already sounding, which carries on as a legato note does;T00andRSend it, and move the sounding note back.XXNote Cut: the note sounds fornnticks. 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:
- 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. - 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 ownTandRSsettle first, moves it. - 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.
- The effects, left to right. Where two effects on the row set the same thing, the one further right wins. A sample triggered with
Yis always the last thing the row applies, whatever its column. - 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 thennrows below it.
Instrument Step Parameter Reference
Opened from Help > Instrument Step Parameter Reference or ⇧⌘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
- 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).
- 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.
- 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.
- 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.
- 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.
- 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). - 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.
- 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.
- 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.
- The PWM volume is heard only where pulse-width modulation runs, as the level of its quiet half.
- 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
Wavecolumn is heard only in wavetable mode. A step playing a wavetable leaves the whole Envelope group unheard, whatever its tone mode. - 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
ShapeandPerand the timer's ownPer,Oct,TransandPitchare not heard. The step volume sets how far each restarted envelope rises. - 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.
- 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 ⇧⌘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 |
|---|---|
⌘N |
New song |
⌘O |
Open song |
⌘S |
Save song |
⇧⌘S |
Save song as |
⇧⌘O |
Open Last Song (no effect when there is no last song to load) |
⇧⌘X |
Export WAV (opens the export dialog pre-selected to WAV); nothing while a playlist is showing |
⇧⌘M |
Export MP3 (opens the export dialog pre-selected to MP3); nothing while a playlist is showing |
⇧⌘H |
Export SNDH Container (.sndh): the song, or every song of the playlist while its list is showing |
⇧⌘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 |
|---|---|
⌘[ |
Move to the song before the selected one, playing it if the set is playing |
⌘] |
Move to the song after the selected one, playing it if the set is playing |
Playback Shortcuts
| Key | Action |
|---|---|
F5 / ⇧Space |
Play song from beginning |
Space |
Play song from current position (when nothing is playing) |
F6 / ⌥Space |
Play pattern (loop current pattern) |
⇧F6 |
Play the pattern from the cursor and loop it; while something is playing, jumps to the cursor |
⌘F6 |
Play the selected rows in a loop (at least two rows) |
⇧F7 / ⇧⌘Space |
Play from cursor; while something is playing, switches it to this mode |
F7 / ⌥⇧Space |
Pause the song where it stands, or resume it |
F8 / ⎋ / Space |
Stop playback, a held song or a preview (Space only while playing or held) |
⌥F5 |
Play song (ignore temp loop) |
⌥Z / ⌥X / ⌥C |
Toggle mute for channel A/B/C, in the pattern grid or the playlist |
⌥⇧Z / ⌥⇧X / ⌥⇧C |
Toggle solo for channel A/B/C, in the pattern grid or the playlist |
⌥0 |
Mute or unmute all channels. In the editor, when the song has a tenth instrument, it selects that instrument instead (see Instrument Shortcuts) |
⌥M |
Turn the metronome on or off |
⌥N |
Turn the count-in on or off |
Navigation Shortcuts
| Key | Action |
|---|---|
| Arrow keys | Move cursor; hold Shift to extend selection |
⌥← / ⌥→ |
In the pattern grid, ⌥← goes to the start of the channel the cursor is on, and to the start of the channel before it when already there, and ⌥→ 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 |
⇥ / ⇧⇥ |
Next/previous channel; next/previous step group in the step grid |
⇞ / ⇟ |
Move the cursor 16 rows |
↖ / ↘ |
Jump to first/last row (pattern editor) or first/last slot (song editor) |
⌘← / ⌘→ |
Move to the start of the previous/next cell in the pattern grid and the step grid, skipping the digits in between |
⇧↩ |
Move down one row, onto the start of the cell, in the pattern grid |
⌥⌘↑ / ⌥⌘↓ |
Scroll the pattern view, or the step grid, without moving the cursor |
⇧⌘← / ⇧⌘→ |
Extend the selection by one cell to the left/right in the pattern grid and the step grid |
⌥⇧← / ⌥⇧→ |
The same movement as ⌥← / ⌥→ 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 |
⌥⇧↑ / ⌥⇧↓ |
Extend a full-row selection up/down by one row |
⌥⇧⌘↑ / ⌥⇧⌘↓ |
Extend a full-row selection up/down by the edit step |
⌃, / ⌃. |
Previous/next song position |
⌃⇧, / ⌃⇧. |
First/last song position |
F9 / ⌘↩ |
Focus pattern editor |
⌃` |
Focus song editor |
⌃⇥ / ⌃⇧⇥ |
Move focus to the next/previous control, from anywhere including the pattern grid |
Edit Mode and Entry
| Key | Action |
|---|---|
↩ |
Toggle Edit Mode (when pattern editor focused) |
⇧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 |
⇧= / ⇧- (or ⇧Numpad + / ⇧Numpad -) |
Increase/decrease edit step |
` |
Set octave to 0 |
F1–F4 |
Set octave to 1–4 |
⇧F1–⇧F4 |
Set octave to 5–8 |
[ / ] |
Decrement/increment note by one semitone |
⌘↓ / ⌘↑ |
Alternate binding for [ / ], easier to reach on compact macOS keyboards |
⇧⌘↓ / ⇧⌘↑ |
Transpose down/up by one octave (-12/+12) |
⇧[ / ⇧] |
Transpose by one octave |
Editing Shortcuts
| Key | Action |
|---|---|
⌘R |
Rename selected list item (when an instrument, sample, wavetable, arpeggio, or vibrato list is focused) |
⌘Z / ⇧⌘Z |
Undo / Redo |
⌘X / ⌘C / ⌘V |
Cut / Copy / Paste |
⇧⌘V |
Paste and Advance |
⌥⌘O |
Paste Overlay |
⌥⌘U |
Paste Underlay |
⌥⌘I |
Paste Insert |
⌦ |
Delete selection or current row |
⇧⌦ |
Delete row on all channels |
⌃O |
Insert blank row |
⌃⇧O |
Insert blank row on all channels |
⌘⌫ |
Clear track row, then move the cursor as Auto-cursor advance does |
⇧⌘⌫ |
Clear pattern row, then move the cursor as Auto-cursor advance does |
⌥⌫ |
Clear current track |
⌥⇧⌫ |
Clear current pattern |
⌘D |
Duplicate (context-sensitive) |
⇧⌘D |
Stamp Down |
⇧⌘R |
Reverse Content |
⌘G |
Transform (stretch or compress) |
⌘K |
Draw an effect as a curve |
⇧⌘N |
Add new (context-sensitive) |
⌘L |
Select row |
⌘T |
Select track |
⇧⌘T |
Select column |
⌘A |
Select pattern |
Instrument Shortcuts
| Key | Action |
|---|---|
⌘[ / ⌘] |
Select previous/next instrument |
⌥1–⌥9 |
Select instrument 1–9 directly, in the pattern grid too |
⌥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 |
⇧/ |
Preview the current instrument step |
⌘/ |
Preview the current instrument step on loop |
⌥/ |
Preview the note at the pattern editor cursor |
⌥/ |
Away from the pattern editor: preview the selected instrument looped, or on the Samples tab the selected sample looped |
⌥⌘F |
Replace this instrument with another (scope follows what has focus) |
⌘K |
Draw the step parameter under the cursor as a curve |
⌘/ |
In the instrument browser and the curve editor: preview the selected instrument looped |
`, F1–F4, ⇧F1–⇧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
⌘F, ⌘E, ⌘I, ⌘U and ⌘J work while the pattern grid has the keyboard; the others work anywhere in the window.
| Key | Action |
|---|---|
⌘F |
Toggle Follow Playback |
⌘E |
Toggle Center Scroll during Playback |
⌘I |
Toggle Auto-instrument |
⌘U |
Turn Auto-cursor advance off, or back on |
⌘J |
Toggle Enter chords as arpeggios (while a MIDI device is active) |
⌥⇧1 |
Auto-cursor advance by single line |
⌥⇧2 |
Auto-cursor advance by edit step |
⌥⇧3 |
Auto-cursor advance hopping over gaps |
⌘P |
Collapse / expand the pattern editor |
⇧⌘G |
Show / hide the song editor's event strip |
⌘- |
Zoom the interface out |
⌘= |
Zoom the interface in |
⌘0 |
Reset the interface zoom to 100% |
⌘1 … ⌘6 |
Open an editor tab: Song, Instruments, Arpeggios, Vibratos, Samples, Wavetables |
Reference Shortcuts
| Key | Action |
|---|---|
⇧⌘E |
Open Tracker Effect Reference |
⇧⌘I |
Open Instrument Step Parameter Reference |
⇧⌘K |
Open Keyboard Shortcut Reference |