midi-shell-commands 1.0.0 → 1.1.1

package/.nvmrc

@@ -0,0 +1 @@
+22

package/README.md

@@ -46,6 +46,9 @@ The application periodically checks for new MIDI input devices and will start li
 
    chmod +x ./scripts/*.sh
 
+On macOS, a LaunchAgent will be installed on npm install that automatically runs this tool in the background watching
+`~/Documents/MidiShellCommands` at login. See Daemon mode below.
+
 ## Usage
 
 You can run the tool in a few ways:
@@ -64,7 +67,7 @@ You can run the tool in a few ways:
 
 - Or directly with Node, specifying the path to your scripts directory:
 
-  node index.js ./scripts
+  node midi-shell-commands.js ./scripts
 
 Replace `./scripts` with the path to your own directory containing executable scripts.
 
@@ -95,6 +98,21 @@ Make it executable:
 chmod +x scripts/noteon.60.sh
 ```
 
+## Daemon mode (macOS)
+
+- On macOS, when you run `npm install` for this package, it will:
+  - Create the directory `~/Documents/MidiShellCommands` if it does not exist.
+  - Install a LaunchAgent at `~/Library/LaunchAgents/com.midi-shell-commands.plist` that starts `midi-shell-commands` at login, watching
+    that directory.
+  - Attempt to load the LaunchAgent immediately so it begins running right away.
+- Logs can be found at `~/Library/Logs/midi-shell-commands.stdout.log` and `~/Library/Logs/midi-shell-commands.stderr.log`.
+- To manage the LaunchAgent manually:
+  - Reload:
+    `launchctl unload ~/Library/LaunchAgents/com.midi-shell-commands.plist && launchctl load -w ~/Library/LaunchAgents/com.midi-shell-commands.plist`
+  - Disable autostart: `launchctl unload -w ~/Library/LaunchAgents/com.midi-shell-commands.plist`
+  - Remove: delete the plist file and unload it.
+- If you run `midi-shell-commands` with no arguments, it will also default to watching `~/Documents/MidiShellCommands`.
+
 ## Notes and behavior
 
 - Only non-hidden files in the scripts directory are considered (files not starting with a dot).
@@ -118,7 +136,7 @@ chmod +x scripts/noteon.60.sh
 
 ## Development
 
-- Main entry: `index.js`
+- Main entry: `midi-shell-commands.js`
 - Dependencies: `easymidi`
 - Helpful npm scripts:
   - `npm start` — starts the watcher using `./scripts` as the scripts directory.

package/lib/postinstall.js

@@ -0,0 +1,142 @@
+#!/usr/local/bin/node
+/**
+ * Postinstall script to set up a macOS LaunchAgent which runs midi-shell-commands
+ * pointing at ~/Documents/MidiShellCommands.
+ */
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const childProcess = require('child_process');
+
+function log(msg) {
+  try {
+    // Best-effort: npm may suppress some outputs; still try.
+    console.log(`[midi-shell-commands] ${msg}`);
+  }
+  catch {}
+}
+
+(function main() {
+  const platform = process.platform;
+  if (platform !== 'darwin') {
+    log('Postinstall daemon setup skipped (not macOS).');
+    return;
+  }
+
+  const home = os.homedir();
+  const scriptsDir = path.join(home, 'Documents', 'MidiShellCommands');
+  try {
+    fs.mkdirSync(scriptsDir, { recursive: true });
+    // Add a sample README the first time, without overwriting user files.
+    const readmePath = path.join(scriptsDir, 'README.txt');
+    if (!fs.existsSync(readmePath)) {
+      fs.writeFileSync(readmePath, 'Place executable scripts here. Names should match patterns like:\nnoteon.<note>\nnoteon.<note>.<channel>\nnoteon.<note>.<channel>.<velocity>\nMake files executable (chmod +x).');
+    }
+  }
+  catch (e) {
+    log(`Failed to create scripts directory at ${scriptsDir}: ${e.message}`);
+    // Continue; LaunchAgent will still start and the app will create it on run.
+  }
+
+  // Determine bin path where npm linked the CLI
+  const npmPrefix = process.env.npm_config_prefix || '';
+  let binPath = '';
+  if (npmPrefix) {
+    // Typical global install
+    binPath = path.join(npmPrefix, 'bin', 'midi-shell-commands');
+  }
+  if (!binPath || !fs.existsSync(binPath)) {
+    // Fallback to local project binary path
+    binPath = path.join(process.cwd(), 'midi-shell-commands.js');
+  }
+
+  const launchAgentsDir = path.join(home, 'Library', 'LaunchAgents');
+  const label = 'com.midi-shell-commands';
+  const plistPath = path.join(launchAgentsDir, `${label}.plist`);
+
+  try {
+    fs.mkdirSync(launchAgentsDir, { recursive: true });
+  }
+  catch (e) {
+    log(`Failed to ensure LaunchAgents directory: ${e.message}`);
+    return;
+  }
+
+  const stdoutPath = path.join(home, 'Library', 'Logs', 'midi-shell-commands.stdout.log');
+  const stderrPath = path.join(home, 'Library', 'Logs', 'midi-shell-commands.stderr.log');
+
+  const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+  <dict>
+    <key>Label</key>
+    <string>${label}</string>
+    <key>ProgramArguments</key>
+    <array>
+      <string>${binPath}</string>
+      <string>${scriptsDir}</string>
+    </array>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <true/>
+    <key>StandardOutPath</key>
+    <string>${stdoutPath}</string>
+    <key>StandardErrorPath</key>
+    <string>${stderrPath}</string>
+    <key>EnvironmentVariables</key>
+    <key>PATH</key>
+    <string>/usr/local/bin:/usr/local/sbin:/usr/bin:/bin:/usr/sbin:/sbin</string>
+  </dict>
+</plist>`;
+
+  try {
+    fs.writeFileSync(plistPath, plist, { encoding: 'utf8' });
+    log(`Installed LaunchAgent at ${plistPath}`);
+  }
+  catch (e) {
+    log(`Failed to write LaunchAgent plist: ${e.message}`);
+    return;
+  }
+
+  // Try to (re)load the LaunchAgent so it starts now
+  try {
+    if (process.env.SUDO_UID) {
+      // Avoid trying to load as root for a user agent
+      log('Skipping launchctl load because running under sudo. You can load it later with your user session.');
+      return;
+    }
+
+    // Unload if already loaded to pick up updates
+    try {
+      childProcess.execSync(`launchctl unload ${escapePath(plistPath)}`, { stdio: 'ignore' });
+    }
+    catch {}
+
+    // Preferred modern approach: bootstrap into the current user session
+    const uid = process.getuid && process.getuid();
+    if (uid) {
+      try {
+        childProcess.execSync(`launchctl bootstrap gui/${uid} ${escapePath(plistPath)}`, { stdio: 'ignore' });
+        log('LaunchAgent bootstrapped.');
+        return;
+      }
+      catch {}
+    }
+
+    // Fallback to legacy load
+    childProcess.execSync(`launchctl load -w ${escapePath(plistPath)}`, { stdio: 'ignore' });
+    log('LaunchAgent loaded.');
+  }
+  catch (e) {
+    log(`Could not load LaunchAgent automatically: ${e.message}\nYou can load it manually with:\n  launchctl load -w ${plistPath}`);
+  }
+})();
+
+function escapePath(p) {
+  // Simple shell escaping for spaces
+  if (p.includes(' ')) {
+    return `'${p.replace(/'/g, '\'\\\'\'')}'`;
+  }
+  return p;
+}

