Link search Menu Expand Document

norns: help

Between this page and the search bar above, you should be able to self-solve most norns troubles that you’d run into.

If you need additional help, we’re here for you! Please send an email to help@monome.org using this format:

  • What issue did you experience?
  • What steps are necessary to reproduce the issue?
  • What additional hardware was connected to norns at the time of the issue? This includes controllers, wifi dongles, external hubs, etc.
  • Please attach any output printed in maiden when the issue occurs

If you’re unable to supply concrete steps to reliably reproduce the issue, this will reduce our efficacy. Please understand if we point you to existing resources and ask you to verify additional info.

For support with specific scripts and libraries, please visit lines and search for the script’s thread.

sections

HARDWARE

replacing parts

wifi nub

If you have lost your nub, you can purchase a new one here or email help@monome.org for a replacement (10 USD, shipping included, only US).

If you have experienced signal strength issues and wish to replace your wifi dongle completely, you may wish to purchase a high gain antenna adapter.

charger

The charger that comes with norns is GEO151UB-6020 and its power specs are 2A / 5.25V. A direct replacement can be purchased from Adafruit.

battery

Before you purchase a new battery, please consider that your norns may not be reporting battery performance accurately. To test, fully drain the battery and then charge it fully.

If performance does not improve, then a direct replacement can be purchased from Adafruit or by emailing help@monome.org for a replacement (20 USD, shipping included, only US).

encoders

If your encoders feel “jumpy”, you can verify that your encoders are in need of repair by performing this simple test:

  • navigate to the LEVELS page
  • turn a level all the way up and continue to turn the encoder
  • if the level jumps and does not remain at maximum, then you might want to replace that encoder

For in-depth testing, see this thread on lines.

We do not recommend at-home repair, as the encoders are extremely sensitive to heat and require quick, confident soldering. To arrange repair / replacement, please email help@monome.org with the following info:

  • your order number (if you purchased the unit from monome directly)
  • if you did not purchase from monome, please provide any details you have about the unit’s prior life
  • use a small screwdriver to remove the bottom plate and let us know if your board is either black or forest green

extending storage

standard norns

Many of the original standard norns came equipped with a CM3 (Compute Module 3) which has 4gb of storage. This can be replaced with a CM3+ (Compute Module 3+) for up to 32gb of storage. Just search raspberry pi cm3+ 32gb to find a retailer.

There is no soldering needed, but you will have to disassemble your norns a bit. Please follow this tutorial video:

nb. if you are unable to use the screen Terminal commands shown in the video, you can expand your filesystem following the shield steps listed in the next section

shield

Since shield’s Raspberry Pi runs off of an SD card, which can cover a wide range of capacities, the software doesn’t know how much space it’s allowed to allocate for itself.

If you notice that shield doesn’t seem to see the entire capacity of your microSD card, this is normal! You’ll just need to let shield expand its filesystem:

  • open a terminal on a computer connected to the same network as your shield
  • execute: ssh we@norns.local
    • if this doesn’t find your shield, you can also use ssh we@IP_ADDRESS_OF_SHIELD, eg. ssh we@192.168.1.100
  • password: sleep (you will not see characters while typing, this is normal), press ENTER/RETURN
  • execute: sudo raspi-config
  • navigate to Advanced and hit ENTER/RETURN
  • select expand filesystem and hit ENTER/RETURN
  • lots of activity will happen. when it’s done, power down and reboot. if you get any errors, reboot again.
  • if you SSH back into norns and execute df -h, you’ll see the newly expanded capacity

wifi troubleshooting

standard norns

If you are not actively using the WiFi nub, it’s best not to keep it plugged in. It uses a lot of power, draining both battery and system resources.

