Playlists
A playlist is an ordered set of songs that belong together, such as the soundtrack of a game or
a collection. It is saved as a .rhp file.
A playlist refers to your song files instead of storing copies of them, so a change you make to a song also appears in the playlist.
What a playlist is for
A playlist lets you publish its songs together as a single Atari ST tune, each song a subtune. See Publishing the Set.
Making and Opening a Playlist
File > New Playlist (⌥⌘N) starts a playlist with the song you have open, from
the editor or from another playlist. If that song has never been saved, the playlist starts empty.
File > Open (⌘O) opens a song or a playlist, depending on the file's extension.
Opening the Demo Playlist
File > Open Demo Playlist opens a new playlist of all the demo songs that come with RhYMe, in the order File > Open Demo Song lists them, except that songs of ten minutes or longer come last, so the playlist starts with the shorter demos. It is in the playlist's File menu too. Use it to listen to the demos one after another, or to try out a playlist and its exports without making one first.
RhYMe copies the demo songs to a separate folder and rebuilds the playlist each time you open it, so it always contains the demos for your version. Closing an unchanged playlist needs no confirmation. If you save it, RhYMe asks where, as it does for a new playlist. Saving a demo song opened from the playlist also asks for a location and never changes the original.
Working in the List
While a playlist is open, its list of songs replaces the editor, together with the main toolbar.
The menu bar changes to the playlist's own: File, Edit, Options, View and Help.
There, Open offers playlists only, File has Close Playlist
(⌘W), and Edit contains only Undo and Redo. Help has the Keyboard Shortcut
Reference (⇧⌘K), which lists the playlist's shortcuts with the rest, but not the
other references, the guides or the tips, which are about the editor. The status bar is hidden
until you go back to the editor.
The audio export keys, ⇧⌘X and ⇧⌘M, do nothing while the list
is showing. The playlist's own exports, ⇧⌘H and ⇧⌘P, are
described under Publishing the Set.
The Songs in the List
Songs are listed in publishing order, numbered from one, each with its file name. The browser version shows only the file name, without a folder or path. At the end of each row is the song's length, in minutes and whole seconds.
The columns show the song's number, the song, whether it loops, its Features, its Author, its Composer, its tick Rate, its Start and its Length. Features shows whether the song uses samples (S), wavetables (W) and timers (T), in the same colors as the badges in the instrument list. A song shows a badge only for a feature it uses, and a song with none of them shows a dash; hover a badge to see what it means. A wavetable is played by a timer, so a song with wavetables shows the timer badge too. These features use the Atari ST's timers during playback. The author and composer are the ones stored in the song's information; a song that has none leaves them empty. A name too long for its column ends in an ellipsis; hover an author or composer to read it in full. Rate is the tick rate set in the song's properties, so you can see at a glance whether the songs of a set play at different rates. A song that ticks at the PAL frame rate also shows 50 Hz; hover it to see that it ticks at 50.0527 Hz. A rate other than 50 Hz is shown in a different color, so a song that plays at an unusual rate stands out. Start is how far into the playlist the song begins when the playlist is played through in the order of the list, so you can read the running order of the whole set at a glance. A song RhYMe cannot find adds nothing to the start times after it. While the length of a song further up is still being read, the start times below it stay empty until it is known.
The Author, Composer, Rate, Start and Length columns can be made wider or narrower. Drag the divider just before a column's header to the left to widen that column, or to the right to narrow it; the Song column takes whatever room is left. Double-click a divider to give its column the usual width again. RhYMe remembers the widths for every playlist you open, and Reset Layout in the View menu restores them.
The song that is playing is marked with the play symbol, also while it is paused. The list also marks:
- a song that loops, with the loop symbol in the narrow column after the song: when it reaches its end it starts again from its loop point, so with Play Through off it would keep playing. With Play Through on it plays once, and the loop symbol is dimmed;
- a song that is in the playlist more than once, so a song added twice by accident is easy to spot;
- in editor: the song you have open in the song editor;
- missing: a song file that was moved or deleted. RhYMe keeps it in the list so you can put it right; it shows no length.
A playlist can contain up to 99 songs, the most subtunes a published tune can count.
The Toolbars
The playlist's main toolbar replaces the editor's. It has New Playlist, Open and Save, Undo and Redo (which undo changes to the playlist, not to the song) and Close Playlist. At its right is the Song button back to the editor.
Below it is the list's own toolbar:
| Action | What it does |
|---|---|
| Add Songs | Add one or more song files (⇧⌘A) |
| Add Current Song | Add the song you have open in the editor (⌥⌘A) |
| Remove Song | Take the selected song out of the playlist (⌫) |
| Open Song in the Editor | Open the selected song for editing (⌘↩) |
| Move Song Up / Down | Change the order the songs are published in (⌥↑ / ⌥↓) |
| Sort by Name | Sort the whole set by name (⌥⌘S) |
| Play from Start | Play the playlist from its first song (F5) |
| Play Song | Play the selected song without opening it (↩, Space or F6, or double-click it) |
| Pause | Pause the playing song, or resume it where it left off (Space or F7) |
| Stop | Stop the song the list is playing (F8 or ⎋) |
| Previous / Next Song | Move to the song before or after the selected one, playing it if the playlist is playing (⌘[ / ⌘]) |
| Play Through | When a song ends, start the next one (⌥T) |
| Shuffle | Play the set in a random order, each song once; available while Play Through is on (⌥S) |
| Pause Between Songs | Leave a moment of silence between two songs; the menu beside it chooses how long. Available while Play Through is on |
Space plays the selected song when nothing is playing, pauses the playing song, and
resumes a paused one. The keys work as soon as the playlist opens, and the transport keys act on
the set, not on the song in the editor.
The readout at the end of the toolbar shows the position in the whole set against the set's length. A song RhYMe cannot find is left out of the total.
The bar under the toolbar shows how far the playing song has got, with the time into the song at its left and the song's length at its right. At the right end of the same row are the number of the song you are on and how many songs there are. It always shows the song that is playing, even when you select another one. Move the mouse over it to see the time at that point. Click a point on it, or drag the thumb, to continue the song from there; it carries on when you let go of the mouse button. A paused song stays paused, and continues from the new point when you resume it. While no song is playing, the bar is dimmed and the times beside it are those of the selected song. With no song selected, the bar is hidden.
Right-click a song for a menu with the same actions.
Play Through and Shuffle
Play Through is on when you start RhYMe. With it on, each song plays once and the next one starts when it ends, down to the last, even a song that loops. This applies only to songs played from the list; the song in the editor still repeats.
Between two songs, RhYMe pauses for a second, so each song is heard on its own. Turn the pause off with the Pause Between Songs button on the playlist's toolbar, and choose how long it lasts, from 1 to 10 seconds, from the menu beside it. RhYMe remembers both the next time you start it. Stop during the pause and the next song does not start; pick a song, or use Previous Song or Next Song, and that song starts at once. The start times and the length of the whole playlist do not include the pauses.
Shuffle works only while Play Through is on, and keeps its setting when you turn Play Through off and on again. It makes Previous Song, Next Song and Play from Start follow a random order in which each song comes up once before any comes up twice; Previous Song goes back the way you came. The list itself, and what you publish, are not reordered.
Oscilloscopes
The oscilloscopes are shown above the list too, turned on and off with View > Show
Oscilloscopes in the playlist's menu. This is separate from the pattern editor's setting, so you
can hide them here and keep them in the editor, or the other way around. Click a channel to mute it, ⌘click it to solo it, or use their
right-click menu. The mute keys (⌥Z / ⌥X / ⌥C, and
⌥0 for all three) and the solo keys (⌥⇧Z / ⌥⇧X /
⌥⇧C) work here too.
On a wide window the oscilloscopes stop growing at a comfortable width and stay at the left of the list, so the waveforms keep their shape.
Drag the bar between the oscilloscopes and the list to set their height. It is separate from the height of the pattern editor's oscilloscopes, so each can be set to suit what is below it. As there, keep dragging up past their smallest height to hide them here, and Reset Layout restores their height.
Arranging the Songs
Drag a song up or down the list to move it.
⌘click or ⇧click to select several songs. Dragging, Remove Song and
Move Song Up / Down then act on all of them; Play Song and Open Song in the Editor act on the first one you selected.
Adding, removing and moving songs can be undone with ⌘Z and redone with
⇧⌘Z. The playlist has its own history, separate from the song's.
Listening to a Song
Play Song plays the selected song from the list without opening it. The song you have open in the editor stays open, and returns when the playing stops.
Going Back and Forth
Opening a song from the list loads it into the editor as usual, and the playlist stays open behind it. Playlist at the end of the main toolbar and Song on the playlist's toolbar switch between the two. The Playlist button appears only while a playlist is open.
Going to the playlist stops the song or pattern the editor is playing, as Stop would, since the editor is then out of view.
Publishing the Set
File > Export for Atari ST in the playlist's menu writes all its songs, in list order, into one Atari ST file, each song a subtune named by its title. A song that is in the playlist more than once becomes a subtune at each place:
- SNDH Container (
⇧⌘H) makes one.sndhtune, from which SNDH players offer each song. - Atari ST Program (
⇧⌘P) makes one.prgprogram that lists the songs on screen: the arrow keys move through the list, and typing a song's number (both digits past the ninth) goes straight to it.
The two shortcuts export the playlist while its list is showing, and the song you are editing otherwise. The menu is unavailable while the playlist is empty.
Each song is exported as it was last saved. If the song open in the editor is in the playlist and has unsaved changes, you are asked first. A missing song stops the export, and you are told which songs to put back or remove.
Songs at different tick frequencies can share one file: each still plays at its own rate. Such a file plays from the Atari ST's Timer C, so the export fails, and its report says why, when a song's effects use Timer C or when Replay clock is set to Vertical blank. The songs whose effects use Timer C are checked before anything is packed, and the report names each of them; clear T-C in their properties to export the set. The dialog remembers where it last wrote for this playlist, and offers the playlist's name for the file.
Saving
Save (⌘S) and Save As (⇧⌘S) save the playlist while its
list is showing, and the song otherwise; the window title shows which.
The song and the playlist keep their own unsaved changes: adding, removing or reordering songs changes the playlist, editing notes changes the song. When you close RhYMe with changes in both, you are asked about each.
File > Close Playlist, or the toolbar's Close Playlist button, closes the playlist and brings the editor back, asking about unsaved changes first.