kitowall 2.0.0 → 2.2.0

package/dist/cli.js

@@ -118,6 +118,8 @@ Commands:
                                          Show system logs (requests/downloads/errors)
   logs clear                             Clear system logs
   we config set-api-key <key>            Save Steam Web API key (~/.config/kitowall/we.json)
+  we config get-steam-roots              Show configured manual Steam roots
+  we config set-steam-roots <a,b,c>      Save manual Steam roots (steam root or workshop/content/431960)
   we search [--text <q>] [--tags <a,b>] [--sort <top|newest|trend|subscribed|updated>] [--page <n>] [--page-size <n>] [--days <n>] [--fixtures]
                                          Search Wallpaper Engine workshop items (appid 431960)
   we details <publishedfileid> [--fixtures]
@@ -127,6 +129,9 @@ Commands:
   we job <job_id>                        Show one download job
   we jobs [--limit <n>]                  List recent download jobs
   we library                             List downloaded workshop items
+  we scan-steam                          Detect Steam workshop folders and list downloaded ids
+  we sync-steam                          Sync local Steam Workshop 431960 items into Kitsune downloads
+  we app-status                          Detect if Wallpaper Engine (AppID 431960) is installed
   we coexist enter|exit|status           Temporarily stop/restore wallpaper rotation services
   check [--namespace <ns>] [--json]        Quick system check (no changes)
 
@@ -303,14 +308,26 @@ async function main() {
         }
         if (action === 'config') {
             const sub = cleanOpt(args[2] ?? null);
-            if (sub !== 'set-api-key')
-                throw new Error('Usage: we config set-api-key <key>');
-            const key = cleanOpt(args[3] ?? null);
-            if (!key)
-                throw new Error('Usage: we config set-api-key <key>');
-            (0, workshop_1.setWorkshopApiKey)(key);
-            console.log(JSON.stringify({ ok: true, updated: 'steamWebApiKey' }, null, 2));
-            return;
+            if (sub === 'set-api-key') {
+                const key = cleanOpt(args[3] ?? null);
+                if (!key)
+                    throw new Error('Usage: we config set-api-key <key>');
+                (0, workshop_1.setWorkshopApiKey)(key);
+                console.log(JSON.stringify({ ok: true, updated: 'steamWebApiKey' }, null, 2));
+                return;
+            }
+            if (sub === 'get-steam-roots') {
+                console.log(JSON.stringify({ ok: true, ...(0, workshop_1.workshopGetSteamRoots)() }, null, 2));
+                return;
+            }
+            if (sub === 'set-steam-roots') {
+                const raw = cleanOpt(args[3] ?? null) ?? '';
+                const roots = raw ? raw.split(',').map(v => v.trim()).filter(Boolean) : [];
+                const out = (0, workshop_1.workshopSetSteamRoots)(roots);
+                console.log(JSON.stringify(out, null, 2));
+                return;
+            }
+            throw new Error('Usage: we config <set-api-key|get-steam-roots|set-steam-roots> ...');
         }
         if (action === 'search') {
             const text = cleanOpt(getOptionValue(args, '--text'));
@@ -386,6 +403,21 @@ async function main() {
             console.log(JSON.stringify(out, null, 2));
             return;
         }
+        if (action === 'scan-steam') {
+            const out = (0, workshop_1.workshopScanSteamDownloads)();
+            console.log(JSON.stringify({ ok: true, ...out }, null, 2));
+            return;
+        }
+        if (action === 'sync-steam') {
+            const out = (0, workshop_1.workshopSyncSteamDownloads)();
+            console.log(JSON.stringify(out, null, 2));
+            return;
+        }
+        if (action === 'app-status') {
+            const out = (0, workshop_1.workshopWallpaperEngineStatus)();
+            console.log(JSON.stringify(out, null, 2));
+            return;
+        }
         if (action === 'coexist') {
             const sub = cleanOpt(args[2] ?? null);
             if (sub === 'enter') {
@@ -405,7 +437,7 @@ async function main() {
             }
             throw new Error('Usage: we coexist <enter|exit|status>');
         }
-        throw new Error('Usage: we <config|search|details|download|job|jobs|library|run-job|coexist> ...');
+        throw new Error('Usage: we <config|search|details|download|job|jobs|library|scan-steam|sync-steam|app-status|run-job|coexist> ...');
     }
     // Regular commands (need config/state)
     const config = (0, config_1.loadConfig)();

package/dist/core/workshop.js

@@ -4,6 +4,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setWorkshopApiKey = setWorkshopApiKey;
+exports.workshopGetSteamRoots = workshopGetSteamRoots;
+exports.workshopSetSteamRoots = workshopSetSteamRoots;
+exports.workshopWallpaperEngineStatus = workshopWallpaperEngineStatus;
+exports.workshopScanSteamDownloads = workshopScanSteamDownloads;
+exports.workshopSyncSteamDownloads = workshopSyncSteamDownloads;
 exports.workshopSearch = workshopSearch;
 exports.workshopDetails = workshopDetails;
 exports.workshopQueueDownload = workshopQueueDownload;
@@ -74,6 +79,16 @@ function readWeConfig() {
         return {};
     }
 }
