@walldock/agent 0.1.0

package/dist/wallpaper/linux.js

@@ -0,0 +1,152 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setWallpaperLinux = setWallpaperLinux;
+const node_child_process_1 = require("node:child_process");
+const node_util_1 = require("node:util");
+const fs = __importStar(require("node:fs/promises"));
+const exec = (0, node_util_1.promisify)(node_child_process_1.execFile);
+async function run(cmd, args) {
+    await exec(cmd, args);
+}
+async function tryRun(cmd, args) {
+    try {
+        await run(cmd, args);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function fileUri(p) {
+    return p.startsWith('file://') ? p : `file://${p}`;
+}
+async function gnomeSet(imagePath) {
+    const uri = fileUri(imagePath);
+    await run('gsettings', ['set', 'org.gnome.desktop.background', 'picture-uri', uri]);
+    await tryRun('gsettings', ['set', 'org.gnome.desktop.background', 'picture-uri-dark', uri]);
+}
+async function mateSet(imagePath) {
+    await run('gsettings', ['set', 'org.mate.background', 'picture-filename', imagePath]);
+}
+async function cinnamonSet(imagePath) {
+    await run('gsettings', ['set', 'org.cinnamon.desktop.background', 'picture-uri', fileUri(imagePath)]);
+}
+async function kdeSet(imagePath, monitorIndex, multiMonitor) {
+    if (!multiMonitor) {
+        const ok = await tryRun('plasma-apply-wallpaperimage', [imagePath]);
+        if (ok)
+            return;
+    }
+    const imgJson = JSON.stringify(fileUri(imagePath));
+    const script = `var ds=desktops();if(!ds||ds.length===0){throw "no desktops";}var i=Math.min(${monitorIndex},ds.length-1);var d=ds[i];d.wallpaperPlugin="org.kde.image";d.currentConfigGroup=["Wallpaper","org.kde.image","General"];d.writeConfig("Image",${imgJson});`;
+    for (const dbus of ['qdbus6', 'qdbus']) {
+        if (await tryRun(dbus, ['org.kde.plasmashell', '/PlasmaShell', 'org.kde.PlasmaShell.evaluateScript', script]))
+            return;
+    }
+    throw new Error('KDE PlasmaShell script failed');
+}
+async function xfceSet(imagePath, monitorIndex) {
+    const execPromisified = (0, node_util_1.promisify)(node_child_process_1.execFile);
+    const { stdout } = await execPromisified('xfconf-query', ['-c', 'xfce4-desktop', '-l']);
+    const keys = stdout.split('\n').map(l => l.trim()).filter(l => l.includes('/last-image')).sort();
+    if (keys.length === 0)
+        throw new Error('xfce4-desktop: no last-image keys');
+    const key = keys[monitorIndex % keys.length];
+    const ok = await tryRun('xfconf-query', ['-c', 'xfce4-desktop', '-p', key, '-n', '-t', 'string', '-s', imagePath]);
+    if (!ok)
+        await run('xfconf-query', ['-c', 'xfce4-desktop', '-p', key, '-s', imagePath, '-t', 'string']);
+}
+async function swaySet(imagePath, monitorIndex) {
+    const { stdout } = await exec('swaymsg', ['-t', 'get_outputs']);
+    const outputs = JSON.parse(stdout);
+    const output = outputs[monitorIndex];
+    if (!output)
+        throw new Error(`sway: no output at index ${monitorIndex}`);
+    await run('swaymsg', ['output', output.name, 'bg', imagePath, 'fill']);
+}
+async function hyprlandSet(imagePath, monitorIndex) {
+    const { stdout } = await exec('hyprctl', ['monitors', '-j']);
+    const monitors = JSON.parse(stdout);
+    const monitor = monitors[monitorIndex];
+    if (!monitor)
+        throw new Error(`hyprland: no monitor at index ${monitorIndex}`);
+    await tryRun('hyprctl', ['hyprpaper', 'preload', imagePath]);
+    await run('hyprctl', ['hyprpaper', 'wallpaper', `${monitor.name},${imagePath}`]);
+}
+function detectDesktop() {
+    if (process.env['SWAYSOCK'])
+        return 'sway';
+    if (process.env['HYPRLAND_INSTANCE_SIGNATURE'])
+        return 'hyprland';
+    const xdg = (process.env['XDG_CURRENT_DESKTOP'] ?? '').toUpperCase();
+    for (const token of xdg.split(':')) {
+        if (token.includes('XFCE'))
+            return 'xfce';
+        if (token.includes('KDE'))
+            return 'kde';
+        if (token.includes('MATE'))
+            return 'mate';
+        if (token.includes('CINNAMON') || token.includes('X-CINNAMON'))
+            return 'cinnamon';
+        if (token.includes('GNOME') || token.includes('UNITY') || token.includes('BUDGIE'))
+            return 'gnome';
+    }
+    const session = (process.env['DESKTOP_SESSION'] ?? '').toLowerCase();
+    if (session.includes('xfce'))
+        return 'xfce';
+    if (session.includes('mate'))
+        return 'mate';
+    if (session.includes('cinnamon'))
+        return 'cinnamon';
+    return 'unknown';
+}
+async function setWallpaperLinux(imagePath, monitorIndex, totalMonitors) {
+    // Verify file exists before attempting
+    await fs.access(imagePath);
+    const abs = await fs.realpath(imagePath);
+    const desktop = detectDesktop();
+    const multi = totalMonitors > 1;
+    switch (desktop) {
+        case 'gnome': return gnomeSet(abs);
+        case 'mate': return mateSet(abs);
+        case 'cinnamon': return cinnamonSet(abs);
+        case 'kde': return kdeSet(abs, monitorIndex, multi);
+        case 'xfce': return xfceSet(abs, monitorIndex);
+        case 'sway': return swaySet(abs, monitorIndex);
+        case 'hyprland': return hyprlandSet(abs, monitorIndex);
+        default: throw new Error(`Unsupported desktop environment (XDG_CURRENT_DESKTOP=${process.env['XDG_CURRENT_DESKTOP'] ?? 'unset'})`);
+    }
+}

package/dist/wallpaper/macos.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Set wallpaper on macOS.
+ * Uses osascript System Events `desktop N` where N = monitorIndex + 1.
+ * Matches the order NSScreen.screens returns them (same as our Swift enumeration).
+ */
+export declare function setWallpaperMacOS(imagePath: string, monitorIndex: number): Promise<void>;

package/dist/wallpaper/macos.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setWallpaperMacOS = setWallpaperMacOS;
+const node_child_process_1 = require("node:child_process");
+const node_util_1 = require("node:util");
+const exec = (0, node_util_1.promisify)(node_child_process_1.execFile);
+/**
+ * Set wallpaper on macOS.
+ * Uses osascript System Events `desktop N` where N = monitorIndex + 1.
+ * Matches the order NSScreen.screens returns them (same as our Swift enumeration).
+ */
+async function setWallpaperMacOS(imagePath, monitorIndex) {
+    const desktopN = monitorIndex + 1;
+    const script = `
+tell application "System Events"
+  set picture of desktop ${desktopN} to POSIX file "${imagePath.replace(/"/g, '\\"')}"
+end tell`.trim();
+    await exec('osascript', ['-e', script]);
+}

package/dist/wallpaper/windows.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Set wallpaper on Windows using the IDesktopWallpaper COM interface via inline C# in PowerShell.
+ * monitorIndex maps to GetMonitorDevicePathAt(monitorIndex) — same order as our screen enumeration.
+ */
+export declare function setWallpaperWindows(imagePath: string, monitorIndex: number): Promise<void>;

package/dist/wallpaper/windows.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setWallpaperWindows = setWallpaperWindows;
+const node_child_process_1 = require("node:child_process");
+const node_util_1 = require("node:util");
+const exec = (0, node_util_1.promisify)(node_child_process_1.execFile);
+/**
+ * Set wallpaper on Windows using the IDesktopWallpaper COM interface via inline C# in PowerShell.
+ * monitorIndex maps to GetMonitorDevicePathAt(monitorIndex) — same order as our screen enumeration.
+ */
+async function setWallpaperWindows(imagePath, monitorIndex) {
+    // Escape path for PowerShell string
+    const safePath = imagePath.replace(/'/g, "''");
+    const script = `
+$ErrorActionPreference = 'Stop'
+Add-Type @"
+using System;
+using System.Runtime.InteropServices;
+
+[ComImport, Guid("B92B56A9-8B55-4E14-9A89-0199BBB6F93B"),
+ InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+public interface IDesktopWallpaper {
+  void SetWallpaper([MarshalAs(UnmanagedType.LPWStr)] string monitorID,
+                    [MarshalAs(UnmanagedType.LPWStr)] string wallpaper);
+  [return: MarshalAs(UnmanagedType.LPWStr)]
+  string GetWallpaper([MarshalAs(UnmanagedType.LPWStr)] string monitorID);
+  [return: MarshalAs(UnmanagedType.LPWStr)]
+  string GetMonitorDevicePathAt(uint monitorIndex);
+  [return: MarshalAs(UnmanagedType.U4)]
+  uint GetMonitorDevicePathCount();
+  void GetMonitorRECT([MarshalAs(UnmanagedType.LPWStr)] string monitorID,
+                      out tagRECT displayRect);
+  void SetBackgroundColor(uint color);
+  uint GetBackgroundColor();
+  void SetPosition(int position);
+  int GetPosition();
+  void SetSlideshow(object items);
+  void GetSlideshow(out object items);
+  void SetSlideshowOptions(int options, uint tick);
+  void GetSlideshowOptions(out int options, out uint tick);
+  void AdvanceSlideshow([MarshalAs(UnmanagedType.LPWStr)] string monitorID, int direction);
+  int GetStatus([MarshalAs(UnmanagedType.LPWStr)] string monitorID);
+  bool Enable(bool enable);
+}
+
+[StructLayout(LayoutKind.Sequential)]
+public struct tagRECT { public int left, top, right, bottom; }
+
+[ComImport, Guid("C2CF3110-460E-4FC1-B9D0-8A1C0C9CC4BD")]
+public class DesktopWallpaperClass {}
+"@
+$wt = [System.Activator]::CreateInstance([Type]::GetTypeFromCLSID([Guid]'C2CF3110-460E-4FC1-B9D0-8A1C0C9CC4BD'))
+$wp = [IDesktopWallpaper]$wt
+$monPath = $wp.GetMonitorDevicePathAt(${monitorIndex})
+$wp.SetWallpaper($monPath, '${safePath}')
+`.trim();
+    await exec('powershell.exe', ['-NoProfile', '-Command', script]);
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@walldock/agent",
+  "version": "0.1.0",
+  "description": "Walldock desktop agent — sync wallpapers across all your screens",
+  "license": "MIT",
+  "main": "dist/main.js",
+  "bin": {
+    "walldock-agent": "dist/main.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "keytar": "^7.9.0"
+  },
+  "devDependencies": {
+    "@types/keytar": "^4.4.2",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/main.js"
+  }
+}