REST reference

/channel

58 addresses under /channel.All families · Refusal codes

Root

GETPATCH/channel
  • clippedwritable
  • stripswritable
Example response
{
  "clipped": [],
  "strips": [
    {
      "index": 1,
      "kind": "input"
    },
    {
      "index": 2,
      "kind": "input"
    },
    {
      "index": 3,
      "kind": "input"
    },
    {
      "index": 4,
      "kind": "input"
    },
    {
      "index": 1,
      "kind": "main"
    },
    {
      "index": 1,
      "kind": "matrix"
    },
    {
      "index": 1,
      "kind": "aux"
    },
    {
      "index": 1,
      "kind": "mix"
    },
    {
      "index": 2,
      "kind": "mix"
    },
    {
      "index": 1,
      "kind": "dca"
    }
  ]
}

Align

GETPATCH/channel/{kind}/{index}/align

e.g. /channel/input/1/align

  • delayMswritable0–100 ms, step 0.01
  • referencewritable
Example response
{
  "delayMs": 0,
  "reference": ""
}
GETon demand/channel/{kind}/{index}/align/measurement

e.g. /channel/input/1/align/measurement

  • atread-only
  • framesread-only
  • referenceread-only
Example response
{
  "at": 0,
  "frames": 0,
  "reference": ""
}

Capability

GET/channel/{kind}/{index}/capability

e.g. /channel/input/1/capability

  • featuresread-only
  • gainRangeread-only
  • knownread-only
  • writableread-only
Example response
{
  "features": [
    "fader",
    "mute",
    "solo",
    "pan",
    "gain",
    "trim",
    "polarity",
    "name",
    "meter",
    "eq",
    "gate",
    "comp",
    "inserts",
    "phantom",
    "pad",
    "sens",
    "width"
  ],
  "gainRange": {
    "maxDb": 55,
    "minDb": 0,
    "stepDb": 1
  },
  "known": [
    "fader",
    "mute",
    "solo",
    "pan",
    "trim",
    "polarity",
    "name",
    "meter",
    "eq",
    "gate",
    "comp",
    "inserts",
    "width"
  ],
  "writable": [
    "fader",
    "mute",
    "solo",
    "pan",
    "gain",
    "trim",
    "polarity",
    "name",
    "meter",
    "eq",
    "gate",
    "comp",
    "inserts",
    "phantom",
    "pad",
    "sens"
  ]
}

Chain

GET/channel/{kind}/{index}/chain

e.g. /channel/input/1/chain

  • orderread-only
Example response
{
  "order": [
    "trim",
    "insA",
    "gate",
    "eq",
    "dyn",
    "insB",
    "fader",
    "insPost"
  ]
}
GETPATCH/channel/{kind}/{index}/chain/processors/{processorId}

e.g. /channel/input/1/chain/processors/trim

  • enabledwritable
  • kindread-only
  • labelread-only
  • pluginwritable
  • sortread-only-1000000–1000000
  • tapPointread-only

    Top-Of-Ch · Post-Trim · Pre-EQ · Post-EQ · Pre-Fader · Post-Fader

Example response
{
  "enabled": true,
  "kind": "trim",
  "label": "Trim/HPF",
  "plugin": "",
  "sort": 0,
  "tapPoint": "Top-Of-Ch"
}
GET/channel/{kind}/{index}/chain/processors/{processorId}/params/{symbol}

e.g. /channel/input/1/chain/processors/1/params/1

No fields observed on the reference rig.

GET/channel/{kind}/{index}/chain/processors/{processorId}/properties/{property}

e.g. /channel/input/1/chain/processors/1/properties/1

No fields observed on the reference rig.

Clip

GETPATCH/channel/{kind}/{index}/clip

e.g. /channel/input/1/clip

  • atread-only
  • clippedwritable
  • countread-only
Example response
{
  "at": null,
  "clipped": false,
  "count": 0
}

