OXI E16 Scene Configuration

Create and edit .oxie16 scene files for the OXI E16 MIDI controller.

File Format

Scene files are JSON with this structure:

{
  "title": "Scene Name",
  "icon": [32 bytes],
  "selectedPreset": 0,
  "code": {"code": ""},
  "pages": [12 pages]
}

Page Structure

{
  "title": "Page Name",
  "output": 0,
  "channel": 1,
  "encoders": [16 encoders]
}

• channel: Default MIDI channel for the page (1-16)
• output: MIDI output (0 = default)

Encoder Structure

{
  "name": "Display Name (8 char max)",
  "abbr": "Abbr (4 char)",
  "color": 0,
  "bipolar": false,
  "push_action": {...},
  "turn_actions": [{primary}, {secondary}]
}

Color Values

10×10 palette (0-99), indexed left-to-right, top-to-bottom:

• 0-9: Blues, 10-19: Blues/Purples, 20-29: Violets
• 30-39: Purple/Brown, 40-49: Olive/Yellow, 50-59: Reds/Orange
• 60-69: Reds/Pink, 70-79: Magentas, 80-89: Cyans/Teal, 90-99: Greens

Turn Action (MIDI Mapping)

{
  "instrument": 127,
  "parameter": 0,
  "type": 9,
  "display": 10,
  "mode": 3,
  "channel": 0,
  "lower": 0,
  "upper": 127,
  "defaultValue": 0,
  "nr1": 73,
  "nr2": 1,
  "output": 12
}

Type Values

NRPN Fields

• nr1: LSB (CC#98 value)
• nr2: MSB (CC#99 value)

Example: NRPN MSB 1, LSB 73 → nr1: 73, nr2: 1

CC Fields

• nr1: CC number (0-127)
• nr2: 0 (unused)

Other Fields

Output Values

Display Values

Push Action (Encoder Press)

Same structure as turn_action but different type values:

Creating a Scene

1. Start with the base structure (12 pages, 16 encoders each)
2. Set page titles and channels
3. Configure each encoder’s turn_actions[0] for primary mapping
4. Set turn_actions[1] type to 0 if unused
5. Save as .oxie16 file

References

• references/scene-schema.json — Full JSON Schema for validation
• references/scene-template.json — Minimal starting template

Abbreviation Best Practices

For 4-character abbreviations on the E16 display:

Oscillators: Use O1/O2 prefix (not 1/2 or A/B)

• O1Tn, O1Wv, O1Lv (Osc1 Tune, Wave, Level)
• O2Tn, O2Wv, O2Lv (Osc2 Tune, Wave, Level)

Envelopes: Use consistent F/A prefix for Filter/Amp

• FAtk, FDcy, FSus, FRel (Filter ADSR)
• AAtk, AHld, ADcy, ARel (Amp AHDR)

Effects: Clear prefixes, avoid ambiguity

• DTim, DFbk, DMix (Delay Time/Feedback/Mix)
• RDcy, RMix, RPDl (Reverb Decay/Mix/PreDelay)
• CDpt, CSpd, CMix (Chorus Depth/Speed/Mix)
• MOvr not MOD (Master Overdrive — avoids confusion with modulation)

Sends: Short and clear

• Cho, Dly, Rev (Chorus/Delay/Reverb sends)

Avoid:

• Single digit prefixes (1Tn → use O1Tn)
• Ambiguous terms (SAni → use SwMd for Swarm Mode)
• MOD for overdrive (use MOvr or OD)

Example: Elektron Digitone II

For NRPN-based synths like the Digitone II:

• Use type: 9 for all mappings
• Set page channel to the track’s MIDI channel
• Use channel: 16 in turn_action for FX parameters (if FX channel = 16)
• NRPN addresses: nr1 = LSB, nr2 = MSB

Sample page layout for Wavetone engine:

O1Tn  O1Wv  O1Pd  O1Lv
O2Tn  O2Wv  O2Pd  O2Lv
O1Ln  O2Ln  OMod  Drft
NAtk  NDcy  NLvl  NCol