loupedeck-commander 1.2.1 → 1.2.3

package/README.md

@@ -1,131 +1,131 @@
-# loupedeck-commander
-
-## Getting started
-
-The loupedeck-commander is helping you using your Loupedeck device more easily, and connect it with custom commands you define with script files.
-
-Features:
-
-- Reference image files for every state of your button in the touch-display fields
-- Connect commands to your state transitions
-- Tested with following LoupeDeck devices:
-  - [LoupeDeck Live](https://loupedeck.com/products/loupedeck-live/)
-  - [LoupeDeck CT](https://loupedeck.com/products/loupedeck-ct/)
-
-Runs on:
-
-- Linux (Tested with Ubuntu 22.04 and Debian 11/12 on x64 & arm32/arm64)
-- Windows (Tested with Windows 10/11 on x64)
-
-Small footprint
-
-- Raspberry PI Zero is suitable to run this
-
-Please take care about the following:
-
-- LoupeDeck devices after `version 0.2.x` use a serial interface instead of WebSocket.
-   When using this library please upgrade your firmware using the [LoupeDeck Software](https://loupedeck.com/downloads/)
-   Tested with Firmware version [`version 0.2.5`](https://support.loupedeck.com/f-a-q-support#firmware-connectivity-issues)
-
-## Basic Usage
-
-Do the following steps:
-
-```bash
-# init your new node package
-npm init
-
-# install the loupedeck-commander dependency
-npm install -s loupedeck-commander 
-```
-
-Create a new configuration file with at least one profile or copy from here,
-and replace the image references with your own icons (90x90px size):
-
-- [config.json](https://gitlab.com/keckxde/loupedeck-commander/-/blob/main/config.json)
-- [profile-1.json](https://gitlab.com/keckxde/loupedeck-commander/-/blob/main/profile-1.json)
-
-Create a `index.mjs` file to open up your loupedeck connection:
-
-```javascript
-# save as index.mjs
-import { BaseLoupeDeckHandler } from 'loupedeck-commander'
-
-const handler = new BaseLoupeDeckHandler('config.json')
-
-/**
- * Stop the handlers when a signal like SIGINT or SIGTERM arrive
- * @param {*} signal 
- */
-const stopHandler = async(signal) =>  {
-  console.log(`Receiving ${signal} => Stopping processes.`)
-  await handler.stop()
-}
-
-// Initiating the signal handlers:
-// see https://www.tutorialspoint.com/unix/unix-signals-traps.htm
-process.on('SIGINT', async (signal) => { stopHandler(signal) })
-process.on('SIGTERM', async (signal) => { stopHandler(signal) })
-
-// Start it
-await handler.start()
-
-// Take care of running background processes and stop them accordingly:
-await new Promise((resolve) => process.once("SIGINT", resolve));
-
-```
-
-Run the script using the following command:
-
-```bash
-node index.mjs
-```
-
-If you end up with errors related to canvas module - please install the dependencies as mentioned below, and run `npm install -s` again
-
-## Thanks
-
-Big thanks go out to [foxxyz](https://github.com/foxxyz/loupedeck) and his team maintaining a great javascript loopdeck module 
-
-## Hints
-
-### Cannot connect to Loupedeck device
-
-You may need to add your user to the `dialout` group to allow access to the LoupeDeck device, you could do su using the `usermod` as shown below
-
-```bash
-# ls -la /dev/ttyACM0 
-crw-rw---- 1 root dialout 166, 0 Nov 30 12:59 /dev/ttyACM0
-
-# add the current user to the dialout group:
-# sudo usermod -a -G dialout $USER
-```
-
-After modifying users group you need to logout and login again to activate this change
-
-### CANVAS Module - additional effort needed
-
-The library is using [canvas](https://www.npmjs.com/package/canvas) to load images and render graphical content on the LoupeDeck devices.
-Please follow the instructions to install the preconditions, to properly use canvas on your system.
-
-Example for Ubuntu:
-
-```bash
-# different build & graphic dev-libs are needed to use canvas module:
-sudo apt-get install build-essential libcairo2-dev libpango1.0-dev libjpeg-dev libgif-dev librsvg2-dev
-```
-
-### Resizing of images
-
-The buttons images shown on the different buttons should be prepared with specific resolutions:
-
-- Main/Center Touch-Area:        90px x 90px per Button
-- Left/Right Touch-Area:         90px x 270px per Button
-- LoupeDeck CT Knob Touch-Area:  240px x 240px Button
-
-if you already have suitable icons with the right aspect ratio, you could resize them with imagemagick/mogrify:
-
-```bash
-mkdir resized
-mogrify -resize 90x90 -quality 100 -path resized *.png
-```
+# loupedeck-commander
+
+## Getting started
+
+The loupedeck-commander is helping you using your Loupedeck device more easily, and connect it with custom commands you define with script files.
+
+Features:
+
+- Reference image files for every state of your button in the touch-display fields
+- Connect commands to your state transitions
+- Tested with following LoupeDeck devices:
+  - [LoupeDeck Live](https://loupedeck.com/products/loupedeck-live/)
+  - [LoupeDeck CT](https://loupedeck.com/products/loupedeck-ct/)
+
+Runs on:
+
+- Linux (Tested with Ubuntu 22.04 and Debian 11/12 on x64 & arm32/arm64)
+- Windows (Tested with Windows 10/11 on x64)
+
+Small footprint
+
+- Raspberry PI Zero is suitable to run this
+
+Please take care about the following:
+
+- LoupeDeck devices after `version 0.2.x` use a serial interface instead of WebSocket.
+   When using this library please upgrade your firmware using the [LoupeDeck Software](https://loupedeck.com/downloads/)
+   Tested with Firmware version [`version 0.2.5`](https://support.loupedeck.com/f-a-q-support#firmware-connectivity-issues)
+
+## Basic Usage
+
+Do the following steps:
+
+```bash
+# init your new node package
+npm init
+
+# install the loupedeck-commander dependency
+npm install -s loupedeck-commander 
+```
+
+Create a new configuration file with at least one profile or copy from here,
+and replace the image references with your own icons (90x90px size):
+
+- [config.json](https://gitlab.com/keckxde/loupedeck-commander/-/blob/main/config.json)
+- [profile-1.json](https://gitlab.com/keckxde/loupedeck-commander/-/blob/main/profile-1.json)
+
+Create a `index.mjs` file to open up your loupedeck connection:
+
+```javascript
+# save as index.mjs
+import { BaseLoupeDeckHandler } from 'loupedeck-commander'
+
+const handler = new BaseLoupeDeckHandler('config.json')
+
+/**
+ * Stop the handlers when a signal like SIGINT or SIGTERM arrive
+ * @param {*} signal 
+ */
+const stopHandler = async(signal) =>  {
+  console.log(`Receiving ${signal} => Stopping processes.`)
+  await handler.stop()
+}
+
+// Initiating the signal handlers:
+// see https://www.tutorialspoint.com/unix/unix-signals-traps.htm
+process.on('SIGINT', async (signal) => { stopHandler(signal) })
+process.on('SIGTERM', async (signal) => { stopHandler(signal) })
+
+// Start it
+await handler.start()
+
+// Take care of running background processes and stop them accordingly:
+await new Promise((resolve) => process.once("SIGINT", resolve));
+
+```
+
+Run the script using the following command:
+
+```bash
+node index.mjs
+```
+
+If you end up with errors related to canvas module - please install the dependencies as mentioned below, and run `npm install -s` again
+
+## Thanks
+
+Big thanks go out to [foxxyz](https://github.com/foxxyz/loupedeck) and his team maintaining a great javascript loopdeck module 
+
+## Hints
+
+### Cannot connect to Loupedeck device
+
+You may need to add your user to the `dialout` group to allow access to the LoupeDeck device, you could do su using the `usermod` as shown below
+
+```bash
+# ls -la /dev/ttyACM0 
+crw-rw---- 1 root dialout 166, 0 Nov 30 12:59 /dev/ttyACM0
+
+# add the current user to the dialout group:
+# sudo usermod -a -G dialout $USER
+```
+
+After modifying users group you need to logout and login again to activate this change
+
+### CANVAS Module - additional effort needed
+
+The library is using [canvas](https://www.npmjs.com/package/canvas) to load images and render graphical content on the LoupeDeck devices.
+Please follow the instructions to install the preconditions, to properly use canvas on your system.
+
+Example for Ubuntu:
+
+```bash
+# different build & graphic dev-libs are needed to use canvas module:
+sudo apt-get install build-essential libcairo2-dev libpango1.0-dev libjpeg-dev libgif-dev librsvg2-dev
+```
+
+### Resizing of images
+
+The buttons images shown on the different buttons should be prepared with specific resolutions:
+
+- Main/Center Touch-Area:        90px x 90px per Button
+- Left/Right Touch-Area:         90px x 270px per Button
+- LoupeDeck CT Knob Touch-Area:  240px x 240px Button
+
+if you already have suitable icons with the right aspect ratio, you could resize them with imagemagick/mogrify:
+
+```bash
+mkdir resized
+mogrify -resize 90x90 -quality 100 -path resized *.png
+```

package/VERSION.md

@@ -1,33 +1,33 @@
-# Versions
-
-## 1.0.2
-
-1. Updated button rendering strategy:
-   - Render Background Color - per Button State
-   - Render Image on Top (if available), works well with transparent images
-
-2. Updated configuration strategy:
-   - Keep all state related attributes per button-state also in config:
-     example:
-
-     ```json
-     "states": {
-        "off": {
-            "color": "#aaaaaa",
-            "image": "icons/bulb.png",
-            "cmd": "echo \"{id} {state}\""
-        },
-        "on": {
-            "color": "#11ff11",
-            "image": "icons/bulb.png",
-            "cmd": "echo \"{id} {state}\""
-        }
-     ```
-
-## 1.0.1 
-
-bugfixes and documentation
-
-## 1.0.0
-
+# Versions
+
+## 1.0.2
+
+1. Updated button rendering strategy:
+   - Render Background Color - per Button State
+   - Render Image on Top (if available), works well with transparent images
+
+2. Updated configuration strategy:
+   - Keep all state related attributes per button-state also in config:
+     example:
+
+     ```json
+     "states": {
+        "off": {
+            "color": "#aaaaaa",
+            "image": "icons/bulb.png",
+            "cmd": "echo \"{id} {state}\""
+        },
+        "on": {
+            "color": "#11ff11",
+            "image": "icons/bulb.png",
+            "cmd": "echo \"{id} {state}\""
+        }
+     ```
+
+## 1.0.1 
+
+bugfixes and documentation
+
+## 1.0.0
+
 first public release

package/common/ApplicationConfig.mjs

@@ -1,84 +1,84 @@
-import { readJSONFile, writeJSONFile } from './utils.mjs'
-
-export class ApplicationConfig {
-  application = 'undefined'
-  profiles = []
-
-  loadFromFile (fileName) {
-    console.info(`ApplicationConfig: Loading Config File ${fileName}`)
-    const config = readJSONFile(fileName)
-
-    this.application = config.application
-    for (let i = 0; i < config.profiles.length; i++) {
-      const profile = new Profile(config.profiles[i])
-      this.profiles.push(profile)
-    }
-  }
-}
-
-class Profile {
-  name = ''
-  file = ''
-  description = ''
-
-  touch = {}
-  knobs = {}
-  buttons = {}
-  parameters = {}
-  #file = ''
-  #loaded = false
-  #error = false
-
-  constructor (data) {
-    this.name = data.name
-    this.#file = data.file
-    this.loadFromFile(this.#file)
-    if (this.#error) { this.saveToFile(`profile-${this.name}-sav.json`) }
-  }
-
-  loadFromFile (fileName) {
-    console.info(`ProfileConfig: Loading Config File ${fileName}`)
-    const config = readJSONFile(fileName)
-    this.#error = (config === undefined)
-    this.#loaded = !this.#error
-    if (!this.#error && this.#loaded) {
-      this.profile = config.profile
-      this.description = config.description
-
-      // Load the Configurations for Touch-Displays
-      this.touch = new TouchConfig(config.touch)
-      // Load the Configurations for Button-Areas
-      this.buttons = config.buttons
-      // Load Parameters
-      this.parameters = config.parameters
-    }
-  }
-
-  saveToFile (fileName) {
-    fileName = fileName.toLowerCase()
-
-    console.info(`ProfileConfig: Save To Config File ${fileName}`)
-    writeJSONFile(fileName, this)
-  }
-}
-
-/**
- * Class that handles the different configs for the touch displays of the device covering Loupedeck Live (without knob) and also CT (with knob)
- */
-class TouchConfig {
-  center = {} // CENTER Display Config - Available in CT & LIVE
-  left = {} // LEFT Display Config - Available in CT & LIVE
-  right = {} // RIGHT Display Config - Available in CT & LIVE
-  knob = {} // KNOB Display Config - Available only in CT
-
-  constructor (data) {
-    this.loadFromJSON(data)
-  }
-
-  loadFromJSON (data) {
-    this.center = data.center
-    this.left = data.left
-    this.right = data.right
-    this.knob = data.knob
-  }
-}
+import { readJSONFile, writeJSONFile } from './utils.mjs'
+
+export class ApplicationConfig {
+  application = 'undefined'
+  profiles = []
+
+  loadFromFile (fileName) {
+    console.info(`ApplicationConfig: Loading Config File ${fileName}`)
+    const config = readJSONFile(fileName)
+
+    this.application = config.application
+    for (let i = 0; i < config.profiles.length; i++) {
+      const profile = new Profile(config.profiles[i])
+      this.profiles.push(profile)
+    }
+  }
+}
+
+class Profile {
+  name = ''
+  file = ''
+  description = ''
+
+  touch = {}
+  knobs = {}
+  buttons = {}
+  parameters = {}
+  #file = ''
+  #loaded = false
+  #error = false
+
+  constructor (data) {
+    this.name = data.name
+    this.#file = data.file
+    this.loadFromFile(this.#file)
+    if (this.#error) { this.saveToFile(`profile-${this.name}-sav.json`) }
+  }
+
+  loadFromFile (fileName) {
+    console.info(`ProfileConfig: Loading Config File ${fileName}`)
+    const config = readJSONFile(fileName)
+    this.#error = (config === undefined)
+    this.#loaded = !this.#error
+    if (!this.#error && this.#loaded) {
+      this.profile = config.profile
+      this.description = config.description
+
+      // Load the Configurations for Touch-Displays
+      this.touch = new TouchConfig(config.touch)
+      // Load the Configurations for Button-Areas
+      this.buttons = config.buttons
+      // Load Parameters
+      this.parameters = config.parameters
+    }
+  }
+
+  saveToFile (fileName) {
+    fileName = fileName.toLowerCase()
+
+    console.info(`ProfileConfig: Save To Config File ${fileName}`)
+    writeJSONFile(fileName, this)
+  }
+}
+
+/**
+ * Class that handles the different configs for the touch displays of the device covering Loupedeck Live (without knob) and also CT (with knob)
+ */
+class TouchConfig {
+  center = {} // CENTER Display Config - Available in CT & LIVE
+  left = {} // LEFT Display Config - Available in CT & LIVE
+  right = {} // RIGHT Display Config - Available in CT & LIVE
+  knob = {} // KNOB Display Config - Available only in CT
+
+  constructor (data) {
+    this.loadFromJSON(data)
+  }
+
+  loadFromJSON (data) {
+    this.center = data.center
+    this.left = data.left
+    this.right = data.right
+    this.knob = data.knob
+  }
+}