ZENITH

ZENITH-1

ZENITH-1, by Polystellarflow, turns your M-VAVE FM-1 into a generative ambient machine. It is built on Charles Vestal's AMB-1 and works the same way: switch it on and it plays by itself. You don't perform it so much as tend it, like a garden. Left alone, it travels: through the parts of a world, from era to era, and from world to world.

Breathing pads bloom and fade. Shimmering bells play from tape loops of unequal length, as in Brian Eno's Music for Airports. Under them are a gliding bass, soft Euclidean percussion and a texture of air; over them, now and then, a lead voice (a sax, a flute, a muted trumpet and more) plays melodies of its own. All of it goes through a tape echo, a long tape loop and a shimmering plate reverb. There are eight worlds, each with its own sounds, scales, tempo and space, and when you leave it alone, full-screen pictures move with the music.

A drawing of the FM-1 running ZENITH-1, each control labeled with what it does. The Controls section below says the same in words
The FM-1 (a drawing), running ZENITH-1, each control labeled


1Install

Build ZENITH-1 and start its install page (see BUILDING.md), then open <http://localhost:8765/install/> in Chrome or Edge. Connect the FM-1 with a USB data cable and press Install. Don't unplug it while it's writing. When it's done, the FM-1 restarts into ZENITH-1.

