roonpipe 1.0.0 → 1.0.2

package/README.md

@@ -91,7 +91,11 @@ Or if installed from source:
 pnpm run cli
 ```
 
-Use arrow keys to navigate results and press Enter to play.
+Features:
+- Use arrow keys to navigate search results
+- Press Enter to select a track
+- Choose an action: Play now, Add to queue, or Play next
+- Press Ctrl+C to exit
 
 ### Development Mode
 
@@ -140,6 +144,7 @@ Response:
       "title": "Let It Be",
       "subtitle": "The Beatles · Let It Be",
       "item_key": "10:0",
+      "image": "/home/user/.cache/roonpipe/images/abc123.jpg",
       "sessionKey": "search_1234567890"
     }
   ]
@@ -148,19 +153,46 @@ Response:
 
 ### Play
 
+Play a track immediately (preserves current queue):
+
+```bash
+echo '{"command":"play","item_key":"10:0","session_key":"search_1234567890","action":"playNow"}' | nc -U /tmp/roonpipe.sock
+```
+
+Add to the queue:
+
+```bash
+echo '{"command":"play","item_key":"10:0","session_key":"search_1234567890","action":"queue"}' | nc -U /tmp/roonpipe.sock
+```
+
+Play next (add after current track):
+
 ```bash
-echo '{"command":"play","item_key":"10:0","session_key":"search_1234567890"}' | nc -U /tmp/roonpipe.sock
+echo '{"command":"play","item_key":"10:0","session_key":"search_1234567890","action":"addNext"}' | nc -U /tmp/roonpipe.sock
 ```
 
+Replace the queue and play immediately:
+
+```bash
+echo '{"command":"play","item_key":"10:0","session_key":"search_1234567890","action":"play"}' | nc -U /tmp/roonpipe.sock
+```
+
+Available actions:
+- `play` (default) — Replace queue and play immediately
+- `playNow` — Play immediately while preserving the queue (adds next and skips)
+- `queue` — Add to the end of the queue
+- `addNext` — Add after the current track
+
 ## Project Structure
 
 ```
 src/