If you are consistently unable to connect your norns to WiFi through the connection steps outlined here, please perform the following steps:

  1. Try getting very close to your WiFi router. Bad signal can make it seem nonfunctional.

  2. Plug the WiFi nub into a non-norns computer (laptop/desktop ; MacOS/Windows/Linux) and confirm that the nub functions as expected. If your nub is defective, please email help@monome.org for a replacement.

  3. If you are prompted to update the nub’s drivers, please do so. Even if there are no updates available, sometimes the simple task of searching for an update resolves connectivity issues. When this process completes, plug the nub back into norns.

  4. If norns is still unable to connect to WiFi, connect the power cable to your non-norns computer and follow the serial steps outlined here. Once you perform this serial login, try executing nmtui for a graphical interface of the WiFi utilities, which may have better luck connecting to a network:

  5. If you are still unable to connect, please email help@monome.org with the following information:

    • Whether your nub was able to successfully connect with a non-norns computer
    • Screenshots of the terminal screens in step 4
    • The name of your WiFi network
    • The make/model of your WiFi router
    • Your router config (WPA, WEP, etc)
    • Whether your router is set up as a mesh

norns shield

For the best overall performance, for both CPU and RF interference, we highly recommend disabling WiFi when you don’t need it.

If you are consistently unable to connect your shield to WiFi through the connection steps outlined here and you are sure your password is being entered correctly, please perform the following steps:

  1. Try connecting shield to your router via ethernet and connecting to it from another computer via SSH.

  2. In Terminal, execute nmtui for a graphical interface of the WiFi utilities, which will provide more information about network connection issues:

  3. If you are still unable to connect, you might need to change your Pi’s country code. In Terminal, execute sudo raspi-config and enter Localisation Options to set your country.

  4. Beyond these steps, we recommend checking the journalctl file to see additional information about why your Pi is failing to connect. Execute journalctl --no-pager to see a full log.

If you’ve hit the end of this list without success, we recommend searching online for your specific router and confirming whether there’s any known configuration steps for your Pi model and your router. Network connectivity relies on the Pi itself, rather than the norns software stack.

norns shield boot troubleshooting

If your shield does not seem to be booting, the first thing to check is if the “startup tone” is occurring from your shield’s output. Connect headphones or a speaker to shield’s output (demarcated by the outward-facing arrow) and power it up – within 20 seconds or so, you should hear a sine-like tone which indicates the norns OS has been successfully loaded.

If you do not hear a startup tone, the norns OS is not booting. The best next step is re-flashing your SD card following these steps.

  • If you do not hear a startup tone after a successful re-flash, we recommend confirming that your Raspberry Pi is operational. The easiest way to do this is to remove the Pi from the shield, attach it to an HDMI monitor/TV, and power the Pi separately. If the Pi is operational, you’ll see a rainbow square on your monitor/TV.
    • If your Pi is operational, your shield might require repair/re-touching. See the next steps section below.
    • If your Pi is not operational, replacing the Pi should resolve the issue.
  • If you do hear a startup tone after a successful re-flash, but do not see any activity on the screen, the screen or the header might be a point of failure. See the next steps section below.

next steps

  • If you purchased a fully-built unit (no soldering) from monome, please email help@monome.org for service or replacement.
  • If you soldered the unit yourself, please post images of the board to this thread. Note that this is a community resource, so please be respectful of time and energy limitations.
  • If you purchased it from a third-party who soldered the components, please reach out to them for resolution.

grid connectivity troubleshooting

If you’ve recently received a new grid, you may find that scripts do not seem to be connecting to it.

To troubleshoot:

  • ensure your norns is up to date via SYSTEM > UPDATE (see wifi + files for more info)
  • many scripts assume that an artist only has access to one grid (versus many MIDI controllers), and automatically connect to the first slot under SYSTEM > DEVICES > GRID.
    • disconnect all grids
    • press K3 on slot 1, select none, press K3
    • press K3 on slot 2, select none, press K3
    • ..repeat for any slot that doesn’t say none
    • connect your new grid + it should populate slot 1!

audio input/output hardware specs

Codec

Standard norns has audio codec CS4270. In 2022, we revised the shield circuit to CS4271, due to global component shortage – more info here.

The codec is externally clocked with a crystal (for no jitter), and the sample rate is fixed at 48k.

Inputs

The standard norns input jacks are configured for balanced or unbalanced. Input impedance is 10k.

