kitowall 3.1.0 → 3.3.0

package/dist/cli.js

@@ -55,6 +55,7 @@ const staticUrl_1 = require("./adapters/staticUrl");
 const logs_1 = require("./core/logs");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
+const exec_1 = require("./utils/exec");
 const workshop_1 = require("./core/workshop");
 const live_1 = require("./core/live");
 function getCliVersion() {
@@ -159,17 +160,11 @@ Commands:
   live remove <id> [--delete-files]
   live thumb regen [--id <id>] [--all]
   live open [--id <id>]                   Print folder path (root or item folder)
+  live service-autostart <install|enable|disable|start|stop|restart|status>
   live config show
-  live config wallpaper-show --id <id>
-  live config wallpaper --id <id> [--keep-services true|false] [--mute-audio true|false] [--profile performance|balanced|quality]
-                        [--display-fps <n|off>] [--seamless-loop true|false] [--loop-crossfade true|false]
-                        [--loop-crossfade-seconds <n>] [--optimize true|false]
-                        [--proxy-width <n>] [--proxy-fps <n>] [--proxy-crf <n>]
   live config runner [--bin-name <name>]
-  live config apply-defaults [--keep-services true|false] [--mute-audio true|false] [--display-fps <n|off>]
-                             [--proxy-width-hd <n>] [--proxy-width-4k <n>] [--proxy-fps <n>] [--proxy-crf-hd <n>] [--proxy-crf-4k <n>]
-                             [--loop-crossfade-seconds <n>] [--profile performance|balanced|quality]
-                             [--seamless-loop true|false] [--loop-crossfade true|false] [--optimize true|false]
+  live config apply-defaults [--video-fps <n>] [--video-speed <n>] [--hwaccel auto|nvdec|vaapi|none]
+                             [--quality low|medium|high|ultra] [--pause-on-steam-game true|false] [--steam-poll-ms <n>]
   live doctor [--fix]
   check [--namespace <ns>] [--json]        Quick system check (no changes)
 
@@ -266,6 +261,21 @@ function formatError(err) {
     }
     return { message, hint, code };
 }
