HOME

JamesOS / FM-1 · Quick start

Make your first beat.

Three synth tracks, four drum lanes, one intuitive way to play your FM-1. Use this guide to make your first beat.

1. Install JamesOS

Back up your projects and patterns before installing. If you already use JamesOS, save your current edits and download all saved projects with the Editor. For other firmware, use its compatible backup tool. The installer does not create a backup. If you have projects made with 1.0a, read projects made with JamesOS 1.0a first.

  1. On a desktop computer, open Chrome or Edge and visit the JamesOS installer.
  2. Connect the powered-on FM-1 directly to the computer with a USB data cable. Close other music software using the FM-1 and stop playback.
  3. Open the installer, allow MIDI access, and follow the on-screen connection, review and installation steps. Keep the FM-1 connected and the browser open until the instrument restarts and the installer confirms it.

Installing unofficial firmware may void your warranty. An interrupted installation can leave the instrument unresponsive. See backups and recovery.

2. Make a sound

Connect headphones or speakers, switch on your FM-1 and turn the volume up gradually.

  • The screen opens on HOME. Play the keyboard. OCT− and OCT+ move the octave.
  • Turn KNOB 1 and KNOB 2 (TIMBRE, HARMONICS) and listen to how they change the tone of played notes.
  • Turn the PRESETS encoder to change the synth engine.
  • Press SEL, turn KNOB 1 (or SELECT) to browse 128 starting sounds (audition them with the keyboard), then press SEL again to select and keep one.
  • Turn the ALGORITHM encoder to switch tracks. T1, T2 and T3 are synth tracks; DK is the drum kit.

3. Make a beat

  • Select the drum kit DK. Press SEQ: the keyboard becomes a step grid. Turn SELECT to choose drum lane D1, then tap WHITE KEYS on the keyboard to add or remove hits. Choose D2–D4 to add other drum sounds.
  • Press PLAY. To set the tempo, press OCT− + GLO to open TEMPO and turn KNOB 1 (BPM).
  • Select a synth track, press SEQ, tap steps, and hold a step for a moment to set its note, length, velocity and condition.

4. Mix and master

  • Press FX. The first screen is the send levels for DRIVE, DELAY, MODULATION, REVERB. Turn the four knobs to adjust the sends.
  • Press FX again for the effect settings.
  • Reverb is shared by all tracks (the GLOBAL tag); the rest belong to the track (the TRACK tag).
  • GLO opens the mixer: knobs 1–4 set the track levels and select the track; OCT− mutes, OCT+ solos.
  • Select DK and press EDIT for KIT LEVEL and individual drum-lane levels, mute and solo.
  • On DK, ARP opens RETRIGGER: hold a lit step to set extra hits and spacing with knobs 1 and 2.
  • Stop playback, then press SAVE to open the SAVE menu. SAVE again quick-saves the current project. If there is no current slot, choose a slot and name first. Always save before switching off.

5. Handy gestures

Do thisTo get
Hold HOME for 0.8 sNotes keep sounding after you let go (HOLD)
Hold ARP for 0.8 s on a synth trackArpeggiator on or off
Hold GLO, turn SELECTJump to the master filter page
Turn SELECT outside a browser, drum grid or menuSweep the master filter
On FX SENDS, hold OCT− and turn a knobSnap the send to 0%, 50% or 100%
Hold the RIGHTMOST BLACK KEY on the keyboardPunch-in effects with the other keys
Hold SEQ, turn KNOB 1Pattern length

The screen shows a hint while you hold a gesture button. Turn MONITOR on in TEMPO to see audio CPU load on the bottom two pixel rows.

Full manual

JamesOS is free community firmware for the M-VAVE FM-1 with three synth tracks, a four-lane drum kit, track effects, a shared reverb and a sequencer. Start with the quick start for a first beat, or check the backup and recovery notes.

Warranty and risk. Installing unofficial firmware may void your hardware warranty. An interrupted update can leave the instrument unresponsive. JamesOS comes with no warranty (GNU GPL v3, sections 15 and 16). Back up your work before updating. JamesOS is not made or endorsed by the manufacturer of the FM-1.

1. The instrument at a glance

2. Controls

FM-1 controls, with the JamesOS logo on its screen
FM-1 controls and the JamesOS logo.

Buttons

Press a page button once to open its first screen. Press it again to move to the next screen in that group.

ButtonWhat it does
HOMESound controls and the track filter. OCT− + HOME opens or leaves MOD DEPTHS and VOICE. Hold HOME for 0.8 seconds to toggle HOLD.
ENVAMP envelope, FILTER envelope, then envelope SETUP.
FXSENDS, DRIVE, DELAY, MODULATION, then REVERB.
GLOMixer and master controls. Press OCT− + GLO for TEMPO and MIDI settings. Hold and turn SELECT for the master filter shortcut.
SEQStep grid, then sequencer settings. Hold and turn KNOB 1 to change pattern length.
ARPSynth arpeggiator; on DK, opens RETRIGGER. On synth tracks, hold for 0.8 seconds to toggle the arpeggiator.
SELBrowse SOUNDS or DRUM KITS. Press again to keep the highlighted sound.
LFOCycle through LFO 1, LFO 2 and GLOBAL LFO.
EDITCycle through KIT LEVEL, PATCH 1 and PATCH 2.
PLAYStart or stop the sequencer. The indicator is green while stopped and red while playing.
RECArm or disarm recording.
SAVEOpen the SAVE menu. Follow the actions shown in its bottom bar.
OCT−Lower the synth octave. OCT− often acts as a Function key when held with another control; see the page-specific actions below.
OCT+Raise the synth octave, or perform the page-specific actions below.

