kitowall 3.5.13 → 3.5.16

package/README.md

@@ -1,10 +1,10 @@
-<img src="https://github.com/KitotsuMolina/Kitowall/blob/master/assets/kitowall.png?raw=true" alt="Kitowall" width="420" />
+<img src="https://github.com/KitotsuMolina/Kitowall/blob/main/assets/kitowall.png?raw=true" alt="Kitowall" width="420" />
 
 # Kitowall
 
 `Kitowall` is a wallpaper manager for Hyprland/Wayland using `swww`.
 
-Current version: `1.0.7`.
+Current version: `3.5.15`.
 
 ## What You Can Do
 - Rotate wallpapers with transitions.
@@ -43,11 +43,28 @@ If your system needs it on Wayland:
 WEBKIT_DISABLE_DMABUF_RENDERER=1 npm run tauri:dev
 ```
 
+## AppImage (Recommended)
+AppImage is now the primary desktop distribution for `kitowall-ui`.
+
+1) Download the latest `Kitowall-<version>-x86_64.AppImage` from GitHub Releases.
+2) Make it executable:
+```bash
+chmod +x ./Kitowall-*.AppImage
+```
+3) First-time host bootstrap (installs CLI/runtime dependencies on host):
+```bash
+./scripts/bootstrap-host.sh
+```
+4) Initialize services:
+```bash
+kitowall init --namespace kitowall --apply --force
+```
+
 ## Package / Release
 - Release checklist: `RELEASE_CHECKLIST.md`
 - Release notes: `RELEASE_NOTES_1.0.0.md`
 - Dependencies: `DEPENDENCIES.md`
-- Flatpak packaging: `flatpak/`
+- AppImage CI: `.github/workflows/build-appimage.yml`
 
 Main commands:
 ```bash