Colour

GETPATCH/channel/{kind}/{index}/colour

e.g. /channel/input/1/colour

  • colourwritable
Example response
{
  "colour": ""
}

Delay

GETPATCH/channel/{kind}/{index}/delay

e.g. /channel/input/1/delay

  • feedbackwritable0–0.99
  • mixwritable0–1
  • onwritable
  • pingpongwritable
  • syncwritable
  • syncDivisionwritable0.0625–16
  • timeMswritable0–2000 ms, step 1
  • tonewritable0–1
Example response
{
  "feedback": 0.3,
  "mix": 0.3,
  "on": false,
  "pingpong": false,
  "sync": false,
  "syncDivision": 1,
  "timeMs": 300,
  "tone": 0.3
}

Dynamics

GETPATCH/channel/{kind}/{index}/dynamics

e.g. /channel/input/1/dynamics

  • attackMswritable0.1–100 ms, step 1
  • kindwritable

    comp · limiter

  • makeupDbwritable0–24 dB, step 0.5
  • onwritable
  • ratiowritable1–20, step 0.5
  • releaseMswritable5–3000 ms, step 10
  • thresholdDbwritable-60–0 dB, step 1
Example response
{
  "attackMs": 5,
  "kind": "comp",
  "makeupDb": 0,
  "on": false,
  "ratio": 4,
  "releaseMs": 200,
  "thresholdDb": -18
}

Eq

GETPATCH/channel/{kind}/{index}/eq

e.g. /channel/input/1/eq

  • onwritable
Example response
{
  "on": true
}
GETPATCH/channel/{kind}/{index}/eq/bands

e.g. /channel/input/1/eq/bands

  • bandswritable
Example response
{
  "bands": [
    {
      "freqHz": 120,
      "gainDb": 0,
      "id": "1",
      "name": "low",
      "on": true,
      "q": 0.7,
      "type": "lowShelf"
    },
    {
      "freqHz": 800,
      "gainDb": 0,
      "id": "2",
      "name": "lowMid",
      "on": true,
      "q": 1,
      "type": "bell"
    },
    {
      "freqHz": 3000,
      "gainDb": 0,
      "id": "3",
      "name": "midHigh",
      "on": true,
      "q": 1,
      "type": "bell"
    },
    {
      "freqHz": 10000,
      "gainDb": 0,
      "id": "4",
      "name": "high",
      "on": true,
      "q": 0.7,
      "type": "highShelf"
    }
  ]
}
GETPATCH/channel/{kind}/{index}/eq/bands/{bandId}

e.g. /channel/input/1/eq/bands/1

  • freqHzwritable20–20000 Hz, step 10
  • gainDbwritable-15–15 dB, step 0.5
  • idread-only
  • onwritable
  • qwritablerange depends on the instance
  • typewritable

    bell · lowShelf · highShelf · notch

Example response
{
  "freqHz": 120,
  "gainDb": 0,
  "id": "1",
  "on": true,
  "q": 0.7,
  "type": "lowShelf"
}
GETPATCH/channel/{kind}/{index}/eq/bands/sort

e.g. /channel/input/1/eq/bands/sort

  • paramsread-only
  • progressread-only
  • refusalread-only
  • reportread-only
  • runningwritable
  • startedAtread-only
Example response
{
  "running": false
}
GETPATCH/channel/{kind}/{index}/eq/filters/{filter}

e.g. /channel/input/1/eq/filters/hpf

  • freqHzwritablerange depends on the instance
  • onwritable
  • slopewritable
Example response
{
  "freqHz": 80,
  "on": false,
  "slope": 12
}

Fader

GETPATCH/channel/{kind}/{index}/fader

e.g. /channel/input/1/fader

  • audibleDbread-only
  • dcaScaleread-only
  • positionwritable0–1
Example response
{
  "audibleDb": 2.0000000000000018,
  "db": 2.0000000000000018,
  "dcaScale": 1,
  "position": 0.8
}