Knobs and encoders

KNOBS 1–4 match the four control columns. The active knob badge is highlighted; a dotted icon with an X means there is no parameter for that knob on this page. Turn faster to move more quickly through continuous values. Discrete choices such as engine or note selections keep their individual steps.

ALGORITHM selects T1, T2, T3 or DK. On KIT LEVEL it is inactive; leave that page before changing track.

PRESETS selects a synth engine without changing its other sound settings. On drum HOME it chooses the kit engine; on the drum sequencer, KIT LEVEL and RETRIGGER it chooses the selected lane's voice. In SOUNDS or DRUM KITS it scrolls the browser.

SELECT normally sweeps the master filter. In SOUNDS or DRUM KITS it scrolls; on the drum step grid and RETRIGGER it selects a lane. SAVE screens use it for their own selection. These page-specific functions take priority over the filter shortcut.

Keyboard and octave buttons

The 27 keys play the selected synth on HOME and parameter pages. The octave buttons shift synth notes by up to two octaves; their lights show the current octave. Drum sounds have no octave shift. On SEQ, the WHITE KEYS on the keyboard become the step grid. RETRIGGER and KIT LEVEL have their own input rules.

WhereOCT− / OCT+
Global MIXERToggle mute / solo for the selected track.
KIT LEVELToggle mute / solo for the selected drum lane.
SEQ grid or RETRIGGERPrevious / next bank of 16 steps.
While editing a SEQ stepNudge its timing earlier / later, in 1/128-note increments.
SEQ settingsNo action.
PUNCH FXPrevious / next settings page.
SOUNDS browser on a synth trackChange the audition octave.
SAVE screensUse the SAVE and PLAY button actions shown on screen.

Reading the screen

Track colours identify the selected track. Goldenrod identifies global controls, including shared reverb and Punch FX. A TRACK badge means the effect settings belong to the selected track. A GLOBAL badge means the effect is shared, though its send can still be per track.

The header shows the track or globe badge, page title, tempo and battery. The metronome swings once across per beat and centres while stopped. Small dots above the bottom cue bar show your position in a page group. Rounded button cues explain shortcuts; brief status messages temporarily replace them.

SCREEN GUIDE

Reading the screen graphics

These examples come from the firmware. Shapes, levels and colours respond to the current sound and settings; the labels and values on the screen identify the control.

TIMBRE
HARMONICS
MORPH
OSC MIX
LFO WAVE
LFO RATE
OCTAVES
ARP GATE

3. Pages

The screenshots and control graphics show examples of the screens. Values, track colours and graphics respond as you play and turn the controls.

HOME and kits · ENV · FX · GLO · SEQ · ARP · RETRIGGER · SEL · LFO · EDIT / KIT LEVEL · Modulation · PUNCH FX

HOME

HOME with the Analog VCF engine and its four controls
HOME with the Analog VCF engine and its four controls

On a synth track, HOME shows TIMBRE, HARMONICS, MORPH and OSC MIX. The first three shape the selected engine. OSC MIX blends its MAIN and AUX outputs; their sounds depend on the engine. Turn PRESETS to choose a different engine.

Press OCT− + HOME to open the deep menu. Press HOME to move between its two pages; press OCT− + HOME again to return to the sound pages.

HOME MOD DEPTHS with timbre, harmonics, morph and pitch modulation controls
HOME / MOD DEPTHS

MOD DEPTHS adjusts the combined modulation reaching TIMBRE, HARMONICS, MORPH and PITCH. Zero leaves the routed modulation unchanged. Positive values increase its depth; negative values reduce it.

HOME VOICE page with portamento, glide mode, amp mode and gate length
HOME / VOICE

On a synth track, PORTA TIME sets portamento from 0% to 100%, up to two seconds per octave. GLIDE MODE selects OFF, LEGATO (glide when notes overlap), or ALWAYS (glide from the previous pitch). AMP MODE selects the normal ENVELOPE or LPG, which couples a low-pass gate to the amplitude envelope. In LPG mode, GATE LENGTH limits how long a held note plays, from 10 ms to 2 seconds; OFF follows the key hold, and releasing a key early closes the gate. LPG uses a fixed 2 ms close; the amp RELEASE control is hidden in LPG mode. These controls are inactive on the drum kit.

On DK, turn PRESETS on HOME to choose BRAIDS or PLAITS. Use SEL to browse the starting kits, including 80S and 90S:

KitKNOB 1KNOB 2KNOB 3KNOB 4
BRAIDS KITTIMBRECOLORSNAPGATE
PLAITS KITTIMBREHARMONICSMORPHGATE

The 80S and 90S starting kits use the PLAITS engine, so their HOME controls are TIMBRE, HARMONICS, MORPH and GATE. SNAP adjusts the attack character of the BRAIDS kit. GATE limits each hit's duration; OPEN lets its natural tail play. A shorter held-step LENGTH takes precedence. GATE is temporary and returns to OPEN when a session loads.