@@ -64,46 +81,11 @@ npm run package:ui
 npm run package:all
 ```
 
-## Flatpak (Linux)
-```bash
-# 0) Install host deps (Arch Linux)
-./BOOTSTRAP_FLATPAK_BUILD_DEPS.sh
-
-# 1) Build desktop binary
-cd ui
-npm run tauri:build
-cd ..
-
-# 2) Prepare flatpak sources (binary + icon)
-./flatpak/prepare.sh
-
-# 3) Build and install flatpak
-flatpak-builder flatpak/build-dir flatpak/io.kitotsu.KitoWall.yml --user --install --force-clean
-```
-
-For Flathub source pipeline:
-```bash
-./BOOTSTRAP_FLATPAK_BUILD_DEPS.sh
-./GENERATE_FLATHUB_SOURCES.sh 2.1.0 && ./BUILD_FLATPAK_FROMSOURCE.sh
-```
-
-Integrated local Flatpak (Kitowall + Kitsune + Kitsune-RenderCore in one app):
-```bash
-./BOOTSTRAP_FLATPAK_BUILD_DEPS.sh
-./GENERATE_FLATHUB_SOURCES.sh 2.1.0
-./BUILD_FLATPAK_INTEGRATED_LOCAL.sh
-flatpak run io.kitotsu.KitoWall
-```
-
 ## User Docs
 - Current status: `STATUS.md`
 - Config examples: `CONFIG_EXAMPLES.md`
 - UI details: `ui/README.md`
 
-## Known Issues
-- Flatpak watch unit failing with `/app/bin/node` in user systemd:
-  - `issues/flatpak-watch-service-failed.md`
-
 ## Legal
 - License: `LICENSE.md`
 - Attribution notice: `NOTICE.md`

package/dist/core/init.js

@@ -17,9 +17,6 @@ function esc(a) {
     return JSON.stringify(a);
 }
 async function runHostShell(cmd) {
-    if (process.env.FLATPAK_ID) {
-        return (0, exec_1.run)('flatpak-spawn', ['--host', 'sh', '-lc', cmd]);
-    }
     return (0, exec_1.run)('sh', ['-lc', cmd]);
 }
 async function hostCmdExists(cmd) {
@@ -32,7 +29,7 @@ async function hostCmdExists(cmd) {
     }
 }
 async function ensureHostDeps() {
-    const required = ['swww', 'swww-daemon', 'hyprctl', 'mpvpaper'];
+    const required = ['swww', 'swww-daemon', 'hyprctl'];
     const missing = [];
     for (const dep of required) {
         if (!(await hostCmdExists(dep)))
@@ -45,8 +42,6 @@ async function ensureHostDeps() {
         pkgSet.add('swww');
     if (missing.includes('hyprctl'))
         pkgSet.add('hyprland');
-    if (missing.includes('mpvpaper'))
-        pkgSet.add('mpvpaper');
     const packages = Array.from(pkgSet);
     // Best effort auto-install on Arch host; if it fails, we keep a clear actionable error.
     if (packages.length > 0 && await hostCmdExists('pacman')) {
@@ -62,41 +57,9 @@ async function ensureHostDeps() {
     }
     if (stillMissing.length > 0) {
         throw new Error(`Missing host dependencies: ${stillMissing.join(', ')}. ` +
-            `Install on host (Arch): sudo pacman -S --needed swww hyprland mpvpaper`);
+            `Install on host (Arch): sudo pacman -S --needed swww hyprland`);
     }
 }
-async function ensureHostRendercoreBridge(appId) {
-    const home = (0, node_os_1.homedir)();
-    const localBinDir = (0, node_path_1.join)(home, '.local', 'bin');
-    ensureDir(localBinDir);
-    const bridgePath = (0, node_path_1.join)(localBinDir, 'kitsune-rendercore');
-    const bridgeScript = `#!/usr/bin/env bash
-set -euo pipefail
-exec /usr/bin/flatpak run --command=kitsune-rendercore ${appId} "$@"
-`;
-    (0, node_fs_1.writeFileSync)(bridgePath, bridgeScript, { encoding: 'utf8', mode: 0o755 });
-    const userDir = (0, node_path_1.join)(home, '.config', 'systemd', 'user');
-    ensureDir(userDir);
-    const unitPath = (0, node_path_1.join)(userDir, 'kitsune-rendercore.service');
-    const unit = `
-[Unit]
-Description=Kitsune RenderCore Live Wallpaper (Flatpak bridge)
-After=graphical-session.target
-PartOf=graphical-session.target
-
-[Service]
-Type=simple
-ExecStart=${bridgePath}
-Restart=on-failure
-RestartSec=1
-
-[Install]
-WantedBy=default.target
-`.trimStart();
-    (0, node_fs_1.writeFileSync)(unitPath, unit, 'utf8');
-    await (0, exec_1.run)('systemctl', ['--user', 'daemon-reload']);
-    await (0, exec_1.run)('systemctl', ['--user', 'enable', '--now', 'kitsune-rendercore.service']).catch(() => { });
-}
 async function disableIfExists(unit) {
     await (0, exec_1.run)('systemctl', ['--user', 'disable', '--now', unit]).catch(() => { });
     await (0, exec_1.run)('systemctl', ['--user', 'reset-failed', unit]).catch(() => { });
@@ -124,22 +87,15 @@ async function initKitowall(opts) {
     const state = (0, state_1.loadState)(); // crea/migra state si hace falta
     const ns = (opts.namespace && opts.namespace.trim()) ? opts.namespace.trim() : 'kitowall';
     const force = !!opts.force;
-    const isFlatpak = Boolean(process.env.FLATPAK_ID);
-    const flatpakAppId = (process.env.FLATPAK_ID || 'io.kitotsu.KitoWall').trim();
     // Validaciones mínimas
     await ensureHostDeps();
-    if (isFlatpak) {
-        await ensureHostRendercoreBridge(flatpakAppId);
-    }
     // Apagar servicios que pisan el wallpaper
     await detectAndHandleConflicts(force);
     const userDir = (0, node_path_1.join)((0, node_os_1.homedir)(), '.config', 'systemd', 'user');
     ensureDir(userDir);
     const nodePath = process.execPath;
     const cliPath = (0, node_path_1.resolve)(process.argv[1]); // dist/cli.js absoluto
-    const cliInvoke = isFlatpak
-        ? `/usr/bin/flatpak run --command=kitowall ${flatpakAppId}`
-        : `${JSON.stringify(nodePath)} ${JSON.stringify(cliPath)}`;
+    const cliInvoke = `${JSON.stringify(nodePath)} ${JSON.stringify(cliPath)}`;
     const xdgRuntimeDir = (process.env.XDG_RUNTIME_DIR && process.env.XDG_RUNTIME_DIR.trim())
         ? process.env.XDG_RUNTIME_DIR.trim()
         : `/run/user/${process.getuid?.() ?? 1000}`;

package/dist/core/live.js

@@ -47,8 +47,8 @@ const LIVE_BROWSER_UA = process.env.KITOWALL_LIVE_UA ||
     'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36';
 const LIVE_BROWSER_UA_FALLBACK = process.env.KITOWALL_LIVE_UA_FALLBACK ||
     'insomnia/12.3.1';
-const INTEGRATED_RENDERCORE_ENV = 'KITOWALL_FLATPAK_INTEGRATED_RENDERCORE';
-const INTEGRATED_RENDERCORE_BIN_FALLBACK = '/app/bin/kitsune-rendercore';
+const INTEGRATED_RENDERCORE_ENV = 'KITOWALL_INTEGRATED_RENDERCORE';
+const INTEGRATED_RENDERCORE_BIN_FALLBACK = 'kitsune-rendercore';
 function nowUnix() {
     return Math.floor(Date.now() / 1000);
 }
@@ -871,8 +871,6 @@ function rendercoreEnvPath() {
     return node_path_1.default.join(node_os_1.default.homedir(), '.config', 'kitsune-rendercore', 'env');
 }
 function integratedRendercoreMode() {
-    if (!process.env.FLATPAK_ID)
-        return false;
     const v = clean(process.env[INTEGRATED_RENDERCORE_ENV]).toLowerCase();
     return v === '1' || v === 'true' || v === 'yes' || v === 'on';
 }

package/dist/core/systemd.js

@@ -37,8 +37,6 @@ async function installSystemd(opts) {
     ensureDir(userDir);
     const every = systemdInterval(opts.every);
     const ns = (opts.namespace && opts.namespace.trim()) ? opts.namespace.trim() : 'kitowall';
-    const isFlatpak = Boolean(process.env.FLATPAK_ID);
-    const flatpakAppId = (process.env.FLATPAK_ID || 'io.kitotsu.KitoWall').trim();
     const nodePath = process.execPath;
     const cliPath = (0, node_path_1.resolve)(process.argv[1] || '');
     const xdgRuntimeDir = (process.env.XDG_RUNTIME_DIR && process.env.XDG_RUNTIME_DIR.trim())
@@ -53,9 +51,7 @@ async function installSystemd(opts) {
     const waylandBootstrap = 'WAYLAND_DISPLAY="${WAYLAND_DISPLAY:-$(ls \\"$XDG_RUNTIME_DIR\\"/wayland-* 2>/dev/null | xargs -r -n1 basename | sort | tail -n1)}"; ' +
         'if [ -z "$WAYLAND_DISPLAY" ]; then WAYLAND_DISPLAY=wayland-1; fi; ' +
         'export WAYLAND_DISPLAY;';
-    const nextCmd = isFlatpak
-        ? `${waylandBootstrap} exec /usr/bin/flatpak run --command=kitowall ${flatpakAppId} rotate-now --namespace ${ns} --force`
-        : `${waylandBootstrap} exec ${JSON.stringify(nodePath)} ${JSON.stringify(cliPath)} rotate-now --namespace ${JSON.stringify(ns)} --force`;
+    const nextCmd = `${waylandBootstrap} exec ${JSON.stringify(nodePath)} ${JSON.stringify(cliPath)} rotate-now --namespace ${JSON.stringify(ns)} --force`;
     const kitowallNextService = `
         [Unit]
         Description=Kitowall apply next wallpapers

