Important - Updates
If you are running the norns software prior to 200218 DO NOT run the on device SYSTEM > UPDATE from the norns menu.
You will need to update manually. See here for update info
If you have 200218 or later, the norns menu option for SYSTEM > UPDATE should work normally.
Installing from disk image
For Fates v1.8 pcb or later
Download Fates disk image (for pi3 or pi4)
For Raspberry Pi 3b+ (200218 norns 2.2.9)
img file (2.2GB)
For Raspberry Pi 4b (200218 norns 2.2.9)
img file (2.2GB)
Flash disk image to the sdcard
Use balenaEtcher - https://www.balena.io/etcher/
When etcher is finished it will unmount your SD card.
Remove the SD card and insert into your pi/fates and power it up.
Wifi
Use the norns menu to navigate to SYSTEM > WIFI and add your WiFi network manually.
Use the ADD option to choose your network and enter your password, etc.
norns wifi hotspot
Alternately you can setup the pi as a hotspot from the menu. Once you select that you need to connect to the hotspot network called norns with your computer. the password is nnnnnnnn
SSH to the pi
Open a terminal, SSH to the Pi
The default norns user is we
The default password is sleep
Thus to connect you will use ssh we@norns.local (or the IP address of the device) and enter sleep
Expand filesystem
*** this is super important ***
Open a terminal, SSH to the Pi and do
sudo raspi-config
Then go to Advanced Options and select the first option to Expand Filesystem.
Then do Finish and reboot.
If this errors and says the filesystem can't be resized, try the following from the command line:
sudo raspi-config --expand-rootfs
sudo resize2fs /dev/mmcblk0p2
Then reboot.
NOTE - Ignore the warning to reboot after the --expand-rootfs command. The resize2fs will take a minute or two to run. Wait for it.
Set your timezone, wifi-country
Open a terminal, SSH to the Pi and do
sudo raspi-config
first go to Localization Options menu item and select Change Timezone
then repeat with Change WiFi Country
Finish and reboot (if not prompted).
After these changes, 2 things may happen:
-
You get a
SUPERCOLLIDER FAILerror at the top of the screen. In this case use the norns menu to SLEEP (which shuts the pi down) and then when the led stops flashing, unplug and plug in power once more to restart. At which point you should see option 2 below. -
You see
NONElisted at the top of the screen. This is normal. Just go to SELECT > AWAKE to start the Awake script.
Update
Run SYSTEM > UPDATE on device to update to the current release
Norns documentation
https://monome.org/docs/norns/
Be sure to check out the section on the web-based editor maiden.
Maiden is extremely useful to get debug information if something is going wrong with the norns software. Its interface is arranged into a left sidebar FILE navigator and a right split editor, where the top is the EDITOR and the bottom is the REPL (read-eval-print-loop).
Norns scripts
You can find scripts/patches for norns on the lines forum
Scripts are installed at ~/dust/code The easiest way to install is by using git clone from the linux command line as most of the scripts are hosted on github.
for example
cd ~/dust/code
git clone https://github.com/justmat/foulplay.git
will install the Foulplay script by @justmat
Norns extras
There are 2 extra scripts installed at in the ~/ home directory - norns-restart.sh and norns-stopall.sh. These can be used to restart all of the norns software components or stop all those processes (matron, crone/supercollider, JACK, and maiden).
These install instructions are based on the work of Tehn, Nordseele, Thetechnobear among others. Thank you!