Written from devices/monome/norns.vendor.fw-awed-82bc3fa.jsonEdit on GitHubJSON

Monome norns (script _awed): OSC control from Claude, scripts and controllers

41 named commands to drive Monome norns over OSC — from Claude (MCP), live-coding environments or a MIDI controller.

  • sourcemaker's documentation
  • firmwareawed-82bc3fa
  • real unitnot yet checked

Not checked on a real Monome norns yet. Own one? Load a sound or send a control, and tell us whether it worked.

Maker
Monome
Version
script _awed (melocoi/_awed @ 82bc3fa)
Source
maker's documentation
OSC prefix
/norns_awed
README.mdfrom the author's repository; not claimed yet, anyone can improve itEdit

From the README of melocoi/_awed at 82bc3fa, licence MIT.

_awed

a harmonic series aggregator

for norns w/grid

video performance/tutorial

and some additional videos to be found here _awed DEMO vids

here are some of the key combos that are not in the video, but may be helpful

  • K1 + Enc 2 = main buffer Record amplitude

[ indicated on screen by the bg square color ]

will effect how loud the harmonics will be recorded to the buffer.

  • K1 + Enc 3 = buffer Preserve amplitude

[ indicated on screen by the size of the circle ]

will efffect how long the decay of the delay is

  • K1 + Enc 1 = main buffer Amplitude

[ indicated on screen by the color inside the circle ]

control the overall volume of the recorded buffers

the following allows for quick controls over the buffer length, ( performed in video around 8:06 )

  • K2 = set Loop start

  • K3 = set Loop end

  • K2 (long press > 1 sec) = clears loop length and restores default length set in params menu

  • K3 (long press > 1 sec) = clear loop contents, total erasure

for quick reference here are some controls mentioned in the video

  • Enc 1 = buffer playback rate

[ indicated on screen by the size of the bg square ]

the rate is quantized to the scale selected for the synth, set in the params menu. Can also adjust the rate slew.

  • Enc 2 = synth filter Q factor

[ indicated on screen by thickness of randomly drawn lines ]

defaults to max value (highets Q factor) turn CW to reduce Q factor

  • Enc 3 = softcut filter cutoff frequency of main buffer

[ indicated on screen by the thickness of the circles border ]

This filter is quantized to the scale selected for the synth, set in the params menu. This means you will get stepped filter sweeps. Which is an effect I enjoy.

Here is a map of the grid layout

Now some info on the different parts of the script...

The script comprises 2 major sections. the Synth and the Tape loop.

.................................................................................

.................................................................................

.................................................................................

the Synth

The synth engine is based on a band pass filtered saw wave.

There are two modes available. Percussion mode and Long Tone mode. Selected by the PERC/LONG TOGGLE (displayed above).

Control of the synth is available by using the grid sections ENVELOPE GRID, HARMONICS, and ROOT NOTE (displayed above). As well as a filter resonance control using Enc 2.

The premises of this synth and the way to make sounds and pitches is intimately related to the harmonic series. An understanding of which, while not required, can open up some of the possibilities and limitations that are present in this interface. The most basic thing to understand is how a harmonic is a multiple of a root pitch.

Read the whole README on GitHub

Use it

Start the bridge with this driver; it forwards named OSC commands to the software:

osc-bridge run --device devices/monome/norns.vendor.fw-awed-82bc3fa.json

Then send OSC to 127.0.0.1:7777, for example:

osc-bridge osc-send /norns_awed/param/{id}

From Claude or any MCP client, the osc-bridge mcp server exposes this driver as norns_awed: ask “what can the Monome norns do?” and it reads this map with list_routes. See the MCP guide.

MIDI controls

41 controls, each with its number, its range and the name to send

OSC commands