+async function switchToStaticWallpaperMode() {
+    const liveBin = cleanOpt(process.env.KITOWALL_LIVE_RUNNER_BIN ?? null) ?? 'kitsune-rendercore';
+    try {
+        await (0, exec_1.run)(liveBin, ['service', 'disable'], { timeoutMs: 20000 });
+    }
+    catch {
+        // best effort
+    }
+    try {
+        await (0, workshop_1.workshopCoexistenceExit)();
+    }
+    catch {
+        // best effort
+    }
+}
 async function main() {
     const args = process.argv.slice(2);
     outputJsonOnError = args.includes('--json');
@@ -511,7 +521,7 @@ async function main() {
     if (cmd === 'live') {
         const action = cleanOpt(args[1] ?? null);
         if (!action)
-            throw new Error('Usage: live <init|list|browse|search|resolve|preview|preview-clear|fetch|apply|auto-apply|favorite|remove|thumb|open|config|doctor> ...');
+            throw new Error('Usage: live <init|list|browse|search|resolve|preview|preview-clear|fetch|apply|auto-apply|favorite|remove|thumb|open|service-autostart|config|doctor> ...');
         if (action === 'init') {
             console.log(JSON.stringify((0, live_1.liveInit)(), null, 2));
             return;
@@ -652,6 +662,21 @@ async function main() {
             console.log(JSON.stringify(out, null, 2));
             return;
         }
+        if (action === 'service-autostart') {
+            const sub = cleanOpt(args[2] ?? null);
+            if (sub !== 'install' &&
+                sub !== 'enable' &&
+                sub !== 'disable' &&
+                sub !== 'status' &&
+                sub !== 'start' &&
+                sub !== 'stop' &&
+                sub !== 'restart') {
+                throw new Error('Usage: live service-autostart <install|enable|disable|start|stop|restart|status>');
+            }
+            const out = await (0, live_1.liveServiceAutostart)(sub);
+            console.log(JSON.stringify(out, null, 2));
+            return;
+        }
         if (action === 'doctor') {
             const out = await (0, live_1.liveDoctor)({ fix: args.includes('--fix') });
             console.log(JSON.stringify(out, null, 2));
@@ -663,39 +688,6 @@ async function main() {
                 console.log(JSON.stringify((0, live_1.liveGetConfig)(), null, 2));
                 return;
             }
-            if (sub === 'wallpaper-show') {
-                const id = cleanOpt(getOptionValue(args, '--id'));
-                if (!id)
-                    throw new Error('Usage: live config wallpaper-show --id <id>');
-                console.log(JSON.stringify((0, live_1.liveGetWallpaperConfig)(id), null, 2));
-                return;
-            }
-            if (sub === 'wallpaper') {
-                const id = cleanOpt(getOptionValue(args, '--id'));
-                if (!id) {
-                    throw new Error('Usage: live config wallpaper --id <id> [--keep-services true|false] [--mute-audio true|false] [--profile performance|balanced|quality] [--display-fps <n|off>] [--seamless-loop true|false] [--loop-crossfade true|false] [--loop-crossfade-seconds <n>] [--optimize true|false] [--proxy-width <n>] [--proxy-fps <n>] [--proxy-crf <n>]');
-                }
-                const profile = cleanOpt(getOptionValue(args, '--profile'));
-                const displayFpsRaw = cleanOpt(getOptionValue(args, '--display-fps'));
-                const display_fps = !displayFpsRaw
-                    ? undefined
-                    : (displayFpsRaw.toLowerCase() === 'off' ? null : Number(displayFpsRaw));
-                const out = (0, live_1.liveSetWallpaperConfig)(id, {
-                    keep_services: parseBool(getOptionValue(args, '--keep-services')),
-                    mute_audio: parseBool(getOptionValue(args, '--mute-audio')),
-                    profile: (profile === 'performance' || profile === 'balanced' || profile === 'quality') ? profile : undefined,
-                    display_fps: (display_fps === undefined || display_fps === null || Number.isFinite(display_fps)) ? display_fps : undefined,
-                    seamless_loop: parseBool(getOptionValue(args, '--seamless-loop')),
-                    loop_crossfade: parseBool(getOptionValue(args, '--loop-crossfade')),
-                    loop_crossfade_seconds: cleanOpt(getOptionValue(args, '--loop-crossfade-seconds')) ? Number(cleanOpt(getOptionValue(args, '--loop-crossfade-seconds'))) : undefined,
-                    optimize: parseBool(getOptionValue(args, '--optimize')),
-                    proxy_width: cleanOpt(getOptionValue(args, '--proxy-width')) ? Number(cleanOpt(getOptionValue(args, '--proxy-width'))) : undefined,
-                    proxy_fps: cleanOpt(getOptionValue(args, '--proxy-fps')) ? Number(cleanOpt(getOptionValue(args, '--proxy-fps'))) : undefined,
-                    proxy_crf: cleanOpt(getOptionValue(args, '--proxy-crf')) ? Number(cleanOpt(getOptionValue(args, '--proxy-crf'))) : undefined
-                });
-                console.log(JSON.stringify(out, null, 2));
-                return;
-            }
             if (sub === 'runner') {
                 const out = (0, live_1.liveSetRunner)({
                     bin_name: cleanOpt(getOptionValue(args, '--bin-name')) ?? undefined
@@ -704,24 +696,13 @@ async function main() {
                 return;
             }
             if (sub === 'apply-defaults') {
-                const displayFpsRaw = cleanOpt(getOptionValue(args, '--display-fps'));
-                const display_fps = !displayFpsRaw
-                    ? undefined
-                    : (displayFpsRaw.toLowerCase() === 'off' ? null : Number(displayFpsRaw));
                 const out = (0, live_1.liveSetApplyDefaults)({
-                    keep_services: parseBool(getOptionValue(args, '--keep-services')),
-                    mute_audio: parseBool(getOptionValue(args, '--mute-audio')),
-                    profile: cleanOpt(getOptionValue(args, '--profile')) ?? undefined,
-                    display_fps: (display_fps === undefined || display_fps === null || Number.isFinite(display_fps)) ? display_fps : undefined,
-                    seamless_loop: parseBool(getOptionValue(args, '--seamless-loop')),
-                    loop_crossfade: parseBool(getOptionValue(args, '--loop-crossfade')),
-                    loop_crossfade_seconds: cleanOpt(getOptionValue(args, '--loop-crossfade-seconds')) ? Number(cleanOpt(getOptionValue(args, '--loop-crossfade-seconds'))) : undefined,
-                    optimize: parseBool(getOptionValue(args, '--optimize')),
-                    proxy_width_hd: cleanOpt(getOptionValue(args, '--proxy-width-hd')) ? Number(cleanOpt(getOptionValue(args, '--proxy-width-hd'))) : undefined,
-                    proxy_width_4k: cleanOpt(getOptionValue(args, '--proxy-width-4k')) ? Number(cleanOpt(getOptionValue(args, '--proxy-width-4k'))) : undefined,
-                    proxy_fps: cleanOpt(getOptionValue(args, '--proxy-fps')) ? Number(cleanOpt(getOptionValue(args, '--proxy-fps'))) : undefined,
-                    proxy_crf_hd: cleanOpt(getOptionValue(args, '--proxy-crf-hd')) ? Number(cleanOpt(getOptionValue(args, '--proxy-crf-hd'))) : undefined,
-                    proxy_crf_4k: cleanOpt(getOptionValue(args, '--proxy-crf-4k')) ? Number(cleanOpt(getOptionValue(args, '--proxy-crf-4k'))) : undefined
+                    video_fps: cleanOpt(getOptionValue(args, '--video-fps')) ? Number(cleanOpt(getOptionValue(args, '--video-fps'))) : undefined,
+                    video_speed: cleanOpt(getOptionValue(args, '--video-speed')) ? Number(cleanOpt(getOptionValue(args, '--video-speed'))) : undefined,
+                    hwaccel: cleanOpt(getOptionValue(args, '--hwaccel')) ?? undefined,
+                    quality: cleanOpt(getOptionValue(args, '--quality')) ?? undefined,
+                    pause_on_steam_game: parseBool(getOptionValue(args, '--pause-on-steam-game')),
+                    steam_poll_ms: cleanOpt(getOptionValue(args, '--steam-poll-ms')) ? Number(cleanOpt(getOptionValue(args, '--steam-poll-ms'))) : undefined
                 });
                 console.log(JSON.stringify(out, null, 2));
                 return;
@@ -732,7 +713,7 @@ async function main() {
             console.log(JSON.stringify((0, live_1.liveViewData)(), null, 2));
             return;
         }
-        throw new Error('Usage: live <init|list|browse|search|resolve|preview|preview-clear|fetch|apply|auto-apply|favorite|remove|thumb|open|config|doctor> ...');
+        throw new Error('Usage: live <init|list|browse|search|resolve|preview|preview-clear|fetch|apply|auto-apply|favorite|remove|thumb|open|service-autostart|config|doctor> ...');
     }
     // Regular commands (need config/state)
     const config = (0, config_1.loadConfig)();
@@ -1514,6 +1495,7 @@ async function main() {
         state.mode = value;
         state.last_updated = Date.now();
         (0, state_1.saveState)(state);
+        await switchToStaticWallpaperMode();
         console.log(JSON.stringify({ ok: true, mode: state.mode }, null, 2));
         return;
     }
@@ -1531,6 +1513,7 @@ async function main() {
             }, null, 2));
             return;
         }
+        await switchToStaticWallpaperMode();
         const result = await controller.applyNext(pack, namespace);
         console.log(JSON.stringify({
             pack: result.pack,

package/dist/core/live.js

@@ -22,6 +22,7 @@ exports.liveThumbRegen = liveThumbRegen;
 exports.liveAutoApplySet = liveAutoApplySet;
 exports.liveAutoApplyUnset = liveAutoApplyUnset;
 exports.liveDoctor = liveDoctor;
+exports.liveServiceAutostart = liveServiceAutostart;
 exports.liveSetRunner = liveSetRunner;
 exports.liveGetWallpaperConfig = liveGetWallpaperConfig;
 exports.liveSetWallpaperConfig = liveSetWallpaperConfig;
@@ -37,6 +38,7 @@ const promises_1 = require("node:stream/promises");
 const exec_1 = require("../utils/exec");
 const net_1 = require("../utils/net");
 const fs_1 = require("../utils/fs");
+const workshop_1 = require("./workshop");
 const LIVE_LOCK_STALE_MS = 10 * 60 * 1000;
 const LIVE_DOWNLOAD_MIN_BYTES = 3 * 1024 * 1024;
 const LIVE_PREVIEW_MIN_BYTES = 64 * 1024;
@@ -103,7 +105,7 @@ function defaultRunnerConfig() {
     return {
         mode: 'bin',
         cargo_project_dir: process.env.KITOWALL_LIVE_RUNNER_PROJECT?.trim() || '',
-        bin_name: process.env.KITOWALL_LIVE_RUNNER_BIN?.trim() || 'kitsune-livewallpaper'
+        bin_name: process.env.KITOWALL_LIVE_RUNNER_BIN?.trim() || 'kitsune-rendercore'
     };
 }
 function defaultIndex() {
@@ -112,19 +114,12 @@ function defaultIndex() {
         items: [],
         per_monitor: {},
         apply_defaults: {
-            keep_services: false,
-            mute_audio: false,
-            profile: 'quality',
-            display_fps: null,
-            seamless_loop: true,
-            loop_crossfade: true,
-            loop_crossfade_seconds: 0.35,
-            optimize: true,
-            proxy_width_hd: 1920,
-            proxy_width_4k: 3840,
-            proxy_fps: 60,
-            proxy_crf_hd: 18,
-            proxy_crf_4k: 16
+            video_fps: 30,
+            video_speed: 1.0,
+            hwaccel: 'auto',
+            quality: 'high',
+            pause_on_steam_game: true,
+            steam_poll_ms: 1000
         },
         runner: defaultRunnerConfig()
     };
@@ -136,10 +131,7 @@ function ensureIndexShape(index) {
         version: 1,
         items: items.filter(v => v && typeof v === 'object'),
         per_monitor: (index.per_monitor && typeof index.per_monitor === 'object') ? index.per_monitor : {},
-        apply_defaults: {
-            ...base.apply_defaults,
-            ...(index.apply_defaults ?? {})
-        },
+        apply_defaults: normalizeApplyDefaults(index.apply_defaults, base.apply_defaults),
         runner: {
             ...base.runner,
             ...(index.runner ?? {}),
@@ -209,7 +201,21 @@ function readIndex() {
     }
     try {
         const raw = node_fs_1.default.readFileSync(idxPath, 'utf8');
-        return ensureIndexShape(JSON.parse(raw));
+        const parsed = ensureIndexShape(JSON.parse(raw));
+        // Auto-migrate legacy runner to RenderCore.
+        if (clean(parsed.runner.bin_name) === 'kitsune-livewallpaper') {
+            const migrated = {
+                ...parsed,
+                runner: {
+                    ...parsed.runner,
+                    mode: 'bin',
+                    bin_name: 'kitsune-rendercore'
+                }
+            };
+            writeIndexAtomic(migrated);
+            return migrated;
+        }
+        return parsed;
     }
     catch {
         return defaultIndex();
@@ -824,48 +830,92 @@ function clampFloat(value, fallback, min, max = Number.MAX_SAFE_INTEGER) {
         return fallback;
     return Math.min(max, Math.max(min, n));
 }
-function buildVideoConfigFromDefaults(defaults, variant) {
+function mapProfileToQuality(profile) {
+    const p = clean(profile).toLowerCase();
+    if (p === 'performance')
+        return 'low';
+    if (p === 'balanced')
+        return 'medium';
+    if (p === 'quality')
+        return 'high';
+    if (p === 'low' || p === 'medium' || p === 'high' || p === 'ultra')
+        return p;
+    return 'high';
+}
+function normalizeApplyDefaults(raw, fallback) {
+    const src = (raw && typeof raw === 'object') ? raw : {};
+    const hwaccelRaw = clean(src.hwaccel).toLowerCase();
+    const qualityRaw = clean(src.quality).toLowerCase();
+    const profileRaw = src.profile;
+    const hwaccel = (hwaccelRaw === 'auto' || hwaccelRaw === 'nvdec' || hwaccelRaw === 'vaapi' || hwaccelRaw === 'none') ? hwaccelRaw : fallback.hwaccel;
+    const qualityFromProfile = mapProfileToQuality(profileRaw);
+    const quality = (qualityRaw === 'low' || qualityRaw === 'medium' || qualityRaw === 'high' || qualityRaw === 'ultra') ? qualityRaw : (profileRaw === undefined ? fallback.quality : qualityFromProfile);
     return {
-        keep_services: !!defaults.keep_services,
-        mute_audio: !!defaults.mute_audio,
-        profile: defaults.profile,
-        display_fps: defaults.display_fps === null ? null : clampInt(defaults.display_fps, 0, 1),
-        seamless_loop: !!defaults.seamless_loop,
-        loop_crossfade: !!defaults.loop_crossfade,
-        loop_crossfade_seconds: clampFloat(defaults.loop_crossfade_seconds, 0.35, 0),
-        optimize: !!defaults.optimize,
-        proxy_width: variant === '4k'
-            ? clampInt(defaults.proxy_width_4k, 3840, 320)
-            : clampInt(defaults.proxy_width_hd, 1920, 320),
-        proxy_fps: clampInt(defaults.proxy_fps, 60, 1, 240),
-        proxy_crf: variant === '4k'
-            ? clampInt(defaults.proxy_crf_4k, 16, 1, 51)
-            : clampInt(defaults.proxy_crf_hd, 18, 1, 51)
+        video_fps: clampInt(Number(src.video_fps ?? (src.display_fps === null ? fallback.video_fps : src.display_fps)), fallback.video_fps, 1, 240),
+        video_speed: clampFloat(Number(src.video_speed), fallback.video_speed, 0.1, 4.0),
+        hwaccel,
+        quality,
+        pause_on_steam_game: src.pause_on_steam_game === undefined
+            ? fallback.pause_on_steam_game
+            : parseBoolish(String(src.pause_on_steam_game), fallback.pause_on_steam_game),
+        steam_poll_ms: clampInt(Number(src.steam_poll_ms), fallback.steam_poll_ms, 200, 120000)
     };
 }
-function normalizeVideoConfig(config, fallback) {
-    const displayFpsInput = config?.display_fps;
-    const displayFps = displayFpsInput === null
-        ? null
-        : (displayFpsInput === undefined
-            ? fallback.display_fps
-            : clampInt(displayFpsInput, fallback.display_fps ?? 30, 1, 240));
-    const profile = config?.profile === 'performance' || config?.profile === 'balanced' || config?.profile === 'quality'
-        ? config.profile
-        : fallback.profile;
-    return {
-        keep_services: config?.keep_services ?? fallback.keep_services,
-        mute_audio: config?.mute_audio ?? fallback.mute_audio,
-        profile,
-        display_fps: displayFps,
-        seamless_loop: config?.seamless_loop ?? fallback.seamless_loop,
-        loop_crossfade: config?.loop_crossfade ?? fallback.loop_crossfade,
-        loop_crossfade_seconds: clampFloat(config?.loop_crossfade_seconds ?? fallback.loop_crossfade_seconds, fallback.loop_crossfade_seconds, 0),
-        optimize: config?.optimize ?? fallback.optimize,
-        proxy_width: clampInt(config?.proxy_width ?? fallback.proxy_width, fallback.proxy_width, 320),
-        proxy_fps: clampInt(config?.proxy_fps ?? fallback.proxy_fps, fallback.proxy_fps, 1, 240),
-        proxy_crf: clampInt(config?.proxy_crf ?? fallback.proxy_crf, fallback.proxy_crf, 1, 51)
-    };
+function rendercoreEnvPath() {
+    return node_path_1.default.join(node_os_1.default.homedir(), '.config', 'kitsune-rendercore', 'env');
+}
+function syncRendercoreEnv(defaults) {
+    const p = rendercoreEnvPath();
+    (0, fs_1.ensureDir)(node_path_1.default.dirname(p));
+    const existing = {};
+    if (node_fs_1.default.existsSync(p)) {
+        const raw = node_fs_1.default.readFileSync(p, 'utf8');
+        for (const line of raw.split('\n')) {
+            const t = line.trim();
+            if (!t || t.startsWith('#'))
+                continue;
+            const eq = t.indexOf('=');
+            if (eq <= 0)
+                continue;
+            existing[t.slice(0, eq).trim()] = t.slice(eq + 1).trim();
+        }
+    }
+    existing.KRC_VIDEO_FPS = String(defaults.video_fps);
+    existing.KRC_VIDEO_SPEED = String(defaults.video_speed);
+    existing.KRC_HWACCEL = defaults.hwaccel;
+    existing.KRC_QUALITY = defaults.quality;
+    existing.KRC_PAUSE_ON_STEAM_GAME = defaults.pause_on_steam_game ? 'true' : 'false';
+    existing.KRC_STEAM_POLL_MS = String(defaults.steam_poll_ms);
+    const ordered = [
+        'KRC_VIDEO_DEFAULT',
+        'KRC_VIDEO_MAP_FILE',
+        'KRC_VIDEO_MAP',
+        'KRC_VIDEO_FPS',
+        'KRC_VIDEO_SPEED',
+        'KRC_HWACCEL',
+        'KRC_QUALITY',
+        'KRC_PAUSE_ON_STEAM_GAME',
+        'KRC_STEAM_POLL_MS'
+    ];
+    const keys = Array.from(new Set([...ordered, ...Object.keys(existing)])).sort((a, b) => {
+        const ia = ordered.indexOf(a);
+        const ib = ordered.indexOf(b);
+        if (ia >= 0 && ib >= 0)
+            return ia - ib;
+        if (ia >= 0)
+            return -1;
+        if (ib >= 0)
+            return 1;
+        return a.localeCompare(b);
+    });
+    const lines = [];
+    for (const key of keys) {
+        const value = existing[key];
+        if (value === undefined)
+            continue;
+        lines.push(`${key}=${value}`);
+    }
+    node_fs_1.default.writeFileSync(p, `${lines.join('\n')}\n`, 'utf8');
 }
 async function resolvePost(provider, pageUrl) {
     const html = await fetchHtml(pageUrl, pageUrl);
@@ -1039,26 +1089,6 @@ function parseId(id) {
         throw new Error(`Invalid variant in id: ${id}`);
     return { provider, slug, variant };
 }
-async function buildApplyCommand(index, item, monitor) {
-    const defs = index.apply_defaults;
-    const proxyWidth = item.variant === '4k' ? 3840 : 1920;
-    const proxyCrf = item.variant === '4k' ? defs.proxy_crf_4k : defs.proxy_crf_hd;
-    const bool = (v) => (v ? 'true' : 'false');
-    const args = [
-        'video-play',
-        item.file_path,
-        '--monitor', monitor,
-        '--profile', defs.profile,
-        '--seamless-loop', bool(defs.seamless_loop),
-        '--loop-crossfade', bool(defs.loop_crossfade),
-        '--loop-crossfade-seconds', String(defs.loop_crossfade_seconds),
-        '--optimize', bool(defs.optimize),
-        '--proxy-width', String(proxyWidth),
-        '--proxy-fps', String(defs.proxy_fps),
-        '--proxy-crf', String(proxyCrf)
-    ];
-    return { cmd: index.runner.bin_name, args };
-}
 async function liveResolve(pageUrl) {
     const provider = providerFromUrl(pageUrl);
     const post = await resolvePost(provider, pageUrl);
@@ -1428,7 +1458,6 @@ async function liveFetch(opts) {
     }
     const id = itemId(provider, slug, selected.variant);
     const thumbPath = await generateThumb(filePath, id);
-    const defaults = readIndex().apply_defaults;
     const item = {
         id,
         provider,
@@ -1442,25 +1471,19 @@ async function liveFetch(opts) {
         size_bytes: sizeBytes,
         favorite: false,
         added_at: nowUnix(),
-        last_applied_at: 0,
-        video_config: buildVideoConfigFromDefaults(defaults, selected.variant)
+        last_applied_at: 0
     };
     withLiveLock(() => {
         const current = readIndex();
         const prev = current.items.find(v => v.id === item.id);
-        const fallbackCfg = buildVideoConfigFromDefaults(current.apply_defaults, item.variant);
         const next = prev
             ? {
                 ...item,
                 favorite: prev.favorite,
                 added_at: prev.added_at || item.added_at,
-                last_applied_at: prev.last_applied_at || 0,
-                video_config: normalizeVideoConfig(prev.video_config, fallbackCfg)
+                last_applied_at: prev.last_applied_at || 0
             }
-            : {
-                ...item,
-                video_config: normalizeVideoConfig(item.video_config, fallbackCfg)
-            };
+            : item;
         const updated = upsertItem(current, next);
         writeIndexAtomic(updated);
         return true;
@@ -1493,49 +1516,21 @@ async function liveApply(opts) {
     if (!item || !node_fs_1.default.existsSync(item.file_path)) {
         throw new Error(`Live file not found for ${idRaw}. Re-download it with live fetch.`);
     }
-    const fallbackCfg = buildVideoConfigFromDefaults(index.apply_defaults, item.variant);
-    const cfg = normalizeVideoConfig(item.video_config, fallbackCfg);
     const bin = index.runner.bin_name;
     const setVideoArgs = [
-        'config',
         'set-video',
         '--monitor', monitor,
-        '--video', item.file_path,
-        '--keep-services', cfg.keep_services ? 'true' : 'false',
-        '--profile', cfg.profile,
-        '--loop-crossfade-seconds', String(cfg.loop_crossfade_seconds),
-        '--proxy-width', String(cfg.proxy_width),
-        '--proxy-fps', String(cfg.proxy_fps),
-        '--proxy-crf', String(cfg.proxy_crf)
+        '--video', item.file_path
     ];
-    if (cfg.mute_audio)
-        setVideoArgs.push('--mute-audio');
-    if (cfg.display_fps !== null)
-        setVideoArgs.push('--display-fps', String(cfg.display_fps));
-    if (cfg.seamless_loop)
-        setVideoArgs.push('--seamless-loop');
-    if (cfg.loop_crossfade)
-        setVideoArgs.push('--loop-crossfade');
-    if (cfg.optimize)
-        setVideoArgs.push('--optimize');
     await (0, exec_1.run)(bin, setVideoArgs, { timeoutMs: 120000 });
-    // Keep livewallpaper authority persistent across session restarts when user applies from library.
-    try {
-        await (0, exec_1.run)(bin, ['service-autostart', 'install', '--overwrite'], { timeoutMs: 15000 });
-    }
-    catch { }
-    try {
-        await (0, exec_1.run)(bin, ['service-autostart', 'enable'], { timeoutMs: 15000 });
-    }
-    catch { }
-    try {
-        await (0, exec_1.run)(bin, ['stop-services'], { timeoutMs: 15000 });
-    }
-    catch { }
-    await (0, exec_1.run)(bin, ['start-config'], { timeoutMs: 120000 });
+    // Live mode owns wallpaper state: stop static rotation services while live is active.
+    await (0, workshop_1.workshopCoexistenceEnter)();
+    // Keep live authority persistent across session restarts.
+    await (0, exec_1.run)(bin, ['service', 'install'], { timeoutMs: 20000 });
+    await (0, exec_1.run)(bin, ['service', 'enable'], { timeoutMs: 20000 });
     withLiveLock(() => {
         const current = readIndex();
-        const updatedItems = current.items.map(v => (v.id === item.id ? { ...v, last_applied_at: nowUnix(), video_config: cfg } : v));
+        const updatedItems = current.items.map(v => (v.id === item.id ? { ...v, last_applied_at: nowUnix() } : v));
         const perMonitor = { ...current.per_monitor };
         const currentMon = perMonitor[monitor] || {
             auto_apply: false,
@@ -1555,7 +1550,7 @@ async function liveApply(opts) {
         monitor,
         runner: index.runner.mode,
         command: bin,
-        args: ['start-config']
+        args: setVideoArgs
     };
 }
 function liveFavorite(id, on) {
@@ -1685,8 +1680,8 @@ async function liveDoctor(opts) {
     }
     if (opts?.fix && deps.runner_bin) {
         try {
-            await (0, exec_1.run)(index.runner.bin_name, ['install-dependencies'], { timeoutMs: 180000 });
-            fix.push(`Executed: ${index.runner.bin_name} install-dependencies`);
+            await (0, exec_1.run)(index.runner.bin_name, ['install-deps'], { timeoutMs: 180000 });
+            fix.push(`Executed: ${index.runner.bin_name} install-deps`);
             try {
                 await (0, exec_1.run)('ffmpeg', ['-version'], { timeoutMs: 4000 });
                 deps.ffmpeg = true;
@@ -1703,11 +1698,11 @@ async function liveDoctor(opts) {
             }
         }
         catch (e) {
-            fix.push(`Failed to execute '${index.runner.bin_name} install-dependencies': ${String(e)}`);
+            fix.push(`Failed to execute '${index.runner.bin_name} install-deps': ${String(e)}`);
         }
     }
     else if (!deps.ffmpeg || !deps.hyprctl) {
-        fix.push(`Run '${index.runner.bin_name} install-dependencies' to install missing runtime dependencies`);
+        fix.push(`Run '${index.runner.bin_name} install-deps' to install missing runtime dependencies`);
     }
     return {
         ok: Object.values(deps).every(Boolean) || (deps.hyprctl === false && Object.keys(deps).filter(k => k !== 'hyprctl').every(k => deps[k])),
@@ -1717,6 +1712,71 @@ async function liveDoctor(opts) {
         fix
     };
 }
+async function liveServiceAutostart(action) {
+    const index = readIndex();
+    let bin = index.runner.bin_name;
+    let out;
+    const extractResult = (err) => {
+        const result = err?.result;
+        if (!result)
+            return null;
+        return {
+            stdout: String(result.stdout ?? ''),
+            stderr: String(result.stderr ?? ''),
+            code: Number(result.code ?? 1)
+        };
+    };
+    try {
+        out = await (0, exec_1.run)(bin, ['service', action], { timeoutMs: 30000 });
+    }
+    catch (err) {
+        const partial = extractResult(err);
+        if (action === 'status' && partial) {
+            out = partial;
+            return {
+                ok: true,
+                action,
+                runner: bin,
+                stdout: out.stdout.trim(),
+                stderr: out.stderr.trim(),
+                code: out.code
+            };
+        }
+        // Legacy compatibility: if user still points to kitsune-livewallpaper,
+        // map to its older subcommand to avoid hard failure.
+        if (clean(bin) === 'kitsune-livewallpaper') {
+            try {
+                out = await (0, exec_1.run)(bin, ['service-autostart', action], { timeoutMs: 30000 });
+            }
+            catch (legacyErr) {
+                const legacyPartial = extractResult(legacyErr);
+                if (action === 'status' && legacyPartial) {
+                    out = legacyPartial;
+                    return {
+                        ok: true,
+                        action,
+                        runner: bin,
+                        stdout: out.stdout.trim(),
+                        stderr: out.stderr.trim(),
+                        code: out.code
+                    };
+                }
+                throw legacyErr;
+            }
+        }
+        else {
+            throw err;
+        }
+    }
+    return {
+        ok: true,
+        action,
+        runner: bin,
+        stdout: out.stdout.trim(),
+        stderr: out.stderr.trim(),
+        code: out.code
+    };
+}
 function liveSetRunner(opts) {
     return withLiveLock(() => {
         const current = readIndex();
@@ -1730,36 +1790,12 @@ function liveSetRunner(opts) {
     });
 }
 function liveGetWallpaperConfig(id) {
-    const itemIdValue = clean(id);
-    if (!itemIdValue)
-        throw new Error('id is required');
-    const index = readIndex();
-    const item = index.items.find(v => v.id === itemIdValue);
-    if (!item)
-        throw new Error(`Live item not found: ${itemIdValue}`);
-    const fallback = buildVideoConfigFromDefaults(index.apply_defaults, item.variant);
-    return {
-        ok: true,
-        id: item.id,
-        video_config: normalizeVideoConfig(item.video_config, fallback)
-    };
+    throw new Error('Per-wallpaper config is no longer supported. Use: live config apply-defaults');
 }
 function liveSetWallpaperConfig(id, opts) {
-    const itemIdValue = clean(id);
-    if (!itemIdValue)
-        throw new Error('id is required');
-    return withLiveLock(() => {
-        const current = readIndex();
-        const item = current.items.find(v => v.id === itemIdValue);
-        if (!item)
-            throw new Error(`Live item not found: ${itemIdValue}`);
-        const fallback = buildVideoConfigFromDefaults(current.apply_defaults, item.variant);
-        const previous = normalizeVideoConfig(item.video_config, fallback);
-        const nextCfg = normalizeVideoConfig({ ...previous, ...opts }, fallback);
-        const items = current.items.map(v => (v.id === itemIdValue ? { ...v, video_config: nextCfg } : v));
-        writeIndexAtomic({ ...current, items });
-        return { ok: true, id: itemIdValue, video_config: nextCfg };
-    });
+    void id;
+    void opts;
+    throw new Error('Per-wallpaper config is no longer supported. Use: live config apply-defaults');
 }
 function liveGetConfig() {
     const index = readIndex();
@@ -1768,34 +1804,12 @@ function liveGetConfig() {
 function liveSetApplyDefaults(opts) {
     return withLiveLock(() => {
         const current = readIndex();
-        const next = { ...current.apply_defaults };
-        if (opts.keep_services !== undefined)
-            next.keep_services = opts.keep_services;
-        if (opts.mute_audio !== undefined)
-            next.mute_audio = opts.mute_audio;
-        if (opts.profile !== undefined)
-            next.profile = opts.profile;
-        if (opts.display_fps !== undefined)
-            next.display_fps = opts.display_fps;
-        if (opts.seamless_loop !== undefined)
-            next.seamless_loop = opts.seamless_loop;
-        if (opts.loop_crossfade !== undefined)
-            next.loop_crossfade = opts.loop_crossfade;
-        if (opts.loop_crossfade_seconds !== undefined)
-            next.loop_crossfade_seconds = opts.loop_crossfade_seconds;
-        if (opts.optimize !== undefined)
-            next.optimize = opts.optimize;
-        if (opts.proxy_width_hd !== undefined)
-            next.proxy_width_hd = opts.proxy_width_hd;
-        if (opts.proxy_width_4k !== undefined)
-            next.proxy_width_4k = opts.proxy_width_4k;
-        if (opts.proxy_fps !== undefined)
-            next.proxy_fps = opts.proxy_fps;
-        if (opts.proxy_crf_hd !== undefined)
-            next.proxy_crf_hd = opts.proxy_crf_hd;
-        if (opts.proxy_crf_4k !== undefined)
-            next.proxy_crf_4k = opts.proxy_crf_4k;
+        const next = normalizeApplyDefaults({
+            ...current.apply_defaults,
+            ...opts
+        }, current.apply_defaults);
         writeIndexAtomic({ ...current, apply_defaults: next });
+        syncRendercoreEnv(next);
         return { ok: true, apply_defaults: next };
     });
 }

package/dist/core/workshop.js

@@ -131,9 +131,12 @@ function getCoexistServices() {
     const defaults = [
         'swww-daemon.service',
         'swww-daemon@kitowall.service',
+        'kitowall-watch.service',
+        'kitowall-next.service',
+        'kitowall-next.timer',
         'hyprwall-watch.service',
-        'hyprwall-next.timer',
-        'kitowall-next.timer'
+        'hyprwall-next.service',
+        'hyprwall-next.timer'
     ];
     const configured = Array.isArray(cfg.coexistServices) ? cfg.coexistServices.map(v => String(v).trim()).filter(Boolean) : [];
     return configured.length > 0 ? configured : defaults;
@@ -956,6 +959,29 @@ function killPid(pid) {
         return false;
     }
 }
+async function stopKnownLiveProcesses() {
+    // Live V2 can run wallpapers without registering pids in workshop active-state.
+    // Stop common runtime processes as best-effort fallback.
+    const patterns = [
+        'mpvpaper',
+        'kitsune-livewallpaper',
+        'kitsune-rendercore'
+    ];
+    for (const pattern of patterns) {
+        try {
+            await (0, exec_1.run)('pkill', ['-f', pattern]);
+        }
+        catch {
+            // best effort
+        }
+    }
+    try {
+        await (0, exec_1.run)('systemctl', ['--user', 'stop', 'kitsune-rendercore.service']);
+    }
+    catch {
+        // best effort
+    }
+}
 function workshopActiveStatus() {
     const paths = getWePaths();
     ensureWePaths(paths);
@@ -982,14 +1008,26 @@ async function isUnitActive(unit) {
         return false;
     }
 }
+async function isUnitEnabled(unit) {
+    try {
+        const out = await (0, exec_1.run)('systemctl', ['--user', 'is-enabled', unit], { timeoutMs: 4000 });
+        return out.stdout.trim() === 'enabled';
+    }
+    catch {
+        return false;
+    }
+}
 async function workshopCoexistenceEnter() {
     const paths = getWePaths();
     ensureWePaths(paths);
     const units = getCoexistServices();
     const active = [];
+    const enabled = [];
     for (const unit of units) {
         if (await isUnitActive(unit))
             active.push(unit);
+        if (await isUnitEnabled(unit))
+            enabled.push(unit);
     }
     for (const unit of active) {
         try {
@@ -999,8 +1037,16 @@ async function workshopCoexistenceEnter() {
             // best effort
         }
     }
+    for (const unit of enabled) {
+        try {
+            await (0, exec_1.run)('systemctl', ['--user', 'disable', unit]);
+        }
+        catch {
+            // best effort
+        }
+    }
     const snapshotId = String(now());
-    const snap = { id: snapshotId, ts: now(), active };
+    const snap = { id: snapshotId, ts: now(), active, enabled };
     (0, fs_1.writeJson)(node_path_1.default.join(snapshotDir(paths), `${snapshotId}.json`), snap);
     (0, fs_1.writeJson)(snapshotFile(paths), { id: snapshotId, ts: snap.ts });
     return { ok: true, stopped: active, snapshot: active, snapshot_id: snapshotId };
@@ -1013,18 +1059,29 @@ async function workshopCoexistenceExit() {
         return { ok: true, restored: [] };
     const raw = JSON.parse(node_fs_1.default.readFileSync(snapPath, 'utf8'));
     let active = Array.isArray(raw.active) ? raw.active.map(v => String(v)) : [];
+    let enabled = Array.isArray(raw.enabled) ? raw.enabled.map(v => String(v)) : [];
     if ((!active || active.length === 0) && raw.id) {
         const historical = node_path_1.default.join(snapshotDir(paths), `${raw.id}.json`);
         if (node_fs_1.default.existsSync(historical)) {
             try {
                 const snap = JSON.parse(node_fs_1.default.readFileSync(historical, 'utf8'));
                 active = Array.isArray(snap.active) ? snap.active.map(v => String(v)) : [];
+                enabled = Array.isArray(snap.enabled) ? snap.enabled.map(v => String(v)) : [];
             }
             catch {
                 active = [];
+                enabled = [];
             }
         }
     }
+    for (const unit of enabled) {
+        try {
+            await (0, exec_1.run)('systemctl', ['--user', 'enable', unit]);
+        }
+        catch {
+            // best effort
+        }
+    }
     const restored = [];
     for (const unit of active) {
         try {
@@ -1086,9 +1143,13 @@ async function workshopStop(options) {
         }
     }
     else if (options?.all) {
+        await stopKnownLiveProcesses();
         clearActiveState();
         shouldRestore = true;
     }
+    if (options?.all) {
+        await stopKnownLiveProcesses();
+    }
     const coexist = shouldRestore ? await workshopCoexistenceExit() : { ok: true, restored: [] };
     return {
         ok: true,

package/dist/utils/exec.js

@@ -18,6 +18,7 @@ function run(cmd, args = [], options = {}) {
             'ffprobe',
             'cargo',
             'kitsune-livewallpaper',
+            'kitsune-rendercore',
             'dd'
         ]);
         const useHost = isFlatpak && hostCommands.has(cmd);

package/package.json

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