Skip to content

Creating Instruments

This guide shows how to build instruments, from square-wave leads to timer-driven sounds. For the controls, see 9. Instrument Editor.

To start with a ready-made sound, choose Browse Standard Library (⌥⌘K) on the instrument list's toolbar. You can listen to RhYMe's instruments, add them to your song and adjust them (see Instrument Browser).

Lead

A lead carries the melody and needs a clear tone that cuts through the mix.

Start with Square Only mode (mode 1) on the first step and Vol at Fh (full). Keep the instrument Speed at its default of 1, as all the recipes here do.

Add a second step with a slightly lower volume, such as Dh, and set the loop start on it, so the note sustains at that level while it is held. For a percussive lead, drop the volume over 2–3 steps without a loop instead: a new instrument loops from its first step, so put the cursor on that step and press ⌘L to clear the loop.

Lead instrument

Vibrato

For a vibrato on every note, set Vibrato on the instrument's Parameters tab. For one you start and stop in the pattern, use the H effect or a vibrato table (QVnn).

Arpeggio

Write A47 on the row of a lead note to cycle it through a major chord (the note, then 4 and 7 semitones up), without editing the instrument.

Hard Bass

Hard bass uses Square Drives Envelope mode (mode 3) for the punchy bass typical of Atari ST chip music. Create an instrument with 1–2 steps in mode 3:

  • Set the envelope Shape to one that repeats, such as 8h (falling saw), Ah (falling triangle), Ch (rising saw) or Eh (rising triangle). A shape that runs once, such as 9h, falls silent after a moment
  • Set the envelope Ratio to 2h–4h. Each step moves the envelope an octave: higher is brighter and buzzier, lower is deeper
  • Leave Vol at Fh: in envelope modes the envelope sets the level
  • Leave the envelope Per unset, so the envelope ratio derives it from the square, unless you want a fixed envelope frequency

If some notes come out quieter than others, detune the square and the envelope a little, or drop the envelope an octave and let the square carry the fundamental. Higher up the keyboard a hard bass starts to sound flat; there, drop the envelope an octave or use the Envelope synchronization timer mode (see An In-Tune Buzzer and 8. Sound Generation).

Hard bass instrument

Drums and Percussion

Drums on the YM2149 are built mostly from the noise generator, often with a short square-wave burst whose pitch drops quickly, as in the drums of the Standard Library.

A drum plays once, so it must not loop: on a new instrument, put the cursor on the first step and press ⌘L to clear the loop.

Make a drum Achromatic with Type on the Parameters tab. It then sounds the same whatever note you enter, its notes show as hits in the pattern, and transpositions leave them alone.

Kick Drum

Use Off mode (mode 0) with a noise period set:

  • Step 1: noise period 1Fh (lowest frequency), volume Fh, for a deep, rumbling attack
  • Step 2: noise period 0Ch–10h (mid frequency), volume 8h

Add more steps for a longer kick.

Kick drum instrument

Snare

A snare combines a short square-wave burst, which gives the hit its body, with noise that rattles on after it. Lower the volume on every step so the hit fades:

  • Steps 1–3: Square Only mode (mode 1), square Per 1C0h, 200h, then 240h, so the burst drops in pitch; noise period 08h, 08h, then 0Ah; volume Fh, Eh, then Dh
  • Steps 4–10: Off mode (mode 0), noise only, its period rising from 0Ah to 10h so the rattle darkens as it fades; volume falling from Ch to 3h

Writing the square Per keeps the burst at the same pitch whatever note you enter. For a snare with the envelope's buzz in its body, use Square and Envelope mode (mode 5) with envelope shape 8h on the first steps instead. In that mode the envelope sets the level, so the steps' volumes do not make it fade, and it takes the envelope from any other channel using it. For a simpler snare, use Off mode with only noise at 04h–08h.

Snare instrument

Hi-hat

Use Off mode with a single noise burst at a high frequency (01h–03h), volume Fh.

Hi-hat instrument

Noise and Shared Resources

The three channels share one noise generator, so let only one channel play noise at a time, or give channels that play it together the same noise period (see Shared Hardware Resources).

PWM Textures