Command Arguments Name to send
Param id: string, value: float /norns_awed/param/{id}
Param {set} {id} set: string, id: string, value: float /norns_awed/param/{set}/{id}
Remote key n: int, z: int /norns_awed/remote/key
Remote enc n: int, delta: int /norns_awed/remote/enc
Remote brd code: int, z: int /norns_awed/remote/brd
Param dTune value: int /norns_awed/param/dTune
Param driftSpeed value: int /norns_awed/param/driftSpeed
Param driftSpread value: int /norns_awed/param/driftSpread
Param wrap value: int /norns_awed/param/wrap
Param deviate value: int /norns_awed/param/deviate
Param text1 value: string /norns_awed/param/text1
Param text2 value: string /norns_awed/param/text2
Param text3 value: string /norns_awed/param/text3
Param blank1 value: string /norns_awed/param/blank1
Param rootFreq value: int /norns_awed/param/rootFreq
Param root note value: int /norns_awed/param/root_note
Param text4 value: string /norns_awed/param/text4
Param blank2 value: string /norns_awed/param/blank2
Param text5 value: string /norns_awed/param/text5
Param text6 value: string /norns_awed/param/text6
Param blank3 value: string /norns_awed/param/blank3
Param temperament value: int /norns_awed/param/temperament
Param ratios value: int /norns_awed/param/ratios
Param scale value: int /norns_awed/param/scale
Param blank4 value: string /norns_awed/param/blank4
Param tapeLength value: int /norns_awed/param/tapeLength
Param lEnd value: int /norns_awed/param/lEnd
Param lStrt value: int /norns_awed/param/lStrt
Param rateSlew value: int /norns_awed/param/rateSlew
Param tapeWobble value: int /norns_awed/param/tapeWobble
Param wobRate value: int /norns_awed/param/wobRate
Param mutLvl1 value: int /norns_awed/param/mutLvl1
Param mutLvl2 value: int /norns_awed/param/mutLvl2
Param rstChnc1 value: int /norns_awed/param/rstChnc1
Param rstChnc2 value: int /norns_awed/param/rstChnc2
Param revChnc1 value: int /norns_awed/param/revChnc1
Param revChnc2 value: int /norns_awed/param/revChnc2
Param micChnc1 value: int /norns_awed/param/micChnc1
Param micChnc2 value: int /norns_awed/param/micChnc2
Param amplitude value: float /norns_awed/param/amplitude
Param time value: float /norns_awed/param/time

JSON

The same MIDI as norns.vendor.fw-2.9.4, which this firmware shares.

Limitations

Source: the Lua source of the norns script _awed by ululo (melocoi/_awed at 82bc3fa), 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 36 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.

Other versions