Fbs

GETPATCH/channel/{kind}/{index}/fbs

e.g. /channel/input/1/fbs

  • autoBandsread-only
  • cooldownMinuteswritable0–120 min, step 1
  • holdSecondswritable1–300 s, step 1

    never

  • maxAutoBandswritable1–24, step 1
  • mergeCentswritable0–600 cents, step 10
  • modewritable

    off · ringout · live

  • notchQwritable0.3–116, step 1
  • sensitivitywritable0–1, step 0.05
Example response
{
  "autoBands": 0,
  "cooldownMinutes": 10,
  "holdSeconds": 5,
  "maxAutoBands": 6,
  "mergeCents": 100,
  "mode": "off",
  "notchQ": 116,
  "sensitivity": 0
}
GET/channel/{kind}/{index}/fbs/candidates

e.g. /channel/input/1/fbs/candidates

No fields observed on the reference rig.

GET/channel/{kind}/{index}/fbs/lastAction

e.g. /channel/input/1/fbs/lastAction

No fields observed on the reference rig.

Gain

GET/channel/{kind}/{index}/gain

e.g. /channel/input/1/gain

  • dbread-onlyrange depends on the instance
Example response
{
  "db": 0
}

Gate

GETPATCH/channel/{kind}/{index}/gate

e.g. /channel/input/1/gate

  • attackMswritable0–500 ms, step 0.5
  • holdMswritable0–2000 ms, step 5
  • hysteresisDbwritable0–24 dB, step 0.5
  • kneeEndDbwritable-80–0 dB, step 1
  • kneeStartDbwritable-80–0 dB, step 1
  • onwritable
  • rangeDbwritable-90–0 dB, step 1
  • ratiowritable1–100, step 1
  • releaseMswritable0–5000 ms, step 10
  • thresholdDbwritable-80–0 dB, step 1
Example response
{
  "attackMs": 1,
  "holdMs": 10,
  "hysteresisDb": 3,
  "kneeEndDb": -37,
  "kneeStartDb": -43,
  "on": false,
  "rangeDb": -90,
  "ratio": 16,
  "releaseMs": 100,
  "thresholdDb": -40
}

Head amp

GETPATCH/channel/{kind}/{index}/headAmp

e.g. /channel/input/1/headAmp

  • gainDbwritablerange depends on the instance
  • gainRangeread-only
  • padwritable
  • phantomwritable
Example response
{
  "gainDb": 32,
  "gainDefaultDb": 32,
  "gainRange": {
    "maxDb": 55,
    "minDb": 0,
    "stepDb": 1
  },
  "pad": false,
  "phantom": false
}

Hrp

GETPATCH/channel/{kind}/{index}/hrp

e.g. /channel/input/1/hrp

  • amountwritable0–1
  • autoBandsread-only
  • freezewritable
  • maxAutoBandswritable1–24, step 1
  • modewritable

    off · monitor · adaptive

Example response
{
  "amount": 0.5,
  "autoBands": 0,
  "freeze": false,
  "maxAutoBands": 8,
  "mode": "off"
}
GETon demand/channel/{kind}/{index}/hrp/report

e.g. /channel/input/1/hrp/report

  • atread-only
  • voicesread-only
Example response
{
  "at": 0,
  "voices": []
}
GETPATCH/channel/{kind}/{index}/hrp/reset

e.g. /channel/input/1/hrp/reset

  • paramsread-only
  • progressread-only
  • refusalread-only
  • reportread-only
  • runningwritable
  • startedAtread-only
Example response
{
  "running": false
}

Inserts

GETPATCH/channel/{kind}/{index}/inserts

e.g. /channel/input/1/inserts

  • pluginswritable
Example response
{
  "plugins": []
}
GET/channel/{kind}/{index}/inserts/{slot}

