Skip to content

v3.0.0

Latest

Choose a tag to compare

@github-actions github-actions released this 22 May 19:48
· 6 commits to main since this release
2356e2d

⚠️ 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 never playlist type is now manual; the per-playlist "show animations" toggle is gone (transitions are now a global/backend setting).
  • Building from source now requires pnpm (previously npm).
  • 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

Full Changelog: v2.0.4...v3.0.0