MIDI sequencing studio
Owner's Manual
0.0 / 17.1 s
peak -8.5 dBFS
openzig build run-studio -- manual/index/cover --play 1
renderzig build run-studio -- render manual/index/cover cover.wav
cover/song.json
{
"tempo": 112,
"end": "9",
"sections": ["1 A", "5 B"],
"key": ["1 A minor"],
"chords": ["1 Am", "2 F", "3 C", "4 G", "5 Am", "6 F", "7 C", "8 G"],
"devices": [
{ "name": "synth", "type": "synth", "state": { "parts": [
{ "patch": "A45", "level": -8, "reverb_send": 15 },
{ "patch": "A51", "level": -4 },
{ "patch": "A61", "level": -10, "delay_send": 15 }
] } },
{ "name": "808", "type": "drums" }
],
"tracks": [
{ "name": "drums", "device": "808", "channel": 1, "role": "drums", "clips": [{ "at": "1", "length": "8.0.0", "notes": "beat" }] },
{ "name": "bass", "device": "synth", "channel": 2, "keys": "pent", "role": "bass", "clips": [{ "at": "1", "length": "8.0.0", "notes": "bass" }] },
{ "name": "keys", "device": "synth", "channel": 1, "keys": "chord 7", "role": "chords", "clips": [{ "at": "5", "length": "4.0.0", "notes": "keys" }] },
{ "name": "lead", "device": "synth", "channel": 3, "keys": "pent", "role": "lead", "clips": [{ "at": "5", "length": "4.0.0", "notes": "lead" }] }
],
"notes": {
"beat": {
"length": "1.0.0",
"notes": [
"1.1.0 C2 0.0.240 120", "1.1.480 F#2 0.0.240 70",
"1.2.0 C2 0.0.240 112", "1.2.0 D#2 0.0.240 100", "1.2.480 F#2 0.0.240 76",
"1.3.0 C2 0.0.240 116", "1.3.480 F#2 0.0.240 70",
"1.4.0 C2 0.0.240 112", "1.4.0 D#2 0.0.240 100", "1.4.480 F#2 0.0.240 80"
]
},
"bass": { "length": "8.0.0", "follow": { "pattern": "offbeat", "low": "E1" } },
"keys": { "length": "4.0.0", "follow": { "pattern": "halves", "low": "F3" } },
"lead": {
"length": "4.0.0",
"notes": [
"1.1.0 E5 0.0.900 100", "1.2.0 D5 0.0.420 92", "1.2.480 C5 0.0.420 92", "1.3.0 A4 0.1.900 96",
"2.1.0 C5 0.0.900 96", "2.2.0 D5 0.0.900 92", "2.3.0 C5 0.0.900 94", "2.4.0 A4 0.0.900 90",
"3.1.0 E5 0.1.420 100", "3.2.480 G5 0.0.420 96", "3.3.0 E5 0.0.900 96", "3.4.0 D5 0.0.900 92",
"4.1.0 D5 0.0.900 96", "4.2.0 E5 0.0.420 90", "4.2.480 D5 0.0.420 92", "4.3.0 G4 0.1.900 100"
]
}
}
}This is the manual for the studio, a home MIDI studio of 1989 in one program. It arranges songs in bars on tracks, after Cubase on the Atari ST; records what you play, from the computer's keys or a MIDI keyboard; mixes on a desk after the TASCAM Portastudio 244's; and plays three instruments, each a box of the decade with a panel of its own: a synthesizer that recreates the Roland SH-101 and the Juno-106, a drum machine after the TR-808 and the TR-909, and a sampler after the Akai S900 and S1000, with an MPC60's pads.
It teaches from the beginning, with the studio as the apparatus: every sound in it was rendered by the studio, every picture is a capture of its window, and every example is a small song you can open, play, and change. It teaches the music first, how a beat is built, which notes and chords go together, what a bass plays, how a melody moves, how a song changes from one section to the next, and how to take apart and learn a song you like, and then the studio's tools for the work around it. Each instrument has a book of its own at the back, which teaches how it makes its sounds.
Besides its notes, the studio knows four things about a song:
- Its key: a tonic and a mode, such as A minor, which the bar names beside the tempo.
- Its chords: a chord a bar, or a beat, on the chord row under the sections.
- What each track is for: its role, such as the bass or the chords, and the way the keys play it.
- Its sections, with the coach's count of what changes between them.
With them it helps in four ways. It guards what you play, keeping the keys in the key and a chord under one finger. It shows what fits: the key's rows in Key Edit, the chord's notes, the next key to press. It writes what follows from the chords and the sections: a bass, a voicing, a fill. And it explains, in a line beside the pointer. It never writes a melody: that stays yours.
Before you start
You need Zig 0.17 and, on Linux, the X11, Wayland, xkbcommon, OpenGL, and
ALSA development libraries, plus wayland-scanner. On macOS, you need
Apple's Command Line Tools (xcode-select --install). The sampler's sounds
aren't in the repository: tools/fetch-samples.sh fetches a piano, the sea,
and a break into library/. Then, in the repository:
zig build run-studio # a new song
zig build run-studio -- studio/templates/pop # a song from a template
zig build run-studio -- --help # every option
Space plays and stops. The letter keys play the selected track,
from A on the home row up to ', with the row above for the black keys;
Z and X move an octave. In the arrange view,
Up and Down select a track. Ctrl+1
shows the arrange view, Ctrl+2 the selected track's device,
Ctrl+3 the editor, and Ctrl+4 the desk. Esc goes
back to the arrange view, and there stops the song and lets go of every
note. F1 shows every command and its key, and Ctrl+Q quits.
Chapter 0 is a tour of the window.
On macOS, Command works wherever this manual says Ctrl, but for Ctrl+H and Ctrl+Space, since Command+H hides the window and Command+Space opens Spotlight: hold Control for those two.
Ctrl+N drops a list: empty, a synth and four empty tracks, and
five templates, each a few bars to loop with its key, its chords, and its
parts set, so Space plays the start of a song and every part can
be changed. A template opens as a new song without a name, and the first
Ctrl+S asks for one.
| Template | Tempo | Key | What's in it |
|---|---|---|---|
| two-loop | 122 | A minor | Am9 Dm9 Fmaj7 Em7, with an offbeat bass, stabs, a house beat, a lead, and a sampler |
| pop | 100 | C major | C G Am F on a piano, an eighths bass, a synth-pop beat, a lead, and the pop form |
| boom bap | 90 | D minor | Dm7 and Bbmaj7 at 58% swing, stabs, a roots bass, and a boom bap beat |
| techno | 128 | F minor | One chord, Fm, a pumping bass, an arpeggio, and a techno beat |
| ballad | 72 | G major | G Em C D on a piano's broken chords and a pad, without drums |
How to read this
Chapter 0 is a tour of the window, and chapter 1 makes a first song from a template in one sitting, touching everything the chapters after it explain. Then each chapter takes one part of a song, in the order Ableton's Learning Music takes them: the beat, the notes, the chords, the bass, the melody, and the form. Then two chapters on learning from songs: recreating one, and practicing its parts. Chapter 11 asks for all of it in your own words.
The chapters after them are the studio's tools, each in full: songs, tracks, and devices; arranging; recording; the editors; lanes; the desk; and a controller. Then come the instruments' books, the synth's, the drum machine's, and the sampler's, each an owner's manual of its own, and last the reference: every key, every gesture of the mouse, and every mark the window draws; what a song's file holds; and the command line.
A figure has a picture of the window, cropped to the part that matters, the
clip the song renders, and a recipe: the song's song.json and the two
commands that reproduce the figure, one to open the window as the picture
shows it and one to render the clip to a WAV file. The songs are small
folders in manual/, next to the chapters, and nothing in a figure
was drawn by hand. Open them, play them, and change them: that's what
they're for.
When the pointer rests on something for a moment, a hint beside it says what it is and why it works: a key, a degree, a chord, a pattern, a mark in Key Edit. Ctrl+H hides every hint, and Key Edit's dots and tints with them, until Ctrl+H shows them again.
Contents
Introduction
- 0The window
The bar · The views · The kinds of control · What the colors mean · The inspector · The menu at the pointer · Callouts and tags · Hints and marks · Every command · Empty places · Modes
- 1A first song
A song to start from · A key that suits you · Chords for the verse · A beat · A bass line · A melody · Fitted to the chords · The form · A fill into the chorus · Practice · Saving it · Try it in the window
I. Making music
- 2The grid
Beats and bars · The kick, the snare, and the hats · Swing · Euclidean rhythms · Beats by style · Try it in the window
- 3Keys
Twelve notes · Scales and keys · The degrees and their pulls · Major and minor · The modes · Keys that stay in the key · Try it in the window
- 4Chords
Triads · Numerals · Sevenths · The chord row · Chords under one finger · Voice leading · Try it in the window
- 5Progressions
Home, away, and tension · What follows what · The progressions · Borrowing · Try it in the window
- 6Bass lines
Roots · Parts that follow the chords · Rhythm against the kick · The patterns · Roles · Try it in the window
- 7Melody
Chord notes on the beat · What Key Edit marks · Steps and leaps · Rhythm first · Getting it down · Try it in the window
- 8Form
Sections · The two-loop rule · Energy · Transitions · Try it in the window
II. Learning from songs
III. In your own words
IV. Working in the studio
- 12Songs, tracks, and devices
A song is a folder · Starting a song · Opening and saving · Exporting a WAV · The track list · Adding a track · Muting and soloing · The inspector for a track · Deleting a track · Devices · Programs · The device view · The synth in the studio · Moving a track to another device · Adding and removing devices while the song plays · Undo · Try it in the window
- 13Arranging
Clips · The tools · Selecting clips · Moving clips · Copies and linked copies · Resizing and trimming · Cutting and gluing · Audio clips · Groups · Sections · The ruler and the locators · Cycle · Inserting, deleting, and duplicating bars · Mute scenes · Scrolling and zooming · Try it in the window
- 14Recording
The track that records · Record and the count-in · Where a take lands · Automatic quantize · The record button's menu · Punching in · Cycling: overdub or replace · Recording slower · The panel into lanes · Sequences as pattern clips · Mute scenes · Chords into the chord row · Undo and a take · A synth take made a song · Audio tracks · Recording audio · The round trip · Monitoring · Try it in the window
- 15The editors
Opening a clip · The header · The roll · Selecting and moving · Velocity · Chopping · The clip's end · What the roll shows · Step input · Drum Edit · List Edit · Try it in the window
- 16Lanes
A track's lanes · Adding a lane · Points · Hold, linear, and exponential · How a lane plays · Recording a lane · The tempo and swing rows · Lanes and clips · A track on another device · Try it in the window
- 17The desk
A strip a device · The EQ · The sends · The returns · Pan · Mute and solo · The fader and the meter · The master · Working the desk · Devices on the desk · Audio tracks on the desk · Bouncing · The desk is hardware · Recording the desk · The MiniLab on the desk · Try it in the window
- 18A controller
The DAW program · Keys, strips, and pedal · Knobs and pages · The encoder · The faders · Nothing jumps · The pads · A drum machine's track · On the desk · Recording from the controller · The screen and the lights · Every control · Try it in the window
V. The instruments
- Synth: Owner's Manual
0. The window · 1. The oscillator · 2. The filter · 3. Shaping in time: the envelope and the amplifier · 4. Movement: the LFO · 5. Width: the chorus · 6. Keys and voices · 7. The arpeggiator and the sequencer · 8. Steps with depth · 9. Parts and the clock · 10. Space: the delay and the reverb · 11. Patches, the bank, and projects · 12. MIDI · 13. Rendering, scripts, and takes · 14. Recipes · 15. What's modeled, and how · 16. Reference · Sources and reading
- Drums: Owner's Manual
0. The panel · 1. The bass drum · 2. Toms, congas, rim shot, and claves · 3. Snare, clap, and maracas · 4. The metal · 5. Accent · 6. Rhythms and the memory · 7. Playing and writing on the panel · 8. In the song · 9. Reference
- Sampler: Owner's Manual
0. The pages · 1. Samples · 2. Programs and keygroups · 3. The voice · 4. Pads and breaks · 5. Sampling · 6. Sounds in the song · 7. Reference
VI. Reference
- 19Every key
Keys · The mouse · The MiniLab · The marks
- 20Song files
A song's folder · Reading and writing · Positions, lengths, and points · The tempo · The brief · The swing · The end · Sections · The key · The chords · Devices · The synth's state · The drum machine's state · The sampler's state · The desk · Tracks · Audio tracks · The reference track · Clips · Lanes · Notes · Groups · Mute scenes · Settings:
keys.json,said.json, andaudio.json· The model's answers · The library · Program files · Templates and follower patterns - 21The command line and scripts
studio --help· Opening the window · Where it starts · Audio and MIDI · Rendering · Takes and the synth · MIDI files · Sampler programs from SFZ · The library and sample memory · Pictures · Window scripts · The model · Building · The examples · Exit statuses and errors