力 RYOKU // NIXOS
報 // RELEASE

PATCHNOTES.

All patch notes are stored here

Current
0.63.1-beta.19
Previous
0.60.1-beta.19
Order
Newest first
Archive
Persistent
LATEST // CURRENT NIXOS PORT

MUSUBI
0.63.1

結び
BETA.19

This update brings Ryoku on NixOS up to v0.63.1-beta.19, completing the latest upstream sync while preserving the NixOS-specific adaptations required to keep Ryoku fully declarative and functional. This is a much larger update than the previous patch, with major changes to wallpaper effects, audio, translations, Ryotunes, RyoStore, Ryoku Settings and several parts of the desktop.

✨

Features added

  • Added Ryostage, Ryoku's new wallpaper staging system which replaces the old Depth and Parallax systems.
  • Added support for both Ryostage segmentation models:
    • U2NetP — smaller and faster model for quicker processing.
    • BiRefNet General Lite — much larger model for higher quality cutouts.
  • Added the new 10-band Ryoku Equalizer, including support for EQ presets, individual band controls, enabling/disabling the EQ and automatic audio sink retargeting.
  • Added a fully declarative Ryoku EQ systemd user service for NixOS.
  • Added Ryoku's new shared internationalisation system, including the full upstream translation catalogue and language metadata.
  • Added the new ryoku-i18n tooling to NixOS while keeping all translation data inside the immutable Nix store.
  • Added the new upstream Stage controls and editor, including wallpaper foreground layers, positioning, angles, outlines and Stage widgets.
  • Added the latest upstream Ryoku Settings / Hub changes, including improvements to plugins, profile information, updates and translated UI elements.
  • Added the latest RyoStore backend and interface changes.
  • Added the latest Ryoport interface and backend changes.
  • Added the latest upstream Hyprland integration changes, including updated workspace, keybind and window-rule behaviour.
  • Updated Ryotunes to v1.0.6, replacing the previous legacy v2.5.1 build and bringing the latest native QML client, daemon, CLI and playback changes to Ryoku on NixOS.
  • Added the latest upstream Ryotunes integration used by the Ryoku CLI and Doctor.
  • Added the latest upstream Doctor checks including Stage, language and other new system reconciliation logic while retaining the NixOS-specific Doctor backend.
🛠️

Bug Fixes

  • Fixed Ryotunes packaging for the new v1 release layout.
  • Fixed the Ryotunes native QML client runtime path on NixOS while retaining the declarative ryotunesd service.
  • Fixed Ryotunes launching normal desktop helpers from its daemon by exposing the required NixOS runtime environment without reverting to mutable Arch-style paths.
  • Fixed shared translations not having a stable system-wide location on NixOS by exposing the immutable catalogue through RYOKU_I18N_DIR.
  • Fixed the Ryoku CLI not automatically seeing the new shared translation catalogue.
  • Fixed the shell, Hub and other Ryoku components not having a common NixOS translation path.
  • Fixed Ryostage's upstream mutable Python/venv installation model for NixOS. Required Python libraries are now supplied declaratively instead.
  • Fixed Ryostage model discovery on NixOS while retaining compatibility with existing Depth/Parallax model caches.
  • Fixed the new equalizer relying on Arch system paths by providing the required PipeWire, PulseAudio, systemd and helper tools through its Nix runtime.
  • Preserved the NixOS-specific Docker/Stash behaviour while updating it to the new translated upstream UI.
  • Preserved all existing NixOS-specific CLI, updater, Doctor, Ryogami, Ryotunes and system integration behaviour during the upstream rebase.
  • Fixed remaining references to the old neur0map Ryoku repositories following the upstream move to Ryoku-dev.
  • Synced previously missed lockscreen and shared UI changes discovered during the final upstream integrity audit.
🧹

Changes

  • Depth and Parallax have been retired upstream and replaced by Ryostage.
  • ryoku-depth has been removed and the old Parallax engine has transitioned to the new ryostage command.
  • awww has been removed from the Ryoku Nix runtime. Wallpaper rendering and transitions are now handled by Ryogami.
  • Ryostage model installation is declarative on NixOS. The upstream command is still supported, but NixOS does not create a mutable Python environment behind the user's back.
  • Equalizer startup is managed declaratively through NixOS rather than installing the upstream /usr/bin/pipewire systemd unit.
  • Translation catalogues now live in the shared ryoku/i18n tree instead of the older ryoku/ui/translations layout.
  • Ryoku on NixOS now tracks the new Ryoku-dev organisation for Ryoku and Ryotunes. Unrelated upstream repositories such as neur0map/glazepkg remain unchanged.
  • Ryotunes is now pinned to the exact v1.0.6 source used alongside this Ryoku release rather than following a moving latest version.
  • The old separate ryotunes-qml.desktop launcher has been removed in line with upstream Ryotunes. The standard Ryotunes launcher is now the canonical application entry.
  • RyoStore, Ryoport, Hyprland, the lockscreen and shared Ryoku UI have all been synchronised against the exact v0.63.1-beta.19 upstream source.