e.g. /channel/input/1/inserts/1

No fields observed on the reference rig.

GET/channel/{kind}/{index}/inserts/{slot}/params/{symbol}

e.g. /channel/input/1/inserts/1/params/1

No fields observed on the reference rig.

GET/channel/{kind}/{index}/inserts/{slot}/properties/{property}

e.g. /channel/input/1/inserts/1/properties/1

No fields observed on the reference rig.

GET/channel/{kind}/{index}/inserts/suitability

e.g. /channel/input/1/inserts/suitability

No fields observed on the reference rig.

Instrument

GETPATCH/channel/{kind}/{index}/instrument

e.g. /channel/input/1/instrument

  • instrumentwritable

    kick-in · kick-out · snare-top · snare-bottom · hihat · tom-rack · tom-floor · overheads · congas · bongos · timbales · cajon · hand-perc · bass-di · bass-mic · upright-bass · synth-bass · egtr-amp · agtr-di · agtr-steel · egtr-clean · egtr-crunch · keys-di · piano · grand-piano · electric-piano · hammond-organ · synth-pad · synth-lead · lead-vocal-m · lead-vocal-f · backing-vocal · spoken-word · choir · brass · fiscorn · flugelhorn · trumpet · cornet · french-horn · trombone-tenor · trombone-bass · trombone-alto · trombone-valve · tuba · sax-soprano · sax-alto · sax-tenor · sax-baritone · strings · violin-section · solo-violin · viola · cello · double-bass-arco · playback-stereo · backing-tracks · click-track · talkback-band

Example response
{
  "instrument": null
}

Link

GETPATCH/channel/{kind}/{index}/link

e.g. /channel/input/1/link

  • linkedwritable
  • partnerwritable
  • roleread-only
Example response
{
  "linked": false,
  "partner": null,
  "role": null
}

Meter

GETon demand/channel/{kind}/{index}/meter

e.g. /channel/input/1/meter

  • atread-only
  • levelread-only
Example response
{
  "at": 0,
  "level": -6.023529411764713
}

Mix minus

GETPATCH/channel/{kind}/{index}/mixMinus

e.g. /channel/main/1/mixMinus

  • enabledwritable
Example response
{
  "enabled": false
}
GET/channel/{kind}/{index}/mixMinus/excluded

e.g. /channel/input/1/mixMinus/excluded

No fields observed on the reference rig.

Mute

GETPATCH/channel/{kind}/{index}/mute

e.g. /channel/input/1/mute

  • audibleMuteread-only
  • byGroupread-only
  • byPanicread-only
  • bySipread-only
  • individualwritable
Example response
{
  "audibleMute": false,
  "byGroup": false,
  "byPanic": false,
  "bySip": false,
  "individual": false
}

Name

GETPATCH/channel/{kind}/{index}/name

e.g. /channel/input/1/name

  • namewritable
Example response
{
  "name": ""
}

Pan

GETPATCH/channel/{kind}/{index}/pan

e.g. /channel/input/1/pan

  • panwritable-1–1
Example response
{
  "pan": 0
}

Polarity

GETPATCH/channel/{kind}/{index}/polarity

e.g. /channel/input/1/polarity

  • invertedwritable
Example response
{
  "inverted": false
}

Recall safe

GETPATCH/channel/{kind}/{index}/recallSafe

e.g. /channel/input/1/recallSafe

  • allwritable
  • effectiveread-only
  • scopeswritable

    fader · mute · sends · eq · dyn · inserts

Example response
{
  "all": false,
  "effective": [],
  "scopes": []
}

Record

GETPATCH/channel/{kind}/{index}/record

e.g. /channel/input/1/record

  • armedwritable
  • tapswritable

    Post-Trim · Pre-Fader · Post-Fader

Example response
{
  "armed": true,
  "taps": [
    "Post-Trim",
    "Post-Fader"
  ]
}

Reverb