Press HOME again for the track filter: FILTER, RESONANCE, ENV DEPTH, KEY TRACK. FILTER spans low-pass through open to high-pass. ENV DEPTH is bipolar: it sets how much the filter envelope moves the filter. KEY TRACK switches note-based cutoff tracking on or off. The track filter and master filter are separate stages. On the track filter page, make a fresh OCT− hold and turn KNOB 1 to snap toward the low-pass end, open midpoint or high-pass end. Keep holding OCT− and turn again to move between those points.

Track filter controls and the OCT− plus knob 1 snap cue
Track filter

ENV

ENV / AMP with its envelope curve and ADSR settings
ENV / AMP with its envelope curve and ADSR settings

Three screens:

ScreenControls
ENV / AMPATTACK, DECAY, SUSTAIN, RELEASE of the sound's volume.
ENV / FILTERATTACK, DECAY, SUSTAIN, RELEASE of the modulation envelope.
ENV / SETUPINTENSITY, TARGET, LOOP, RETRIGGER for that modulation envelope.

HOME filter ENV DEPTH adds a separate amount of the modulation envelope to the filter. The envelope SETUP target and intensity can also route that envelope to a destination. See modulation for the interaction with PATCH.

FX

FX SENDS with different effect send levels
FX SENDS with different effect send levels

The drum track and all three synth tracks have these five screens:

ScreenControls
SENDSDRIVE, DELAY, MODULATION, REVERB levels for the selected track.
DRIVEMODE (OVERDRIVE, DISTORT or FUZZ), GAIN, TONE, BIAS.
DELAYENGINE (DIGITAL, TAPE ECHO, MULTITAP or GLITCH), TIME, FEEDBACK, TONE.
MODULATIONENGINE (CHORUS, FLANGE, PHASER or VIBRATO), RATE, DEPTH, FEEDBACK.
REVERBENGINE (ROOM, HALL or SPACE), SIZE, DECAY, PRE DELAY.
FX DELAY with engine, time, feedback and tone
FX DELAY

Use SENDS to set how much of each effect the selected track receives.

FX DRIVE with mode, gain, tone and bias
FX DRIVE

On DRIVE, GAIN sets the strength of the distortion, TONE adjusts its brightness, and BIAS changes its character by offsetting the distortion. At zero bias each drive mode uses its natural character; higher settings add asymmetry.

On DELAY, TIME selects a tempo-synchronised note division, FEEDBACK controls the repeats, and TONE darkens or brightens them. T means triplet (two-thirds of the named note); D means dotted (one and a half times the named note). At 120 BPM, 1/4 is 500 ms, 1/4T is about 333 ms and 1/4D is 750 ms.

FX MODULATION with engine, rate, depth and feedback
FX MODULATION

On MODULATION, RATE and DEPTH set the speed and amount of movement. FEEDBACK adds resonance and colour, especially with FLANGE and PHASER; zero leaves the effect uncoloured by feedback.

REVERB is shared by all tracks: its ENGINE, SIZE, DECAY and PRE DELAY affect the shared reverb, while each track's reverb SEND is set on the SENDS page. PRE DELAY sets when the reverb begins: AUTO derives it from the reverb settings, while 1/64T, 1/64, 1/32T, 1/64D, 1/32, 1/16T, 1/32D, 1/16, 1/8T, 1/16D and 1/8 follow the current tempo. The dry sound remains immediate. To hear the difference, use a short sound with ROOM and a high reverb SEND, set the tempo to 60 BPM, then compare 1/64T with 1/8. Allow a few seconds after changing the setting for the timing to settle.

FX REVERB with engine, size, decay and pre delay
FX REVERB

On SENDS, hold OCT− and turn any knob to jump directionally between 0%, 50% and 100%. The cue appears below the four send bars. A snap gesture does not change octave; a plain OCT− tap still lowers the synth octave. Without the modifier, sends adjust continuously.

GLO (global)

Global mixer with different track levels and active signal meters
Global mixer with different track levels and active signal meters

Press GLO repeatedly to visit the mixer and master screens. Press OCT− + GLO to open TEMPO; press GLO there to reach the MIDI pages. From TEMPO or either MIDI page, OCT− + GLO returns to the main GLOBAL mixer:

ScreenControls and use
MIXERTrack levels on knobs 1–4. Turning a level knob also selects that track, even when its level is already at a limit. OCT− mutes; OCT+ solos.
GLOBAL / PANPan for T1, T2, T3 and DK. The centre marker indicates true centre.
GLOBAL / FILTERFILTER, RESONANCE and ENV DEPTH. The fourth slot is inactive. SELECT and KNOB 1 edit the same master filter.
GLOBAL / HEATHEAT TYPE (BITCRUSH, SATURATE or TAPE WOW), AMOUNT. This is separate from each track's DRIVE.
COMPRESSORSOURCE, THRESHOLD, RATIO, MAKEUP. SOURCE offers OFF, ALL, TRACK 1–3 or KICK DRUM.
COMP TIMEATTACK, HOLD, RELEASE, MIX.
TEMPO (hold GLO)BPM, SWING, CLOCK SOURCE and MONITOR. The clock readout appears in the header, and the build number appears in the cue area.