package/{index.js → midi-shell-commands.js}

@@ -3,21 +3,57 @@ const childProcess = require('child_process');
 const easyMIDI = require('easymidi');
 const fs = require('fs');
 const path = require('path');
+const os = require('os');
 
-if (process.argv.length === 2) {
-  console.error('Please pass the path to the directory containing your scripts.');
+console.log('Midi Shell Commands starting up!');
+
+// Default to ~/Documents/MidiShellCommands if no directory is provided
+let targetDirArg = process.argv[process.argv.length - 1];
+if (process.argv.length === 2 || targetDirArg === '--daemon') {
+  targetDirArg = path.join(os.homedir(), 'Documents', 'MidiShellCommands');
+}
+console.log(`Watching ${targetDirArg}`);
+
+const watchDir = path.resolve(targetDirArg);
+
+// Ensure the directory exists
+try {
+  fs.mkdirSync(watchDir, { recursive: true });
+}
+catch (e) {
+  console.error('Failed to create or access scripts directory:', watchDir);
+  console.error(e);
   process.exit(1);
 }
 
-const watchDir = path.resolve(process.argv[process.argv.length - 1]);
-const scripts = fs.readdirSync(watchDir).filter(f => f[0] !== '.');
-const scriptsWithoutExtension = scripts.map(script => script.split('.').slice(0, -1).join('.'));
-const checkDelay = 60 * 1000 + (Math.random() * 3000) | 0;
+let scripts = [];
+let scriptsWithoutExtension = [];
 
+process.on('exit', cleanUpInputs);
+refreshScripts();
+try {
+  fs.watch(watchDir, { persistent: true }, refreshScripts);
+}
+catch (e) {
+  // Non-fatal on some platforms
+}
+
+const checkDelay = 60 * 1000 + (Math.random() * 3000) | 0;
 const watchedInputs = {};
 checkInputs();
 setInterval(checkInputs, checkDelay);
 
+function refreshScripts() {
+  try {
+    scripts = fs.readdirSync(watchDir).filter(f => f[0] !== '.');
+    scriptsWithoutExtension = scripts.map(script => script.split('.').slice(0, -1).join('.'));
+  }
+  catch (e) {
+    console.error('Failed to read scripts directory:', watchDir);
+    console.error(e);
+  }
+}
+
 function checkInputs() {
   const inputNames = easyMIDI.getInputs();
   for (const inputName of inputNames) {
@@ -36,6 +72,7 @@ function listenToInput(inputName) {
 
 function invokeScripts(msg) {
   const possibleFileNames = mapMessageToFileNames(msg);
+  console.log(possibleFileNames[0]);
   for (const possibleFileName of possibleFileNames) {
     for (let i = 0; i < scriptsWithoutExtension.length; i++) {
       if (scriptsWithoutExtension[i] === possibleFileName) {
@@ -60,8 +97,8 @@ function reportErrors(err) {
   }
 }
 
-process.on('exit', () => {
+function cleanUpInputs() {
   for (const input of Object.values(watchedInputs)) {
     input.close();
   }
-});
+}

package/package.json

@@ -1,18 +1,19 @@
 {
   "name": "midi-shell-commands",
-  "version": "1.0.0",
-  "main": "index.js",
+  "version": "1.1.1",
+  "main": "midi-shell-commands.js",
   "bin": {
-    "midi-shell-commands": "index.js"
+    "midi-shell-commands": "midi-shell-commands.js"
   },
   "scripts": {
-    "start": "node index.js ./scripts",
+    "start": "node midi-shell-commands.js ./scripts",
+    "postinstall": "node lib/postinstall.js",
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "keywords": [],
   "author": "",
   "license": "ISC",
-  "description": "",
+  "description": "Execute shell scripts on MIDI note events; supports macOS daemon mode via LaunchAgent.",
   "dependencies": {
     "easymidi": "^3.1.0"
   }