viscera

Manual · Viscera 1.1.3

Guide

Viscera turns the M-VAVE FM-1 into a live-capture instrument. You catch sound coming in over Bluetooth or USB, then stretch it, freeze it, shatter it, vocode it and ring it through resonators. This page covers installing it safely, getting sound in, how the sound flows, and what every page and control does.

01

Installing

Coming from Ravel? Go back to stock first

Don't install Viscera straight over Ravel, SLOOP or any other Felucca-based firmware. Handing over to M-VAVE's updater from those can switch the FM-1 off part-way through. Viscera's install page refuses to install from them for this reason.

  1. Open Ravel's install page and use Back to the stock firmware with M-VAVE's V15 file. That puts M-VAVE's own firmware back.
  2. Check that the FM-1 starts into M-VAVE's firmware.
  3. Then come back to Viscera's install page and install from there.
Early firmware

Viscera is being tested on hardware now. Back up first: save your projects and samples with M-VAVE's workbench, because switching firmware doesn't convert them. Viscera's reel (captures you KEEP) uses the flash where the stock firmware keeps its projects.

Steps

  1. Use Chrome or Edge on a computer. Switch the FM-1 on and connect it by USB. Close other MIDI software.
  2. On the install page, pick a version from the menu. The newest is first, and each has a line on what it changed. Press Use this version.
  3. Press Connect and allow MIDI access. The page says what the FM-1 runs now, and names the Viscera version if it's one.
  4. Press Install Viscera. Keep the cable in, the FM-1 on and the tab in front until it restarts, which takes one to three minutes.

Going back: on the install page, Put M-VAVE's V15 back installs M-VAVE's original firmware. M-VAVE's workbench can too.

1.1.0 note: on the FM-1, 1.1.0 overloads the CPU when RESON is on, with clicks even at zero volume. Use 1.1.1 or later.

02

Quick start

  1. Send sound in. Pair a phone over Bluetooth and play something, or play into the FM-1 from a computer over USB (see Getting audio in).
  2. Press HOME for HANDS. The screen shows track A.
  3. Tap REC to start catching, then tap again to end. The gap between the taps is the loop length. A full buffer ends it by itself.
  4. Turn the knobs. STRETCH slows or speeds it without changing pitch, PITCH shifts it, and POS and SIZE pick the window it plays.
  5. Try FX (SHARDS) and SEL (SPECTRA) on the same capture. Opening one of these pages also sets the track to that mode.
  6. Press PLAY to run the sequencer and modulators, and ALGORITHM to change track (A–D).

03

Getting audio in

The FM-1 has no analogue input. Sound gets in two ways, and Viscera can use both at once.

InputHow
BluetoothA phone, tablet or computer plays music to the FM-1 as a Bluetooth speaker. Bluetooth audio must be on: GLO → SETTINGS, first view, BT AUD. Then pair from the phone's Bluetooth settings and press play.
USBConnected to a computer, the FM-1 shows up as a USB audio device. Choose it as the output in your computer's sound settings or your DAW.

AUDIO IN (GLO → SETTINGS, second view)

Everything about input in one place:

  • whether Bluetooth is waiting, connected or playing, and whether USB is connected;
  • a level meter for each input;
  • the selected track's INPUT (BT, USB, BT+USB, another track, or the main mix), its GAIN, and MONITR (hear the input through the FM-1).

PRESETS picks the track, and REC opens its SOURCE page. If a capture comes out silent, check here first: the meter moves, the track's INPUT is right, and its SOURCE is CAPTURE.

Samples

Samples in the FM-1's flash sample bank also play (SOURCE → REEL → a slot S1–S16). Write them with the Samples section of the install page or M-VAVE's workbench.

04

Signal path

inputs: BT, USB ──┐ partner's output ─┼─▶ SOURCE ─▶ PUTTY ─▶ (RESON) ─▶ COLOR ─▶ level / pan ─┬─▶ master ─▶ out the reel, samples ┘ capture HANDS one track noise └─▶ SPACE send reel SHARDS at a time drive (delay + reverb) thru SPECTRA crush comp, tilt