The global mixer's centre meter shows each track after its track effects and pan, before shared reverb, master compression and master output. Its top turns red at full scale and it decays after a peak. This is different from the individual drum-lane meters described under KIT LEVEL.

To jump to the master filter, hold GLO and turn SELECT. On GLOBAL / FILTER, make a fresh OCT− hold and turn KNOB 1 to snap toward the low-pass end, open midpoint or high-pass end. Keep holding OCT− and turn again to move between those points.

Global filter controls and the OCT− plus knob 1 snap cue
Global filter

BPM and SWING are shared. MONITOR is described in section 6.

Compressor

Compressor screen showing source, threshold, ratio, makeup and gain-reduction meter
COMPRESSOR with its gain-reduction meter and four controls
Compressor timing graph with attack, hold and release sections
COMP TIME: the selected timing section is highlighted

The global compressor controls the dynamics of the finished mix. Press GLO until you reach COMPRESSOR; press it again for COMP TIME. Both pages show a goldenrod gain-reduction meter above the controls: it shows how much the compressor is turning the signal down. On COMP TIME, the graph combines ATTACK, HOLD and RELEASE; turning a control highlights its section. MIX blends the compressed and uncompressed signals.

PageControlWhat it does
COMPRESSORSOURCEChooses the signal that triggers compression: OFF, ALL, TRACK 1–3 or KICK DRUM. Choose a track or kick to make that signal drive compression of the mix.
COMPRESSORTHRESHOLDSets the level above which the compressor begins reducing gain.
COMPRESSORRATIOSets how strongly signals above the threshold are compressed. 1:1 applies no compression.
COMPRESSORMAKEUPAdds gain to the compressed signal.
COMP TIMEATTACKSets how quickly compression responds to a rising signal.
COMP TIMEHOLDSets how long compression holds before releasing.
COMP TIMERELEASESets how quickly compression eases after the signal falls.
COMP TIMEMIXBlends the compressed and uncompressed signals.

For a pumping effect, try KICK DRUM as the source and adjust THRESHOLD, RATIO and RELEASE while the beat plays. Use the meter and your ears to set the amount of gain reduction.

SEQ: patterns and step editing

Synth sequencer with notes on the 16-step grid
Synth sequencer with notes on the 16-step grid

Press SEQ for the current track's grid. WHITE KEYS on the keyboard toggle 16 steps in the current bank; OCT− and OCT+ move between four banks, for up to 64 steps.

On patterns longer than 16 steps, the bottom cue alternates every 3 seconds between OCT−/+ + REC SHIFT NOTES and OCT−/+ STEP BANK.

Sequencer with a 32-step pattern and the OCT−/+ STEP BANK cue
A 32-step pattern with the STEP BANK cue

On DK, turn SELECT to choose D1–D4; WHITE KEYS toggle hits in that lane. On the FM-1 SEQ grid, black keys do not choose a lane or note. On a synth track, hold a step until its edit controls appear, then press another white key to set and audition that step’s pitch. On DK, PRESETS changes the selected lane’s voice. Knob settings without a held step are defaults for new steps, rather than edits to every existing hit.

Hold a step to edit NOTE, LENGTH, VELOCITY and CONDITION. OCT− and OCT+ nudge its timing earlier or later in 1/128-note increments. The display simplifies the offset to a musical fraction, such as +1/32 or −3/64. The available range depends on the track speed and swing, keeping the note within its neighboring step boundaries. Holding SEQ with a step makes it a fill step. Conditions include ALWAYS, probabilities, FIRST PASS, REPEATS, AFTER HIT, AFTER MISS, NEIGHBOR, ALONE, FILL, NO FILL and A-of-B patterns.

To shift every note in the current track by one step, hold REC and press OCT− or OCT+. Keep holding REC to shift again. Notes that pass the first or last step wrap around the track’s sequence. On DK, all four drum lanes move together; timing and other step settings move with each note.

To copy a step, hold an active step and press REC. Hold a destination step and press PLAY to paste. Synth steps paste to synth tracks and drum steps to drum lanes; the step’s edits come with it. With no copied step, PLAY retains its transport function.

Press SEQ again for STEPS, SPEED, QUANTIZE. STEPS is the pattern length; SPEED selects 1/8, 1/16 or 1/32; QUANTIZE controls recording-time quantisation. Hold SEQ and turn KNOB 1 as a shortcut to pattern length. REC arms recording; PLAY starts or stops playback.

ARP: synth arpeggiator

On T1–T3, press ARP for MODE, RATE, OCTAVES, GATE. Hold ARP for 0.8 seconds to toggle the arpeggiator. While it is on, the ARP page shows an ARP: ON badge. HOLD sustains notes after you release the keys.

MODE offers UP, DOWN, UP AND DOWN, RANDOM and MANUAL. MANUAL follows the order you played the notes. RATE offers 1/8, 1/8T, 1/16, 1/16T and 1/32. The 3 beside the note icon means a triplet; straight rates follow global swing. GATE sets each arpeggiated note's length as a fraction of the interval.

RETRIGGER: repeated drum hits

Drum retrigger grid with programmed hits and a selected step
Drum retrigger grid with programmed hits and a selected step

