Documentation menu
On this page

The Grid skill is a musical direction system, not a preset list. It turns a brief such as “dark, minimal, psychedelic bass at 142 BPM” into coordinated decisions about role, source, rhythm, envelope, spectrum, movement, space, and arrangement. The same vocabulary works for a single sound, an eight-bar loop, a full track, or a live performance patch.

The system is intentionally layered:

refine one axis Brief Role and thesis Groove and phrase Source and envelope Spectrum and nonlineartone Bounded modulation Space, level, andstereo Arrangement andperformance Listen in context

A style is therefore not “turn these eight knobs.” It is a set of relationships that should survive a new note, a new phrase, and a new listening context.

The deterministic song compiler implements a narrower, explicit contract than this artistic vocabulary. It compiles supported styles, numeric/tonal fields, sparse/minimal density hints and recognized exclusions into real MIDI sections and patterns; it records other artistic language as an inference boundary. See the accepted brief grammar. Synth recipes, headroom targets and modulation routes remain intentions until realized and checked in the host. Inspect actual imported clips with grid_inspect_arranger; for a linear score disable enabled loops with guarded grid_set_clip_loop, then re-inspect flags, source counts/spans and geometry. Source summaries do not expand loops or prove playback/audio. MIDI import can supply default Organ instruments: inspect the 16-sibling device window and replace unintended voices using a fresh expected_selection_token and authorization, rather than stacking instruments. Listening remains separate.

The styling model

Every brief is decomposed into three kinds of decisions.

Musical dimensions

Dimension Question Techno example
Role What job does this material perform? mono bass anchor, metallic reply, transition noise
Thesis What should the listener remember? a rigid kick with a bass phrase that answers it
Register Where should it live, and what must it leave clear? sub below the kick's attack; grit above the sub
Rhythm What repeats, where are the rests, and what changes? four-on-the-floor kick, sparse syncopated bass
Density How many events are active at once? low event count, high consequence per hit
Contrast What makes the next event meaningful? dry transient against a short filtered tail
Motion Which relationship changes, at what time scale? one filter or sideband drift every eight bars
Temperature Is the material warm, cold, abrasive, or neutral? dark upper spectrum with controlled grit
Space How much depth, width, and tail does the role need? centered low end; narrow, short metallic return
Arc How does the idea enter, develop, peak, and leave? subtract bass for one phrase, then return with one accent

Grid dimensions

The musical dimensions are expressed through Grid building blocks:

Source: sine,sawtooth, pulse, noise Control: clock,chance, S-H LFO, pitch Shape: envelope,filters, nonlineardetail Mix and safety: blend,delay, gain, VU

The diagram is a compositional vocabulary, not a claim about the current project's topology. Resolve modules, ports, instance IDs, and parameter ranges from the live Grid graph before making a graph edit. See the live inventory.

Styles are starting directions

There are two related style layers.

Parameter scaffolds

These are tonal starting points for exposed controls:

Scaffold Starting character Useful when
glass bright, open, precise, lightly animated airy percussion or clean upper layers
ember warm, body-forward, restrained movement dark bass, warm drones, textured motion
acid high contrast, narrow pulse character, assertive motion acid bass, sharp rhythm, controlled edge
hollow sparse, airy, low-density contour background beds and distant events

A scaffold is blended toward the current device state. It is not a replacement for listening and does not imply access to the internal graph.

Behavioral style profiles

These profiles describe how a patch should behave over time:

Profile Scaffold Behavioral principle
slow-air glass slow movement, defined scale, diffuse space
deep-bed hollow sustained drone, low density, background role
distant-events hollow rare events, wide space, long tails
soft-drift hollow gentle evolution, low density, soft contrast
night-motion ember textured motion, scale-aware movement, dark atmosphere
layered-motion ember layered diffusion, controlled artifacts, persistent motion
pulse-lab acid bounded variation, regenerate gesture, percussive contrast

A profile supplies a behavioral bias. It does not choose modules, cables, or a finished arrangement.

Soundscape roles

grid_soundscape_plan is a non-mutating planning tool. It names roles and suggested module families before any live edit. The planner's broad vocabularies include:

  • deep-ambient: sustained bed and slow bounded motion;
  • weather-texture: noise, separated spectral bands, sparse transients;
  • distant-events: stable bed with unrelated slow event rates;
  • harmonic-drift: defined pitch vocabulary and gradual root movement;
  • artifact-bed: nonlinear processing, bounded feedback, visible level control;
  • generative-percussion: short voices, probability, phase offsets, and short diffusion.

Use plans to decide what should exist. Use live catalogs and graph reads to decide what actually exists in this Bitwig installation.

Usability model

The system borrows the strongest interaction ideas from design-direction tools, but applies them to listening and stateful audio work.

1. Recognition over recall