Four tracks, A to D, in two pairs: A+B and C+D. A pair can bounce sound between its two tracks, cross spectra, and move together under your hands.

  • SOURCE: what the track holds. Your capture, the reel or a sample, or the live input passing through (THRU).
  • PUTTY: one of three ways to work it (HANDS, SHARDS, SPECTRA).
  • RESON: an eight-band resonant filterbank, on one track at a time.
  • COLOR: noise, drive, crush, compression and tilt.
  • SPACE: a shared delay and reverb, fed by each track's SEND.
  • DISSECT listens to a source and drives things from what it hears: hits, bands and pitch.
  • Modulators, robots, macros and scenes move any of it.

05

Controls

ControlWhat it does
KNOB 1–4The four parameters on screen.
SELECTThe page's next view (the dots in the header).
ALGORITHMTrack A–D.
PRESETSThe page's list: SOURCE's source, the step on SEQ, a modulator's type, a matrix row, a project or sound slot, a Bluetooth device, a learned mapping.
MASTEROutput level.
HOME / FX / SELHANDS / SHARDS / SPECTRA, which also sets the track's mode. Press again for the next view.
EDITSOURCE, then MIX.
ENVCOLOR, press again for RESON.
GLOSPACE, then DISSECT, then SETTINGS.
LFOThe first modulator, then the next one each press, then the MATRIX of every route. Hold LFO and turn a knob to map a modulator to it.
ARPPERFORM: macros and scenes. Hold ARP and turn a knob to map a macro; ARP + a pad recalls a scene.
SEQThe sequencer: STEPS or CAROM (PRESETS switches).
SAVEPROJECT, then SOUNDS. Hold SAVE and turn a knob for MIDI learn. SAVE + REC on a putty page keeps the capture on the reel.
PLAYPlay / stop.
RECOn putty pages and SOURCE: capture (tap, tap), overdub (hold), robot (hold + turn a knob). REC + PLAY clears the capture and its robots. On other pages, the page's own action: freeze SPACE, ping RESON, record steps, and so on.
OCT− / OCT+Octave. Held while turning a knob: the pair moves together (OCT−) or apart (OCT+). Both held: TEMP, where changes snap back when you let go.
PadsNotes for the track, or steps on SEQ, scenes on ARP, RESON's bands on its BAND view.

The bottom line of the screen shows a page's gestures for a moment when it opens.

06

Capturing: SOURCE (EDIT)