On DK, ARP opens RETRIGGER, with all four drum lanes visible. It does not open the synth arpeggiator.

  1. Pick the drum lane. The first four BLACK KEYS choose D1, D2, D3 and D4, from left to right. You can also turn SELECT.
  2. If the pattern is longer than 16 steps, press OCT− or OCT+ to show the bank of steps you want.
  3. Hold a lit white step key. An empty step does not audition or accept a retrigger edit.
  4. Turn KNOB 1, RETRIGS, for 0–7 extra hits. OFF means no repeats beyond the original hit.
  5. Turn KNOB 2, SPACING, for the interval between hits: 1/128, 1/64, 1/32, 1/16, 1/8, 1/4, 1/2 or 1/1 note.
  6. Release the step to finish editing. Turning those knobs without holding a lit step does not edit it.

White marks in a hit cell show assigned retriggers. Active step keys are medium brightness, with the held step and playhead brighter. A later hit in the same lane replaces any remaining repeats. The original hit's condition is checked once; repeats do not roll its probability again. Retriggers save with the project.

SEL: SOUNDS and DRUM KITS

SOUNDS browser
SOUNDS browser

On a synth track, SEL opens SOUNDS: 128 sounds, starting with 32 favorites and followed by categories for bass, leads, keys, pads and more. On DK it opens DRUM KITS: 12 starting points for BRAIDS and PLAITS, including 80S and 90S sounds.

Turn KNOB 1, SELECT or PRESETS to browse the five visible rows. The highlighted entry is auditioned by the keys and by a running sequence. The knob chip lights in the track colour while you scroll. Press SEL again when the cue reads LOAD PRESET to keep that entry. Leaving before keeping it restores the previous sound. The drum browser preserves the sequence, lane voice choices and levels.

LFO

LFO controls
LFO controls

Two LFOs per track, each with WAVE, RATE, TARGET, DEPTH. WAVE offers SINE, TRIANGLE, SAW, SQUARE and SAMPLE HOLD. The target menu follows the selected engine; on a Plaits synth track, MODEL steps through the models around the current sound. DEPTH sets how far it moves. The display uses MORPH for the relevant Plaits control. Route badges show which LFO or patch is affecting a parameter, with colour and pulsing to distinguish them.

Press LFO to cycle through LFO 1, LFO 2 and GLOBAL LFO. The global LFO is shared across the instrument; its targets include the global filter and resonance, heat, compressor controls, and reverb size and decay. Press EDIT to cycle through KIT LEVEL, PATCH 1 and PATCH 2. Each track has its own patches, including the drum kit. Each patch has SOURCE, TARGET, AMOUNT and ENABLE; negative amounts invert the route. On a synth track, its targets match the track LFO targets, including MODEL and the arpeggiator controls. In HOME’s MOD DEPTHS page, scale modulation for TIMBRE, HARMONICS, MORPH and PITCH.

PATCH 1 controls for the selected track
PATCH 1 for the selected track

EDIT: KIT LEVEL

Drum mixer with individual lane levels
Drum mixer with individual lane levels

Select DK, then press EDIT to open the drum KIT LEVEL mixer. Each knob controls D1–D4 and selects that lane. PRESETS changes its voice. OCT− toggles mute; OCT+ toggles solo. The four strips show matching D1–D4 badges, short voice names and M/S indicators. Keyboard keys and ALGORITHM are inactive here. Use the track’s PATCH pages under EDIT, and the kit’s ENV and LFO pages for modulation.

Several drum lanes can be soloed together. Solo excludes only the other drum lanes, so synth tracks keep playing. Mute takes precedence over solo. The underlying lane levels are preserved; existing effect tails may continue to decay. Lane mutes save with the project; solos clear on load.

KIT LEVEL meters show individual lanes before the kit's shared track-effects chain. The global mixer's DK meter shows the summed kit after that chain. Lane names use a five-character maximum, including KICK1, SNARE, OHAT, CHAT, CYMB and TOM.

Modulation: how routes interact

The source labels describe these signals:

SourceMeaning
OSC AVG / MIX AVGSigned averages from the preceding audio block. They are not audio-rate oscillator or mix patch outputs.
AMP ENV / FILTER ENVThe amplitude or filter envelope.
LFO 1 / LFO 2The selected waveform of that LFO. Dedicated TRI and SQU sources provide its triangle or square signal.
GLOBAL LFOThe shared LFO waveform. PATCH AMOUNT sets its depth independently of the global LFO’s own DEPTH setting.
VELOCITY / NOTEThe most recently played note's velocity or pitch.
RANDOMA new random signal each audio block.
RANDOM PER NOTEA new value on each note-on, held until the next. Polyphonic voices and drum lanes on the same track share the most recent value.
GATEHigh during the filter envelope's attack, decay and sustain stages.

Targets include pitch, the engine's sound controls, FILTER FREQUENCY, FILTER RESONANCE, TRACK LEVEL and TRACK PAN, the amp envelope, DRIVE SEND, DELAY SEND, MOD FX SEND, REVERB SEND and the LFO and arpeggiator controls. Choices depend on the engine. Kit modulation signals are shared by the kit, rather than independent per drum lane.

LFO and PATCH routes can contribute to the same destination. MOD DEPTHS scales the combined modulation applied to TIMBRE, HARMONICS, MORPH and PITCH. At 0% it passes unchanged; +50% makes it one and a half times as strong, −50% halves it, and −100% removes it. The sign of the underlying route is preserved.

