scripts to send code to the matron and crone/sclang REPLs on a norns, and connect to those REPLs

installation

requirements:

• rlwrap
• websocat
• stdbuf
  • on macOS, stdbuf is available in coreutils
• my norns-lua-tools library to be installed on the target norns, see that repo for installation instructions

to install, copy matron.sh and crone.sh into your $PATH

usage

see matron.sh -h for the help output:

Usage: matron.sh: [-re] [-H hostname] [-n name] [luacode]

options:
    -H hostname: connection will go to <hostname>.local
        - ex. -H some-norns will connect to some-norns.local
        - if not specified, uses "norns.local"
    -n name: connection will go to norns-<name>.local
        - simply a shorter form of -H if your norns has a certain hostname convention,
          like "norns-something"
        - ex. -n shield will connect to to norns-shield.local
        - if used along with -H, whichever option comes last takes precedence
    -r: enter the maiden REPL after evaluating the provided lua code (either via arg or -e)
        - the REPL is automatically entered if no lua code is provided
    -e: open $EDITOR for entering the code to execute
        - if luacode is provided as an arg, $EDITOR will be populated with it
    -p: "plain" mode, don't set the terminal title or do anything else fancy/experimental that may be implemented in the future

examples:

matron.sh -r

    opens a REPL to norns.local

matron.sh -H norns-shield 'norns.script.load("code/awake/awake.lua")'

    loads the awake script on norns-shield.local

matron.sh -re -n grey

    opens $EDITOR to input code to evaluatee on norns-grey.local, and then after that code is evaluated, enter the matron REPL on that norns

crone.sh is extremely similar to matron.sh, except it connects to the supercollider system on norns instead of the lua system

known issues

• "maiden" commands (ex. ;; install) do not work via matron.sh - only actual lua code