The shield has only one stereo input.

Outputs

The standard norns output jacks are configured for balanced or unbalanced. Output impedance is 590 ohm. Output from the codec is connected to the headphone driver as well.

The shield has only one stereo output. Revision 210330 outputs 1.75V peak-to-peak, which is roughly consumer line level.

Headphone driver

The standard norns headphone driver is a TPA6130A2. Volume is controlled via i2c with a simple protocol, so no driver is necessary. The i2c lines are connected to i2c0.

The shield does not have a separate headphone output.

norns shield noise troubleshooting

While the standard aluminum norns is a fully-isolated pro-audio device, norns shield has a necessarily different footprint and construction. As a consumer-level audio device, there are cases where the norns shield can experience interference from the underlying Pi unit, which creates noise in the audio lines.

Over the shield’s many iterations, we have worked to reduce these issues – revision 210330 improved audio isolation over the previous two releases (191106 and 200323), which 211028 (the latest model) retained.

If you experience noise on a 211028 unit, this is most likely the WIFI antenna on the Pi creating interference. To protect against this, each 211028 board was shipped with a white sticker covering the components in closest proximity to the Pi’s USB + Ethernet ports:

If you experience consistent noise, either visually represented on the in VU meter on the LEVELS screen or generally when listening to the shield’s output, disassemble the unit and check the state of this sticker.

If the sticker has been removed, or if it has worn down, or is just not effectively shielding against the strength of your Pi’s WIFI antenna, it can be replaced with a few layers of electrical tape.

Also, reassembling the unit with a little more looseness might also help – over-tightening the enclosure screws can contribute to unexpected noise + interference.

If there is still interference when WIFI is on and networking while monitoring is necessary, we recommend turning WIFI off (via SYSTEM > WIFI) and plugging directly into your router via the Pi’s Ethernet jack. This will completely bypass the Pi’s antenna and any related interference in the audio lines.

can I plug modular signals into norns directly?

NO!

norns (both standard and shield) has line-level inputs only – sending modular signals, which run very hot, through these inputs may result in damage. Please attenuate your modular signals before sending them into norns with an interface module like Intellijel’s Audio Interface.

how do I send MIDI to/from norns from/to another computer?

Since norns is a MIDI host and other computers are also MIDI hosts, norns is not able to send/receive MIDI to/from a DAW or computer directly over its USB charge port.

shield: can I use the Pi’s HDMI output to mirror the shield’s screen?

No.

The norns OS is primarily developed for/on the standard norns hardware, which makes use of a compute module which has a smaller form factor than the traditional Pi board and does not have any of the additional I/O. This allows standard units to provide pro-audio I/O, a battery, and an overall roomier layout while maintaining a small footprint.

Avoiding the additional CPU headroom required to support external video output also allows us to optimize the capabilities of norns, to provide standard norns and shield users with the same foundational software experience.

SOFTWARE

gathering system logs

In the event of an inexplicable issue, norns can dump the output of its logging mechanism to a text file. Logs capture the current and previous boots, which includes matron, SuperCollider, and operating system messages. Navigate to SYSTEM > LOG and press K3 – this will create a file at dust/data/system.log which can then be copied via maiden or downloaded via SMB or SFTP.

This information can be extremely helpful for community script authors, since it will reliably present any script-level errors, which can be difficult to capture through maiden’s REPL window.

If you have a recurring issue which you believe is hardware or system failure, unrelated to any script, please include this file with your support request to help@monome.org

recovering from freezes

If you experience a freeze that you can’t recover from, there’s a special button combination which will gently restart the software.

  • First, press and hold K3

  • While K3 is held, press and hold K2

  • While K3 and K2 are held, press and hold K1

  • Hold all three keys down for 10 seconds

The order of the keypresses matters: K3 then add K2 then add K1

If multiple attempts of this combination fail, these options are last resorts:

  • standard norns have a little white button on the rear side which provides a hard reset

  • shields do not have a reset button, so the only option is to pull power

Use the brute-force approach only if you cannot recover using the suggested method

