Skip to content

Latest commit

 

History

History
100 lines (64 loc) · 2.64 KB

readme-setup.md

File metadata and controls

100 lines (64 loc) · 2.64 KB

norns setup

build prerequisites

packages

sudo apt-get install libevdev-dev liblo-dev libudev-dev libcairo2-dev liblua5.3-dev libavahi-compat-libdnssd-dev libasound2-dev

sources

build and install:

https://github.com/monome/libmonome.git
https://github.com/nanomsg/nanomsg.git

or use the debian repository as follows:

curl https://keybase.io/artfwo/pgp_keys.asc | sudo apt-key add -
echo "deb https://package.monome.org/ stretch main" | sudo tee /etc/apt/sources.list.d/norns.list
sudo apt update
sudo apt install libmonome-dev libnanomsg-dev supercollider-language supercollider-server supercollider-supernova supercollider-dev

building norns

git clone https://github.com/monome/norns.git
cd norns
./waf configure
./waf

this should build all the c-based components (matron and ws-wrapper.)

the crone audio engine consists of supercollider classes. copy files to the default location for user SC extensions

pushd sc
./install.sh
popd

configure

  • add /usr/local/lib to library search paths (if libmonome is installed from sources.) the recommended way to do this is by editing /etc/ld.so.conf. (use of the LD_LIBRARY_PATH variable is deprecated, since it willl override binary-specific settings.)

launching components

1. launch crone (audio engine)

run crone.sh from the norns directory. this creates a sclang process wrapped with ws-wrapper

if the crone classes are installed correctly, you should see some lines like this in output from sclang initialization:

-------------------------------------------------
 Crone startup

 OSC rx port: 57120
 OSC tx port: 8888
--------------------------------------------------

and immediately after sclang init, you should see the server being booted and some jack/alsa related messages.

2. launch matron (lua interpreter)

with the audio engine running, run matron.sh from the norns directory. this creates a matron process wrapped with ws-wrapper

matron waits for crone to finish loading before entering the main event loop.

3. launch maiden (web UI client)

get most recent version

download to ~/maiden/ and untar

execute with ./maiden.arm -debug -site ./app/build -data ~/norns/lua/

docs addendum

if you want to generate the docs (using ldoc) first install:

sudo apt-get install luarocks liblua5.1-dev
sudo luarocks install ldoc

to generate the docs:

ldoc . in the root norns folder

To read the documentation, point the browser window with Maiden loaded to http://norns.local/doc (or use IP address if this doesn't work).