Knob
SOURCECAPTURE (what REC catches), REEL (a kept capture, or a bank sample S1–S16) or THRU (the live input, passing through a short ring).
INPUTBT, USB, BT+USB (default), another track, or the main mix.
RATEHI 44.1 kHz, MID 22 kHz (default) or LO 11 kHz: lower rates hold longer captures, and sound grittier.
SOSHow much of the old sound an overdub keeps.
BOUNCEOFF, IN (the track captures its partner's output) or PING (when one track ends a capture, the other takes it back, as long). PING needs BUFFER SPLIT.
REEL / SPLICEKEPT (the reel) or a bank slot; all of the reel or one splice.
GAINInput gain.
KEYSWhat the pads do: OFF, PITCH, PLAY (restart and gate) or SLICE (each key a sixteenth of the window, from F3).
FREEZEHold the playhead still (for THRU, the ring stops recording).
BUFFERLONG (default) or SPLIT; see below.

LONG and SPLIT

  • LONG (the default, 1.1.1 and later) puts the four buffers end to end as one capture the tracks share: about 1.3 s at HI, 2.6 s at MID, 5.2 s at LO.
    • Any track on CAPTURE plays it, each with its own playhead, mode and settings.
    • One track records at a time.
    • A track on THRU keeps one buffer for its ring, so the long capture gets the rest.
  • SPLIT gives each track its own buffer (0.33 s HI, 0.65 s MID, 1.31 s LO), so the pairs can bounce and PING sound between two separate captures.

BUFFER is a setting of the FM-1, not of a project.

Recording

  • Tap REC to start and tap again to end. A full buffer ends it.
  • Hold REC to overdub over what plays (SOS sets how much stays).
  • Hold REC and turn a knob to record a robot: up to about two seconds of the gesture, looping on its own after you let go. Each track has four, and a fifth replaces the oldest.
  • REC + PLAY clears the capture and the track's robots.

The reel

SAVE + REC keeps the capture on the reel in flash, as a splice that survives power-off. That's about 2.6 s at MID in all, 16 splices at most. Writing to flash pauses the sound for a moment. The first KEEP asks twice, because the reel takes the place of any projects the stock firmware kept there. GLO → SETTINGS → PANEL → REEL shows the room left; turn it and press REC to erase the reel.

07

The putty pages

Each mode reads a window of the source, from POS to POS + SIZE, with a playhead moving through it.

  • STRETCH sets the playhead's speed (0.25× to 8×; at the top it freezes) without changing pitch.
  • PITCH shifts it ±24 semitones.

HANDS (HOME)

Two overlapping grains follow the playhead: smooth stretching and pitching.

ViewKnobs
1STRTCH, PITCH, POS, SIZE
2GRAIN (10–260 ms), JITTER, REVRS, LEVEL
3FREEZE, KEYS, GAIN, SOS

SHARDS (FX)

Up to eight grains broken from the window. SHAPE runs:

  • smooth;
  • swell (reverse decay);
  • expodec;
  • glass: sharper and shorter, and at the top it shatters into denser shards an octave up.
ViewKnobs
1SHAPE, DENS, SPRAY (scatter in the window), TRIG: FREE, HIT (on DISSECT's hits), NOTE (keys, steps, CAROM), CLOCK (the steps)
2SIZE, SPREAD (pitch scatter), REVRS (chance), STEREO
3The hands: STRTCH, PITCH, POS, SIZE

SPECTRA (SEL)

A phase vocoder: the sound taken apart into its spectrum and put back.

ViewKnobs
1STRTCH, BLUR (smears the spectrum over time), SHIFT (±24 semitones), CROSS (puts the partner's spectrum on this track's sound)
2GATE (only the loud parts), TILT, HOLD (peaks held), PHASE (scatter)
3PITCH, POS, SIZE, FREEZE

Two tracks can be SPECTRA at once; a third plays as HANDS and says so.

08

RESON (ENV, twice)

An eight-band resonant filterbank at 200, 400, 800, 1200, 1600, 2400, 3200 and 4800 Hz. It runs on one track at a time, after PUTTY and before COLOR. Opening the page puts it on the track you're on, and ENV goes back to COLOR. Each band is two resonators:

  • one the sound passes through;
  • one that rings with a decay of its own, excited by pings, dust and droplets.
ViewKnobs
BANKPROFILE (LIQ MEM, GLASS, THROAT, DUST, RADIO, DROPS), WIDTH, RESO (decay), MIX
BANDBAND (or pads 1–8), GAIN (dB, 0 is off), FREQ (±1 octave), DECAY
VOCODEMODSRC, ATTACK, RELEAS, DEPTH
PINGTRIG, QUANT (OFF, 1/32 … 1/4), HARD, DENS (dust)
MOTIONLIQUID, FDBK, SHIFT (±12 semitones, all bands), SPECTR
PARTICLESCOHES, DROPS, MIGR, OSC
SETUPMODE, SENS, TRACK (0 turns RESON off)

Modes (SETUP → MODE)

ModeWhat it does
FILTERThe sound through the bank.
VOCODEEach band's level follows the modulator in that band. The track is the carrier.
PINGOnly the ringing bank, struck by bursts.
HYBRIDThe default: half of each, vocoded.

The vocoder

Set MODE to VOCODE on SETUP (HYBRID vocodes too). Then pick MODSRC on the VOCODE view:

MODSRCThe modulator
INPUTThe live input, e.g. a voice over Bluetooth or USB.
PARTNRThe other track of the pair.
OSCAn oscillator, sine → saw → pulse, set on PARTICLES.
NOISEA noise source.
SELFThe track itself.
OUTPUTRESON's own output.

For the classic voice-over-synth sound, put a sound on the track and set MODSRC to INPUT.

Pings, dust and droplets

  • TRIG picks what pings the ringing bank:
    • HIGH, FULL or LOW: a transient detector on that band of the modulator (SENS sets how easily);
    • HITS: DISSECT's hits;
    • NOTES: keys, steps and CAROM on RESON's track;
    • REC on the page pings by hand.
  • QUANT holds pings for the grid: the steps' when playing, the tempo's when stopped.
  • HARD runs from a soft burst to a sharp click.
  • DENS throws dust, specks that each ring one band. COHES gathers them around the hits.
  • DROPS plays tiny grains of the wet sound. MIGR sends them into other bands instead of out.
  • LIQUID lets tuning, decay and level drift slowly. FDBK returns the wet sound into the bank.

RESON is the heaviest thing on the FM-1. Under load the CPU guard thins it to its loudest bands.

09

COLOR (ENV) and SPACE (GLO)

COLOR

Noise, drive, crush and compression in that order, then a two-band tilt.

ViewKnobs
1DRIVE, COMP, CRUSH, TILT
2NOISE, N.DEC, N.TONE, WET
3C.MODE (BITS, REDUX, BOTH), XOVER, N.TYPE (WHITE, PINK, DUST), W.MODE

SPACE

A shared bus with a tempo-synced delay and a reverb. Each track feeds it with SEND on MIX.

ViewKnobs
1DELAY, TIME, FDBK, TONE
2REVERB, SIZE, DAMP, LONG

REC freezes SPACE; holding REC clears it.

MIX (EDIT, twice)

Every track's LEVEL, PAN, SEND, FILTER and MUTE, then MAIN, master COMP and the input MONITR.

10

DISSECT (GLO, twice)

One listener for the whole instrument. It hears its SOURCE and finds:

  • hits (set by SENS and FOCUS);
  • three bands;
  • the pitch, with its first eight partials.

Its hits can throw CAROM balls, clock the steps, burst SHARDS (TRIG HIT) and ping RESON (TRIG HITS). FOLLOW modulators can follow its bands, hits, pitch or brightness. The second view sets the track's shards as the hits drive them. REC on DISSECT opens SHARDS with TRIG HIT.

11

Modulation (LFO)

Each track has four modulator slots. PRESETS changes a slot's type:

TypeParameters
WAVERATE, AMOUNT, PHASE, OFFSET, SKEW, FOLD, CURVE, SHAPE and SYNC (free, straight, triplet, dotted)
RANDOMRATE, AMOUNT, PHASE, OFFSET, LENGTH, VARIAT, SMOOTH and SYNC
FOLLOWAn envelope follower of this track, its source, any track, the main mix or the live input
ADSRAn envelope from notes or REC

LFO opens the first modulator: RATE, AMOUNT, PHASE and OFFSET, then SELECT for SKEW, FOLD, CURVE and SHAPE, then SYNC. Each LFO press goes to the next modulator. After the fourth comes the MATRIX, a list of every route:

  • PRESETS picks a row.
  • The knobs set SOURCE (any of the sixteen modulators), DEVICE, PARAM and AMOUNT.
  • REC switches the row between bipolar and unipolar.
  • On the last row, NEW, turning any knob makes a route.

The fast way: hold LFO and turn any knob on any page. The track's modulator then moves that parameter, and the direction you turn sets the amount.

12

Perform, temp and scenes (ARP)

  • Macros: eight per project, each moving up to eight parameters on any track. Hold ARP and turn a knob to map the selected macro (hold ARP and turn PRESETS to choose it).
  • Scenes: eight per project, each a snapshot of every track's sound and the macros. ARP + a pad recalls a scene, and ARP + SAVE + a pad stores one. MORPH glides toward the TARGET scene. MIDI program change recalls them too.
  • TEMP: hold OCT− and OCT+ together, tweak anything, and it all snaps back when you let go.
  • Two hands: hold OCT− and turn a knob to move both tracks of the pair; hold OCT+ to move them apart.

13

Sequencer (SEQ)

One pattern per track. PRESETS switches between STEPS and CAROM.

STEPS

  • 16 to 64 steps. Each holds:
    • a SLICE: the playhead jumps to that sixteenth of the window, or OFF to play on;
    • a PITCH;
    • a LEN, in eighths of a step;
    • a PROB;
    • a velocity and a parameter lock.
  • PRESETS picks the step and the pads switch steps on and off.
  • REC records live, quantised to the step.

CAROM

Notes bounce around a box and play when they hit a wall. The knobs are:

  • SPEED, GRAVTY, LOSS, SPREAD;
  • QUANT (snap the hits to the grid);
  • the number of balls and WALLS;
  • JITTER and GATE.

Play notes to throw balls.

Tempo is internal (30–300 BPM, with swing) or MIDI clock.

14

Projects and sounds (SAVE)

  • PROJECT: eight slots, each holding every track's sound, the sequences, scenes and macros.
    • PRESETS picks a slot.
    • REC loads it, or saves into an empty slot.
    • SAVE + PLAY saves over.
    • Saving happens only while stopped, with a moment of silence.
  • SOUNDS (SAVE, twice): sixteen slots that belong to the FM-1, not to a project. A sound is one track's SOURCE, PUTTY and COLOR settings and its modulators. REC loads one onto the selected track.

Captures themselves aren't saved in projects: KEEP them on the reel.

15

MIDI

MIDI arrives over the MIDI jack, USB and Bluetooth MIDI alike.

  • Notes: channels 1–4 play tracks A–D.
  • Clock: CLOCK AUTO follows MIDI clock when it arrives, MIDI always does, and INT never does. Start, continue and stop run the transport.
  • MIDI learn: hold SAVE, turn a knob, then move a controller. Mappings belong to the FM-1 and pick up: the parameter doesn't move until the controller passes its value.
  • KNOB CC: CC 110–113 turn knobs 1–4 of the page on screen (switch it off in SETTINGS → PANEL).
  • Fixed CCs on a track's channel:
    • 7 level, 10 pan, 11 send, 12 filter;
    • 14–19 the hands;
    • 20–28 SHARDS;
    • 70–76 SPECTRA;
    • 80–87 COLOR;
    • 102–105 the modulators' amounts.
  • Channel 16: main, master compressor, SPACE, morph, the macros and swing.
  • Program change recalls scenes.

16

Settings (GLO, three times)

View
BLUETOOTHBT AUD and BT MIDI on or off, ROLE (central or peripheral), UNPAIR. PRESETS picks a device, and REC scans and connects.
AUDIO INInputs, meters, and the track's INPUT, GAIN and monitor (see Getting audio in).
CLOCKWhether MIDI clock is arriving and which clock is followed.
PANELBACKLIT, KNOB CC, METRO (a click on each beat), REEL (room left; REC erases it). It also shows the version, the CPU load per track and the guard's state.
MIDI LEARNThe learned mappings. REC clears one.

17

Trouble

Clicks and glitches

Clicks and glitches, even at zero volume, mean the FM-1 is out of CPU. A guard eases things in two steps when rendering takes over 90 % of the time: the reverb rests, then shards and RESON thin out. If that isn't enough, it rests the sound for about a second. GLO → SETTINGS → PANEL shows the load per track. Turn RESON off (SETUP → TRACK 0) or use fewer SPECTRA tracks.

Safe mode

"SAFE MODE" on the screen means the last three starts never ran for four seconds. Press PLAY to start Viscera anyway. Leaving it on for four seconds also clears the count, so the next power-on starts normally. Installing a new version starts the count afresh. In safe mode the sound is off and the install page still connects, so you can always reinstall. Hold OCT− + OCT+ while switching on to enter safe mode yourself.

A dark FM-1 after an install

If the FM-1 stays dark (no screen, no lights), Ravel's install page → Back to the stock firmware with a V15 file puts M-VAVE's firmware back.

Silent captures

Check GLO → SETTINGS → AUDIO IN. The meter should move, the track's INPUT should be right, and SOURCE should be CAPTURE.

Trying it without an FM-1

The browser emulator runs the same code, with an audio file, your computer's sound or a microphone as the input.