roonpipe 1.0.7 → 1.0.9

package/README.md

@@ -11,6 +11,7 @@ A Linux integration layer for [Roon](https://roonlabs.com/) that brings native d
 - **Desktop Notifications** — Get notified when tracks change, complete with album artwork
 - **Playback Controls** — Play, pause, stop, skip, seek, volume, shuffle, and loop
 - **Library Search** — Search your entire Roon library (tracks, albums, artists, playlists, and works from local and streaming services)
+- **Frequency-based Re-ranking** — Frequently played items are boosted in search results, and items missing from Roon's results are injected based on your play history
 - **GNOME Search Integration** — Search and play music directly from the GNOME overview or search bar
 - **Unix Socket API** — Integrate with other applications using a simple JSON-based IPC protocol
 - **Interactive CLI** — Search and play music from your terminal with arrow key navigation and action menus
@@ -171,6 +172,7 @@ Response:
       "subtitle": "",
       "item_key": "100:0",
       "image": "/home/user/.cache/roonpipe/images/abc123.jpg",
+      "image_key": "abc123",
       "hint": "list",
       "sessionKey": "search_1234567890",
       "type": "artist",
@@ -187,6 +189,7 @@ Response:
       "subtitle": "The Beatles",
       "item_key": "101:0",
       "image": "/home/user/.cache/roonpipe/images/def456.jpg",
+      "image_key": "def456",
       "hint": "list",
       "sessionKey": "search_1234567890",
       "type": "album",
@@ -204,6 +207,7 @@ Response:
       "subtitle": "The Beatles",
       "item_key": "102:0",
       "image": "/home/user/.cache/roonpipe/images/ghi789.jpg",
+      "image_key": "ghi789",
       "hint": "action_list",
       "sessionKey": "search_1234567890",
       "type": "track",
@@ -213,6 +217,7 @@ Response:
         {"title": "Play Now"},
         {"title": "Add Next"},
         {"title": "Queue"},
+        {"title": "Play Album"},
         {"title": "Start Radio"}
       ]
     }