package/dist/managers/swww.js

@@ -8,10 +8,7 @@ function startSwwwDaemon(namespace) {
     const args = [];
     if (namespace)
         args.push('--namespace', namespace);
-    const inFlatpak = Boolean(process.env.FLATPAK_ID);
-    const cmd = inFlatpak ? 'flatpak-spawn' : 'swww-daemon';
-    const spawnArgs = inFlatpak ? ['--host', 'swww-daemon', ...args] : args;
-    const child = (0, node_child_process_1.spawn)(cmd, spawnArgs, {
+    const child = (0, node_child_process_1.spawn)('swww-daemon', args, {
         stdio: 'ignore',
         detached: true
     });

package/dist/utils/exec.js

@@ -5,29 +5,8 @@ exports.run = run;
 const child_process_1 = require("child_process");
 function run(cmd, args = [], options = {}) {
     return new Promise((resolve, reject) => {
-        const isFlatpak = Boolean(process.env.FLATPAK_ID);
-        const integratedRendercore = isFlatpak && (process.env.KITOWALL_FLATPAK_INTEGRATED_RENDERCORE === '1'
-            || process.env.KITOWALL_FLATPAK_INTEGRATED_RENDERCORE === 'true');
-        const hostCommands = new Set([
-            'swww',
-            'swww-daemon',
-            'hyprctl',
-            'systemctl',
-            'xdg-open',
-            'steamcmd',
-            'ffmpeg',
-            'ffprobe',
-            'cargo',
-            'kitsune-livewallpaper',
-            'dd'
-        ]);
-        if (!integratedRendercore) {
-            hostCommands.add('which');
-            hostCommands.add('kitsune-rendercore');
-        }
-        const useHost = isFlatpak && hostCommands.has(cmd);
-        const finalCmd = useHost ? 'flatpak-spawn' : cmd;
-        const finalArgs = useHost ? ['--host', cmd, ...args] : args;
+        const finalCmd = cmd;
+        const finalArgs = args;
         const child = (0, child_process_1.spawn)(finalCmd, finalArgs, {
             cwd: options.cwd,
             env: options.env,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kitowall",
-  "version": "3.5.13",
+  "version": "3.5.16",
   "description": "CLI/daemon for Hyprland wallpapers using swww with pack-based rotation.",
   "repository": {
     "type": "git",
@@ -26,6 +26,7 @@
     "release:check": "npm run build && npm run test:e2e",
     "package:cli": "npm pack",
     "package:ui": "npm --prefix ui run tauri:build",
+    "package:appimage": "npm --prefix ui run tauri:build",
     "package:all": "npm run release:check && npm run package:cli && npm run package:ui",
     "test:smoke": "bash ./tests/smoke.e2e.sh",
     "test:regression": "bash ./tests/regression.e2e.sh",