A valid enabled PATCH sourced from FILTER ENV replaces the envelope SETUP direct route, even when its amount is zero or its destination is different. ARP destinations do not replace that direct route. Disable that patch to restore the direct route. HOME filter ENV DEPTH remains an independent filter contribution. Track filter modulation can sweep through the open center between low-pass and high-pass.

PUNCH FX

Hold the RIGHTMOST BLACK KEY on the keyboard and press another black effect key. One group runs at a time while its effect keys are held; releasing them ends that effect. Releasing the RIGHTMOST BLACK KEY on the keyboard returns to the page you were using. Punch effects act on the finished mix and use the global goldenrod colour. ECHO is unavailable while polyphonic voices use its delay memory; the screen shows ECHO UNAVAILABLE IN POLY.

GroupEffect keys, counting from key 0 at the leftSettings
LOOP1, 3, 5Loop length: 1 bar, 1/2, 1/4 or 1/8 bar.
ECHO8, 10Time and feedback.
FILTER13, 15, 17Low-pass/high-pass shape and amount.
TREMOLO20, 22Rate and depth.

The hold key is key 25. OCT− and OCT+ move between two Punch settings pages. The active group's name and parameter are highlighted; LOOP returns to the first page because it has no second-page control.

While playing, the hold key is one brightness step above idle BLACK KEYS on the keyboard. Holding it dims the WHITE KEYS on the keyboard and lights the effect keys; the active group's lights chase from left to right. Punch is available on performance pages; the step grid and SAVE screens retain their own key roles.

4. Gestures and shortcuts

GestureResult
Hold HOME for 0.8 secondsToggle HOLD.
Hold ARP for 0.8 seconds on a synthToggle the arpeggiator.
Hold GLO, turn SELECTJump to the master filter and sweep it.
Fresh OCT− hold on GLOBAL / FILTER, turn KNOB 1Snap the filter to an end or the open midpoint.
Hold OCT−, turn a knob on FX SENDSSnap that send to 0%, 50% or 100%.
Hold SEQ, turn KNOB 1Change pattern length.
OCT− + GLOOpen TEMPO, or return from TEMPO or MIDI to the GLOBAL mixer.
OCT− + SEQOpen PATTERNS, or return from PATTERNS or ARRANGE to SEQUENCER.
Hold an active SEQ step + REC; hold a compatible destination step + PLAYCopy and paste a step.
Hold a SEQ step, turn knobsEdit that step's note, length, velocity and condition.
Hold a SEQ step, press OCT− / OCT+Nudge its timing.
Hold SEQ with a stepMake it a fill step.
Hold a lit drum step on RETRIGGEREdit RETRIGS and SPACING with knobs 1 and 2.
Turn a mixer level knobAdjust its level and select its track or drum lane.
Hold the RIGHTMOST BLACK KEY on the keyboardUse Punch FX.

5. Saving, projects and Editor

Save and load

SAVE opens the SAVE menu: QUICKSAVE, SAVE AS, LOAD and INIT. Follow the bottom cues: SAVE confirms or quick-saves where offered; PLAY cancels. Quick-save writes the current slot. If no current slot is selected, choose a slot and name to save first. There are 12 slots and project names can contain up to 12 characters. Knobs 1 and 2 edit the name. Project-list selections use global goldenrod.

Loading with unsaved changes opens SAVE FIRST?. INIT starts a blank project after confirmation. Stop playback before saving or initializing. These actions stop lingering notes and effect tails. If REC is armed, it pauses during the operation and is armed again afterward. Save before switching off.

Project storage

Projects contain the session and pattern bank. Retriggers and lane mutes save with the project; lane solos clear on load. Drum GATE is temporary and returns to OPEN when a session loads. Use the Editor to download your saved projects and keep the backup somewhere safe. Save current edits on the instrument first.

Project compatibility. If a project cannot be loaded, keep a verified backup and do not overwrite a slot whose contents you need.

Backups and recovery

Save your current edits, then use the Editor to download all saved projects before changing firmware. Keep that backup somewhere safe: returning to stock firmware can clear every JamesOS project slot. After reinstalling JamesOS, restore each project to its chosen slot and load it on the instrument. If installation fails, see the FM-1 rescue guide.

Projects made with JamesOS 1.0a

Projects saved with 1.0a do not load directly in 1.0b. The instrument lists them as OLD FORMAT. Updating does not erase them, but saving over such a slot replaces the old project. Convert them with the Editor.

  1. Before you update, save any work you want to keep into a named slot. Only saved slots can be converted, not unsaved edits.
  2. Keep your own backup if you have one.
  3. After updating, open the Editor, connect the FM-1 and select the old project. The Editor marks it as an older project format.
  4. Choose Download original and keep that file. The slot on the instrument is not changed.
  5. Choose Download upgraded project and read the notes the Editor shows.
  6. Select an empty slot, choose the upgraded file and confirm. Then load that slot on the instrument.
  7. Listen to the result. Keep the original until you are happy with it.

Conversion can approximate some settings, or refuse a project it cannot convert safely. It does not promise the same sound: the mix, filter, reverb, delay and drum kits changed in 1.0b, so a converted project can sound a little different. Projects saved by 1.0b cannot be opened by 1.0a.

Patterns and arrangement