Users can describe an audible goal instead of remembering module names:

“Make the bass darker but keep the kick transient clear.”

The system translates that into spectral density, source balance, filter placement, and role protection. Native names remain available for precision, but the first interface is musical language.

2. Progressive disclosure

The workflow reveals complexity only when needed:

  1. brief and role;
  2. style direction;
  3. one preview;
  4. exact parameter diff;
  5. graph topology only when graph access exists;
  6. native ranges and ports only before a mutation;
  7. performance macros after the sound works.

This prevents a blank patch from becoming a wall of implementation details.

3. Preview before commitment

The shaping tools separate exploration from mutation:

grid_shape_start grid_shape_compose user reviews diff focused refinement explicit authorization status + state read-back hear result in context grid_shape_undo discard without mutation Start Observed Draft Listening End Applied Verified Recovered

A preview must name the audible intention, affected controls, unchanged roles, and potential risk. No preview is proof that the sound is good; it is a cheap way to reject the wrong direction.

4. Small diffs reduce cognitive load

Each pass should answer one listening question:

  • more weight or more bite?
  • darker through filtering or rougher through nonlinear tone?
  • more psychedelic through sidebands or event timing?
  • more energy through density, brightness, width, or anticipation?

Changing five unrelated dimensions at once destroys causal understanding.

5. Feedback is state plus sound

Live read-back can establish observed control state:

  • selected-device state at the observation point;
  • exposed parameter values;
  • graph modules, ports, connections, and coordinates when available;
  • native parameter ranges and options when returned;
  • actual post-operation state when read back, not acceptance alone.

Only listening can prove:

  • groove;
  • emotional fit;
  • masking;
  • whether “dark” reads as dark;
  • whether “psychedelic” remains trackable;
  • whether the arrangement develops rather than loops.

The interface must say which kind of evidence it has.

6. User control and recovery

Choose the recovery that covers the actual change:

Change Recovery
shaping revision grid_shape_undo with the same session ID
exposed parameter batch named parameter snapshot
latest graph or device operation grid_project_undo
mistaken undo grid_project_redo after checking what was undone

A timeout or stale-state error is not an invitation to retry. Re-observe first.

Patch sessions freeze rather than automatically rolling back; retained before-graphs are evidence only. Song import attempts cannot be replayed after ambiguity. Host undo is global, parameter snapshots do not restore an arrangement, and no multi-step sequence has a guaranteed single undo boundary.

7. Expert efficiency without expert-only language

Semantic names such as PW, Saw %, Pitch, CUTOFF, and FEEDBACK support fast control. The musical alias explains why the control matters:

“roughen the edge” → Wavefolder DRIVE, bounded and post-filtered
“open the room”   → Blend DEPTH plus short filtered delay return
“drop the hats”   → lower high-frequency event density, not master volume

The same action can therefore be precise for an expert and intelligible to a producer who thinks in sound.

Request translation

Translate adjectives across several axes instead of treating them as presets.

User language First interpretation Protect
psychedelic bass stable sub, harmonic sidebands, slow timbral change pulse and tonal center
dark and gritty reduced bright density plus bounded nonlinear texture transient definition and headroom
minimal raw techno few voices, dry-forward transients, sparse probability kick/bass hierarchy
hypnotic fixed motif plus delayed phrase-level variation recognition
bigger greater perceived scale through arrangement and space low-end mono compatibility
tighter shorter overlap and clearer event boundaries groove and swing
warmer stronger body with fewer brittle partials bass articulation

When adjectives conflict, state the tradeoff. “Dark but forward” means less bright density with preserved transient contrast, not a dull or quiet mix.

Capability-aware usability

Live Grid/device work has two capability-dependent paths; offline song/export and Nitro evidence remain separate from both:

graph_available = true graph_available = false get_grid_capabilities get_selected_device_state Inspect graph and uselive modules / ports Use exposed controlsonly Plan → preview → applyone mutation Plan → shape preview →apply exposed values Read back and listen

graph_available: false is a positive usability feature: it prevents the agent from presenting fabricated cables or pretending that a catalog snapshot is the user's patch. The system should explain the limitation and continue with the safe exposed-control path when that is sufficient.

Finish criteria

A styled Grid result is ready for the next stage when:

  • the user can name its role and central musical idea;
  • the anchor remains clear in context;
  • the source, envelope, rhythm, spectrum, motion, and space agree;
  • variation is bounded and occurs at a meaningful time scale;
  • the result survives repetition and supports an arrangement block;
  • technical state and recovery path are documented;
  • the user has heard it and can state the next focused adjustment.

For detailed operating procedures, continue to the producer workflows, agent playbook, and Grid quickstart.

Search docs

All words must match. Enter opens the first result.

Type a tool, argument, or guard to begin.