Orac, Sidekick, Pure Data and SC for Norns

Orac, Sidekick and Pure Data for Norns

These are 3 related projects :

  • Orac - Pure Data based Modular Sync
  • Sidekick - a utility to allow for application switching on Norns, allows OSC interaction with hardware
  • NuiLite - a C++ and Pure Data (external) for developing standalone apps.

Note: this works alongside happily alongside the Norns applications


I created a small wiki for all documentation, latest tips, instructions and troubleshooting
Orac, Sidekick, Pure Data and SC for Norns

(if anyone would like to contribute edit it, that would be cool, just sent me a DM for instructions)


Release 0.2.0

Change Log

0.2.0-2 - small bug fix release, mainly around osc messages
0.2.0-1 - OSC support, Supercollider support, patch sub-directories, details see this post


  • DIY Norns e.g FATES
  • Monome Norns
  • Monome DIY Norns Shield

note: currently Monome DIY Norns Shield requires a small workaround, see wiki for details


Installing orac/sidekick/pure data for the first time:
a) network connection
ensure your norns is connected to your local network via wifi, and that it has connection to the internet.

b) log in to Norns

ssh we@norns.local (password: sleep) 

c) run the installer
copy n’ paste the following command to your norns, and press enter

sudo curl https://thetechnobear.github.io/apt-norns/install.sh | sh

Thats it your done, subsequent updates can be done directly from Sidekick (see below).

note: if you installed orac/sidekick using the old method of copying files to the norns, you should use this ‘first time install’ procedure too.

Updates to Orac/Sidekick

when you would like to update Orac and Sidekick, you can do this directly from Sidekick

  • network connection
    ensure your norns is connected to your local network via wifi, and that it has connection to the internet.
  • in Sidekick, select ‘Check for updates’ from the menu
    this will then automatically update whatever components are needed to be updated.

note: this will currently (known issue) delete ~/sidekick, so backup patches beforehand

Using Sidekick

Using Sidekick

Sidekick runs quietly in the background, until you ‘activate’ it

to activate sidekick , press all 3 buttons at the same time for 5 seconds

(note: activating sidekick will quit the current active application)

after this a list of applications and ‘actions’ for sidekick will appear,

use ENC 1 to select, and button 1 to select the action/application.

additional notes:

  • you may add new applications to launch in ~/sidekick/system, and pure data patches in ~/sidekick/patches
  • when the norns first boots up, sidekick will start the last application that you used (or norns when first run), however if you hold down BUT 1, this will prevent this, and instead bring up the menu.
  • sidekick has a preference file where a defaults can be altered (e.g time to activate)
Using Orac

Using Orac

for an overview of Orac, I recommend watching loopops excellent introduction to orac2

whilst this is shown on the Organelle, its basically the same on Norns,
except we need to use the following ‘controls’

Main control

But 1 = bring up menu
But 3 + enc 2 = switch module
But 3 + enc 3 = switch page
(But 2 will become Aux in future release!)

on 4 encode norns - enc 1to enc 4, change values on page.
on 3 encode norns - enc 2 selects parameter, enc 3 changes values.

Menu control

once menu is brought up.
Enc 1 = scroll menu items
But 1 = exit menu
But 2 = back
But 3 = enter/ok

note: module selection
modules are categories into groups,
when you enter the menu, it initially has the current module selected,
if you want a different type of module, scroll to top to ‘…’ and select, to traverse hierarchy.

(previous information on this page has been moved to the wiki, see link above)


wait… what?! :open_mouth:

Here we go!


Wow, that was fast :slight_smile:

LOL, good timing, I just sat down to play with the Fates and saw your message.


Well done! 20 char of :grinning:

1 Like

Holly sh… , Mark you’re a genius!!

1 Like

are there any written instructions or an installation guide/faq?

So… Is it easy to port organelle pd patches to norns using sidekick?


I haven’t had a chance to load up the new version, but I may write up some more detailed install instructions on my Fates github at some point.


for installation there is not really anything to it… standard Linux stuff.

copy deb files to norns, then

sudo apt-get install -y ./*.deb

that’s it. ( this is shown in the above video)

the nui pure data external, I planning on a adding a few more graphics mthods, and then updating the ‘demo’ apps - I guess that’ll then become a help file , as is standard practice for PD.

some of the orac community are now starting to work on a wiki in the orac repo (detailed above).
this is great, as all this is open source, its really cool when the community helps out, and the perspective from non-developers really improves the quality (imho)

1 Like

really depends on the patch…

the older ones, that used screenLineX , should pretty much work with copying the mother,pd that I included in the PolyPd example.

the more recent ones, use an extended graphics api , which I need to go thru and add the corresponding methods to the NuiLite/pd external.
adding new graphics methods is pretty easy… just have to find the time, or others can extend if they know a bit of C++ - and follow example of how the existing ones are implemented.

good news is, screen dimensions are the same on the organelle, so that’s not going to cause any issues.


is this possible with my very diy norns. i have used diff gpio’s for enc and buttons as my soundcard had conflicting pin usage. i have followed the youtube video but when i press all 3 enc my norns freezes. :slight_smile:

(I believe) the GPIO assignments should not matter if you have them setup in a device overlay to be knob1, keys, etc. (assuming you copied that from the norns source and norns software runs normally for you without modifications).

But… I’m not entirely sure how Mark has that laid out in code.

1 Like

Stoked! Now I can swap patches with my Organelle-equipped friends!


As @okyeron says if the overlay is the same should work.
You could try running sidekick manually on command line as described in the last part of the video ,

1 Like

@TheTechnobear all is working well w Orac demos, so fun to play with Braids polyphony using a MIDI keyboard! Only thing I’m having trouble with is no sound output using the PolyPd patch. If you have any pointers that’d be great – I don’t know pD so I’ll also start digging into that to see if I can figure it out.
UPDATE: I pressed button 3 and now have sound, yay! Oddly, the fourth knob value has decided to tie itself to the other three knobs (I didn’t add a fourth encoder to fates yet), so if I change Tune, Vibrato Rate, or Vibrato Depth the Decay time also changes. Odd. I must have clicked something in the Pd patch without meaning to.
UPDATE 2: Hmm back to original behavior where button 3 does nothing, and volume is at zero. Decay parameter doesn’t update automagically with other encoders, so that’s good.

1 Like

My Pi-3b fates just latches when I press the three buttons… anyone else get a 3b working?

I am working with a 3b+ and I’m getting crashes when I hold down the three buttons. I’m using a FATES board and for some reason Sidekick can’t be accessed. Might do a purge and try to reinstall it.

Oops - yep, I’m using 3b+ too. Wonder if that’s what’s different.