The Monome norns is mapped in 356 versions. per Electra preset, per Electra preset, per Electra preset, norns system OSC, v2.9.4, script 32-harmony, script 3d, script 4-big-knobs, script 4CCFader, script abacus, script acid-test, script ack, script acrostic, script amen, script amenbreak, script animator, script arcify, script arcologies, script arp_index, script ash, script ashsynth, script asterion, script automs70, script avonlea, script awake, script awake-ashsynth, script awake-passersby, script awake-rings, script b-b-b-b-beat, script bakeneko, script barcode, script barycenter, script beacon, script beets, script benjolis, script bistro, script bitebeet, script bitters, script bline, script blippoo, script blndr, script bloom, script blue, script boingg, script bounds, script bowering, script breakthrough, script buoys, script caliper, script carter's delay, script cc-canvas, script cccccccc, script changes, script cheat_codes_2, script choukanzu, script circles, script clarck, script clcks, script clipper, script clockabout, script colorwheel, script combiner, script combos, script compass, script concrete, script constellations, script corners, script cranes, script crow_talk, script cryptkeeper, script cybermidi, script cyrene, script d, script delar, script delayyyyyyyy, script delinquencer, script demoncore, script descartes, script dimension-expander, script downtown, script dreamsequence, script drift, script dronecaster, script drum_room, script duatone, script dunes, script Eastwind, script easygrain, script eels, script ekombi, script endless-stairs, script esper, script eterna, script euclidigons, script faeng, script fall, fates 2.9.3, script fiahod, script fibonacci, script fixed-filter-banking-crisis, script flora, script fm7, script folio, script footfoot, script forge, script foulplay, script foundry, script fugarc, script fugu, script gematria, script gemini, script get in the sea!, script giro, script glaciers, script glitchlets, script glitchlooper, script glut, script goldeneye, script grains, script graintopia, script granchild, script grd, script grendy, script greyhole, script grid-test, script gridofpoints, script gridofrings, script gridstep, script groovecats, script grurder, script hachi, script hands, script haven, script haze, script here-there, script hid_demo, script Hiswing, script hpns, script hs010, script icarus, script iiitoii, script impact, script ingenue, script initenere, script internorns, script interpret, script intervaltrainer, script islands, script isoseq, script jala, script jiffy, script just-play, script justharmonicon, script KoiBoi2, script kolor, script kreislauf, script kria_midi, script krill, script l_ll__l_, script lamellae, script lamination, script larc, script lemniscate, script leslie, script less-concepts, script lissadron, script loom, script lorenz, script lorenzos-drums, script loudnumbers_norns, script luck, script m18s, script magnetar, script magpie, script makebreakbeat, script mangl, script manifold, script marcovaldo, script massif, script MDPatch, script MDScaler, script meadowphysics, script metrix, script metronome, script midarto, script midi-monitor, script midi-review, script midididi, script midigrid, script midiplayer, script mlr, script mlre, script Mnmpatch, script molly_the_poly, script moln, script monitor, script monomaniac, script moonraker, script mosaic, script mouse, script mx.samples, script mx.synths, script n.kria, script nørgård, script n16o, script nameless-nightmare, script narf, script nb_drumcrow, script nb_mxsynths, script nb_plyprc, script nb_smpKit, script nc01-drone, script nc02-rs, script nc03-ds, script ndls, script nice-tapes, script nisp, script nmMelodyMagic, script nmQuadroDubber, script nmRain, script nmSmartyPants, script noize, script noizeop, script norman, script norns.online, script nornsfetch, script nydl, script o-o-o, script oblique, script oilcan, script onehanded, script ong, script oooooo, script orbital, script orca, script orgn, script orgnwrms, script ortf, script otis, script overtones, script overwintering, script p8, script paracosms, script paranibbles, script parrot, script passersby, script passthrough, script patchwork, script path-trace, script pedalboard, script phonotype, script phyllis, script pirate-radio, script pit-orchisstra, script pitfalls, script pitter-patter, script piwip, script pixels, script plasma, script plonky, script pools, script ppm_norns, script punchcard, script qfwfq, script quence, script r, script rachim, script raft, script raindrops, script randomizer_typhon, script rangl, script rebound, script reels, script repeater, script repl-looper, script ribbons, script rpls, script rpmate, script rudiments, script sam, script sampswap, script samsara, script samthree, script sath-lemon, script schicksalslied, script scholastic, script scryingstone, script seaflex, script seeker_ii, script sempra, script serialism, script shapes, script shfts, script shnthsalslied, script showers, script sidvagn, script silos, script sines, script skylines, script smash, script sonde, script spirals, script splicer, script splnkr, script stack, script step, script stjörnuíþrótt, script streams, script strides, script strum, script stwnsh, script SuperBrain, script supertonic, script sway, script sweet bees, script synthy, script takt, script tambla, script tapedeck, script taweeet, script tetra, script tetrabobo, script tetrabotis, script thebangs, script thirtythree, script thorns, script Tidbit, script timber, script time-rhythm, script timeparty, script tmi, script torii, script traffic, script triangles, script tulpamancer, script tuner, script tunnels, script turntable, script tviburar, script twine, script twins, script u, script ufo, script uhf, script vcr, script vinker, script warmreload, script waver, script window-crowparator, script wobblewobble, script wrms, script xD1, script Ygg, script yggdrasil, script zellen, script zxcvbn.

Frequently asked questions

Can an AI agent like Claude control the Monome norns?

Yes: SynthHub's hosted MCP server knows the Monome norns's MIDI map, and its browser relay lets the agent send it parameter changes or load a sound, each sound change confirmed by you.