Skip to content

Introduction

RhYMe is an Atari ST chiptune tracker for Windows, macOS and Linux.

This manual describes the browser preview of the editor, which needs no installation. It offers nearly everything the desktop version does; see What Differs from the Desktop Version for the differences.

Enter notes, instruments and effects into a pattern grid, then arrange patterns into a song. You can export the song to play on an Atari ST and its three-channel YM2149 sound chip.

Alongside noise and square waves, RhYMe supports hardware timer techniques such as PWM and envelope synchronization, as well as 4-bit sample playback.

Playback and audio exports aim to reproduce the sound of an Atari ST, including its hardware mixing and filtering.

Hexadecimal notation

Trackers write numbers in hexadecimal: after 0–9 come A–F (10 to 15), so 10h is 16, FFh is 255 and 100h is 256. See also https://en.wikipedia.org/wiki/Hexadecimal.

Why a New Tracker?

RhYMe combines a classic tracker workflow with tools for the Atari ST. Focusing on one machine keeps the editor tailored to its hardware.

Two ways for effects to behave

In classic trackers an effect lasts only for the row it is written on; in modern ones it keeps running until something stops it. RhYMe works the modern way (Trailing) unless a song's Effects mode is set to Non-trailing. See 5. Main Window.

Design Philosophy

  1. Simplicity. Patterns, instruments and effects provide the tools for writing a song without hiding the details of the YM2149 and Atari ST.
  2. A familiar tracker workflow. Notes, instruments and effects go into pattern grids, and numbers are written in hexadecimal.
  3. Keyboard and mouse. Shortcuts make editing fast, while menus and toolbars offer most actions by mouse. The clipboard supports overlay, underlay and insert paste for pattern data, instrument steps and table cells, including between RhYMe windows.
  4. Hardware access. The instrument step grid shows how each step controls the YM2149's registers.
  5. Sound quality. A software YM2149 emulator aims to match the sound of an Atari ST.
  6. Register streaming. Players stream precomputed register writes and timer data, so the Atari ST replay routine does not limit the complexity of an instrument or song. RhYMe does the work when it renders the stream.

Features

Pattern Sequencer

  • 3-channel grid (channels A, B, C - one per PSG voice)
  • Notes, instruments, and up to 5 effects per row
  • 256 patterns of 1-128 rows; the pattern length applies to the whole song
  • 256 arrangement slots with a configurable song loop point
  • A temporary, unsaved song loop range for auditioning without changing the song loop point
  • Mute or solo any channel from its header, its oscilloscope or the keyboard (see 6. Pattern Editor)

40 Effects

  • Arpeggio - Inline 3-note and 4-note arpeggios cycle through semitone offsets each tick
  • Arpeggio speed - Play the arpeggio on a channel, inline or table, at a speed of your choosing
  • Pitch slides - Continuous upward and downward pitch bends
  • Semitone bends - Continuous upward and downward bends that move every note by the same interval
  • Portamento - Smooth glide toward a target note at a configurable speed, in tone periods or in semitones
  • Transpose - Play the notes on a channel a number of semitones higher or lower, from its own row onward
  • Vibrato - Sine modulation around the base pitch at a configurable rate and depth
  • Volume - Set volume directly or slide up/down at a configurable speed
  • Fader - Fade a whole channel in or out over the volumes its rows set, across notes and resets
  • Detune - Set, lower or raise the pitch of a whole channel across its notes, like a record slowing down, and bring it back exactly
  • Arpeggio tables - Start, switch, and stop reusable arpeggio sequences
  • Vibrato tables - Start, switch, and stop reusable vibrato sequences
  • Sample trigger - Play a sample from the sample bank on a channel
  • Sample offset and sample retrigger - Jump to a position in an instrument's sample, or repeat it at a steady rhythm
  • Note delay, note cut and note retrigger - Start a row's note a number of ticks into the row, end it a number of ticks into the row, or start it again every few ticks
  • Song speed - Change song playback speed from the effect's row onward
  • Row length - Make a single row last longer or shorter than the speed, to slow the song down or hurry it on
  • Instrument speed - Run the instrument on a channel faster or slower than the speed stored in it
  • Instrument step - Move the instrument on a channel to one of its steps, or hold it there
  • Reset - Silence all trailing effects and return to full volume
  • Freeze slides - Stop the pitch bends, portamento and volume slides where they are
  • Continue slides - Start the frozen slides again from where they stopped
  • Pattern break - Jump to the next pattern at the end of the current row, or skip a number of rows ahead
  • Classic or modern effect behavior, chosen per song: effects that last one row, or effects that trail across rows (see Two ways for effects to behave)

