librarian

mod that allows binding external hw to norns params.

for now configuration has to be done manually by editing a conf file.

configuration

hw devices need to be listed under the .device field.

each hw device takes the following fields:

field	type	mandatory	description	default value
model	string	✔️	model of the device
device	string	❌	name of the midi device us to communicate w/ the hw	ALL (sends & listen to all)
ch	int	✔️	main midi channel
params	map[string]<anything>	❌	additional configuration supported by the hw	{}

example configuration

create file /home/we/dust/data/librarian/default.inventory

return {
  devices = {
    {
      model = "nord_drum_2",
      device = 'ALL',
      ch = 10,
      params = {
        voice_channels = {1, 2, 3, 4, 5, 6},
        global_channel_notes = {60, 62, 64, 65, 67, 69},
      }
    }
  },
  version = "0.1"
}

supported devices

Arturia Keystep (arturia_keystep_32)

implem, manual (PDF)

the most basic Keystep in the range.

if connected to norns over USB, you don't hve to configure the device as "Arturia KeyStep 32" is assumed by default. otherwise (using midi ports) you'd have to precise the name of the midi device it is connected to (or when in doubt use "ALL").

Alesis Akira (alesis_akira)

WARN: very wip, untested

implem, manual (PDF)

a powerful multi effect. rack version of the Ineko, related to the ModFx series.

Eventide H3000 (eventide_h3000)

WARN: incomplete implem

implem, manual (PDF)

maybe the most ubiquitous studio multi effect.

partial support for bilateral editing (on algos that are supported).

sadly, extracting the current pgm_id from PGM DUMP isn't reliable past a given index. so, in order to work properly, this profile needs to be fed a file ~/dust/data/librarian/h3000_pgm_list.lua (dumped using h3000_pgm_scanner.lua)

param	type	mandatory	default (factory) value	comment
device_id	int	❌	0	unique H3000 midi id, set to a different value if you customized it

Meng Qi Wingie2

WARN: very wip, untested

implem, manual (PDF)

Nord Drum 2 (nord_drum_2)

implem, manual (PDF)

the Nord Drum 2 is a drum synth exposing 6 completely individual voices.

each voice can be triggered through the main midi channel (factory default 10) w/ dedicated notes (global_channel_notes) or through dedicated midi channels (voice_channels), in which case any note value can be send to play the voice melodically.

the global channel approach works better w/ percusive sequencer scripts (such as argen) & traditional dum kit presets (bank #1 & #2).

the individual voice channel approach works better w/ melodic sequencers (awake, less_concepts, washi...) & presets in bank #3.

param	type	mandatory	default (factory) value	comment
voice_channels	int[]	❌	{1, 2, 3, 4, 5, 6}	additional midi channels that can be used to play & access individual voices
global_channel_notes	int[]	❌	{60, 62, 64, 65, 67, 69}	midi notes to trig individual voices using the global midi channel

adding support to new models

see DEV_GUIDE.md