adding + updating scripts

maiden (the web-based editor built into norns) features a project manager to help facilitate project discovery, installation, and upgrades.

To add a script that isn’t hosted on maiden, you can fetch it using maiden’s REPL

If you are updating a project through maiden’s project manager that was not originally installed via the project manager, you will receive an error that the project cannot be found in the catalog. Please delete the previously installed version and reinstall through project manager, which establishes the necessary git files for future updates.

lines also has a dedicated Library for projects tagged norns. In each project’s thread, you’ll find in-depth conversation as well as performance examples and tutorials. Projects for norns are primarily built and maintained by the lines community, so any questions/trouble with a specific project should be directed to its thread.

clear a currently-running script

Press K1 to toggle from PLAY to HOME. Highlight SELECT and hold K1 – you’ll see CLEAR in the middle of the screen. Press K3 to clear the currently running script.

error messages

DUPLICATE ENGINES

Supercollider fails to load if you have multiple copies of the same class, which are commonly contained in duplicate .sc files inside of dust (the parent folder for the projects installed on norns).

To typically solve this, connect via wifi and open maiden. Type ;restart into the maiden matron REPL at the bottom (the >> prompt).

This will restart the audio components and output their logs. If there’s a duplicate class an error message like the following will be shown:

DUPLICATE ENGINES:
/home/we/dust/code/ack/lib/Engine_Ack.sc Engine_Ack.sc
/home/we/dust/code/we/lib/Engine_Ack.sc Engine_Ack.sc
### SCRIPT ERROR: DUPLICATE ENGINES

In this example, the Engine_Ack.sc engine is duplicated in two projects: ack and we. Using maiden, you would expand each project’s lib folder to reveal the duplicated Engine_Ack.sc. After you remove one of the offending engines, execute SYSTEM > RESTART from the norns menu.

If the issue persists or maiden does not report duplicate engines, please email help@monome.org. Keep in mind that unless you’re familiar with Supercollider, do not tamper with its internal folder structure. All typical norns functionality can be handled through the maiden project manager or the dust folder.

LOAD FAIL

This simply means there is an error in the script you’re trying to load.

Connect via wifi and open maiden to see the error message when you again try to load the script.

A common problem may be a missing engine. Check the output for something like:

### SCRIPT ERROR: missing Timber

In this example, the script requires Timber, so go find it in the Project Manager and install it. If you had just recently installed Timber, you need to restart your norns through SLEEP or entering ;restart in the matron REPL.

SUPERCOLLIDER FAIL

This indicates that something is wrong with SuperCollider, which could be due to various issues. First always just try rebooting via SYSTEM > SLEEP.

If you’re able to load maiden, there are two tabs in the main REPL area (above the >> prompt at the bottom of your screen). The first tab is for matron, the control program that runs scripts – the other is sc for SuperCollider. Click into the sc tab and type ;restart into the REPL. That should show you what is going on inside of SuperCollider.

  • You might have a duplicate engine.
  • You might be missing a required engine.
  • If an update was recently applied, it may be necessary to manually re-apply it.
  • If this doesn’t help, you may need to re-flash your norns with a clean image (after backing up any of your data).
  • If this doesn’t fix it, there may be a hardware issue: e-mail help@monome.org.

FILE NOT FOUND

If a newly-renamed script throws a file not found error in maiden, it is likely because the system has not registered the name change – even though you see the new name in the UI. Perform a hard refresh on your browser (how?).

reboot via maiden

To reboot matron, the Lua layer of norns, execute ;restart in the matron tab of the maiden REPL.

To reboot SuperCollider, the synthesis layer of norns, execute ;restart in the supercollider tab of the maiden REPL.

To perform a quick reboot of the entire norns stack (for instance, when installing a script with a synth engine), reboot SuperCollider then reboot matron.

DATA MANAGEMENT

back up norns

All data that you create with norns – scripts you’ve downloaded or created, audio you’ve imported or recorded, MIDI mappings and presets, etc – is stored in a central location: dust.

via wifi

