node-red-contrib-lgtv-notify 1.0.1 → 1.0.3

package/nodes/lgtv-notify.html

@@ -7,7 +7,7 @@
             host: { value: '', required: true }
         },
         credentials: {
-            clientKey: { type: 'text' }
+            clientKey: { type: 'password' }
         },
         label: function() {
             return this.name || this.host || 'LG TV';
@@ -30,6 +30,41 @@
     </div>
 </script>
 
+<script type="text/html" data-help-name="lgtv-config">
+    <p>Configuration node for LG webOS TV connection.</p>
+
+    <h3>Properties</h3>
+    <dl class="message-properties">
+        <dt>Name <span class="property-type">string</span></dt>
+        <dd>A friendly name for this TV (e.g., "Living Room TV").</dd>
+        <dt>TV IP <span class="property-type">string</span></dt>
+        <dd>The IP address of your LG TV on the local network.</dd>
+    </dl>
+
+    <h3>Finding your TV's IP Address</h3>
+    <ol>
+        <li>On your TV, go to <strong>Settings > Network > Wi-Fi Connection</strong></li>
+        <li>Select your connected network</li>
+        <li>The IP address will be displayed (e.g., 192.168.1.100)</li>
+    </ol>
+
+    <h3>Pairing Process</h3>
+    <p>When you first deploy a flow using this TV configuration:</p>
+    <ol>
+        <li>A pairing prompt will appear on your TV screen</li>
+        <li>Use your TV remote to select "Accept"</li>
+        <li>The pairing key is saved automatically</li>
+        <li>Future connections will happen automatically</li>
+    </ol>
+
+    <h3>Requirements</h3>
+    <ul>
+        <li>TV must be powered on (not in standby mode)</li>
+        <li>"LG Connect Apps" must be enabled: Settings > General > External Device Manager > LG Connect Apps</li>
+        <li>TV and Node-RED server must be on the same network</li>
+    </ul>
+</script>
+
 <!-- LG TV Notify Node -->
 <script type="text/javascript">
     RED.nodes.registerType('lgtv-notify', {
@@ -68,12 +103,12 @@
 </script>
 
 <script type="text/html" data-help-name="lgtv-notify">
-    <p>Send toast notifications to an LG webOS TV.</p>
+    <p>Send toast notifications to an LG webOS Smart TV.</p>
 
     <h3>Inputs</h3>
     <dl class="message-properties">
         <dt>payload <span class="property-type">string</span></dt>
-        <dd>The notification message to display on the TV.</dd>
+        <dd>The notification message to display on the TV (max 60 characters recommended).</dd>
     </dl>
 
     <h3>Outputs</h3>
@@ -82,15 +117,43 @@
         <dd>The original message.</dd>
         <dt>toastId <span class="property-type">string</span></dt>
         <dd>The ID of the created toast notification.</dd>
+        <dt>tvResponse <span class="property-type">object</span></dt>
+        <dd>The full response from the TV API.</dd>
     </dl>
 
     <h3>Details</h3>
-    <p>This node sends a toast notification to an LG webOS Smart TV.</p>
-    <p>The notification will appear in the top-right corner of the TV screen for approximately 5 seconds.</p>
-    <p><strong>First use:</strong> When you first deploy, check your TV for a pairing prompt and accept it.</p>
+    <p>This node sends a toast notification to an LG webOS Smart TV. The notification appears in the top-right corner of the TV screen for approximately 5 seconds.</p>
+
+    <h4>First-time Setup</h4>
+    <ol>
+        <li>Configure the TV node with your TV's IP address</li>
+        <li>Deploy the flow</li>
+        <li><strong>Important:</strong> Accept the pairing prompt on your TV</li>
+        <li>The pairing key is saved automatically for future connections</li>
+    </ol>
+
+    <h4>Example Usage</h4>
+    <p>Send a simple notification:</p>
+    <pre>msg.payload = "Doorbell: Someone is at the door!";
+return msg;</pre>
+
+    <h4>Requirements</h4>
+    <ul>
+        <li>LG webOS Smart TV (webOS 3.0 or newer, including 2025 models)</li>
+        <li>TV and Node-RED must be on the same network</li>
+        <li>"LG Connect Apps" must be enabled on the TV (Settings > General > External Device Manager)</li>
+    </ul>
+
+    <h4>Troubleshooting</h4>
+    <ul>
+        <li><strong>TV not connecting:</strong> Ensure TV is powered on (not standby), wait ~25 seconds after power-on</li>
+        <li><strong>No pairing prompt:</strong> Restart Node-RED and redeploy</li>
+        <li><strong>Notifications not showing:</strong> TV must be on and displaying content</li>
+    </ul>
 
     <h3>References</h3>
     <ul>
-        <li><a href="https://github.com/rcaldeira/node-red-contrib-lgtv-notify">GitHub</a> - the node's repository</li>
+        <li><a href="https://github.com/Ricardo-Miguel-Caldeira/node-red-contrib-lgtv-notify">GitHub Repository</a></li>
+        <li><a href="https://www.npmjs.com/package/node-red-contrib-lgtv-notify">npm Package</a></li>
     </ul>
 </script>

package/nodes/lgtv-notify.js

@@ -40,6 +40,7 @@ module.exports = function(RED) {
 
             node.connection.on('error', (err) => {
                 node.error(`Connection error: ${err.message}`);
+                node.warn(`Full error: ${JSON.stringify(err)}`);
                 node.connected = false;
                 node.connecting = false;
             });
@@ -56,7 +57,8 @@ module.exports = function(RED) {
             node.connection.on('connect', () => {
                 node.connected = true;
                 node.connecting = false;
-                node.log(`Connected to ${node.host}`);
+                node.log(`Connected to TV at ${node.host}`);
+                node.warn(`Connection established - clientKey: ${node.connection.clientKey ? 'present' : 'missing'}`);
 
                 // Save client key for future connections
                 if (node.connection.clientKey && node.connection.clientKey !== node.clientKey) {
@@ -82,16 +84,26 @@ module.exports = function(RED) {
         };
 
         this.sendToast = function(message, callback) {
+            node.warn(`sendToast called - connected: ${node.connected}, message: "${message}"`);
+
             if (!node.connected) {
+                node.warn(`Not connected, queuing message. Queue size: ${node.queue.length + 1}`);
                 node.queue.push({ message, callback });
                 node.connect();
                 return;
             }
 
+            node.warn(`Sending toast request to TV...`);
             node.connection.request(
                 'ssap://system.notifications/createToast',
                 { message: message },
                 (err, res) => {
+                    if (err) {
+                        node.error(`Toast request failed: ${err.message || err}`);
+                        node.warn(`Full error object: ${JSON.stringify(err)}`);
+                    } else {
+                        node.warn(`Toast response: ${JSON.stringify(res)}`);
+                    }
                     if (callback) callback(err, res);
                 }
             );
@@ -127,16 +139,21 @@ module.exports = function(RED) {
         this.on('input', function(msg, send, done) {
             const message = msg.payload || config.message || 'Notification';
 
+            node.warn(`Input received - payload type: ${typeof msg.payload}, message to send: "${message}"`);
             node.status({ fill: 'yellow', shape: 'dot', text: 'sending...' });
 
             node.tv.sendToast(message, (err, res) => {
+                node.warn(`Callback received - err: ${err ? JSON.stringify(err) : 'null'}, res: ${JSON.stringify(res)}`);
+
                 if (err) {
                     node.status({ fill: 'red', shape: 'dot', text: 'error' });
+                    node.error(`Failed to send toast: ${err.message || JSON.stringify(err)}`, msg);
                     if (done) done(err);
-                    else node.error(err, msg);
                 } else {
+                    node.warn(`Toast sent successfully - toastId: ${res ? res.toastId : 'unknown'}`);
                     node.status({ fill: 'green', shape: 'dot', text: 'sent' });
-                    msg.toastId = res.toastId;
+                    msg.toastId = res ? res.toastId : null;
+                    msg.tvResponse = res;
                     send(msg);
                     if (done) done();
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-red-contrib-lgtv-notify",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Send toast notifications to LG webOS TVs from Node-RED. Works with webOS 10+ (2025 TVs).",
   "keywords": [
     "node-red",

package/.claude/settings.local.json

@@ -1,31 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npm run build:*)",
-      "mcp__plugin_playwright_playwright__browser_click",
-      "mcp__plugin_playwright_playwright__browser_evaluate",
-      "Bash(curl:*)",
-      "Bash(timeout 5 npx ares-inspect:*)",
-      "mcp__plugin_playwright_playwright__browser_console_messages",
-      "Bash(timeout 8 npx ares-inspect:*)",
-      "WebFetch(domain:webostv.developer.lge.com)",
-      "WebFetch(domain:gist.github.com)",
-      "WebFetch(domain:www.webosbrew.org)",
-      "WebFetch(domain:www.webosose.org)",
-      "Bash(npx ares-device-info:*)",
-      "Bash(npx @�webos-tools/cli ares-device-info -d webostv)",
-      "Bash(npx ares-shell -d webostv -r \"cat /var/run/nyx/os_info.json\")",
-      "Bash(npx ares-shell:*)",
-      "Bash(npx ares-device:*)",
-      "WebFetch(domain:cani.rootmy.tv)",
-      "WebFetch(domain:www.home-assistant.io)",
-      "Bash(timeout 5 curl:*)",
-      "Bash(timeout 3 bash -c 'echo > /dev/tcp/10.1.60.87/3000')",
-      "Bash(timeout 3 bash -c 'echo > /dev/tcp/10.1.60.87/3001')",
-      "Bash(timeout 15 node:*)",
-      "Bash(timeout 35 node:*)",
-      "Bash(npm whoami:*)",
-      "Bash(npm publish)"
-    ]
-  }
-}

package/.github/workflows/publish.yml

@@ -1,25 +0,0 @@
-name: Publish to npm
-
-on:
-  release:
-    types: [published]
-  workflow_dispatch:
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
-
-      - name: Install dependencies
-        run: npm install --ignore-scripts
-
-      - name: Publish to npm
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/CLAUDE.md

@@ -1,99 +0,0 @@
-# YouTube Enhanced - webOS TV App
-
-Based on [youtube-webos](https://github.com/webosbrew/youtube-webos) with custom modifications for larger TVs.
-
-## App Info
-- **App ID**: `com.mysmartv.youtube`
-- **Title**: YouTube Enhanced
-- **Features**: Ad blocking, SponsorBlock, smaller thumbnails (5 per row)
-
-## Project Structure
-```
-/home/rcaldeira/mySmartTV-Youtube/
-├── assets/
-│   └── appinfo.json          # App manifest (custom ID)
-├── src/
-│   ├── index.html            # Entry point
-│   ├── index.js              # Redirects to youtube.com/tv
-│   ├── userScript.ts         # Main injection script
-│   ├── thumbnail-size.css    # Custom CSS for smaller thumbnails
-│   ├── adblock.js            # Ad blocking
-│   ├── sponsorblock.js       # SponsorBlock integration
-│   └── ...                   # Other modules
-├── dist/                     # Build output
-└── com.mysmartv.youtube_1.0.0_all.ipk
-```
-
-## Development Commands
-
-### Build
-```bash
-npm run build
-```
-
-### Package
-```bash
-npx ares-package dist/ --outdir .
-```
-
-### Install to TV
-```bash
-npx ares-install com.mysmartv.youtube_1.0.0_all.ipk -d webostv
-```
-
-### Launch
-```bash
-npx ares-launch com.mysmartv.youtube -d webostv
-```
-
-### Full Deploy (one command)
-```bash
-npm run build && npx ares-package dist/ --outdir . && npx ares-install com.mysmartv.youtube_1.0.0_all.ipk -d webostv && npx ares-launch com.mysmartv.youtube -d webostv
-```
-
-## Preview Method (Remote Debugging)
-
-### 1. Start Inspector
-```bash
-npx ares-inspect com.mysmartv.youtube -d webostv
-```
-
-Output:
-```
-Application Debugging - http://localhost:XXXXX
-```
-
-### 2. Open in Browser
-1. Navigate to `http://localhost:XXXXX`
-2. Click on "YouTube na TV" link
-3. DevTools opens with live screencast of the TV
-
-### 3. Take Screenshot with Playwright
-```javascript
-await page.goto('http://localhost:XXXXX');
-await page.click('text=YouTube na TV');
-await page.waitForTimeout(3000);
-await page.screenshot({ path: 'tv-preview.png' });
-```
-
-## Custom Thumbnail CSS
-
-The `src/thumbnail-size.css` uses CSS transforms to scale down content:
-- Scales browse content to 85%
-- Scales individual tiles to 82%
-- Compacts sidebar to give more content space
-- Results in ~5 thumbnails per row on large TVs
-
-## TV Device
-- **Name**: webostv
-- **IP**: 10.1.60.87:9922
-
-### List Devices
-```bash
-npx ares-setup-device --list
-```
-
-## Notes
-- App coexists with official YouTube (different app ID)
-- All youtube-webos features enabled (ad blocking, SponsorBlock)
-- CSS may need fine-tuning based on specific TV size