The same page has the browser emulator (<http://localhost:8765/emu/>), the same code with sound, played with a mouse, a touch screen or the keyboard.

To go back to M-VAVE's firmware, use "Back to the stock firmware" at the bottom of the install page.

Installing other firmware is at your own risk. If the FM-1 ever won't start, see Troubleshooting.


2Getting started

ZENITH-1 starts playing as soon as you switch it on. A title rises first (ZENITH-1, by Polystellarflow, and the version); any key or button skips it. Then:

  1. Listen. The first world, Warm Space, starts at dawn: a warm pad alone, blooming. Bells, the bass and the rest come in as the world moves into its next parts. Turn MASTER to set the volume.
  2. Leave it. It changes by itself: it plays in parts, every minute or few, and every quarter of an hour or so a new era comes with new loops, new sounds and maybe a new key. On the default Journey setting, Often, every era dissolves the world, and another one rises in its place. No two runs are the same: it starts from a new seed every time it's switched on.
  3. Change worlds. Turn PRESETS. Each of the eight worlds has its own key, tempo, sounds and space.
  4. Change the scale. Press a key whose note is lit to take that note out of the scale. Press it again to bring it back. Press a key that isn't lit to add its note.
  5. Roll the dice. It moves on by itself; when you want something new now, hold EDIT for Random: new sounds for every layer, a new key, mode, tempo, space and levels, all in ranges that sound good. Hold it again for another roll. To undo, hold SAVE: the world goes back to its own recipe.
  6. Play the effects. Press FX. Now all 27 keys play effects: tap one and it plays once. Press FX again to go back. Effects also play by themselves now and then (Auto FX, on the FX page).
  7. Shape a layer. ENV is the pad, ARP the bells, LFO the bass, SEQ the pulse and the lead, SEL the space, HOME the garden and the journey, GLO the setup. KNOB 1–4 set the four values at the bottom of the screen. Press the same button again for that layer's next page.
  8. Watch. Leave it alone for 30 seconds, or press HOME three times, and the screen becomes a picture that moves with the music. Touch anything to bring the pages back.
  9. Freeze or rest. REC holds the chord and lets the reverb ring on forever. PLAY rests the garden; press it again and it grows back.

Each world keeps what you change. ZENITH-1 saves by itself while it rests, or you can press SAVE.

Press GLO four times for the Guide: every button and shortcut on one page.


3Controls

ControlWhat it does
KeysThe keys are the scale, and they light up for the notes in it. Press a key to add its note or take it out. Every octave of a note is the same key. The root always stays, and the scale keeps at least three notes. In the FX menu, the keys play the effects instead.
PLAYGrows or rests the garden. It grows by itself from power-on. Resting, the sounds fade out and the reverb rings away.
RECFreezes the chord. The reverb rings on forever, the bells and pulse go on above it, and the picture holds still. Press REC again to thaw.
EDITHold it for 1.5 s for Random: new sounds and settings, rolled. Hold SAVE to undo (the world's recipe again). A tap does nothing: the music moves on by itself.
HOMEThe Garden page; again, the Journey page; again, the picture.
ENV · ARP · LFO · SEQThe Pad, Bells, Bass and Pulse pages. Each has a second page for its shape: press the button again. SEQ goes on to the Lead and the Lead's shape.
SELThe Space page; again, Tape; again, Air.
FXThe FX menu: the keys play the effects. Press FX again to go back to the page you were on. Hold FX in the menu to let every effect go. On any other page, hold FX and press a key to play its effect without the menu.
GLOThe Setup page; again, Sleep; again, the Picture page; again, the Guide (every button and shortcut).
SELECTTurns to the previous or next page. To change the tempo from any page, hold HOME and turn SELECT.
ALGORITHMPicks the mode: Ionian, Dorian, Phrygian, Lydian, Mixolydian, Aeolian, pentatonic major or minor, the Japanese yo scale, or Balinese pelog. It loads the mode's scale. Once you change the scale with the keys, it's Custom.
PRESETSPicks the world. For the list, see The worlds.
KNOB 1–4Set the four values on the screen. A few clicks always move one step at a time, and a quick turn speeds up, so half a turn sweeps the whole range.
OCT− / OCT+Move the octave of the layer whose page you're on: the pad on the Pad pages, the bass on the Bass pages, the lead on the Lead pages, the bells everywhere else.
MASTERSets the volume.
SAVESaves all eight worlds. Hold it for 1.5 s to put the world back to its recipe: the screen says RESET: SAVE TO KEEP. Until you save, switching off brings your version back.

Press GLO four times for the Guide: every button and shortcut on one page, on the FM-1 itself.

The Guide page: every button and shortcut
The Guide (GLO, four times)

4The screen

The Garden page: Warm Space, D Lydian, tempo 66; a night horizon with the chord DM7 as a constellation, an aurora, orbits and a moon; TEMPO 66, EVOLVE 35, MOTION 55, DRIFT 45s
The Garden page (HOME)

5The garden

ZENITH-1 grows five layers and a texture from one scale and one chord.

Each world has its own way with chords. Some like sevenths, others add a ninth, hang on a suspended second, or stack fourths. Gamelan Dawn is tuned as a Balinese gamelan is, a little away from the piano's notes.

Then comes the space, after Eno's chain for Discreet Music: a short tape echo, a long tape loop up to 5.6 seconds with two heads (each repeat darker and thinner), and a plate reverb. Shimmer feeds the plate's tail back into it an octave up, so it climbs and fades. The plate only takes what is above about 200 Hz, so the tail never turns to mud, and Size changes how long it rings, not how loud.

Under the journey, three smaller things keep it moving:


6The journey

Left alone, ZENITH-1 travels, as HADAL-1 does.

Parts. A world plays in parts, each one to three minutes long, one leading to the next by chance, each a different balance of the layers:

PartWhat you hear
DawnThe pad alone, dark, a few bells, a faint pulse
BloomThe pad and the bells, the bass and the pulse coming in, the lead now and then
FlowEverything: the pulse at its fullest, the lead
ShimmerThe bells in front, more of them, brighter, more shimmer
DeepThe bass and a low pad, few bells
DissolveAlmost nothing: the pad thinning, the air

At each new part, a bell loop starts a new phrase, and as the loops play their phrases are rewritten now and then.

The motif. Every minute or two the bells play a short motif of three to six notes, and each time it comes back changed: up a step, upside down, backwards, slower or an octave up. The loops step back while it plays.

Eras. Every 15 to 40 minutes (5 to 15 with Journey on Often) comes a new era:

New worlds. With Journey on Sometimes, half the eras end the world; on Often, every one does. The world dissolves, and another one rises at dawn, with its own sounds, key, tempo, space and picture.

Set it on the Journey page (HOME, twice):

JourneyWhat it does
OffNo parts, no eras: AMB-1's garden, with Wander
StayParts and eras, always in the same world
SometimesParts, eras, and now and then a new world
OftenEvery era ends in a new world: a new world every 5 to 15 minutes (the default)

It all happens by itself: there is no button for a part or an era. Hold EDIT for Random when you want something new now (see Getting started).


7The worlds

Turn PRESETS to choose one of eight worlds. Each is a recipe for the whole garden: the sounds of every layer, the tempo, key and mode, the way it voices its chords, how loosely the bells fall, the space, the effects it likes to play by itself, and the picture's colours. Each one remembers how you left it. To put the world you're on back to its recipe, hold SAVE for 1.5 s.

WorldKey, tempoIts soundsIts leadIts space and colours
Warm SpaceD Lydian, 66a warm pad that blooms, soft shimmering bells, a deep sine bass, a soft pulseSynth, wanderinga shimmering plate; nebula
CinematicC Aeolian, 58a slow string ensemble, felt-piano bells, a held drone of root and fifth, handsTrumpet, a hymna long, wide hall; golden hour
Lo-fiF Dorian, 78, swunga Rhodes with tremolo, vibraphone, a warm bass, brushesSax, call and answertape wow, short echoes, vinyl crackle; warm tape
GlassA pentatonic major, 80a glass pad, crystal bells an octave up, glitchGlass, arpeggiosheavy shimmer, a breath of wind; aurora
KankyōG yo scale, 70a soft Rhodes, marimba, a round bass, wood and shakerFlute, sparseechoes, soft rain; sakura
Gamelan DawnE pelog, 72, gamelan tuninggamelan bells in beating pairs, gong and kettlesOcarina, an ostinatoa wide hall, dawn wind; dawn
Deep WaterA Aeolian, 50sung voices, soft low bells, a gliding sub bass, handsClarinet, a hymna long tape loop, the sea; ocean
AirportsC# Ionian, 60AMB-1's sung voices and slowed felt-piano bells, after Eno's "1/1" and "2/1", a soft pulseWhistle, sparseAMB-1's chain; moonlight

8The pages

Each button has one page or more: press it once for its first page, again for the next. KNOB 1 is always a layer's level on its first page. Turn SELECT to step through all twenty-one pages in order.

HOME: Garden, Journey

Press HOME a third time for the picture.

The Journey page: JOURNEY Sometimes, WANDER 50, TIDE 50, KEY MOVES 30
The Journey page

ENV: Pad, Pad shape, Pad breath

The Pad page: LEVEL 64, SOUND Warm, SWELL 70, BRIGHT 45
The Pad page

ARP: Bells, and Bell shape

LFO: Bass, and Bass shape

SEQ: Pulse, Pulse shape, Lead, Lead shape

The Lead page: LEVEL 45, SOUND Synth, STYLE Wander, OFTEN 40
The Lead page

SEL: Space, Tape, Air

FX: the FX menu

Level, Auto FX (On or Off), How often and Space. See The FX menu.

GLO: Setup, Sleep, Picture, Guide


9Wander: steer it, or let it drift

Wander sets how much the garden tends itself, beneath the journey.

What you turn stays. A value you turn by hand is yours: Wander leaves it where you put it, until the next era (or a new world) frees it.

What you turn is heard now. Turn up a layer's level or change its sound by hand, and for the next three minutes it plays whatever part the world is in, coming up within a second or two. Even at dawn, where the lead rests, turning the Lead up starts a phrase straight away.

So you can steer closely (Journey Off, Wander 0, Key moves 0), let it drift completely (Journey Often, Wander 100, Key moves 100), or anything between.


10The FX menu

Press FX. While the FX menu is open, the keys play effects instead of changing the scale. All 27 are on one page, three columns of nine, each named beside its key, from F3 at the top left to G5 at the bottom right. A sounding effect is lit.

The FX menu: all 27 effects on one page
The FX menu
RowColumn 1 (F3 – C#4)Column 2 (D4 – A#4)Column 3 (B4 – G5)
1Grains: a cloud of tiny grains of the chord (7 s)Echo notes: one note echoing in time, fadingCall & reply: a phrase up high, answered lower
2Snowfall: soft high notes drifting downStrum: strummed down from high, then again softerGlimmer: the chord at once, then higher, and higher
3Music box: a little tuneTwinkle: high bells from the chord, twinkling here and thereRise: up the scale, quickly
4Kalimba: low and high, rolling over the chordFifths: climbing in fifthsClock: two notes, tick and tock, in time
5Arp: up and down the chord in sixteenthsLullaby: a slow melody, a step or two at a timeStars: high pings (7 s)
6Cascade: bells down the scaleWhirl: low and high, closing inMeteor: a streak up three octaves, then one high note
7Harp: up the chordUnfold: the chord a note at a time, ringing onWind harp: soft harp notes, as the wind plays them (7 s)
8Chimes: wind in the chimesRipple: a trill, slowing downPeal: church bells ringing down, changing order
9Raindrops: drops on glass, here and thereBounce: a note bouncing like a ballSolo: the lead plays a phrase and its answer now, even with its Level at 0

Each effect's level follows the music: the louder the music is at that moment, the more the effect is lifted, and the more the music steps back while it plays, so an effect is heard over a full mix as well as over a quiet one.

The FX page's knobs:


11The picture

When nothing has been touched for 30 seconds (Picture page: After), or when you press HOME three times, the screen becomes a picture: a field of light warped a little each frame, as MilkDrop does, so everything drawn into it leaves trails.

On Auto (the default), the picture changes by itself: a new shape every half minute or so, melting from the last, and a new set of colours every half minute or so, turning slowly. On the world's own, each world has its own colours and its own few pictures, and one melts into the next every minute or so. There are sixteen: Nebula, Aurora, Mandala, Tunnel, Star drift, Orbits, Ripples, Horizon, Bloom, Silk, Embers, Spiral, Petals, Halo, Veils and Dawn. To hold one, choose it with Picture on the Picture page. There are nine sets of colours: Nebula, Dusk, Aurora, Golden, Moonlight, Sakura, Dawn, Ocean and Lo-fi.

Any button brings the pages back (and does nothing else). A key or a knob brings them back and does its job too.

Pictures: Nebula, Aurora, Dawn](img/picture-1.png "Warm Space's Nebula") ![](img/picture-2.png) ![
Pictures: Nebula, Aurora, Dawn](img/picture-1.png "Warm Space's Nebula") ![](img/picture-2.png) ![

12Speaker and headphones

There's no speaker setting. ZENITH-1 knows from the headphone jack where its sound goes:

What the FM-1 sends over USB audio is the same as what it plays. To record at full quality, plug something into the jack.


13MIDI and the screen reader

MIDI comes in over USB and the TRS jack, and goes out over USB.

ZENITH-1 can tell a screen reader what its screen shows, as AMB-1 does: the page and its knobs, a knob's value as you turn it, the world and its key, the notes you add or take out, the effects you play, every message, and the chord each time the garden moves on. Connect the FM-1 by USB and open FM-1 Screen Reader in Chrome or Edge.


14Saving

ZENITH-1 keeps all eight worlds in the FM-1's memory, each as you left it. Tune, MIDI out, Journey, Wander, Sleep, Keys, Strum sound, Key moves, the effects' settings (Level, Auto FX, How often, Space), Lights and the picture's settings are shared by all the worlds.

What the journey and Wander move is never saved: it is the garden's, not yours. When the journey moves to a new world, that world becomes the current one, and the next save remembers it as the world to start on. An FM-1 that ran AMB-1 keeps its panel calibration; AMB-1's pieces are not read.

Troubleshooting

To put the FM-1 in update mode, hold OCT− and OCT+ for 5 seconds, or hold REC while you switch it on. If you installed m-bootloader with the web installer, holding PLAY at power-on opens its recovery menu.

If a button or knob does the wrong thing, calibrate the panel. Hold OCT− and OCT+ while you switch the FM-1 on, and the screen asks you to press each button and turn each knob in turn.

If ZENITH-1 crashes, it shows a red CRASH screen and restarts by itself a few seconds later. If it crashes twice in a row while starting, it starts in SAFE MODE instead: there's no sound, but USB works, so the web installer can reach it. Reinstall ZENITH-1, or put the stock firmware back from the same page. Press PLAY to try starting ZENITH-1 normally again.

If the sound ever stutters, lower Density and Hits, or switch the Air or the Lead off, and tell the author what world and settings you were on.


15Parameters

The defaults are Warm Space's; each world has its own. Those marked * are shared by all the worlds.

PageValueRangeWarm Space
GardenTempo · Evolve · Motion · Drift30–120 · 0–100 · 0–100 · 20 s – 5:0066 · 35 · 55 · 45 s
JourneyJourney* · Wander* · Tide* · Key moves*Off, Stay, Sometimes, Often · 0–100 · 0–100 · 0–100Often · 50 · 50 · 30
PadLevel · Sound · Swell · Bright0–100 · 15 sounds · 0–100 · 0–10064 · Warm · 70 · 45
Pad shapeWarmth · Movement · Space · Width0–100 each45 · 55 · 60 · 75
BellsLevel · Sound · Density · Tone0–100 · 18 sounds · 0–100 · 0–10052 · Soft · 35 · 30
Bell shapeOctave · Shimmer · Space · Decay−2 – +2 · 0–100 · 0–100 · 0–1000 · 55 · 60 · 60
BassLevel · Sound · Octave · Glide0–100 · 10 sounds · −1 – +1 · 0–10042 · Sine · 0 · 40
Bass shapeFifth · Warmth · Movement · Space0–100 each30 · 50 · 30 · 30
PulseLevel · Kit · Hits · Swing0–100 · 13 kits · 0–100 · 50%–75%34 · Soft · 28 · 50%
Pulse shapeTone · Movement · Space · Width0–100 each50 · 40 · 40 · 50
LeadLevel · Sound · Style · Often0–100 · 16 sounds · 6 styles · 0–10045 · Synth · Wander · 40
Lead shapeTone · Space · Vibrato · Glide0–100 each50 · 55 · 45 · 20
Lead breathAttack* · Release*0–100 each50 · 50
SpaceEcho · Echo time · Reverb · Size0–100 · 1/4. – 4 bars · 0–100 · 0–10040 · 1 bar · 70 · 88
TapeShimmer · Warmth · Tape · Width0–100 each45 · 40 · 15 · 75
AirLevel · Sound · Tone · Movement0–100 · 10 sounds · 0–100 · 0–1000 · Drips · 50 · 50
FXLevel* · Auto FX* · How often* · Space*0–100 · Off, On · Off, 1–100 · 0–10060 · On · 35 · 60
SetupRoot · Tune* · MIDI out* · Lights*C–B · −50 – +50 cents · Off, On · Off, On, KeysD · 0 · On · On
KeysKeys* · Strum* · Strum vol*Scale, Strum, Play · 18 bell sounds · 0–100Scale · Harp · 50
SleepSleep*Off, 30, 60, 90 minOff
PicturePicture* · After* · Colours* · Glow*Auto, the world's, or one of 16 · never – 3 min · Auto, the world's, or one of 9 · Soft, Bright, MaxAuto · 30 s · Auto · Soft
ALGORITHMMode10 modes, or CustomLydian

16Credits

ZENITH-1 is free software under the Mozilla Public License 2.0, a modified version of AMB-1. If you share a changed version, share the source of the files you changed too.

M-VAVE and FM-1 are trademarks of their owners. ZENITH-1 is not affiliated with M-VAVE, Brian Eno, Charles Vestal or Hügelton Instruments.