+function normalizePath(input) {
+    const raw = clean(input) ?? '';
+    if (!raw)
+        return '';
+    if (raw === '~')
+        return node_os_1.default.homedir();
+    if (raw.startsWith('~/'))
+        return node_path_1.default.join(node_os_1.default.homedir(), raw.slice(2));
+    return raw;
+}
 function setWorkshopApiKey(apiKey) {
     const key = clean(apiKey);
     if (!key)
@@ -84,6 +99,20 @@ function setWorkshopApiKey(apiKey) {
     (0, fs_1.writeJson)(p, current);
     return { ok: true };
 }
+function workshopGetSteamRoots() {
+    const cfg = readWeConfig();
+    const steamRoots = Array.isArray(cfg.steamRoots)
+        ? cfg.steamRoots.map(v => normalizePath(String(v))).filter(Boolean)
+        : [];
+    return { steam_roots: Array.from(new Set(steamRoots)) };
+}
+function workshopSetSteamRoots(roots) {
+    const cfg = readWeConfig();
+    const normalized = roots.map(v => normalizePath(String(v))).filter(Boolean);
+    cfg.steamRoots = Array.from(new Set(normalized));
+    (0, fs_1.writeJson)(getWeConfigPath(), cfg);
+    return { ok: true, steam_roots: cfg.steamRoots };
+}
 function getSteamWebApiKey() {
     const envKey = clean(process.env.STEAM_WEB_API_KEY) ?? clean(process.env.KITOWALL_STEAM_WEB_API_KEY);
     if (envKey)
@@ -322,6 +351,229 @@ function writeMetaFile(meta) {
         cached_at: now()
     });
 }
