CLI/daemon for Hyprland wallpapers using swww with pack-based rotation.
npm install kitowall
Kitowall is a wallpaper manager for Hyprland/Wayland using swww.
Current version: 1.0.6.
sao, edgerunners, etc.).local, wallhaven, unsplash, reddit, generic_json, static_url.~/.config/kitowall/config.json~/.local/state/kitowall/state.json~/.local/state/kitowall/history.json~/.local/state/kitowall/logs.jsonl~/Pictures/Wallpapers/bash
npm install
npm run buildnode dist/cli.js outputs
node dist/cli.js status
node dist/cli.js next
node dist/cli.js check --json
`Quick Start (UI)
`bash
cd ui
npm install
npm run tauri:dev
`If your system needs it on Wayland:
`bash
WEBKIT_DISABLE_DMABUF_RENDERER=1 npm run tauri:dev
`Package / Release
- Release checklist: RELEASE_CHECKLIST.md
- Release notes: RELEASE_NOTES_1.0.0.md
- Dependencies: DEPENDENCIES.md
- Flatpak packaging: flatpak/Main commands:
`bash
Validate CLI before release
npm run release:checkBuild distributable CLI tarball
npm run package:cliBuild desktop app package (Tauri)
npm run package:uiFull pipeline
npm run package:all
`Flatpak (Linux)
`bash
1) Build desktop binary
cd ui
npm run tauri:build
cd ..2) Prepare flatpak sources (binary + icon)
./flatpak/prepare.sh3) Build and install flatpak
flatpak-builder flatpak/build-dir flatpak/io.kitotsu.KitoWall.yml --user --install --force-clean
`User Docs
- Current status: STATUS.md
- Config examples: CONFIG_EXAMPLES.md
- UI details: ui/README.mdKnown Issues
- Flatpak watch unit failing with /app/bin/node in user systemd:
- issues/flatpak-watch-service-failed.mdLegal
- License: LICENSE.md
- Attribution notice: NOTICE.md
- Trademarks: TRADEMARKS.md
- Logo license: ui/src/assets/logo-LICENSE.md`