Instrument Editor

  • Per-step sequencer defines how the PSG registers change over time
  • Each step controls: volume (0-15), 6 tone coupling modes (square, envelope, square+envelope, and cross-driving variants), noise period, envelope shape, forced tone periods, and per-generator pitch offsets
  • Hardware timer modes per step: Pulse-width modulation (PWM) (the square's volume switched by a timer at audio rate), Envelope Synchronization (ESY) (the hardware envelope restarted by a timer at audio rate), Envelope Volume Modulation (EVM) (a retriggered envelope whose level follows the step volume) and Wavetable (WVT) (a drawn wavetable played through the volume register at the note's pitch)
  • Configurable step advance speed, optional loop point, and envelope retrigger
  • Color-coded instruments appear as swatches in the instrument list and in the pattern grid
  • Audible instrument preview from the editor or pattern grid
  • Load and save individual instruments as .rhi files, including the sample and the wavetables they use
  • Browse, preview and import instruments from your songs, instrument files and the Standard Library (see 9. Instrument Editor)
  • Effect matrix saying how each of an instrument's pitches follows the effects that move a note's pitch (see 9. Instrument Editor)
  • Key range, achromatic instruments that keep a fixed note for drums, and a start delay (see 9. Instrument Editor)

Sample Playback (Digisound)

  • Digitized sample playback through the YM2149's 4-bit volume DAC
  • Song-level sample bank with up to 127 samples, 64 KB each
  • Import samples from WAV files (any bit depth, mono or stereo, with automatic conversion)
  • Per-sample properties: gain (overdrive for punchier samples), resample rate (base playback frequency in Hz), pitch, start and end points with a crop that discards the rest, an optional loop, and an Optimize button that sets them up for the chip in one click (see 12. Samples)
  • Trigger a sample from any pattern row with the Sample Trigger effect (Y)
  • An instrument can play a sample with every note, through its steps, like a sample played over a PSG sound, moved by its own octave, transposition and tuning and, when it follows the volume, played louder or quieter by a relative volume
  • Sample editor panel with waveform graph and audible preview

Wavetables

  • Song-level list of up to 127 wavetables, kept apart from the samples
  • A wavetable is one short cycle of 2 to 64 volume levels that you draw yourself, or fill with a sine, triangle, sawtooth or square
  • An instrument step in the timer's wavetable mode plays a wavetable at the note's pitch, whatever its length, shaped by the step's volume
  • Switching between wavetables of the same length during a note continues the cycle without a click
  • Load and save individual wavetables as .rht files, or make one from a single-cycle WAV file

Arpeggio and Vibrato Tables

  • Song-level named sequences of signed offsets, shared across all patterns
  • Arpeggio tables - semitone offsets layered on top of the base pitch
  • Vibrato tables - period-unit deltas for subtle pitch modulation
  • Independent speed and loop point per table; continue running across notes and instrument changes until explicitly stopped
  • Load and save individual tables as .rhv files

Context-Accurate Playback

  • Start playback from any cursor position, and it sounds as it would had the song played up to there: the volume, the speed and any slide begun earlier are where they would be
  • Previously playing notes are silenced so only the target row onward produces audio
  • No manual reset effects needed to make mid-song auditioning sound correct

Import & Export

  • Arkos Tracker 3 (.aks) import:
    • automatic master-clock conversion for non-ST platforms (e.g., Amstrad CPC at 1 MHz)
    • sample instruments and the drums of the event track
    • where an effect lasts or stops otherwise in Arkos Tracker than in RhYMe, the import adds the effects that keep it sounding as it did
    • a speed the song forces on an arpeggio becomes the arpeggio speed effect SNnn, and a pitch table the song plays at a forced speed gets a copy at that speed among the vibrato tables
    • songs from Arkos Tracker 3.6 and later import too: their SID voices play with the pulse-width modulation timer mode, and their track colors color the patterns that have no color
    • a song from Arkos Tracker 2 must first be opened and saved again in Arkos Tracker 3
  • WAV sample import with automatic format conversion
  • WAV and MP3 export
  • YMXS (.ymxs) structure export: the song as the YMXR tools are given it, to read, edit or pack later
  • YM6 (.ym) export: what the chip is told on every frame, with the song's samples, for YM players
  • SNDH (.sndh) and Atari ST program (.prg) export, with the YMXR player built in
  • Playlists (.rhp): an ordered set of songs, published as one SNDH file or Atari ST program with each song a subtune (see 14. Playlists)
  • Standard MIDI File (.mid) export of the song's notes, one track per channel
  • Native .rhs song format
  • Merge Song: add another song's instruments, tables, samples, wavetables and patterns to the one you have open, with its arrangement after this song's (see 16. Menus & Toolbars)

MIDI Input

  • Record notes from external MIDI controllers
  • Configurable MIDI device selection
  • MIDI toolbar under the pattern grid, to switch MIDI note input off without disconnecting the keyboard or to enter chords as arpeggios (see 6. Pattern Editor)
  • Start, record and stop playback from your controller's transport buttons (see 6. Pattern Editor)

Recording Modes

  • Step recording - cursor advances by a configurable step after each note you enter
  • Live recording - notes are captured in real time as the pattern plays
  • Edit step value configurable from 0 to 16

Keyboard-Driven

  • Edit Mode for the pattern grid, so typing changes the pattern only while it is on
  • Extensive shortcuts for navigation, note entry, octave selection, cut/copy/paste, clear, transpose, and playback control
  • Clipboard, shared with the operating system, with Overlay (paste non-empty fields only), Underlay (paste into empty fields only), and Insert (shift existing content down)
  • Follow Playback, Center Scroll during Playback, and Scroll Past Edges view options to adjust the pattern grid scrolling behavior to your liking
  • Reference windows for effects, instrument parameters, and keyboard shortcuts