Each project stores up to eleven patterns, subject to available project storage. Press OCT− + SEQ to open PATTERNS; from PATTERNS or ARRANGE, press it again to return to SEQUENCER. The eleven black keys select patterns; during playback a selection queues for the next bar. To create a repeating chain, hold the first pattern key, tap each following pattern key in order, then release the first key. Tap a pattern again to repeat it in the chain. A single pattern press ends the chain. Hold a source pattern key and press REC to copy, then hold a destination key and press PLAY to paste.

Patterns page showing the pattern choices and queue cue
PATTERNS

On PATTERNS, turn KNOB 4 from PATTERN to ARRANGE to open ARRANGER; stop playback before changing modes. Turn KNOB 1 to move the cursor between blocks and gaps. Press a black key on a block to change its pattern, or at a gap or END to insert a block. KNOB 2 sets the selected block’s length, or the length of the next block when the cursor is at a gap or END. KNOB 3 switches whole-arrangement LOOP MODE on or off. Hold OCT− and press REC to remove the selected block. PLAY starts at the cursor, or at the beginning when the cursor is at END. Turn KNOB 4 back to PATTERN to select or queue patterns with the black keys.

Arranger page with pattern blocks on a song timeline
ARRANGER

An arrangement can contain up to 64 blocks, with 1–16 bars per block. Save the project to keep its pattern bank and arrangement.

Editor: project transfer

The JamesOS Editor moves saved projects between a compatible FM-1 and a computer. The Editor checks that the connected firmware supports project transfer. In Chrome or Edge, connect the powered-on instrument by USB, open Editor and allow MIDI access. Choose Connect FM-1, then select a saved slot. Save changes on the instrument first: the Editor transfers saved projects, not unsaved changes.

Choose Download project to save the selected slot as a .jproject file. Download all saved projects downloads a ZIP with a separate project file for each occupied slot; empty slots are skipped. To restore one, extract it from the ZIP, select a destination slot, choose the .jproject file, review the replacement and confirm. Loading replaces the saved slot but does not open it on the FM-1; load the slot on the instrument to play it. When the connected firmware supports deletion, the Editor enables Delete project. Deleting permanently removes the selected slot; download a copy first if you want to keep it.

Polyphony

With the sequencer stopped, select a synth on the first HOME page and press OCT− + PLAY to toggle polyphony. The HOME badge shows MONO or POLY and the available voice count. The selected synth can play chords; the number of simultaneous voices depends on the sound engine and modulation settings. The other synth tracks and drums are unavailable while the voices are in use; their settings and sequences are retained. Starting playback restores the normal track engines; HOME shows “POLYPHONY OFF DURING PLAYBACK” while the sequencer runs. Some polyphonic configurations use delay memory for additional voices; punch echo is unavailable while that memory is in use. When playback stops, the return to polyphony waits until held synth notes and the selected track’s audible release finish.

6. The CPU monitor

TEMPO with MONITOR enabled
TEMPO with MONITOR enabled

Press OCT− + GLO to open TEMPO and turn KNOB 4, MONITOR, to ON. It uses the same ON/OFF toggle style as other settings. Its setting is saved with the project.

If two or more audio overruns occur within four bars, the instrument enables MONITOR and shows CPU USAGE HIGH. MONITOR ENABLED. once per power-on session.

The bottom two pixel rows show the average audio load, with a marker for the maximum. The meter turns red after an overrun. The MONITOR card shows AVG, MAX and OVR.

This is an average, not a guarantee against a slow individual block. If you hear clicks and the meter is near the limit, reduce effect sends or simplify the sound. The global mixer and KIT LEVEL show signal level; this bottom bar shows processor load.

7. MIDI and USB audio

MIDI input channels can be assigned to T1–T3 and drum lanes D1–D4. Program Change chooses an engine or kit; CC 7 controls synth track or drum-lane level, CC 71 controls COLOR/MORPH and CC 74 controls TIMBRE. MIDI Start, Continue and Stop control the sequencer, and USB/MIDI clock can be selected as the timing source. See the MIDI chart.

USB audio output is stereo, 16-bit. The sound engine runs at 44.1 kHz and the USB audio device presents 48 kHz to the computer.

8. Specifications and limits

ItemLimit
Tracks3 synth tracks and 1 drum track with 4 lanes.
Synth engines24 Plaits engines.
Kit enginesBRAIDS and PLAITS. The 80S and 90S starting kits use PLAITS.
Starting sounds128 synth sounds and 12 drum-kit starting points.
SequencerUp to 64 steps per track, in four banks of 16.
Tempo60–240 BPM.
RetriggersUp to 7 extra hits per drum step.
Projects12 slots; names up to 12 characters; each project contains a pattern bank.
Modulation2 LFOs and 2 PATCH slots per track, plus 1 global LFO. Modulation is evaluated at block rate.
ReverbOne shared tank; per-track sends.
Audio44.1 kHz internally; stereo 16-bit USB audio at 48 kHz.
Processing256-frame audio blocks; heavy projects can approach the real-time deadline.

9. Troubleshooting