GETPATCH/channel/{kind}/{index}/reverb

e.g. /channel/input/1/reverb

  • algorithmwritable

    room · plate · hall

  • dampingwritable0–1
  • highcutwritable0–20000 Hz, step 10
  • lowcutwritable0–20000 Hz, step 10
  • mixwritable0–1
  • onwritable
  • predelayMswritable0–100 ms, step 1
  • sizewritable0–1
  • widthwritable0–1
Example response
{
  "algorithm": "room",
  "damping": 0.5,
  "highcut": 20000,
  "lowcut": 0,
  "mix": 0.3,
  "on": false,
  "predelayMs": 0,
  "size": 0.7,
  "width": 1
}

Rta

GETPATCH/channel/{kind}/{index}/rta/arming

e.g. /channel/main/1/rta/arming

  • armedwritable
Example response
{
  "armed": false
}

Send

GETPATCH/channel/{kind}/{index}/send/{busKind}/{busIndex}

e.g. /channel/input/1/send/main/1

  • levelwritable0–1
  • tapwritable

    Top-Of-Ch · Post-Trim · Pre-EQ · Post-EQ · Pre-Fader · Post-Fader

Example response
{
  "level": 0.75,
  "tap": "Post-All"
}

Solo

GETPATCH/channel/{kind}/{index}/solo

e.g. /channel/input/1/solo

  • solowritable
Example response
{
  "solo": false
}

Solo safe

GETPATCH/channel/{kind}/{index}/soloSafe

e.g. /channel/input/1/soloSafe

  • safewritable
Example response
{
  "safe": false
}

Source

GETPATCH/channel/{kind}/{index}/source

e.g. /channel/input/1/source

  • modewritable

    live · track

Example response
{
  "mode": "live"
}

Speaker align

GETon demand/channel/{kind}/{index}/speakerAlign

e.g. /channel/input/1/speakerAlign

No fields observed on the reference rig.

Spectrum

GETon demand/channel/{kind}/{index}/spectrum

e.g. /channel/input/1/spectrum

  • atread-only
  • bandsread-only
  • magsread-only
  • mutedread-only
Example response
{
  "at": 0,
  "mags": [],
  "muted": false
}

Trim

GETPATCH/channel/{kind}/{index}/trim

e.g. /channel/input/1/trim

  • dbwritable-24–24 dB, step 0.1
Example response
{
  "db": 0
}

Width

GET/channel/{kind}/{index}/width

e.g. /channel/input/1/width

  • widthread-only
Example response
{
  "width": "mono"
}

Dca

GETPATCH/channel/dca/{index}/members

e.g. /channel/dca/1/members

  • memberswritable
  • parentswritable
Example response
{
  "members": [
    {
      "index": 2,
      "kind": "input"
    }
  ],
  "parents": []
}

Matrix

GETPATCH/channel/matrix/{index}/input/{srcKind}/{srcIndex}

e.g. /channel/matrix/1/input/matrix/1

  • levelwritable0–1
Example response
{
  "level": 0
}

Mute group

GETPATCH/channel/muteGroup/{index}/active

e.g. /channel/muteGroup/1/active

  • activewritable
Example response
{
  "active": false
}
GETPATCH/channel/muteGroup/{index}/members

e.g. /channel/muteGroup/1/members

  • memberswritable
Example response
{
  "members": [
    {
      "index": 2,
      "kind": "input"
    }
  ]
}
GETPATCH/channel/muteGroup/{index}/name

e.g. /channel/muteGroup/1/name

  • namewritable
Example response
{
  "name": ""
}

openmixer

A software mixing console for Linux. The desk is the software; the browser is the surface.

Pages

Licence

OpenMixer is free software under the GPL-3.0-or-later. Every package in the workspace carries the same licence.

Roland, Midas, Behringer, RME and the product names used here belong to their respective owners. OpenMixer is an independent project and is not affiliated with any of them.