Add a macOS/Linux installer, and manual install steps
install.ps1 could never have worked outside Windows: it reads %APPDATA% for the resource path, guards on Get-Process, and needs PowerShell installed. install.sh mirrors it exactly -- same actions, same key table, same idempotent rewrite and backup -- differing only in resource-path discovery and --real-control, which exists because modifier bit 8 means Ctrl on Windows but Command on macOS. Also document installing by hand from the action list, for anyone who would rather not run either script. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Claude Opus 5
Executable
+191
@@ -0,0 +1,191 @@
|
||||
#!/usr/bin/env bash
|
||||
#
|
||||
# MIDI Grid installer for macOS (and Linux REAPER).
|
||||
#
|
||||
# The macOS counterpart of install.ps1, and deliberately a line-for-line
|
||||
# mirror of it: same actions, same key table, same idempotent rewrite of
|
||||
# reaper-kb.ini. If you add an action, add it to *both* files.
|
||||
#
|
||||
# REAPER MUST BE CLOSED. It rewrites reaper-kb.ini on exit and will
|
||||
# discard anything written while it is running.
|
||||
#
|
||||
# Usage: ./install.sh
|
||||
# ./install.sh --uninstall
|
||||
# ./install.sh --resource-path ~/Library/Application\ Support/REAPER
|
||||
# ./install.sh --real-control # see "Modifiers on macOS" below
|
||||
#
|
||||
# Modifiers on macOS
|
||||
# ------------------
|
||||
# In reaper-kb.ini the modifier bit 8 means Ctrl on Windows but *Command*
|
||||
# on macOS; the physical Control key is bit 32. By default this script
|
||||
# keeps bit 8, so every "Ctrl+..." binding in the README is Command+... on
|
||||
# a Mac, which is what Mac users expect. Pass --real-control to bind the
|
||||
# physical Control key instead.
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
script_dir=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)
|
||||
resource_path=""
|
||||
uninstall=0
|
||||
real_control=0
|
||||
|
||||
while [ $# -gt 0 ]; do
|
||||
case "$1" in
|
||||
--uninstall) uninstall=1 ;;
|
||||
--real-control) real_control=1 ;;
|
||||
--script-dir) script_dir="$2"; shift ;;
|
||||
--resource-path) resource_path="$2"; shift ;;
|
||||
-h|--help) sed -n '2,25p' "$0"; exit 0 ;;
|
||||
*) echo "Unknown option: $1" >&2; exit 2 ;;
|
||||
esac
|
||||
shift
|
||||
done
|
||||
|
||||
if [ -z "$resource_path" ]; then
|
||||
if [ -d "$HOME/Library/Application Support/REAPER" ]; then
|
||||
resource_path="$HOME/Library/Application Support/REAPER"
|
||||
elif [ -d "$HOME/.config/REAPER" ]; then
|
||||
resource_path="$HOME/.config/REAPER"
|
||||
else
|
||||
echo "Could not find your REAPER resource folder." >&2
|
||||
echo "Find it via Options > Show REAPER resource path, then pass" >&2
|
||||
echo " --resource-path '/path/to/REAPER'" >&2
|
||||
exit 1
|
||||
fi
|
||||
fi
|
||||
|
||||
kb="$resource_path/reaper-kb.ini"
|
||||
[ -f "$kb" ] || { echo "reaper-kb.ini not found at $kb" >&2; exit 1; }
|
||||
|
||||
if pgrep -x REAPER >/dev/null 2>&1 || pgrep -x reaper >/dev/null 2>&1; then
|
||||
echo "REAPER is running. Close it completely and run this again." >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# id | section | description | script filename
|
||||
actions='
|
||||
RSmidigrid_open|0|MIDI Grid: Open selected item in grid mode|MidiGrid_OpenInGrid.lua
|
||||
RSmidigrid_daemon|0|MIDI Grid: Preview daemon (auto-started)|MidiGrid_Daemon.lua
|
||||
RSmidigrid_mode|32060|MIDI Grid: Toggle grid mode|MidiGrid_ToggleMode.lua
|
||||
RSmidigrid_left|32060|MIDI Grid: Cursor left one cell|MidiGrid_Left.lua
|
||||
RSmidigrid_right|32060|MIDI Grid: Cursor right one cell|MidiGrid_Right.lua
|
||||
RSmidigrid_up|32060|MIDI Grid: Pitch up one scale degree|MidiGrid_Up.lua
|
||||
RSmidigrid_down|32060|MIDI Grid: Pitch down one scale degree|MidiGrid_Down.lua
|
||||
RSmidigrid_cell|32060|MIDI Grid: Toggle note at cursor cell|MidiGrid_ToggleCell.lua
|
||||
RSmidigrid_hold|32060|MIDI Grid: Toggle hold mode|MidiGrid_ToggleHold.lua
|
||||
RSmidigrid_audit|32060|MIDI Grid: Repeat current cell|MidiGrid_AuditionCell.lua
|
||||
RSmidigrid_scale|32060|MIDI Grid: Set root and scale|MidiGrid_SetScale.lua
|
||||
RSmidigrid_triad|32060|MIDI Grid: Toggle diatonic triad|MidiGrid_ChordTriad.lua
|
||||
RSmidigrid_seventh|32060|MIDI Grid: Toggle diatonic seventh chord|MidiGrid_ChordSeventh.lua
|
||||
RSmidigrid_velup|32060|MIDI Grid: Velocity up|MidiGrid_VelUp.lua
|
||||
RSmidigrid_veldn|32060|MIDI Grid: Velocity down|MidiGrid_VelDown.lua
|
||||
RSmidigrid_longer|32060|MIDI Grid: Lengthen note one cell|MidiGrid_Lengthen.lua
|
||||
RSmidigrid_shorter|32060|MIDI Grid: Shorten note one cell|MidiGrid_Shorten.lua
|
||||
RSmidigrid_join|32060|MIDI Grid: Join run of repeated notes|MidiGrid_Join.lua
|
||||
RSmidigrid_shl|32060|MIDI Grid: Shift all notes one cell left|MidiGrid_ShiftLeft.lua
|
||||
RSmidigrid_shr|32060|MIDI Grid: Shift all notes one cell right|MidiGrid_ShiftRight.lua
|
||||
RSmidigrid_shlf|32060|MIDI Grid: Shift all notes left (force)|MidiGrid_ShiftLeftForce.lua
|
||||
RSmidigrid_shrf|32060|MIDI Grid: Shift all notes right (force)|MidiGrid_ShiftRightForce.lua
|
||||
RSmidigrid_playbar|32060|MIDI Grid: Play from start of current bar|MidiGrid_PlayFromBar.lua
|
||||
RSmidigrid_playone|32060|MIDI Grid: Play current bar only|MidiGrid_PlayBarOnly.lua
|
||||
RSmidigrid_loopbar|32060|MIDI Grid: Loop current bar|MidiGrid_LoopBar.lua
|
||||
'
|
||||
|
||||
# flags | keycode | section | id
|
||||
# flags: 1 base, +4 Shift, +8 Ctrl (Command on macOS), +16 Alt
|
||||
# section: 0 = Main, 32060 = MIDI Editor
|
||||
keys='
|
||||
21|71|0|RSmidigrid_open
|
||||
17|71|32060|RSmidigrid_mode
|
||||
1|32805|32060|RSmidigrid_left
|
||||
1|32807|32060|RSmidigrid_right
|
||||
1|32806|32060|RSmidigrid_up
|
||||
1|32808|32060|RSmidigrid_down
|
||||
1|13|32060|RSmidigrid_cell
|
||||
17|72|32060|RSmidigrid_hold
|
||||
17|65|32060|RSmidigrid_audit
|
||||
17|83|32060|RSmidigrid_scale
|
||||
17|51|32060|RSmidigrid_triad
|
||||
17|55|32060|RSmidigrid_seventh
|
||||
21|32806|32060|RSmidigrid_velup
|
||||
21|32808|32060|RSmidigrid_veldn
|
||||
1|76|32060|RSmidigrid_longer
|
||||
5|76|32060|RSmidigrid_shorter
|
||||
17|74|32060|RSmidigrid_join
|
||||
13|32805|32060|RSmidigrid_shl
|
||||
13|32807|32060|RSmidigrid_shr
|
||||
29|32805|32060|RSmidigrid_shlf
|
||||
29|32807|32060|RSmidigrid_shrf
|
||||
17|32|32060|RSmidigrid_playbar
|
||||
25|32|32060|RSmidigrid_playone
|
||||
29|32|32060|RSmidigrid_loopbar
|
||||
'
|
||||
|
||||
backup="$kb.midigrid-backup"
|
||||
if [ ! -f "$backup" ]; then
|
||||
cp "$kb" "$backup"
|
||||
echo "Backed up original to $backup"
|
||||
fi
|
||||
|
||||
tmp=$(mktemp)
|
||||
trap 'rm -f "$tmp" "$tmp.2"' EXIT
|
||||
|
||||
# Drop any previous MIDI Grid lines so re-running is idempotent.
|
||||
grep -v -i 'RSmidigrid' "$kb" > "$tmp" || true
|
||||
|
||||
if [ "$uninstall" -eq 1 ]; then
|
||||
cat "$tmp" > "$kb"
|
||||
echo "Removed MIDI Grid actions and bindings."
|
||||
echo "Note: keys it had taken over (arrows, Enter) are now unbound in the"
|
||||
echo "MIDI editor. Rebind them, or restore $backup."
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# SCR lines go at the top, in table order.
|
||||
: > "$tmp.2"
|
||||
while IFS='|' read -r id section desc file; do
|
||||
[ -n "${id:-}" ] || continue
|
||||
path="$script_dir/$file"
|
||||
[ -f "$path" ] || { echo "Missing script: $path" >&2; exit 1; }
|
||||
printf 'SCR 4 %s %s "%s" %s\n' "$section" "$id" "$desc" "$path" >> "$tmp.2"
|
||||
done <<EOF
|
||||
$actions
|
||||
EOF
|
||||
cat "$tmp" >> "$tmp.2"
|
||||
mv "$tmp.2" "$tmp"
|
||||
|
||||
# KEY lines reference the *named command*, which is the SCR id with a
|
||||
# leading underscore. Without it REAPER cannot resolve the binding and the
|
||||
# key silently does nothing.
|
||||
n_keys=0
|
||||
while IFS='|' read -r flags code section id; do
|
||||
[ -n "${flags:-}" ] || continue
|
||||
if [ "$real_control" -eq 1 ] && [ $(( flags & 8 )) -ne 0 ]; then
|
||||
flags=$(( flags - 8 + 32 ))
|
||||
fi
|
||||
# Replace an existing binding for the same key+section, else append.
|
||||
awk -v flags="$flags" -v code="$code" -v section="$section" -v id="$id" '
|
||||
BEGIN { pat = "^KEY " flags " " code " [^ ]+ " section "([ \t]|$)"
|
||||
new = "KEY " flags " " code " _" id " " section
|
||||
done = 0 }
|
||||
!done && $0 ~ pat { print new; done = 1; next }
|
||||
{ print }
|
||||
END { if (!done) print new }
|
||||
' "$tmp" > "$tmp.2"
|
||||
mv "$tmp.2" "$tmp"
|
||||
n_keys=$(( n_keys + 1 ))
|
||||
done <<EOF
|
||||
$keys
|
||||
EOF
|
||||
|
||||
cat "$tmp" > "$kb"
|
||||
|
||||
n_actions=$(printf '%s' "$actions" | grep -c 'RSmidigrid')
|
||||
echo "Installed $n_actions actions and $n_keys key bindings."
|
||||
if [ "$real_control" -eq 1 ]; then
|
||||
echo "Ctrl bindings use the physical Control key."
|
||||
else
|
||||
echo "On macOS the README's Ctrl+... bindings are Command+... here"
|
||||
echo "(re-run with --real-control to use the Control key instead)."
|
||||
fi
|
||||
echo "Start REAPER, select a MIDI item, and press Alt+Shift+G (Option+Shift+G)."
|
||||
Reference in New Issue
Block a user