{
 "_sources": [
  {
   "type": "vendor-doc",
   "name": "norns script pitfalls",
   "url": "https://github.com/robmckinnon/pitfalls/tree/c5e4074ea91e800806320b8e5db4e9ba040a8ee7",
   "notes": "norns script pitfalls: lib/parameters.lua @ c5e4074. Licence GPL-3.0. Listed in norns.community (monome/norns-community community.json @ 41d05e7).",
   "firmware": "pitfalls-c5e4074",
   "imported_at": "2026-10-26"
  }
 ],
 "_limitations": "Source: the Lua source of the norns script pitfalls by delineator (robmckinnon/pitfalls at c5e4074), listed in norns.community. Shares the norns system OSC of monome/norns.vendor.fw-2.9.4 (port 10111, /param, /remote): give the norns' IP address as host override. Its own routes are the 18 parameter(s) whose id is written out in its source, read without running it, with range, options and default when written out too; set them while the script runs on the norns. 2 parameter call(s) could not be read without running the script (ids built at run time, values from variables) and are not mapped: reach them with the base driver's /param/{id}. Parameters added by libraries or engines outside the repository are not mapped either. A value goes in the parameter's units (an option's index from 1). MIDI is not mapped: the script's MIDI handling is its own and parameter MIDI mappings are learned by each user (PMAP). Untested on hardware.",
 "_coverage": {
  "host_software": "norns script pitfalls",
  "commands": 18,
  "subscriptions": 0,
  "replies": 0
 },
 "midi_of": "monome/norns.vendor.fw-2.9.4",
 "device": {
  "name": "norns",
  "vendor": "Monome",
  "revision": "script pitfalls (robmckinnon/pitfalls @ c5e4074)",
  "osc_prefix": "/norns_pitfalls"
 },
 "commands": [
  {
   "osc": "/param/pitfalls_sequence",
   "section": "PITFALLS",
   "args": [
    {
     "name": "value",
     "type": "string"
    }
   ],
   "forward": {
    "path": "/param/pitfalls_sequence",
    "args": [
     "{value}"
    ]
   },
   "_notes": "sequence: text."
  },
  {
   "osc": "/param/pitfalls_L",
   "section": "PITFALLS",
   "args": [
    {
     "name": "value",
     "type": "float"
    }
   ],
   "forward": {
    "path": "/param/pitfalls_L",
    "args": [
     "{value}"
    ]
   },
   "_notes": "L."
  },
  {
   "osc": "/param/pitfalls_M",
   "section": "PITFALLS",
   "args": [
    {
     "name": "value",
     "type": "float"
    }
   ],
   "forward": {
    "path": "/param/pitfalls_M",
    "args": [
     "{value}"
    ]
   },
   "_notes": "M."
  },
  {
   "osc": "/param/pitfalls_s",
   "section": "PITFALLS",
   "args": [
    {
     "name": "value",
     "type": "float"
    }
   ],
   "forward": {
    "path": "/param/pitfalls_s",
    "args": [
     "{value}"
    ]
   },
   "_notes": "s."
  },
  {
   "osc": "/param/pitfalls_tuning",
   "section": "PITFALLS",
   "args": [
    {
     "name": "value",
     "type": "int",
     "range": [
      400,
      480
     ],
     "default": 440
    }
   ],
   "forward": {
    "path": "/param/pitfalls_tuning",
    "args": [
     "{value}"
    ]
   },
   "_notes": "tuning."
  },
  {
   "osc": "/param/pitfalls_tonic",
   "section": "PITFALLS",
   "args": [
    {
     "name": "value",
     "type": "float"
    }
   ],
   "forward": {
    "path": "/param/pitfalls_tonic",
    "args": [
     "{value}"
    ]
   },
   "_notes": "tonic."
  },
  {
   "osc": "/param/pitfalls_mode",
   "section": "PITFALLS",
   "args": [
    {
     "name": "value",
     "type": "float"
    }
   ],
   "forward": {
    "path": "/param/pitfalls_mode",
    "args": [
     "{value}"
    ]
   },
   "_notes": "mode."
  },
  {
   "osc": "/param/pitfalls_midi_no_start",
   "section": "PITFALLS",
   "args": [
    {
     "name": "value",
     "type": "int",
     "range": [
      60,
      71
     ],
     "default": 60
    }
   ],
   "forward": {
    "path": "/param/pitfalls_midi_no_start",
    "args": [
     "{value}"
    ]
   },
   "_notes": "midi_start."
  },
  {
   "osc": "/param/pitfalls_cutoff",
   "section": "PITFALLS",
   "args": [
    {
     "name": "value",
     "type": "float",
     "default": 555
    }
   ],
   "forward": {
    "path": "/param/pitfalls_cutoff",
    "args": [
     "{value}"
    ]
   },
   "_notes": "cutoff: 50 to 5000 hz."
  },
  {
   "osc": "/param/pitfalls_octave",
   "section": "PITFALLS",
   "args": [
    {
     "name": "value",
     "type": "int",
     "range": [
      0,
      8
     ],
     "default": 3
    }
   ],
   "forward": {
    "path": "/param/pitfalls_octave",
    "args": [
     "{value}"
    ]
   },
   "_notes": "octave."
  },
  {
   "osc": "/param/pitfalls_grid_lib",
   "section": "PITFALLS",
   "args": [
    {
     "name": "value",
     "type": "int",
     "range": [
      1,
      4
     ],
     "values": {
      "grid": 1,
      "midigrid/lib/mg_128": 2,
      "midigrid/lib/midigrid": 3,
      "midigrid/lib/mg_256": 4
     },
     "default": 3
    }
   ],
   "forward": {
    "path": "/param/pitfalls_grid_lib",
    "args": [
     "{value}"
    ]
   },
   "_notes": "grid_lib: option index, from 1."
  },
  {
   "osc": "/param/pitfalls_arpeggiate",
   "section": "PITFALLS",
   "args": [
    {
     "name": "value",
     "type": "int",
     "range": [
      1,
      5
     ],
     "values": {
      "off": 1,
      "scale_up": 2,
      "scale_down": 3,
      "chord": 4,
      "chords": 5
     },
     "default": 1
    }
   ],
   "forward": {
    "path": "/param/pitfalls_arpeggiate",
    "args": [
     "{value}"
    ]
   },
   "_notes": "arpeggiate: option index, from 1."
  },
  {
   "osc": "/param/pitfalls_engine",
   "section": "PITFALLS",
   "args": [
    {
     "name": "value",
     "type": "int",
     "range": [
      1,
      4
     ],
     "values": {
      "PolyPerc": 1,
      "MollyThePoly": 2,
      "MxSamples": 3,
      "Synthy": 4
     },
     "default": 2
    }
   ],
   "forward": {
    "path": "/param/pitfalls_engine",
    "args": [
     "{value}"
    ]
   },
   "_notes": "engine: option index, from 1."
  },
  {
   "osc": "/param/pitfalls_patch",
   "section": "PITFALLS",
   "args": [
    {
     "name": "value",
     "type": "int",
     "default": 1
    }
   ],
   "forward": {
    "path": "/param/pitfalls_patch",
    "args": [
     "{value}"
    ]
   },
   "_notes": "patch: option index, from 1."
  },
  {
   "osc": "/param/pitfalls_tempo_div",
   "section": "PITFALLS",
   "args": [
    {
     "name": "value",
     "type": "float",
     "default": 8
    }
   ],
   "forward": {
    "path": "/param/pitfalls_tempo_div",
    "args": [
     "{value}"
    ]
   },
   "_notes": "tempo_div: 0.25 to 64 d."
  },
  {
   "osc": "/param/pitfalls_in_virtual_port",
   "section": "PITFALLS",
   "args": [
    {
     "name": "value",
     "type": "int",
     "range": [
      1,
      16
     ],
     "default": 1
    }
   ],
   "forward": {
    "path": "/param/pitfalls_in_virtual_port",
    "args": [
     "{value}"
    ]
   },
   "_notes": "midi in port."
  },
  {
   "osc": "/param/pitfalls_out_virtual_port",
   "section": "PITFALLS",
   "args": [
    {
     "name": "value",
     "type": "int",
     "range": [
      1,
      16
     ],
     "default": 2
    }
   ],
   "forward": {
    "path": "/param/pitfalls_out_virtual_port",
    "args": [
     "{value}"
    ]
   },
   "_notes": "midi out port."
  },
  {
   "osc": "/param/pitfalls_pitchbend_semitones",
   "section": "PITFALLS",
   "args": [
    {
     "name": "value",
     "type": "float",
     "default": 2
    }
   ],
   "forward": {
    "path": "/param/pitfalls_pitchbend_semitones",
    "args": [
     "{value}"
    ]
   },
   "_notes": "pitchbend semitones ±: 1 to 16 ±."
  }
 ]
}