To access the dust folder from another computer on the same wifi network, follow the steps in the wifi + files: transfer docs.

To back up or restore your dust folder, follow the steps in the wifi + files: backup docs.

via usb

wifi is the most straightforward way to back up your norns. These instructions are provided for times when you are unable to connect norns to wifi (no dongle, no network, etc).

If you have a standard norns, connect it to a second computer via serial. If you have a shield, host a hotspot for it and connect it to a second computer via ssh. Then, insert a USB stick into norns.

  • Make sure the USB stick is detected with ls /media
    • you should see usb listed, in a different color
    • if you execute ls /media/usb, this should show the contents of the USB stick (if there are any)
  • Copy your dust folder with cp -r /home/we/dust /media/usb
    • if you run into a permission issue, try sudo cp -r /home/we/dust /media/usb
    • this will take time! upwards of 15 minutes.
  • Shutdown with sudo shutdown now

via sd card (shield only)

On Windows + MacOS, the norns partition on your SD card is unfortunately not accessible by simply inserting it into an SD card reader. We recommend using the wifi steps above.

For the adventurous, here are steps to surface the ext4 filesystem: Windows and MacOS.

fresh install

This process will install a clean working system.

WARNING: the disk will be completely erased. Be sure to first back up any data you have in dust.

Full images are not built for every release, so do not worry if the ‘latest’ full image is not the same as the current update – you will update from SYSTEM > UPDATE as part of the last step.

standard norns

The easiest method to flash the disk image is using either etcher or the official Raspberry Pi Imager. They are available for Linux, MacOS, and Windows. If etcher or the Imager do not work for you, or if you prefer the command line, see this guide.

For a visual guide to the Imager, see this video from the Raspberry Pi Foundation.

If you’d like a visual companion to the etcher process, steps 2 and onward are also demonstrated in this video from monome.

Steps:

  1. Install etcher or the Imager. Download the norns disk image: get the standard image. It’ll download as a .tgz file – extract it onto your computer so you have a remaining .img file.
  2. Power norns down and remove the four bottom screws of the unit.
  3. To help simplify the process, please disconnect any other storage devices connected to your computer. Then, plug norns into your computer using its charge cable.
  4. You’ll see a switch through a notch in the norns circuit board. It’s currently on run – switch it to disk. The LED on the back of norns will turn white and remain on until the 6th step.
    • Be aware of the white reset button at the bottom of the unit when you place norns back down – if it keeps getting triggered, try placing the unit upright on its bottom edge.
  5. Run etcher / Imager. If using etcher, you can simply drag the disk image onto the + sign – if using Imager, click Choose OS and Use custom, then navigate to the disk image file. In etcher, select the Compute Module as the target – in Imager, choose the device mounted as /Volumes/boot. Press Flash! / Write, enter your non-norns computer’s password, and wait for it to finish + validate.
    • If you do not see the Compute Module populate, or if it doesn’t initialize properly, try starting fresh by unplugging norns from your computer and restarting your computer. As silly as it sounds, a simple restart has resolved this type of issue in our workshop.
    • If you’re using a USB adapter or hub and you do not see the Compute Module populate or it doesn’t initialize properly, try removing the USB-A connector from the adapter and re-connecting it. If you’re on a USB-C Mac, we have seen connection issues when using hubs resolved by using Apple’s official USB-C-to-A adapter.
    • Try swapping the cable for a different one.
    • If you’re at this point and running MacOS with homebrew installed, try installing rpiboot using these command line instructions.
    • If you’re installing for the first time onto a fresh CM3+ using Windows, you’ll likely need to install the Raspberry Pi boot drivers and run rpiboot before you can image it. Follow these instructions on the Raspberry Pi site to make the new CM3+ show up as a USB mass storage device.
  6. Once the flash and validation are complete, disconnect USB. Flip the switch on the norns board back to run. Secure the bottom back onto the unit.
  7. Boot norns (if you completed the expansion, it will take a bit longer to start than normal), add your network and update via SYSTEM > UPDATE
    • If you perform SYSTEM > UPDATE and norns tells you it’s up to date., it is! We recommend this step for times when a disk image might not be compiled for an incremental update cycle.
  8. If you have a norns with a 32gb CM3+, you will need to expand the file storage, since the fresh install assumes the lowest capacity (4gb). This only needs to be done once, but it’s important after a fresh install – it lets the system know the capacity of your storage.
    • Connect via SSH through a terminal.
    • Execute sudo raspi-config and enter sleep as the password (if prompted).
    • Navigate down to Advanced Options.
    • Select Expand Filesystem and select OK.
    • Navigate to Finish and if prompted to restart, select OK. Please note that this will power norns down fully, rather than restart it. That’s okay! If you were not presented with an option to restart, simply put norns to sleep after the expansion completes.
    • Please note: norns will take a few minutes to fully boot after the filesystem expansion
    • You can verify the expansion has taken place by pressing K2 on the SELECT / SYSTEM / SLEEP screen – disk should show around 26000M (26 gb).
  9. Consider changing the default password and address