ProblemWhat to check
No sound from a trackIts global mixer level, mute and solo states, plus the hardware volume.
One drum lane is silentKIT LEVEL's lane level, M/S state, chosen voice, GATE and that step's length. A mute takes precedence over solo.
The drum knobs do nothingOn RETRIGGER, hold a lit step first. On HOME, the available knobs depend on whether BRAIDS or PLAITS is selected.
ALGORITHM does nothing on the drum mixerLeave KIT LEVEL before changing track.
A filter-envelope route seems inactiveCheck whether an enabled PATCH using FILTER ENV has replaced the direct route.
Clicks or dropoutsEnable MONITOR and simplify effects or sound settings if load approaches the limit.
SAFE AUDIO: SAVE+RESTARTThe instrument has fallen back to one audio core. Save your work and restart; polyphony is unavailable in this state.
STORE FULLThe project cannot fit in the available storage. Reduce its contents, then try saving again; keep another backup.
OLD FORMAT or OLD PROJECT NOT LOADEDThe project format is not supported. Preserve your backup and do not overwrite a slot you need; see project storage.
A protection flag is reported 0x02Keep your full backup and do not overwrite protected data until the cause is identified and resolved.
The FM-1 is stuck after an updateKeep your backup and follow the FM-1 rescue guide for the device mode you see.
A project fails to loadPreserve your work and backup, note the firmware build number and report what happened.

MIDI implementation

JamesOS receives MIDI over USB and the FM-1’s 3.5 mm MIDI IN jack. Use a compatible 5-pin MIDI-to-3.5 mm adapter to connect an external sequencer or controller. JamesOS also appears to the computer as a USB-MIDI and USB-audio device.

Routing and clock

Press OCT− + GLO to open TEMPO, and use knob 3 to select CLOCK SOURCE. Press GLO once for MIDI / 1, where knobs 1–3 set the input channels for T1–T3. Press GLO for MIDI / 2, where knobs 1–4 assign D1–D4. The defaults are channels 1–3 for T1–T3 and 4–7 for D1–D4. Each destination can use any channel 1–16, including a shared channel, or OFF to disable its MIDI input and keyboard MIDI output. Any note on a drum lane’s assigned channel triggers that lane’s selected voice. Channel 10 needs an explicit assignment. These settings are saved with the session.

With CLOCK SOURCE set to USB/MIDI, the FM-1 follows clock and transport received over USB or the MIDI IN jack. Use one clock source at a time. It waits for a stable incoming MIDI clock and stops playback if clock is lost. Start begins at the beginning. Continue resumes the locally stopped position. Song Position Pointer (F2) stops synchronized playback and requires a new Start.

Messages received

MessageEffect
Note On (velocity above 0)Plays a note on the track; velocity sets level. While REC is armed it is recorded into the pattern.
Note Off, or Note On with velocity 0Releases the note.
Program ChangeLoads a sound onto the track (below). A number the track cannot take shows PRESET ROLE LOCKED.
CC 7Synth track level or assigned drum-lane level (0 to 127).
CC 71Track COLOR (0 to 127).
CC 74Track TIMBRE (0 to 127).
CC 120, CC 123All sound off or all notes off for that track.
Start (0xFA)Start the sequencer.
Continue (0xFB)Resume the locally stopped position.
Stop (0xFC)Stop the sequencer.
Clock (0xF8)Supply timing when USB/MIDI clock is selected.

Pitch bend, aftertouch, modulation wheel, RPN/NRPN and bank select are not implemented.

Program numbers

ProgramSoundTracks
52 to 75The 24 synth engines, in the order of the table belowSynth tracks 1 to 3
48BRAIDS KITDrum track
76PLAITS KITDrum track

Programs 0 to 47 and 49 to 51 are not selectable on these tracks. Select the 80S and 90S kits in DRUM KITS. The 128 bank sounds on the SEL page are sets of settings, not program numbers.

ProgramEngineProgramEngineProgramEngine
52ANALOG VCF60VIRTUAL AN68SWARM
53PHASE DIST61WAVESHAPE69NOISE
54FM BASS62FM70PARTICLE
55FM KEYS63GRAIN71STRING
56FM PAD64HARMONIC72MODAL
57WAVE TERRAIN65WAVETABLE73KICK
58STRING MACH66CHORD74SNARE
59CHIPTUNE67SPEECH75HI HAT

Drum notes

Any note received on a drum lane’s assigned MIDI channel plays that lane. Choose the lane’s voice with PRESETS on the drum sequencer, KIT LEVEL or RETRIGGER. If multiple lanes share a channel, a note triggers each assigned lane.

Messages sent

When you play the keyboard, JamesOS sends Note On (velocity 100) and Note Off on the track's channel, so a DAW or other synth can follow what you play. Keyboard output uses USB MIDI channels 1–3 for synth tracks and channel 4 for drums. Channel assignments do not change these output channels, but setting a track or drum lane to OFF suppresses its keyboard MIDI output. It does not send clock, CC, or Program Change.

System exclusive

USB SysEx is used by the installer, compatible Editor project transfers and diagnostic tools. JamesOS also supports the FM-1 community screen-reader protocol over USB MIDI: a compatible screen reader can announce the current screen, controls and status messages. The device stays silent until a reader connects. To use it, connect the instrument by USB, open the FM-1 Screen Reader page in Chrome or Edge and choose Connect. SysEx received through the MIDI IN jack is ignored. Avoid sending unrelated SysEx during an update.

Audio

USB audio output, stereo, 16-bit. The instrument renders at 44.1 kHz; the computer sees a 48 kHz device.