ARCHIVE // 0.60.1

0.60.1
BETA.19

RYOKU ON NIXOS
UPDATE PATCH NOTES

This update brings Ryoku on NixOS up to v0.60.1-beta.19, adding the latest upstream features while fixing several NixOS-specific issues found during testing/ bug reporting.

✨

Features added

  • Parallax Wallpapers with layered foreground/background effects and multi-monitor support
  • Parallax tab added beside Depth in Quick Settings
  • KDE colour integration allowing KDE apps to follow Ryoku/Matugen themes
  • Music visualizers now automatically update colours with your wallpaper
  • Improved visualizer rotation and edge positioning
  • Improved HDMI/TV monitor persistence
  • Power profiles now persist more reliably between sessions
  • Ghostty now keeps your personal configuration when Ryoku updates its theme
  • Full visible shell/widget parity with the latest upstream Ryoku
🛠️

Bug Fixes

  • Fixed Ryogami wallpaper UI failing to open on NixOS
  • Fixed Qt/QuickShell incompatibilities which could break wallpaper previews and multimedia features
  • Fixed Parallax not appearing automatically for users upgrading from older Ryoku versions
  • Fixed HDMI displays and TVs losing saved monitor settings after connector changes
  • Fixed wallpaper/theme changes not updating the now-playing spectrum correctly
  • Fixed Ghostty theme updates overwriting user settings
  • Fixed power profile state being lost unexpectedly
  • Removed outdated Spotify/Spicetify integration and leftover packaging
  • Fixed several NixOS packaging, service and dependency issues discovered during the 0.60 port
🧹

Changes

  • Spotify and Spicetify are no longer bundled or managed by Ryoku
  • Ryoku's Qt and QuickShell components are now kept on the same locked version to prevent compatibility issues
⁉️

Known Issues

  • Ryotunes Spotify doesnt work as intended (This song is not avaliable on spotify errors on every song), this is not a bug with NixOS and simply an upstream bug from the main repo
ARCHIVE // MUSUBI

MUSUBI
0.58.6

結び
BETA.19

Musubi, (meaning to tie together in Japanese) updates Ryoku on NixOS from 0.48.8-beta.18 → 0.58.6-beta.19.

✨

Features added

  • Ryogami wallpaper engine with live wallpapers, shaders, transitions, playlists and multi-monitor support
  • Depth Wallpapers fully integrated into Ryogami
  • Ryotunes with MPRIS and playerctl support
  • Ryoport with Looking Glass and optional GPU passthrough
  • Plugin system with install, validate, remove, export and QS Bar integration
  • QS Bar overhaul with persistent layouts, widget catalogue and improved Control Center
  • Rashin upgrades with packaged skills and Prowl code intelligence
  • New NixOS installer with dry runs, backups, rollback and safe flake editing aswell as finally fully supporting NixOS stable
  • Native Nix update backend
  • Declarative GPU passthrough module
  • New keyboard OSD, widgets, launcher actions and visual improvements
🛠️

Bug Fixes

  • Fixed Arch-only pacman, AUR and system management behaviour on NixOS
  • Fixed Doctor attempting unsafe Arch-specific repairs
  • Fixed update/version detection for local NixOS checkouts
  • Fixed SDDM theme switching and Polkit integration
  • Fixed Rashin skills not being packaged or detected
  • Fixed Rashin incorrectly identifying NixOS as Arch
  • Fixed Ryogami/Depth paths, renderer cleanup and multi-monitor behaviour
  • Fixed RyoVM help commands and missing xorriso
  • Fixed GPU passthrough being exposed before the host is configured
  • Fixed plugin install, discovery and cleanup issues
  • Fixed installer host detection and flake parsing edge cases
  • Fixed Git hooks failing on NixOS due to /bin/bash
  • Numerous additional NixOS path, service and dependency fixes
✅ Fully tested on my main PC and Testing laptop