shield

Use etcher or the official Raspberry Pi Imager to flash your SD card, using these shield-specific instructions. Be sure to use a high quality SD card – if you have any trouble, please try a different card.

If etcher or the Imager do not work for you, or if you prefer to use the command line, see this guide.

After flashing your SD card, you’ll need to expand the filesystem:

  1. Open a terminal on a computer connected to the same network as your shield
  2. Execute: ssh we@norns.local
    Password: sleep
    • if you cannot connect to we@norns.local, try replacing norns.local with your shield’s IP address, discoverable by hitting K2 on the SELECT / SYSTEM / SLEEP screen
  3. Execute: sudo raspi-config
  4. Navigate to Advanced Options and hit RETURN
  5. Select Expand Filesystem and hit RETURN
  6. Lots of activity will happen. When it’s done, power down and reboot. If you get any errors, reboot again.
  7. Connect norns to your network and update via SYSTEM > UPDATE
  8. Consider changing the default password and address

If you have previously connected to a shield (either by this same IP address or simply norns.local) in the past, you may see a warning that the ‘remote host identification has changed’. this is because the shield now has a new host key. The error will give you a filepath to your hosts file, but if you are on MacOS you can simply execute rm -f ~/.ssh/known_hosts in Terminal to erase the previous hosts file and start fresh.

manual / offline update

For this process, we’ll use the phrase execute to mean “type this text into your terminal and press return/enter to run it.”

  • Download and copy the latest release’s.tgz update file to a FAT-formatted USB drive
  • Take note of the .tgz file’s name, as it is important (eg. norns210706 is specific to the July 06 2021 update in YYMMDD format)
  • Insert the USB drive into norns and boot up your norns
  • If using a standard norns, connect via serial. If using a shield, connect via ssh
  • Copy file to ~/update/ by executing the following:
