⚠️ v3.0.0 is a major rewrite — read before upgrading
v3 replaces the old Node.js backend with a new Go daemon and a new on-disk format. Upgrading from v2.x is not seamless:
- Your v2 gallery and playlists are not migrated automatically. v3 uses a new database (CloverDB) in a new location and starts with an empty gallery. Your v2 data is left untouched but unused.
- New data directory: v3 stores everything under
~/.local/share/waypaper-engine/(db/,images/). v2 used~/.waypaper_engine/. To bring images across, re-import them from~/.waypaper_engine/images/. - New control API: the daemon now speaks HTTP over a Unix socket. Any external scripts/tools built against the v2 daemon must be updated.
- Playlist changes: the
neverplaylist type is nowmanual; the per-playlist "show animations" toggle is gone (transitions are now a global/backend setting). - Building from source now requires
pnpm(previouslynpm). - Looper Studio and Shader Studio are new and ship as beta — expect rough edges.
Migration analysis: docs/dev/migration-v2-to-v3.md.
What's Changed
- chore:Update dependencies by @0bCdian in #122
- Revise README with v3 rewrite details and features by @0bCdian in #175
- Refactor/waypaper engine by @0bCdian in #177
- Bump @playwright/test from 1.58.2 to 1.60.0 by @dependabot[bot] in #204
- Bump zustand from 5.0.11 to 5.0.13 by @dependabot[bot] in #205
- Bump oxfmt from 0.35.0 to 0.51.0 by @dependabot[bot] in #203
- Bump actions/setup-go from 5 to 6 by @dependabot[bot] in #200
- Bump @tanstack/react-form from 1.28.3 to 1.32.0 by @dependabot[bot] in #208
- Bump actions/upload-artifact from 4 to 7 by @dependabot[bot] in #196
- Bump actions/upload-pages-artifact from 3 to 5 by @dependabot[bot] in #197
- Bump softprops/action-gh-release from 2 to 3 by @dependabot[bot] in #198
- Bump @vitejs/plugin-react from 5.0.0 to 5.2.0 by @dependabot[bot] in #201
- Bump actions/deploy-pages from 4 to 5 by @dependabot[bot] in #199
- Update deps by @0bCdian in #209
- chore: remediate Dependabot security alerts by @0bCdian in #210
- feat(monitors): faithful per-monitor wallpaper previews by @0bCdian in #211
Full Changelog: v2.0.4...v3.0.0