-├── index.ts    # Entry point, daemon/CLI mode switching
-├── roon.ts     # Roon API connection and browsing
-├── mpris.ts    # MPRIS player, notifications, metadata
-├── socket.ts   # Unix socket server
-└── cli.ts      # Interactive terminal interface
+├── index.ts         # Entry point, daemon/CLI mode switching
+├── roon.ts          # Roon API connection and browsing
+├── mpris.ts         # MPRIS player, notifications, metadata
+├── socket.ts        # Unix socket server
+├── image-cache.ts   # Album artwork caching
+└── cli.ts           # Interactive terminal interface
 ```
 
 ## Contributing

package/dist/cli.js

@@ -109,19 +109,46 @@ function selectTrack(results) {
         }
     });
 }
-function playTrack(track) {
+function selectAction() {
     return __awaiter(this, void 0, void 0, function* () {
-        console.log(`\n▶️ Playing: ${track.title}${track.subtitle ? ` · ${track.subtitle}` : ""}\n`);
+        try {
+            const action = yield (0, prompts_1.select)({
+                message: "What do you want to do?",
+                choices: [
+                    { name: "▶️  Play now", value: "playNow" },
+                    { name: "📋  Add to queue", value: "queue" },
+                    { name: "⏭️  Play next", value: "addNext" },
+                    new prompts_1.Separator(),
+                    { name: "← Back", value: "back" },
+                ],
+                theme: { prefix: "" },
+            });
+            return action === "back" ? null : action;
+        }
+        catch (_a) {
+            return null;
+        }
+    });
+}
+function playTrack(track, action) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const actionLabels = {
+            playNow: "▶️ Playing",
+            queue: "📋 Added to queue",
+            addNext: "⏭️ Playing next",
+        };
+        console.log(`\n${actionLabels[action]}: ${track.title}${track.subtitle ? ` · ${track.subtitle}` : ""}\n`);
         try {
             yield sendCommand({
                 command: "play",
                 item_key: track.item_key,
                 session_key: track.sessionKey,
+                action,
             });
-            console.log("✅ Playback started!\n");
+            console.log("✅  Success!\n");
         }
         catch (error) {
-            console.error("❌ Failed to play track:", error);
+            console.error("❌  Failed:", error);
         }
     });
 }
@@ -146,7 +173,12 @@ function startCLI() {
             if (selected.subtitle === "__search__") {
                 continue;
             }
-            yield playTrack(selected);
+            const action = yield selectAction();
+            if (action === null) {
+                // User chose "Back", continue to track selection
+                continue;
+            }
+            yield playTrack(selected, action);
         }
     });
 }

package/dist/image-cache.js

@@ -0,0 +1,103 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getImageCachePath = getImageCachePath;
+exports.isImageCached = isImageCached;
+exports.cacheImage = cacheImage;
+exports.cacheImages = cacheImages;
+exports.clearOldCache = clearOldCache;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const CACHE_DIR = node_path_1.default.join(node_os_1.default.homedir(), ".cache", "roonpipe", "images");
+// Ensure the cache directory exists
+if (!node_fs_1.default.existsSync(CACHE_DIR)) {
+    node_fs_1.default.mkdirSync(CACHE_DIR, { recursive: true });
+}
+/**
+ * Get the local cache path for an image
+ */
+function getImageCachePath(imageKey) {
+    return node_path_1.default.join(CACHE_DIR, `${imageKey}.jpg`);
+}
+/**
+ * Check if an image is already cached
+ */
+function isImageCached(imageKey) {
+    return node_fs_1.default.existsSync(getImageCachePath(imageKey));
+}
+/**
+ * Download and cache an image from Roon Core
+ */
+function cacheImage(imageApi, imageKey) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!imageKey) {
+            return null;
+        }
+        const cachePath = getImageCachePath(imageKey);
+        // Return cached path if already exists
+        if (isImageCached(imageKey)) {
+            return cachePath;
+        }
+        return new Promise((resolve) => {
+            imageApi.get_image(imageKey, { scale: "fit", width: 300, height: 300, format: "image/jpeg" }, (error, _contentType, imageData) => {
+                if (error || !imageData) {
+                    resolve(null);
+                    return;
+                }
+                try {
+                    node_fs_1.default.writeFileSync(cachePath, imageData);
+                    resolve(cachePath);
+                }
+                catch (_a) {
+                    resolve(null);
+                }
+            });
+        });
+    });
+}
+/**
+ * Cache multiple images in parallel
+ */
+function cacheImages(imageApi, imageKeys) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const results = new Map();
+        const uniqueKeys = [...new Set(imageKeys.filter(Boolean))];
+        yield Promise.all(uniqueKeys.map((key) => __awaiter(this, void 0, void 0, function* () {
+            const path = yield cacheImage(imageApi, key);
+            results.set(key, path);
+        })));
+        return results;
+    });
+}
+/**
+ * Clear old cached images (older than specified days)
+ */
+function clearOldCache(maxAgeDays = 30) {
+    try {
+        const files = node_fs_1.default.readdirSync(CACHE_DIR);
+        const maxAgeMs = maxAgeDays * 24 * 60 * 60 * 1000;
+        const now = Date.now();
+        for (const file of files) {
+            const filePath = node_path_1.default.join(CACHE_DIR, file);
+            const stats = node_fs_1.default.statSync(filePath);
+            if (now - stats.mtimeMs > maxAgeMs) {
+                node_fs_1.default.unlinkSync(filePath);
+            }
+        }
+    }
+    catch (_a) {
+        // Ignore errors during cleanup
+    }
+}

package/dist/roon.js

@@ -1,4 +1,13 @@
 "use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -16,13 +25,14 @@ const node_roon_api_browse_1 = __importDefault(require("node-roon-api-browse"));
 const node_roon_api_image_1 = __importDefault(require("node-roon-api-image"));
 // @ts-expect-error
 const node_roon_api_transport_1 = __importDefault(require("node-roon-api-transport"));
+const image_cache_1 = require("./image-cache");
 let zone = null;
 let coreInstance = null;
 function initRoon(callbacks) {
     const roon = new node_roon_api_1.default({
         extension_id: "com.bluemancz.roonpipe",
         display_name: "RoonPipe",
-        display_version: "1.0.0",
+        display_version: "1.0.2",
         publisher: "BlueManCZ",
         email: "your@email.com",
         website: "https://github.com/bluemancz/roonpipe",
@@ -102,7 +112,7 @@ function searchRoon(query) {
                 }
                 const tracksCategory = (_a = loadResult.items) === null || _a === void 0 ? void 0 : _a.find((item) => item.title === "Tracks");
                 if (!tracksCategory) {
-                    // No tracks category found - return empty array
+                    // No tracks category found - return an empty array
                     resolve([]);
                     return;
                 }
@@ -111,28 +121,66 @@ function searchRoon(query) {
                         reject(browseError);
                         return;
                     }
-                    browse.load(Object.assign(Object.assign({}, opts), { item_key: tracksCategory.item_key, offset: 0, count: Math.min(browseResult.list.count, 50) }), (tracksError, tracksResult) => {
-                        var _a;
+                    browse.load(Object.assign(Object.assign({}, opts), { item_key: tracksCategory.item_key, offset: 0, count: Math.min(browseResult.list.count, 50) }), (tracksError, tracksResult) => __awaiter(this, void 0, void 0, function* () {
+                        var _a, _b;
                         if (tracksError) {
                             reject(tracksError);
                             return;
                         }
-                        const items = ((_a = tracksResult.items) === null || _a === void 0 ? void 0 : _a.map((item) => ({
+                        // Cache all images in parallel
+                        const imageKeys = ((_a = tracksResult.items) === null || _a === void 0 ? void 0 : _a.map((item) => item.image_key).filter(Boolean)) || [];
+                        const imageApi = coreInstance.services.RoonApiImage;
+                        const cachedImages = yield (0, image_cache_1.cacheImages)(imageApi, imageKeys);
+                        const items = ((_b = tracksResult.items) === null || _b === void 0 ? void 0 : _b.map((item) => ({
                             title: item.title || "Unknown",
                             subtitle: item.subtitle || "",
                             item_key: item.item_key,
                             image_key: item.image_key,
+                            image: cachedImages.get(item.image_key) || null,
                             hint: item.hint,
                             sessionKey: sessionKey,
                         }))) || [];
                         resolve(items);
-                    });
+                    }));
                 });
             });
         });
     });
 }
-function playItem(itemKey, sessionKey) {
+const ACTION_TITLES = {
+    play: ["Play Now", "Play"],
+    queue: ["Queue", "Add to Queue"],
+    addNext: ["Play From Here", "Add Next"],
+};
+/**
+ * Skip to the next track in the queue
+ */
+function skipToNext() {
+    return new Promise((resolve, reject) => {
+        if (!coreInstance || !zone) {
+            reject("Not connected");
+            return;
+        }
+        coreInstance.services.RoonApiTransport.control(zone, "next", (err) => {
+            if (err)
+                reject(err);
+            else
+                resolve();
+        });
+    });
+}
+function playItem(itemKey_1, sessionKey_1) {
+    return __awaiter(this, arguments, void 0, function* (itemKey, sessionKey, action = "play") {
+        // "playNow" = add next + skip to it (preserves queue)
+        if (action === "playNow") {
+            yield playItemInternal(itemKey, sessionKey, "addNext");
+            yield skipToNext();
+            return;
+        }
+        return playItemInternal(itemKey, sessionKey, action);
+    });
+}
+function playItemInternal(itemKey, sessionKey, action) {
     return new Promise((resolve, reject) => {
         if (!coreInstance) {
             reject("Roon Core not connected");
@@ -143,6 +191,7 @@ function playItem(itemKey, sessionKey) {
             return;
         }
         const browse = coreInstance.services.RoonApiBrowse;
+        const actionTitles = ACTION_TITLES[action];
         function loadUntilAction(currentItemKey, depth = 0) {
             if (depth > 5) {
                 reject("Too many levels, cannot find action");
@@ -175,20 +224,20 @@ function playItem(itemKey, sessionKey) {
                         reject("No items found");
                         return;
                     }
-                    const playNowAction = loadResult.items.find((item) => item.hint === "action" &&
-                        (item.title === "Play Now" || item.title === "Play"));
-                    if (playNowAction) {
+                    const targetAction = loadResult.items.find((item) => item.hint === "action" &&
+                        actionTitles.some((title) => item.title === title));
+                    if (targetAction) {
                         browse.browse({
                             hierarchy: "search",
                             multi_session_key: sessionKey,
-                            item_key: playNowAction.item_key,
+                            item_key: targetAction.item_key,
                             zone_or_output_id: zone.zone_id,
                         }, (playError) => {
                             if (playError) {
                                 reject(playError);
                             }
                             else {
-                                console.log("Successfully started playback");
+                                console.log(`Successfully executed action: ${action}`);
                                 resolve();
                             }
                         });
@@ -199,7 +248,7 @@ function playItem(itemKey, sessionKey) {
                             loadUntilAction(actionList.item_key, depth + 1);
                         }
                         else {
-                            reject("Could not find Play action or next level");
+                            reject(`Could not find ${action} action or next level`);
                         }
                     }
                 });

package/dist/socket.js

@@ -66,7 +66,7 @@ function startSocketServer(handlers) {
                 }
                 else if (request.command === "play") {
                     try {
-                        yield handlers.play(request.item_key, request.session_key);
+                        yield handlers.play(request.item_key, request.session_key, request.action);
                         client.write(`${JSON.stringify({ error: null, success: true })}\n`);
                     }
                     catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "roonpipe",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Linux integration for Roon – MPRIS support, media keys, desktop notifications, and interactive search CLI",
   "main": "dist/index.js",
   "bin": {
@@ -25,7 +25,7 @@
     "@types/node-notifier": "^8.0.5",
     "nodemon": "^3.1.11",
     "ts-node": "^10.9.2",
-    "typescript": "^5.5.3"
+    "typescript": "^5.9.3"
   },
   "files": [
     "dist"
@@ -43,6 +43,7 @@
     "build": "tsc",
     "start": "node dist/index.js",
     "dev": "nodemon src/index.ts",
-    "cli": "tsc && node dist/index.js --cli"
+    "cli": "tsc && node dist/index.js --cli",
+    "biome": "biome check"
   }
 }