sudo cp /media/usb0/*.tgz ~/update/
  • Once you see the command prompt again, enter the update folder by executing:
cd ~/update
  • Remember that special filename (eg. norns210706)? We’ll need it to unpack to the update folder by executing:
tar xzvf norns210706.tgz
  • You’ll see a flurry of activity, but after a few dozen seconds you’ll get to the command prompt again. Now, we’ll go into the the update folder by executing:
cd 210706
./update.sh

nb. make sure to replace 210706 in the above with the date reflected in the file you downloaded. If you’re in doubt, simply execute ls and you’ll be shown two files: the .tgz and the folder it unpacked. We want to copy the name of the folder exactly.

You’ll see something similar to the following printed in your terminal:

[ ok ] Restarting nmbd (via systemctl): nmbd.service.
[ ok ] Restarting smbd (via systemctl): smbd.service.
CM3
'/home/we/maiden/dist/sources/base.json' -> '/home/we/dust/data/sources/base.json'
'/home/we/maiden/dist/sources/community.json' -> '/home/we/dust/data/sources/community.json'
ln: failed to create symbolic link '/home/we/bin/maiden': File exists
ln: failed to create symbolic link '/home/we/bin/maiden-repl': File exists

nb. those last two failures are benign

  • Finally, execute sudo shutdown now and norns will shut down

If performing these steps on a shield, you won’t see the standard shutdown message reminding you to wait until the non-red LED goes out – you still need to wait!

Once you restart your device, hit K2 on the SELECT / SYSTEM / SLEEP screen and you should see the update’s date listed on the right side of the screen!

change default password + address

Since all norns units come configured with the same username + password, we encourage you to personalize + protect your setup by changing the default hostname and password for the we user.

change SSH password via SYSTEM menu

In the norns SYSTEM menu, there’s a PASSWORD entry which will open up a text selector for you to enter a new password. This will be the password you use to connect to your norns via SSH – this does not change your SMB password (see below) or your hotspot password.

While you can simply reset this SSH password again via this menu option, we encourage you to set it to something memorable so you don’t worry about troubleshooting connectivity in a critical moment.

change Samba password

The smb:// remote login password does not automatically change when you perform the changes above. To set Samba’s login credentials to match the newly set user password, log in to the norns via ssh and execute:

sudo smbpasswd -a we

You’ll be prompted to set a new SMB password – we encourage setting it to match with the password you created via the SYSTEM menu.

hostname

To change the hostname for maiden access, log in to the norns via ssh and execute:

sudo raspi-config

This will lead you to the Raspberry Pi Software Configuration Tool, where you can follow these steps:

  • press ENTER on 1 System Options
  • press ENTER on S4 Hostname
  • press ENTER on <ok> and type in a new hostname for your norns device (no need to type .local
  • navigate down to Finish and press ENTER – if asked to reboot, please do
  • the unit will power down after a few seconds (if working with a standard norns, the unit will not restart but will simply shut down)

Now, you’ll be able to use your new hostname for:

  • maiden access: what once was norns.local will now be your_unique_name.local (you can also use the device’s IP address)
  • ssh alias: what was once norns.local will now be your_unique_name.local (you can also use the device’s IP address)
  • hotspot: what was once the norns network will now be your_unique_name

taking a screenshot

Capturing a screenshot of your norns can be a helpful tool for creating illustrative documentation or sharing UI ideas.

With your norns powered-on and connected to the same wifi network as your computer, connect to maiden. Then, execute this line in maiden’s REPL (replacing with something unique):

_norns.screen_export_png("/home/we/dust/<FILENAME>.png")

Use SMB or SFTP to connect to norns and download the PNGs you just created from the dust folder. You’ll notice the PNG is kinda tiny and the colors are inverted. Let’s fix that with ImageMagick.

With ImageMagick installed on your computer, download this bash script and place it in the same folder as your downloaded screenshots. In terminal, cd to the folder and execute:

./norns-convert_screenshots.bash

That will clean up all the PNGs to render how they do on the norns screen.

nb. You may need to execute chmod u+x ./norns-convert_screenshots.bash beforehand, or use sudo ./norns-convert_screenshots.bash if permission is denied.

If you wish to do this manually, execute the following (replacing <PATH+FILENAME> with the entire path to your downloaded PNG):

magick convert <PATH+FILENAME>.png -gamma 1.25 -filter point -resize 400% -gravity center -background black -extent 120% <PATH+FILENAME>.png

For example:

magick convert /Users/dndrks/Downloads/mlr.png -gamma 1.25 -filter point -resize 400% -gravity center -background black -extent 120% /Users/dndrks/Downloads/mlr.png

MORE

  • Imported audio must be 48khz, bit depth is irrelevant.

  • Line noise while usb charge + audio input are both coming from the same laptop (ground loop) can be defeated with an isolator.

  • If a connected MIDI controller is not functioning as expected, it may be due to a known limitation in scripts that do not explicitly allow for MIDI control from channels other than channel 1. Either reassign your MIDI controller to channel 1 or insert this bit of code into a script.

  • All grid editions will work with norns, but some apps may be coded for varibright levels that your hardware may not support.

  • norns does not have built-in bluetooth + the OS is not currently designed to take advantage of bluetooth.