@@ -224,11 +229,13 @@ Response:
 - `title` — Item title
 - `subtitle` — Additional info (artist names are automatically parsed from Roon's internal format)
 - `item_key` — Item identifier (ephemeral, valid only within session context)
+- `image` — Local path to cached artwork, or `null`
+- `image_key` — Roon image key used for artwork caching and deduplication
 - `type` — Item type: `"artist"`, `"album"`, `"track"`, `"composer"`, `"playlist"`, or `"work"`
 - `actions` — List of available Roon actions for this item (known actions based on type)
 - `category_key` — Key to the category for navigation
 - `index` — Position within the category
-- `sessionKey` — Search session identifier
+- `sessionKey` — Search session identifier (`"stored"` for items injected from play history)
 
 ### Play
 
@@ -252,6 +259,9 @@ Response:
 - `category_key` — Category key from search results
 - `item_index` — Index from search results
 - `action_title` — Title of the action to execute (e.g., "Play Now", "Queue", "Add Next")
+- `item_title` — Item title (optional, used for frequency tracking and resolving injected items)
+- `item_type` — Item type (optional, used for frequency tracking)
+- `item_image_key` — Image key (optional, used for frequency tracking and resolving injected items)
 
 **How It Works:**
 The play command navigates back to the item using `category_key` and `item_index` to get fresh, valid keys, then navigates through the action hierarchy to execute the action matching `action_title`. This approach works around Roon's ephemeral browse keys.
@@ -262,6 +272,7 @@ The play command navigates back to the item using `category_key` and `item_index
 src/
 ├── index.ts                 # Entry point, daemon/CLI mode switching
 ├── roon.ts                  # Roon API connection and browsing
+├── frequency.ts             # Play frequency tracking and search re-ranking
 ├── mpris.ts                 # MPRIS player and metadata
 ├── notification.ts          # Desktop notifications
 ├── socket.ts                # Unix socket server

package/dist/cli.js

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"startCLI",{enumerable:!0,get:function(){return u}});let e=/*#__PURE__*/o(require("node:net")),t=/*#__PURE__*/o(require("node:readline")),n=require("@inquirer/prompts");function o(e){return e&&e.__esModule?e:{default:e}}function r(t){return new Promise((n,o)=>{let r=e.default.createConnection("/tmp/roonpipe.sock",()=>{r.write(JSON.stringify(t))}),a="";r.on("data",e=>{a+=e.toString()}),r.on("end",()=>{try{let e=JSON.parse(a);e.error?o(e.error):n(e)}catch{o("Failed to parse response")}}),r.on("error",e=>{o(`Cannot connect to RoonPipe daemon. Is it running?
 ${e.message}`)})})}async function a(){let e=t.default.createInterface({input:process.stdin,output:process.stdout});return new Promise(t=>{e.question("🔍 Search: ",n=>{e.close(),t(n)})})}async function i(){let e=await a();if(!e.trim())return[];console.log(`
 Searching for "${e}"...
-`);try{return(await r({command:"search",query:e})).results||[]}catch(e){return console.error("❌ Error:",e),[]}}async function l(e){let t={track:"🎵",album:"💿",artist:"🎤",playlist:"📋",work:"🎼",composer:"👤"},o=[...e.map((e,n)=>({name:`${t[e.type]||"•"} ${e.title} ${e.subtitle?`\xb7 ${e.subtitle}`:""}`,value:n})),new n.Separator,{name:"🔍 New search",value:-1},{name:"❌ Quit",value:-2}];try{let t=await (0,n.select)({message:"Select an item to play:",choices:o,pageSize:15,theme:{prefix:""}});if(-2===t)return null;if(-1===t)return{item_key:"",sessionKey:"",title:"",subtitle:"__search__",type:"track",category_key:"",index:0,actions:[]};return e[t]}catch{return null}}async function s(e){try{let t={"Play Now":"▶️",Play:"▶️",Shuffle:"🔀",Queue:"📋","Add to Queue":"📋","Add Next":"⏭️","Play From Here":"⏭️","Start Radio":"📻"},o=e.map(e=>({name:`${t[e.title]||"•"} ${e.title}`,value:e})),r=await (0,n.select)({message:"What do you want to do?",choices:[...o,new n.Separator,{name:"← Back",value:"back"}],theme:{prefix:""}});return"back"===r?null:r}catch{return null}}async function c(e,t){console.log(`
+`);try{return(await r({command:"search",query:e})).results||[]}catch(e){return console.error("❌ Error:",e),[]}}async function l(e){let t={track:"🎵",album:"💿",artist:"🎤",playlist:"📋",work:"🎼",composer:"👤"},o=[...e.map((e,n)=>({name:`${t[e.type]||"•"} ${e.title} ${e.subtitle?`\xb7 ${e.subtitle}`:""}`,value:n})),new n.Separator,{name:"🔍 New search",value:-1},{name:"❌ Quit",value:-2}];try{let t=await (0,n.select)({message:"Select an item to play:",choices:o,pageSize:15,theme:{prefix:""}});if(-2===t)return null;if(-1===t)return{item_key:"",image_key:"",sessionKey:"",title:"",subtitle:"__search__",type:"track",category_key:"",index:0,actions:[]};return e[t]}catch{return null}}async function s(e){try{let t={"Play Now":"▶️","Play Album":"💿",Play:"▶️",Shuffle:"🔀",Queue:"📋","Add to Queue":"📋","Add Next":"⏭️","Play From Here":"⏭️","Start Radio":"📻"},o=e.map(e=>({name:`${t[e.title]||"•"} ${e.title}`,value:e})),r=await (0,n.select)({message:"What do you want to do?",choices:[...o,new n.Separator,{name:"← Back",value:"back"}],theme:{prefix:""}});return"back"===r?null:r}catch{return null}}async function c(e,t){console.log(`
 ${t.title}: ${e.title}${e.subtitle?` \xb7 ${e.subtitle}`:""}
-`);try{await r({command:"play",item_key:e.item_key,session_key:e.sessionKey,category_key:e.category_key,item_index:e.index,action_title:t.title}),console.log("✅  Success!\n")}catch(e){console.error("❌  Failed:",e)}}async function u(){for(console.log("\n🎵 RoonPipe Interactive Search"),console.log("==============================\n");;){let e=await i();if(!e.length){console.log("❌ No results found.\n");continue}console.log(`Found ${e.length} result(s):
+`);try{await r({command:"play",item_key:e.item_key,session_key:e.sessionKey,category_key:e.category_key,item_index:e.index,action_title:t.title,item_title:e.title,item_type:e.type,item_image_key:e.image_key}),console.log("✅  Success!\n")}catch(e){console.error("❌  Failed:",e)}}async function u(){for(console.log("\n🎵 RoonPipe Interactive Search"),console.log("==============================\n");;){let e=await i();if(!e.length){console.log("❌ No results found.\n");continue}console.log(`Found ${e.length} result(s):
 `);let t=await l(e);if(!t){console.log("\nGoodbye! 👋\n");break}if("__search__"===t.subtitle)continue;if(0===t.actions.length){console.log("No actions available for this item.\n");continue}let n=await s(t.actions);n&&await c(t,n)}}

package/dist/frequency.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=exports,t={get loadFrequencyData(){return d},get reRankResults(){return m},get recordPlay(){return f}};for(var i in t)Object.defineProperty(e,i,{enumerable:!0,get:Object.getOwnPropertyDescriptor(t,i).get});let r=/*#__PURE__*/n(require("node:fs")),a=/*#__PURE__*/n(require("node:os")),l=/*#__PURE__*/n(require("node:path")),o=require("./image-cache");function n(e){return e&&e.__esModule?e:{default:e}}let s=l.default.join(a.default.homedir(),".cache","roonpipe","frequency.json"),u={version:1,items:{}},c=null;function y(){try{let e=l.default.dirname(s);r.default.existsSync(e)||r.default.mkdirSync(e,{recursive:!0}),r.default.writeFileSync(s,JSON.stringify(u,null,2))}catch(e){console.error("Failed to save frequency data:",e)}}function d(){try{if(r.default.existsSync(s)){let e=JSON.parse(r.default.readFileSync(s,"utf-8"));if(e?.version===1&&e?.items){u=e;let t=Date.now()-15552e6;for(let[e,i]of Object.entries(u.items))i.lastPlayed<t&&delete u.items[e];y()}}}catch(e){console.error("Failed to load frequency data, starting fresh:",e),u={version:1,items:{}}}}function f(e){try{var t,i,r;let a=(t=e.type,i=e.title,r=e.image_key,`${t}::${i}::${r}`),l=u.items[a];u.items[a]={title:e.title,subtitle:e.subtitle,type:e.type,image:e.image,image_key:e.image_key,count:(l?.count||0)+1,lastPlayed:Date.now()},c&&clearTimeout(c),c=setTimeout(y,2e3)}catch(e){console.error("Failed to record play:",e)}}function m(e,t){try{let i=e.toLowerCase(),r=new Set(t.map(e=>`${e.title}::${e.image_key}`)),a=[];for(let[,e]of Object.entries(u.items)){if(!e.title.toLowerCase().includes(i))continue;let t=`${e.title}::${e.image_key}`;if(r.has(t))continue;let l=e.image_key&&(0,o.isImageCached)(e.image_key)?(0,o.getImageCachePath)(e.image_key):e.image;a.push({title:e.title,subtitle:e.subtitle,item_key:"",image:l,image_key:e.image_key,hint:"",sessionKey:"stored",type:e.type,category_key:"",index:0,actions:"track"===e.type?[{title:"Play Now"},{title:"Add Next"},{title:"Queue"},{title:"Play Album"},{title:"Start Radio"}]:"album"===e.type?[{title:"Play Now"},{title:"Add Next"},{title:"Queue"},{title:"Start Radio"}]:"artist"===e.type||"composer"===e.type?[{title:"Shuffle"},{title:"Start Radio"}]:[]})}let l=new Map;for(let[,e]of Object.entries(u.items)){let t=`${e.title}::${e.image_key}`;l.set(t,function(e){let t=(Date.now()-e.lastPlayed)/864e5;return Math.log2(1+e.count)*.5**(t/30)}(e))}let n=[...t,...a],s=n.length;return n.sort((e,i)=>{let r=`${e.title}::${e.image_key}`,a=`${i.title}::${i.image_key}`,o=l.get(r)||0,n=l.get(a)||0,u=t.indexOf(e),c=t.indexOf(i);return(c>=0?.5*(1-c/s):0)+n-((u>=0?.5*(1-u/s):0)+o)}),n}catch(e){return console.error("Failed to re-rank results:",e),t}}

package/dist/gnome-search-provider.js

@@ -1 +1 @@
-"use strict";var e,t;Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"initGnomeSearchProvider",{enumerable:!0,get:function(){return g}});let r=(t=require("dbus-next"))&&t.__esModule?t:{default:t},n="com.bluemancz.RoonPipe.SearchProvider",a=new Map,i=new Map,o=null,l=null,s=null,u=(e=async(e,t)=>{let r=i.get(e);if(r)return void t(r);try{if(!l)return void t([]);let r=await l(e),n=[];for(let e of r.slice(0,5)){let t=`roon_${e.item_key}`;a.set(t,e),n.push(t)}i.set(e,n),t(n)}catch(e){console.error("Search failed:",e),t([])}},(...t)=>{o&&clearTimeout(o),o=setTimeout(()=>e(...t),300)});async function c(e){let t=e.join(" ");return t.length<4||!l?[]:new Promise(e=>{u(t,e)})}let{Interface:d}=r.default.interface;class S extends d{constructor(){super("org.gnome.Shell.SearchProvider2")}async GetInitialResultSet(e){return c(e)}async GetSubsearchResultSet(e,t){return c(t)}async GetResultMetas(e){let t=r.default.Variant,n=[];for(let r of e){let e=a.get(r);if(e){let a={id:new t("s",r),name:new t("s",e.title),description:new t("s",e.subtitle)};e.image&&(a.gicon=new t("s",e.image)),n.push(a)}}return n}async ActivateResult(e,t,r){let n=a.get(e);if(n&&s)try{if(n.actions.length>0){let e=n.actions.find(e=>"Play Now"===e.title)||n.actions.find(e=>"Shuffle"===e.title)||n.actions[0];await s(n.item_key,n.sessionKey,n.category_key,n.index,e.title),console.log(`Playing: ${n.title}`)}}catch(e){console.error("Failed to play track:",e)}}async LaunchSearch(e,t){console.log("LaunchSearch called - not implemented")}}async function g(e,t){l=e,s=t;try{let e=r.default.sessionBus();await e.requestName(n,0);let t=new S;e.export("/com/bluemancz/RoonPipe/SearchProvider",t),console.log("GNOME Search Provider initialized on",n)}catch(e){console.error("Failed to initialize GNOME Search Provider:",e)}}S.configureMembers({methods:{GetInitialResultSet:{inSignature:"as",outSignature:"as"},GetSubsearchResultSet:{inSignature:"asas",outSignature:"as"},GetResultMetas:{inSignature:"as",outSignature:"aa{sv}"},ActivateResult:{inSignature:"sasu",outSignature:""},LaunchSearch:{inSignature:"asu",outSignature:""}}});
+"use strict";var e,t;Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"initGnomeSearchProvider",{enumerable:!0,get:function(){return S}});let r=(t=require("dbus-next"))&&t.__esModule?t:{default:t},n="com.bluemancz.RoonPipe.SearchProvider",a=new Map,i=new Map,o=null,l=null,s=null,u=(e=async(e,t)=>{let r=i.get(e);if(r)return void t(r);try{if(!l)return void t([]);let r=await l(e),n=[];for(let e of r.slice(0,5)){let t=`roon_${e.item_key}`;a.set(t,e),n.push(t)}i.set(e,n),t(n)}catch(e){console.error("Search failed:",e),t([])}},(...t)=>{o&&clearTimeout(o),o=setTimeout(()=>e(...t),300)});async function c(e){let t=e.join(" ");return t.length<4||!l?[]:new Promise(e=>{u(t,e)})}let{Interface:d}=r.default.interface;class g extends d{constructor(){super("org.gnome.Shell.SearchProvider2")}async GetInitialResultSet(e){return c(e)}async GetSubsearchResultSet(e,t){return c(t)}async GetResultMetas(e){let t=r.default.Variant,n=[];for(let r of e){let e=a.get(r);if(e){let a={id:new t("s",r),name:new t("s",e.title),description:new t("s",e.subtitle)};e.image&&(a.gicon=new t("s",e.image)),n.push(a)}}return n}async ActivateResult(e,t,r){let n=a.get(e);if(n&&s)try{if(n.actions.length>0){let e=n.actions.find(e=>"Play Now"===e.title)||n.actions.find(e=>"Shuffle"===e.title)||n.actions[0];await s(n.item_key,n.sessionKey,n.category_key,n.index,e.title,n.title,n.type,n.image_key),console.log(`Playing: ${n.title}`)}}catch(e){console.error("Failed to play track:",e)}}async LaunchSearch(e,t){console.log("LaunchSearch called - not implemented")}}async function S(e,t){l=e,s=t;try{let e=r.default.sessionBus();await e.requestName(n,0);let t=new g;e.export("/com/bluemancz/RoonPipe/SearchProvider",t),console.log("GNOME Search Provider initialized on",n)}catch(e){console.error("Failed to initialize GNOME Search Provider:",e)}}g.configureMembers({methods:{GetInitialResultSet:{inSignature:"as",outSignature:"as"},GetSubsearchResultSet:{inSignature:"asas",outSignature:"as"},GetResultMetas:{inSignature:"as",outSignature:"aa{sv}"},ActivateResult:{inSignature:"sasu",outSignature:""},LaunchSearch:{inSignature:"asu",outSignature:""}}});

package/dist/index.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});let e=require("node:child_process"),o=require("node:fs"),r=require("node:path"),n=require("./cli"),s=require("./gnome-search-provider"),i=require("./image-cache"),t=require("./mpris"),a=require("./notification"),c=require("./roon"),l=require("./socket"),u=process.argv.includes("--install-gnome"),d=process.argv.includes("--cli");function p(){return(process.env.XDG_CURRENT_DESKTOP?.includes("GNOME")??!1)||(process.env.DESKTOP_SESSION?.includes("gnome")??!1)}if(u){let o=(0,r.join)(__dirname,"../scripts/install-gnome-search-provider.sh");process.getuid&&0!==process.getuid()?(console.log("To install GNOME Search Provider, you need to run this command as root or with sudo:"),console.log(`sudo bash "${o}"`),process.exit(1)):(console.log("Installing GNOME Search Provider..."),(0,e.execSync)(`bash "${o}"`,{stdio:"inherit"}),process.exit(0))}d?(0,n.startCLI)():(process.getuid&&0===process.getuid()&&(console.error("❌ Running as root. Please run as a regular user for the daemon."),process.exit(1)),(0,l.isInstanceRunning)().then(e=>{e&&(console.error("❌ Another instance of RoonPipe is already running."),console.error("  Stop the existing instance first, or use --cli to connect to it."),process.exit(1)),console.log("Starting RoonPipe Daemon"),(0,i.clearOldCache)(),p()&&((0,o.existsSync)("/usr/share/gnome-shell/search-providers/com.bluemancz.RoonPipe.SearchProvider.ini")||(console.warn("⚠️ GNOME Search Provider not installed."),console.warn("  Run 'roonpipe --install-gnome' to enable searching from GNOME overview."))),(0,t.initMpris)(()=>(0,c.getCore)()?.services.RoonApiTransport,c.getZone),(0,c.initRoon)({onCorePaired:e=>{(0,l.startSocketServer)({search:c.searchRoon,play:c.playItem}),p()&&(0,s.initGnomeSearchProvider)(c.searchRoon,c.playItem)},onCoreUnpaired:e=>{(0,t.updateMprisMetadata)(null,null)},onZoneChanged:(e,o)=>{(0,t.updateMprisMetadata)(e,o),(0,a.showTrackNotification)(e,o)},onSeekChanged:e=>{(0,t.updateMprisSeek)(e)}})}));
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});let e=require("node:child_process"),r=require("node:fs"),o=require("node:path"),n=require("./cli"),s=require("./frequency"),i=require("./gnome-search-provider"),t=require("./image-cache"),a=require("./mpris"),c=require("./notification"),l=require("./roon"),u=require("./socket"),d=process.argv.includes("--install-gnome"),p=process.argv.includes("--cli");function h(){return(process.env.XDG_CURRENT_DESKTOP?.includes("GNOME")??!1)||(process.env.DESKTOP_SESSION?.includes("gnome")??!1)}if(d){let r=(0,o.join)(__dirname,"../scripts/install-gnome-search-provider.sh");process.getuid&&0!==process.getuid()?(console.log("To install GNOME Search Provider, you need to run this command as root or with sudo:"),console.log(`sudo bash "${r}"`),process.exit(1)):(console.log("Installing GNOME Search Provider..."),(0,e.execSync)(`bash "${r}"`,{stdio:"inherit"}),process.exit(0))}p?(0,n.startCLI)():(process.getuid&&0===process.getuid()&&(console.error("❌ Running as root. Please run as a regular user for the daemon."),process.exit(1)),(0,u.isInstanceRunning)().then(e=>{e&&(console.error("❌ Another instance of RoonPipe is already running."),console.error("  Stop the existing instance first, or use --cli to connect to it."),process.exit(1)),console.log("Starting RoonPipe Daemon"),(0,t.clearOldCache)(),(0,s.loadFrequencyData)(),h()&&((0,r.existsSync)("/usr/share/gnome-shell/search-providers/com.bluemancz.RoonPipe.SearchProvider.ini")||(console.warn("⚠️ GNOME Search Provider not installed."),console.warn("  Run 'roonpipe --install-gnome' to enable searching from GNOME overview."))),(0,a.initMpris)(()=>(0,l.getCore)()?.services.RoonApiTransport,l.getZone),(0,l.initRoon)({onCorePaired:e=>{(0,u.startSocketServer)({search:l.searchRoon,play:l.playItem}),h()&&(0,i.initGnomeSearchProvider)(l.searchRoon,l.playItem)},onCoreUnpaired:e=>{(0,a.updateMprisMetadata)(null,null)},onZoneChanged:(e,r)=>{(0,a.updateMprisMetadata)(e,r),(0,c.showTrackNotification)(e,r)},onSeekChanged:e=>{(0,a.updateMprisSeek)(e)}})}));

package/dist/roon.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=exports,t={get getCore(){return g},get getZone(){return y},get initRoon(){return d},get parseNowPlaying(){return _},get playItem(){return p},get searchRoon(){return m}};for(var i in t)Object.defineProperty(e,i,{enumerable:!0,get:Object.getOwnPropertyDescriptor(t,i).get});let n=/*#__PURE__*/s(require("node-roon-api")),o=/*#__PURE__*/s(require("node-roon-api-browse")),r=/*#__PURE__*/s(require("node-roon-api-image")),l=/*#__PURE__*/s(require("node-roon-api-transport")),a=require("./image-cache");function s(e){return e&&e.__esModule?e:{default:e}}let u=null,c=null,_=e=>{let t=e.three_line?.line1||"Unknown Track";return{title:t,artists:e.three_line?.line2?[e.three_line.line2.split(" / ").map(e=>e.trim())[0]]:["Unknown Artist"],album:e.three_line?.line3||""}};function d(e){let t=new n.default({extension_id:"com.bluemancz.roonpipe",display_name:"RoonPipe",display_version:"1.0.7",publisher:"BlueManCZ",email:"your@email.com",website:"https://github.com/bluemancz/roonpipe",log_level:"none",core_paired:t=>{c=t,t.services.RoonApiTransport.subscribe_zones((i,n)=>{if("Subscribed"===i)u=n.zones.find(e=>"playing"===e.state)||n.zones[0],e.onZoneChanged(u,t);else if("Changed"===i){if(n.zones_changed){let i=n.zones_changed.find(e=>"playing"===e.state);i?u=i:u&&(u=n.zones_changed.find(e=>e.zone_id===u.zone_id)||u),e.onZoneChanged(u,t)}if(n.zones_seek_changed){let t=n.zones_seek_changed.find(e=>e.zone_id===u?.zone_id);t&&u?.now_playing&&(u.now_playing.seek_position=t.seek_position,e.onSeekChanged(1e6*t.seek_position))}}}),e.onCorePaired(t),console.log(`Core paired: ${t.display_name}`)},core_unpaired:t=>{u=null,c=null,e.onCoreUnpaired(t),console.log(`Core unpaired: ${t.display_name}`)}});t.init_services({required_services:[o.default,r.default,l.default]}),t.start_discovery()}function f(e,t){return new Promise((i,n)=>{e(t,(e,t)=>{e?n(e):i(t)})})}async function m(e){if(!c)throw Error("Roon Core not connected");if(!u)throw Error("No active zone");let t=c.services.RoonApiBrowse,i=`search_${Date.now()}`,n=(e={})=>({hierarchy:"search",multi_session_key:i,zone_or_output_id:u.zone_id,...e}),o=await f(t.browse.bind(t),n({input:e})),r=await f(t.load.bind(t),n({input:e,offset:0,count:o.list.count})),l=[];for(let e of r.items){if(!e.title)continue;let i=n({item_key:e.item_key}),o=await f(t.browse.bind(t),i),r=await f(t.load.bind(t),{...i,offset:0,count:Math.min(o.list.count,5)}),s=r.items?.map(e=>e.image_key).filter(Boolean)||[],u=await (0,a.cacheImages)(c.services.RoonApiImage,s),_=e.title.toLowerCase(),d=_.includes("composer")||_.includes("artist");l.push({category:e,items:r.items||[],cachedImages:u,isArtistCategory:d})}let s=new Map;for(let{items:e,cachedImages:t,isArtistCategory:i}of l)if(i)for(let i of e){let e=t.get(i.image_key);i.title&&e&&s.set(i.title,e)}let _=[];for(let{category:e,items:t,cachedImages:n,isArtistCategory:o}of l){if(o)continue;let r=function(e){let t=e.toLowerCase();return["artist","album","composer","playlist","track","work"].find(e=>t.includes(e))||"track"}(e.title);for(let o=0;o<t.length;o++){var d;let l=t[o],a="action_list"===l.hint&&"Play Artist"===l.title,u=a?"artist":r,c=function(e,t){let i=[{title:"Play Now"},{title:"Add Next"},{title:"Queue"},{title:"Start Radio"}],n=[{title:"Shuffle"},{title:"Start Radio"}];if("action_list"===t)return"track"===e?i:n;switch(e){case"album":case"track":return i;case"artist":case"composer":return n;case"playlist":return[{title:"Play Now"},{title:"Shuffle"},{title:"Add Next"},{title:"Queue"},{title:"Start Radio"}];default:return[]}}(u,l.hint),f=a?e.title:null,m=n.get(l.image_key)||f&&s.get(f)||null;if(_.push({title:a?e.title:l.title||`Unknown ${u.charAt(0).toUpperCase()+u.slice(1)}`,subtitle:(d=l.subtitle)?d.replace(/\[\[(\d+)\|([^\]]+)]]/g,"$2").split(", ")[0].trim():"",item_key:l.item_key,image:m,hint:l.hint,sessionKey:i,type:u,category_key:e.item_key,index:o,actions:c}),a)break}}return _}async function p(e,t,i,n,o){if(!c)throw Error("Roon Core not connected");if(!u)throw Error("No active zone");let r=c.services.RoonApiBrowse,l=(e,t={})=>({hierarchy:"search",multi_session_key:e,zone_or_output_id:u.zone_id,...t});console.log(`[DEBUG] playItem: itemKey=${e}, categoryKey=${i}, itemIndex=${n}, actionTitle=${o}`),await f(r.browse.bind(r),l(t,{item_key:i}));let a=await f(r.load.bind(r),l(t,{item_key:i,offset:n,count:1}));if(!a.items?.[0])throw Error("Item not found at index");let s=a.items[0].item_key;async function _(e,t,i=0){if(i>5)return!1;let n=await f(r.browse.bind(r),l(t,{item_key:e})),a=n.list?.multi_session_key||t,s=await f(r.load.bind(r),l(a,{item_key:e,offset:0,count:n.list?.count||50}));if(!s.items?.length)return!1;for(let e of s.items){if(console.log(`[DEBUG] Navigating: title=${e.title}, hint=${e.hint}`),"action"===e.hint&&e.title===o)return console.log(`[DEBUG] Found action! Executing: ${e.title} (${e.item_key})`),await f(r.browse.bind(r),l(a,{item_key:e.item_key})),console.log("[DEBUG] Successfully executed action"),!0;if("action_list"===e.hint||"list"===e.hint&&1===s.items.length){if(await _(e.item_key,a,i+1))return!0;if(1===i&&"action_list"===e.hint)break}}return!1}if(console.log(`[DEBUG] Got fresh item_key: ${s}`),!await _(s,t))throw Error(`Could not find action "${o}" to execute`)}function y(){return u}function g(){return c}
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=exports,t={get getCore(){return w},get getZone(){return k},get initRoon(){return m},get parseNowPlaying(){return _},get playItem(){return h},get searchRoon(){return g}};for(var i in t)Object.defineProperty(e,i,{enumerable:!0,get:Object.getOwnPropertyDescriptor(t,i).get});let o=/*#__PURE__*/u(require("node-roon-api")),n=/*#__PURE__*/u(require("node-roon-api-browse")),r=/*#__PURE__*/u(require("node-roon-api-image")),a=/*#__PURE__*/u(require("node-roon-api-transport")),l=require("./frequency"),s=require("./image-cache");function u(e){return e&&e.__esModule?e:{default:e}}let c=null,d=null,_=e=>{let t=e.three_line?.line1||"Unknown Track";return{title:t,artists:e.three_line?.line2?[e.three_line.line2.split(" / ").map(e=>e.trim())[0]]:["Unknown Artist"],album:e.three_line?.line3||""}};function m(e){let t=new o.default({extension_id:"com.bluemancz.roonpipe",display_name:"RoonPipe",display_version:"1.0.9",publisher:"BlueManCZ",email:"your@email.com",website:"https://github.com/bluemancz/roonpipe",log_level:"none",core_paired:t=>{d=t,t.services.RoonApiTransport.subscribe_zones((i,o)=>{if("Subscribed"===i)c=o.zones.find(e=>"playing"===e.state)||o.zones[0],e.onZoneChanged(c,t);else if("Changed"===i){if(o.zones_changed){let i=o.zones_changed.find(e=>"playing"===e.state);i?c=i:c&&(c=o.zones_changed.find(e=>e.zone_id===c.zone_id)||c),e.onZoneChanged(c,t)}if(o.zones_seek_changed){let i=o.zones_seek_changed.find(e=>e.zone_id===c?.zone_id);i&&c?.now_playing&&(c.now_playing.seek_position=i.seek_position,e.onSeekChanged(1e6*i.seek_position),o.zones_changed||"playing"===c.state||(c.state="playing",e.onZoneChanged(c,t)))}}}),e.onCorePaired(t),console.log(`Core paired: ${t.display_name}`)},core_unpaired:t=>{c=null,d=null,e.onCoreUnpaired(t),console.log(`Core unpaired: ${t.display_name}`)}});t.init_services({required_services:[n.default,r.default,a.default]}),t.start_discovery()}function y(e,t){return new Promise((i,o)=>{e(t,(e,t)=>{e?o(e):i(t)})})}function f(e){return e?e.replace(/\[\[(\d+)\|([^\]]+)]]/g,"$2").trim():""}async function g(e){if(!d)throw Error("Roon Core not connected");if(!c)throw Error("No active zone");let t=d.services.RoonApiBrowse,i=`search_${Date.now()}`,o=(e={})=>({hierarchy:"search",multi_session_key:i,zone_or_output_id:c.zone_id,...e}),n=await y(t.browse.bind(t),o({input:e})),r=await y(t.load.bind(t),o({input:e,offset:0,count:n.list.count})),a=[];for(let e of r.items){if(!e.title)continue;let i=o({item_key:e.item_key}),n=await y(t.browse.bind(t),i),r=await y(t.load.bind(t),{...i,offset:0,count:Math.min(n.list.count,5)}),l=r.items?.map(e=>e.image_key).filter(Boolean)||[],u=await (0,s.cacheImages)(d.services.RoonApiImage,l),c=e.title.toLowerCase(),_=c.includes("composer")||c.includes("artist");a.push({category:e,items:r.items||[],cachedImages:u,isArtistCategory:_})}let u=new Map;for(let{items:e,cachedImages:t,isArtistCategory:i}of a)if(i)for(let i of e){let e=t.get(i.image_key);i.title&&e&&u.set(i.title,e)}let _=[],m=new Set;for(let{category:e,items:t,cachedImages:o,isArtistCategory:n}of a){if(n)continue;let r=function(e){let t=e.toLowerCase();return["artist","album","composer","playlist","track","work"].find(e=>t.includes(e))||"track"}(e.title);for(let n=0;n<t.length;n++){let a=t[n],l="action_list"===a.hint&&"Play Artist"===a.title,s=l?"artist":r,c=function(e,t){let i=[{title:"Play Now"},{title:"Add Next"},{title:"Queue"},{title:"Play Album"},{title:"Start Radio"}],o=[{title:"Shuffle"},{title:"Start Radio"}];if("action_list"===t)return"track"===e?i:o;switch(e){case"album":return[{title:"Play Now"},{title:"Add Next"},{title:"Queue"},{title:"Start Radio"}];case"track":return i;case"artist":case"composer":return o;case"playlist":return[{title:"Play Now"},{title:"Shuffle"},{title:"Add Next"},{title:"Queue"},{title:"Start Radio"}];default:return[]}}(s,a.hint),d=`${a.title}::${a.image_key}`;if(m.has(d))continue;m.add(d);let y=l?e.title:null,g=o.get(a.image_key)||y&&u.get(y)||null;if(_.push({title:l?e.title:a.title||`Unknown ${s.charAt(0).toUpperCase()+s.slice(1)}`,subtitle:f(a.subtitle),item_key:a.item_key,image:g,image_key:a.image_key||"",hint:a.hint,sessionKey:i,type:s,category_key:e.item_key,index:n,actions:c}),l)break}}return(0,l.reRankResults)(e,_)}async function h(e,t,i,o,n,r,a,s){if(!d)throw Error("Roon Core not connected");if(!c)throw Error("No active zone");let u=d.services.RoonApiBrowse,_=(e,t={})=>({hierarchy:"search",multi_session_key:e,zone_or_output_id:c.zone_id,...t});if("stored"===t&&r){console.log(`[DEBUG] Resolving stored item: "${r}" (image_key: ${s})`);let e=(await g(r)).find(e=>e.image_key===s&&"stored"!==e.sessionKey);if(!e)throw Error(`Could not find "${r}" in fresh search results`);return h(e.item_key,e.sessionKey,e.category_key,e.index,n,e.title,e.type,e.image_key)}console.log(`[DEBUG] playItem: itemKey=${e}, categoryKey=${i}, itemIndex=${o}, actionTitle=${n}`),await y(u.browse.bind(u),_(t,{item_key:i}));let m=await y(u.load.bind(u),_(t,{item_key:i,offset:o,count:1}));if(!m.items?.[0])throw Error("Item not found at index");let k=m.items[0],w=k.item_key;if(console.log(`[DEBUG] Got fresh item_key: ${w}`),"Play Album"===n){let e=k.image_key;if(!e)throw Error("Track has no image_key — cannot identify album");let t=k.subtitle?.split(", ")[0]?.trim();if(!t)throw Error("Track has no subtitle — cannot determine artist");let i=`album_${Date.now()}`,o=(e={})=>({hierarchy:"search",multi_session_key:i,zone_or_output_id:c.zone_id,...e});console.log(`[DEBUG] Searching for album by artist: "${t}" (track image_key: ${e})`);let n=await y(u.browse.bind(u),o({input:t})),d=await y(u.load.bind(u),o({offset:0,count:n.list.count})),_=d.items?.find(e=>e.title?.toLowerCase()==="albums");if(!_)throw Error("No Albums category found in search results");let m=await y(u.browse.bind(u),o({item_key:_.item_key})),g=await y(u.load.bind(u),o({offset:0,count:Math.min(m.list.count,20)})),h=g.items?.find(t=>t.image_key===e);if(!h)throw Error("Could not find album matching this track's artwork");console.log(`[DEBUG] Found matching album: "${h.title}"`),await y(u.browse.bind(u),o({item_key:h.item_key}));let w=await y(u.load.bind(u),o({offset:0,count:5})),b=w.items?.find(e=>"list"===e.hint);if(!b)throw Error("Could not find album list item");await y(u.browse.bind(u),o({item_key:b.item_key}));let p=await y(u.load.bind(u),o({offset:0,count:30})),E=p.items?.find(e=>"action_list"===e.hint&&"Play Album"===e.title);if(!E)throw Error('Could not find "Play Album" action on the album');await y(u.browse.bind(u),o({item_key:E.item_key}));let $=await y(u.load.bind(u),o({offset:0,count:10})),P=$.items?.find(e=>"action"===e.hint&&"Play Now"===e.title);if(!P)throw Error('Could not find "Play Now" action on album');console.log(`[DEBUG] Playing album: "${h.title}"`),await y(u.browse.bind(u),o({item_key:P.item_key})),console.log("[DEBUG] Successfully started album playback"),(0,l.recordPlay)({title:k.title||r||"",subtitle:f(k.subtitle||""),item_key:"",image:null,image_key:k.image_key||s||"",hint:"",sessionKey:"",type:a||"track",category_key:"",index:0,actions:[]});return}async function b(e,t,i=0){if(i>5)return!1;let o=await y(u.browse.bind(u),_(t,{item_key:e})),r=o.list?.multi_session_key||t,a=await y(u.load.bind(u),_(r,{item_key:e,offset:0,count:o.list?.count||50}));if(!a.items?.length)return!1;for(let e of a.items){if(console.log(`[DEBUG] Navigating: title=${e.title}, hint=${e.hint}`),"action"===e.hint&&e.title===n)return console.log(`[DEBUG] Found action! Executing: ${e.title} (${e.item_key})`),await y(u.browse.bind(u),_(r,{item_key:e.item_key})),console.log("[DEBUG] Successfully executed action"),!0;if("action_list"===e.hint||"list"===e.hint&&1===a.items.length){if(await b(e.item_key,r,i+1))return!0;if(1===i&&"action_list"===e.hint)break}}return!1}if(!await b(w,t))throw Error(`Could not find action "${n}" to execute`);(0,l.recordPlay)({title:k.title||r||"",subtitle:f(k.subtitle||""),item_key:"",image:null,image_key:k.image_key||s||"",hint:"",sessionKey:"",type:a||"track",category_key:"",index:0,actions:[]})}function k(){return c}function w(){return d}

package/dist/socket.js

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=exports,r={get isInstanceRunning(){return c},get startSocketServer(){return l}};for(var t in r)Object.defineProperty(e,t,{enumerable:!0,get:Object.getOwnPropertyDescriptor(r,t).get});let n=/*#__PURE__*/i(require("node:fs")),o=/*#__PURE__*/i(require("node:net"));function i(e){return e&&e.__esModule?e:{default:e}}let s="/tmp/roonpipe.sock";function c(){return new Promise(e=>{if(!n.default.existsSync(s))return void e(!1);let r=o.default.createConnection({path:s},()=>{r.end(),e(!0)});r.on("error",()=>{e(!1)}),r.setTimeout(1e3,()=>{r.destroy(),e(!1)})})}function l(e){n.default.existsSync(s)&&n.default.unlinkSync(s),o.default.createServer(r=>{console.log("Client connected to socket"),r.on("data",async t=>{try{let n=JSON.parse(t.toString());if(console.log("Received request:",n),"search"===n.command){try{let t=await e.search(n.query);r.write(`${JSON.stringify({error:null,results:t})}
 `)}catch(e){r.write(`${JSON.stringify({error:String(e),results:null})}
-`)}r.end()}else if("play"===n.command){try{await e.play(n.item_key,n.session_key,n.category_key,n.item_index,n.action_title),r.write(`${JSON.stringify({error:null,success:!0})}
+`)}r.end()}else if("play"===n.command){try{await e.play(n.item_key,n.session_key,n.category_key,n.item_index,n.action_title,n.item_title,n.item_type,n.item_image_key),r.write(`${JSON.stringify({error:null,success:!0})}
 `)}catch(e){r.write(`${JSON.stringify({error:String(e),success:!1})}
 `)}r.end()}else r.write(`${JSON.stringify({error:"Unknown command"})}
 `),r.end()}catch(e){console.error("Socket error:",e),r.write(`${JSON.stringify({error:"Invalid request format"})}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "roonpipe",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Linux integration for Roon – MPRIS support, media keys, desktop notifications, and interactive search CLI",
   "main": "dist/index.js",
   "bin": {