roonpipe 1.0.1 → 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
 
@@ -149,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/roon.js

@@ -32,7 +32,7 @@ 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",
@@ -112,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;
                 }
@@ -147,7 +147,40 @@ function searchRoon(query) {
         });
     });
 }
-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");
@@ -158,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");
@@ -190,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();
                             }
                         });
@@ -214,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.1",
+  "version": "1.0.2",
   "description": "Linux integration for Roon – MPRIS support, media keys, desktop notifications, and interactive search CLI",
   "main": "dist/index.js",
   "bin": {