+function readLibraryFoldersVdf(vdfPath) {
+    if (!node_fs_1.default.existsSync(vdfPath))
+        return [];
+    const raw = node_fs_1.default.readFileSync(vdfPath, 'utf8');
+    const out = [];
+    const lines = raw.split('\n');
+    for (const line of lines) {
+        const m = line.match(/"path"\s+"([^"]+)"/);
+        if (!m || !m[1])
+            continue;
+        const candidate = m[1].replace(/\\\\/g, '\\');
+        out.push(candidate);
+    }
+    return out;
+}
+function getDefaultSteamRoots() {
+    const home = node_os_1.default.homedir();
+    const roots = [
+        node_path_1.default.join(home, '.steam', 'steam'),
+        node_path_1.default.join(home, '.local', 'share', 'Steam'),
+        node_path_1.default.join(home, '.var', 'app', 'com.valvesoftware.Steam', '.local', 'share', 'Steam')
+    ];
+    return Array.from(new Set(roots));
+}
+function getManualSteamRoots() {
+    const cfg = readWeConfig();
+    if (!Array.isArray(cfg.steamRoots))
+        return [];
+    return cfg.steamRoots.map(v => normalizePath(String(v))).filter(Boolean);
+}
+function detectSteamappsDirs() {
+    const steamappsSet = new Set();
+    const candidateRoots = [...getDefaultSteamRoots(), ...getManualSteamRoots()];
+    for (const root of candidateRoots) {
+        const p = normalizePath(root);
+        if (!p || !node_fs_1.default.existsSync(p))
+            continue;
+        if (node_path_1.default.basename(p) === 'steamapps' && node_fs_1.default.existsSync(p)) {
+            steamappsSet.add(p);
+        }
+        const directSteamapps = node_path_1.default.join(p, 'steamapps');
+        if (node_fs_1.default.existsSync(directSteamapps)) {
+            steamappsSet.add(directSteamapps);
+        }
+        const marker = `${node_path_1.default.sep}steamapps${node_path_1.default.sep}workshop${node_path_1.default.sep}content${node_path_1.default.sep}${WE_APP_ID}`;
+        const idx = p.indexOf(marker);
+        if (idx >= 0) {
+            const steamapps = p.slice(0, idx + `${node_path_1.default.sep}steamapps`.length);
+            if (node_fs_1.default.existsSync(steamapps))
+                steamappsSet.add(steamapps);
+        }
+        const markerNoSteamapps = `${node_path_1.default.sep}workshop${node_path_1.default.sep}content${node_path_1.default.sep}${WE_APP_ID}`;
+        const idx2 = p.indexOf(markerNoSteamapps);
+        if (idx2 >= 0) {
+            const steamappsMaybe = p.slice(0, idx2);
+            if (node_path_1.default.basename(steamappsMaybe) === 'steamapps' && node_fs_1.default.existsSync(steamappsMaybe)) {
+                steamappsSet.add(steamappsMaybe);
+            }
+        }
+    }
+    const baseSteamapps = Array.from(steamappsSet);
+    for (const steamapps of baseSteamapps) {
+        const vdf = node_path_1.default.join(steamapps, 'libraryfolders.vdf');
+        for (const lib of readLibraryFoldersVdf(vdf)) {
+            const candidate = node_path_1.default.join(lib, 'steamapps');
+            if (node_fs_1.default.existsSync(candidate))
+                steamappsSet.add(candidate);
+        }
+    }
+    return Array.from(steamappsSet);
+}
+function toWorkshopAppContentDir(inputPath) {
+    const p = normalizePath(inputPath);
+    if (!p)
+        return '';
+    const direct = p;
+    const asSteamRoot = node_path_1.default.join(p, 'steamapps', 'workshop', 'content', String(WE_APP_ID));
+    const asSteamappsRoot = node_path_1.default.join(p, 'workshop', 'content', String(WE_APP_ID));
+    const asContentRoot = node_path_1.default.join(p, String(WE_APP_ID));
+    if (node_fs_1.default.existsSync(direct) && direct.endsWith(`${node_path_1.default.sep}${WE_APP_ID}`))
+        return direct;
+    if (node_fs_1.default.existsSync(direct) && direct.includes(`${node_path_1.default.sep}workshop${node_path_1.default.sep}content${node_path_1.default.sep}${WE_APP_ID}`))
+        return direct;
+    if (node_fs_1.default.existsSync(asSteamRoot))
+        return asSteamRoot;
+    if (node_fs_1.default.existsSync(asSteamappsRoot))
+        return asSteamappsRoot;
+    if (node_fs_1.default.existsSync(asContentRoot))
+        return asContentRoot;
+    return '';
+}
+function detectSteamWorkshopContentDirs() {
+    const discovered = new Set();
+    for (const root of getManualSteamRoots()) {
+        const fromManual = toWorkshopAppContentDir(root);
+        if (fromManual && node_fs_1.default.existsSync(fromManual))
+            discovered.add(fromManual);
+    }
+    for (const steamapps of detectSteamappsDirs()) {
+        const candidate = node_path_1.default.join(steamapps, 'workshop', 'content', String(WE_APP_ID));
+        if (node_fs_1.default.existsSync(candidate)) {
+            discovered.add(candidate);
+        }
+    }
+    return Array.from(discovered);
+}
+function workshopWallpaperEngineStatus() {
+    const manifests = [];
+    const steamapps = detectSteamappsDirs();
+    for (const dir of steamapps) {
+        const manifest = node_path_1.default.join(dir, `appmanifest_${WE_APP_ID}.acf`);
+        if (node_fs_1.default.existsSync(manifest))
+            manifests.push(manifest);
+    }
+    return {
+        ok: true,
+        installed: manifests.length > 0,
+        manifests,
+        steamapps
+    };
+}
+function findPreviewCandidate(dir) {
+    if (!node_fs_1.default.existsSync(dir))
+        return undefined;
+    const entries = node_fs_1.default.readdirSync(dir, { withFileTypes: true });
+    const preferred = ['preview.gif', 'preview.webm', 'preview.mp4', 'preview.jpg', 'preview.png', 'preview.webp'];
+    for (const name of preferred) {
+        const full = node_path_1.default.join(dir, name);
+        if (node_fs_1.default.existsSync(full) && node_fs_1.default.statSync(full).isFile())
+            return full;
+    }
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        const lower = entry.name.toLowerCase();
+        if (lower.startsWith('preview.') || lower.startsWith('thumbnail.')) {
+            return node_path_1.default.join(dir, entry.name);
+        }
+    }
+    return undefined;
+}
+function workshopScanSteamDownloads() {
+    const sources = detectSteamWorkshopContentDirs();
+    const idsSet = new Set();
+    for (const source of sources) {
+        if (!node_fs_1.default.existsSync(source))
+            continue;
+        const entries = node_fs_1.default.readdirSync(source, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const id = clean(entry.name);
+            if (!id)
+                continue;
+            idsSet.add(id);
+        }
+    }
+    const ids = Array.from(idsSet).sort();
+    return { sources, count: ids.length, ids };
+}
+function workshopSyncSteamDownloads() {
+    const app = workshopWallpaperEngineStatus();
+    if (!app.installed) {
+        throw new Error('Wallpaper Engine (AppID 431960) is not installed in Steam. Install it first to sync downloads.');
+    }
+    const paths = getWePaths();
+    ensureWePaths(paths);
+    const sources = detectSteamWorkshopContentDirs();
+    let imported = 0;
+    let skipped = 0;
+    const seen = new Set();
+    for (const source of sources) {
+        if (!node_fs_1.default.existsSync(source))
+            continue;
+        const entries = node_fs_1.default.readdirSync(source, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const id = clean(entry.name);
+            if (!id || seen.has(id))
+                continue;
+            seen.add(id);
+            const sourceDir = node_path_1.default.join(source, id);
+            const targetDir = node_path_1.default.join(paths.downloads, id);
+            if (node_fs_1.default.existsSync(targetDir)) {
+                skipped += 1;
+            }
+            else {
+                node_fs_1.default.cpSync(sourceDir, targetDir, { recursive: true });
+                imported += 1;
+            }
+            const metadataFile = node_path_1.default.join(paths.metadata, `${id}.json`);
+            if (!node_fs_1.default.existsSync(metadataFile)) {
+                const previewCandidate = findPreviewCandidate(sourceDir);
+                let thumbLocal;
+                if (previewCandidate && node_fs_1.default.existsSync(previewCandidate)) {
+                    const ext = node_path_1.default.extname(previewCandidate) || '.jpg';
+                    const previewDir = node_path_1.default.join(paths.previews, id);
+                    (0, fs_1.ensureDir)(previewDir);
+                    thumbLocal = node_path_1.default.join(previewDir, `thumb${ext}`);
+                    if (!node_fs_1.default.existsSync(thumbLocal)) {
+                        node_fs_1.default.copyFileSync(previewCandidate, thumbLocal);
+                    }
+                }
+                writeMetaFile({
+                    id,
+                    title: `Wallpaper ${id}`,
+                    tags: [],
+                    preview_thumb_local: thumbLocal,
+                    author_name: 'Steam Workshop',
+                    time_updated: Math.floor(Date.now() / 1000)
+                });
+            }
+        }
+    }
+    return {
+        ok: true,
+        sources,
+        imported,
+        skipped,
+        total: imported + skipped
+    };
+}
 async function workshopSearch(input) {
     const paths = getWePaths();
     ensureWePaths(paths);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kitowall",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "description": "CLI/daemon for Hyprland wallpapers using swww with pack-based rotation.",
   "license": "SEE LICENSE IN LICENSE.md",
   "type": "commonjs",