Pulse-width modulation (timer mode 1) makes a square-wave tone richer by switching its volume at audio rate.

  • Set the tone mode to Square Only (mode 1) and the timer Mode to 1 (PWM)
  • The PWM rate follows the square: slower on lower notes, faster on higher ones
  • Use the timer Oct and Trans columns to shift the PWM rate without changing the pitch

PWM instrument

PWM and Vibrato

Add a vibrato (H or a vibrato table) to a PWM lead for a thick, analog-like sound.

An In-Tune Buzzer

A buzzer pitched by the envelope period alone drifts off the note above the bass (see Envelope Tuning). The Envelope synchronization timer mode (ESY, timer mode 2) puts it in tune: the timer restarts the envelope at the note's pitch, and the envelope's own period only shapes the sound.

  • Set the tone mode to Envelope Only (mode 2) and the envelope Shape to 8h (falling saw)
  • Set the envelope Oct to +4, which puts a plain buzzer on its note
  • Set the timer Mode to 2 (ESY) and the timer Oct to -1, so the timer restarts the envelope once per cycle of the note
  • Keep the loop a new instrument starts with

Vol has no effect here; the next section gives a buzzer a volume. The buzzer uses one of the song's timers and the envelope generator. The Hardbass Tuned instruments of the Standard Library are built this way.

A Buzzer with a Volume

The Envelope Volume Modulation timer mode (EVM, timer mode 3) gives a buzzer a working Vol: the timer restarts a rising envelope at the buzzer's pitch, and the step volume sets how far the ramp climbs.

  • Set the tone mode to Envelope Only (mode 2)
  • Tune the buzzer with the envelope Oct and Trans columns; Oct +4 puts it on the note
  • Set the timer Mode to 3 (EVM). The envelope shape is set to the rising ramp for you, and in its list the other shapes are unavailable. The other columns RhYMe sets itself are dimmed
  • Set Vol as for a square: 0 is silence and each level matches a square's up to E; E and F both play the full ramp, a little quieter than a square at F
  • Lower Vol over the following steps, or use a volume slide in the pattern, for a decay

The buzzer is in tune across the whole keyboard. It uses one of the song's timers, and only one such buzzer can play at a time. See Sound Generation for its limits.

Wavetable

A wavetable plays a waveform you draw, one cycle of up to 64 volume levels, at the note's pitch (see 13. Wavetables). Wavetables are available in Expert mode while the song's Wavetables feature is checked.

  • On the Wavetables tab, click Add Wavetable; a new wavetable is one cycle of a sine at 12 levels
  • In the instrument, set the step's tone mode to Off (mode 0), so the wavetable plays on its own, and keep Vol at Fh
  • Set the timer Mode to 4 (WVT) and type the wavetable's number, 01, into the Wave column
  • Keep the loop a new instrument starts with: without it, a single step ends the note after one tick

Wavetable instrument

With Square Only instead of Off, the wavetable shapes the square. The wavetable uses one of the song's timers; see Playing a Wavetable.

Hybrid: a Sample over a Square

An instrument can play a sample with every note while its steps go on, so a recorded hit can open a note that the square then continues. Add a sample on the Samples tab first; samples are available in Expert mode while the song's Samples feature is checked.

  • On the instrument's Sample tab, choose the sample under Source. On a new instrument this leaves a single step with tone mode Off and no loop, so only the sample is heard
  • Append two steps in Square Only mode (mode 1) with ⌃⌘O, at volumes Ch and Ah
  • Set the loop start on the second step (01) with ⌘L, so the square keeps sounding while the note is held

Hybrid instrument

The sample starts on its own, then the square sounds under it, shaped by the sample while it plays. The sample uses one of the song's timers; see Sample Tab for following the pitch and the volume.

General Tips

Preview often. Preview Step (⇧/) plays the step you are building; Preview Instrument plays the whole instrument with its loop.

Use looping for sustains. An instrument that should sound for as long as the note is held needs a loop; set the loop start with ⌘L on the step to return to.

Watch for shared resources. See Shared Hardware Resources.

Color-code your instruments. Give instruments distinct colors under Appearance on the Settings tab to see in the pattern grid which instrument plays where.

Reuse with variation. Duplicate an instrument (⌘D in the instrument list) and change a few steps: a lead with vibrato and one without, a bass with a harder attack.