neur0map · Oct 31, 2026 · Oct 28, 2026 · Oct 25, 2026 · Oct 28, 2026 · Oct 28, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -14,6 +14,16 @@ for finer detail.
   user is no longer in a mango session.
 
 ### Fixed
+- Fedora installs keep existing RPM Fusion FFmpeg and Docker CE packages, and
+  no longer request the nonexistent `util-linux-libs` package.
+- RyoStore no longer leaves other products with inert download buttons while an
+  install is running; their actions are disabled and say that another item is
+  downloading until the single-flight operation completes.
+- RyoStore category pages now list products A to Z and include a search field
+  that filters only the open category. The Apps marketplace keeps its Flathub
+  rankings and adds an explicit A-to-Z sort.
+- The Apps marketplace gives its sort chips and scoped search separate rows on
+  narrow windows, so neither overlaps the compact app grid.
 - Users on filtered networks can route `ryoku update` and pacman through a
   local HTTP proxy without weakening package signature checks.
 - Screenshots no longer pick up the animated pointer when a cursor effect has

diff --git a/VERSION b/VERSION
@@ -1 +1 @@
-1.0.6
+1.0.7
diff --git a/docs/barstyles.md b/docs/barstyles.md
@@ -146,7 +146,8 @@ Its settings use the `orpheus` namespace in `shell.json`:
 | `mirror` | boolean | `true` | Mirror the spectrum around the centre. |
 | `feel` | `fluid` or `tight` | `fluid` | Set the wave spring and damping. |
 | `workspaceStyle` | `dots`, `numbers`, `kanji`, `greek`, `dashes`, or `icons` | `dots` | Choose the workspace marks. |
-| `workspaceShowEmpty` | boolean | `true` | Include empty workspaces. Where workspaces are numbered, gaps fill in and one free slot follows the last used. |
+| `workspaceShowEmpty` | boolean | `true` | Include empty workspaces. Where workspaces are numbered, gaps fill in and one free slot follows the last used unless `workspaceSpare` is off. |
+| `workspaceSpare` | boolean | `true` | With `workspaceShowEmpty` on, add one free slot after the last used workspace. Off ends the strip at the last workspace that exists. |
 | `showDate` | boolean | `true` | Show the date under the idle time. |
 | `seconds` | boolean | `false` | Show seconds in the idle time. |
 | `voiceWeather` | boolean | `true` | Show the weather beside the idle time. |
@@ -160,6 +161,7 @@ Its settings use the `orpheus` namespace in `shell.json`:
 | `actions` | subset of `launcher`, `ask`, `overview`, `clipboard`, `capture`, `wallpaper`, `hub` | `["launcher","capture","clipboard"]` | Choose shortcut actions. |
 | `trayLimit` | `3` to `12` | `6` | Set the visible tray item limit. |
 | `statusItems` | subset of `wifi`, `bluetooth`, `volume`, `mic` | all four | Choose the icons in the Controls module. |
+| `aiTools` | subset of `claude`, `codex`, `opencode` | all three | Choose which coding agents the AI usage module counts. Modules page, AI usage. An empty list hides the module. |
 
 The name is Orpheus, the musician of Greek myth whose lyre moved rivers and
 stones. Made by neur0map.

diff --git a/docs/compositors.md b/docs/compositors.md
@@ -35,6 +35,10 @@ A provider is one binary, `ryoku-wm-<name>`, shipped by
 |`session`|the `wayland-session` desktop entry|
 |`environment <pid>`|export the provider's opaque handle from one verified session process|
 
+Ordinary workspace frames carry a one-based `index` inside their output. The
+handle in `id` remains the only action argument; `index` is presentation order,
+and consumers preserve frame order when an older provider omits it.
+
 `ryoku wm compat <plugin-dir>` is the neutral plugin gate. It scans QML,
 JavaScript, shell, Python and executable files without running them, then
 compares any foreign shell interfaces it finds with `caps.foreignApis`. A

diff --git a/docs/store.md b/docs/store.md
@@ -71,6 +71,18 @@ product keeps an artwork stage, while a responsive editorial grid exposes the
 rest of the collection. A card may animate its cover only while hovered.
 Status and actions always belong to the committed selection.
 
+The Apps catalogue is the marketplace surface. It opens with a featured shelf,
+a row of Flathub category plates, a `TRENDING / POPULAR / NEW / UPDATED`
+strip, and compact icon and text tiles in a responsive grid. The category
+plates come from the main category tags the provider already carries and show
+their counts, so a plate exists only when the catalogue has something in it.
+The field beside the sort strip narrows the loaded catalogue in place, and the
+shelf steps aside while a category or a filter is active. The strip sorts the
+union of Flathub's popular, trending, recently added and recently updated
+collections by the matching ranking field, so the tabs describe the catalogue
+rather than reshuffling one popular page. A header search for Flathub keeps
+its relevance order and uses the same compact tiles.
+
 The rail exposes one semantic route order:
 
 ```text
@@ -168,15 +180,21 @@ ryoku/apps/ryostore/
     provider_bars.go
     provider_shell_qml.go
     provider_fastfetch.go
+    provider_flatpak.go
   quickshell/
     shell.qml
     App.qml
     StoreHeader.qml
     ShowroomStage.qml
-    Filmstrip.qml
-    SearchLayer.qml
+    AppsHero.qml
+    AppsTile.qml
+    AppsSearch.qml
     ProductDetail.qml
     ProductCover.qml
+    ProductMedia.qml
+    ProductGrid.qml
+    ProductCard.qml
+    ProviderTabs.qml
     StatusReadout.qml
     lib/
       store.js
@@ -262,6 +280,16 @@ lives under `modules/bar/barstyles/<id>/`, a qylock theme under the qylock theme
 and a plugin in the plugin data directory. Ryostore owns their catalogue adapter
 and installation, not a second runtime copy.
 
+Install, update, removal, and enablement are single-flight so receipts and package
+manager state cannot race. While one product is active, every other product keeps
+its action visible but disabled and names the operation that is already running;
+the active product continues to show the backend's real byte or step progress.
+Within a category, products are ordered by display name and a local search field
+filters only that category. Marketplace categories with explicit ranking controls
+keep those controls; Apps also offers **A to Z** alongside Flathub's Trending,
+Popular, New, and Updated rankings.
+
+
 ## Provider behavior
 
 - **Lockscreens:** fetch the qylock catalogue, preview cache, and install-only
@@ -288,14 +316,18 @@ and installation, not a second runtime copy.
   the category offers Popular, New, and Verified orderings and global search.
   Its thousands of preview and gallery URLs deliberately bypass eager asset
   warming; only visible delegates request their remote media.
-- **Apps (Flatpak):** list up to 300 of the most popular desktop applications
-  from the Flathub collection API, joined with `flatpak list`, so an installed
-  Flathub application outside that ranking is still listed and removable.
-  Flathub is a third-party source: it does not pass through the `ryostore`
-  registry or its screening. The detail labels Flathub's verified or
-  unverified state when known (or unknown for installed-only items) and warns
-  before installation; verification is not a Ryostore safety review. New apps
-  use the system Flatpak installation and its shared runtimes when its
+- **Apps (Flatpak):** list the union of Flathub's popular, trending, recently
+  added and recently updated collections (up to 300 each), joined with
+  `flatpak list`, so an installed Flathub application outside those rankings is
+  still listed and removable. Each hit carries its trending score, monthly
+  installs, listing date and update date for the marketplace strip. The union is
+  cached as one snapshot and served flagged offline when Flathub is
+  unreachable; a partial fetch keeps the collections that answered and leaves
+  the complete cache in place. Flathub is a third-party source: it does not pass
+  through the `ryostore` registry or its screening. The detail labels Flathub's
+  verified or unverified state when known (or unknown for installed-only items)
+  and warns before installation; verification is not a Ryostore safety review.
+  New apps use the system Flatpak installation and its shared runtimes when its
   `flathub` remote is valid; if only the user installation has a valid remote,
   they install there instead. System installs may ask for authorization.
   The store never adds a remote. When neither installation has a valid remote,

diff --git a/docs/updates.md b/docs/updates.md
@@ -428,7 +428,11 @@ package provides (rustup for rust, tuned-ppd for power-profiles-daemon) counts
 as present, so the box's own choice is never overwritten, and the opt-in names
 (`ryokumanifest.OptIn`: hardware packages, the Limine hook and snapshot sync,
 and prowl, which only ever arrives as ryoku-rashin's dependency)
-belong to their gated reconcilers and are never converged. The deliver-once
+belong to their gated reconcilers and are never converged. On a CachyOS box
+(os-release `ID=cachyos`) the manifest is read without the names its layer
+replaces (`cachyosReplaces`, from `system/packages/cachyos.replaces`: the stock
+`linux` kernel and `yay-bin`), so a box converted in place, which has no ledger
+entries for them, is never offered them either. The deliver-once
 apps stay `reconcileShippedApps'` lane, so one update never runs two
 transactions over the same names. Best-effort: a box with no mirror or no
 network reports what did not land and the update moves on. `ryoku verify`

diff --git a/fedora/packages/rpm/fetch/hyprland-preview-share-picker.sh b/fedora/packages/rpm/fetch/hyprland-preview-share-picker.sh
@@ -3,7 +3,7 @@ set -euo pipefail
 
 : "${RYOKU_FETCH_TREE:?}"
 package=hyprland-preview-share-picker
-commit=e2f30ff85486e557018523da45ccbc846e3a499c
+commit=7e11349d3f6ecae75b42be73d6a258503656cc8f
 root="$RYOKU_FETCH_TREE/.rpm-$package"
 dest="$root/$package"
 rm -rf "$root"

diff --git a/fedora/packages/rpm/gpu-screen-recorder.spec b/fedora/packages/rpm/gpu-screen-recorder.spec
@@ -27,7 +27,6 @@ BuildRequires:  pulseaudio-libs-devel
 BuildRequires:  vulkan-headers
 BuildRequires:  wayland-devel
 Requires:       bash
-Requires:       ffmpeg-free
 Requires:       libcap
 Requires:       libjpeg-turbo
 Requires:       mesa-dri-drivers

diff --git a/fedora/packages/rpm/hyprland-preview-share-picker.spec b/fedora/packages/rpm/hyprland-preview-share-picker.spec
@@ -3,7 +3,7 @@
 %global ryoku_vendor cargo
 %global ryoku_vendor_dir .rpm-hyprland-preview-share-picker/hyprland-preview-share-picker
 Name:           hyprland-preview-share-picker
-Version:        0.1
+Version:        0.3.0
 Release:        1%{?dist}
 Summary:        Preview screen share picker for Hyprland
 License:        MIT

diff --git a/fedora/packages/rpm/ryogami.spec b/fedora/packages/rpm/ryogami.spec
@@ -24,8 +24,8 @@ BuildRequires:  wayland-devel
 BuildRequires:  wayland-protocols-devel
 BuildRequires:  ffmpeg-free-devel
 Requires:       quickshell >= 0.3.0
-Requires:       ffmpeg-free
-# ffmpeg-free can otherwise resolve libopenh264 to Fedora's no-codec stub.
+Requires:       /usr/bin/ffmpeg
+# Fedora's ffmpeg-free can otherwise resolve libopenh264 to its no-codec stub.
 Requires:       openh264
 Requires:       ImageMagick
 Requires:       qt6-qtmultimedia

diff --git a/fedora/packages/rpm/ryoku-desktop.spec b/fedora/packages/rpm/ryoku-desktop.spec
@@ -52,8 +52,6 @@ Requires:       papirus-icon-theme
 Requires:       kf6-syntax-highlighting
 Requires:       brightnessctl
 Requires:       playerctl
-Requires:       mpv
-Requires:       mpv-mpris
 Requires:       yt-dlp
 Requires:       wl-clipboard
 Requires:       grim
@@ -65,7 +63,7 @@ Requires:       pulseaudio-utils
 Requires:       jq
 Requires:       dbus-tools
 Requires:       ImageMagick
-Requires:       ffmpeg-free
+Requires:       /usr/bin/ffmpeg
 Requires:       curl
 Requires:       zenity
 Requires:       iw
@@ -105,6 +103,8 @@ Requires:       kernel-headers
 Requires:       dkms
 
 Recommends:     power-profiles-daemon
+Suggests:       mpv
+Suggests:       mpv-mpris
 Suggests:       kitty
 Suggests:       fish
 Suggests:       blesh

diff --git a/fedora/packages/rpm/ryoku-keysounds-profiles.spec b/fedora/packages/rpm/ryoku-keysounds-profiles.spec
@@ -11,7 +11,7 @@ BuildRequires:  coreutils
 BuildRequires:  ffmpeg-free
 BuildRequires:  findutils
 BuildRequires:  python3
-Requires:       ffmpeg-free
+Requires:       /usr/bin/ffmpeg
 
 %description
 The real switch recordings both key-sound engines use, cut from the MIT-licensed

diff --git a/fedora/packages/rpm/ryoku-shell.spec b/fedora/packages/rpm/ryoku-shell.spec
@@ -16,7 +16,7 @@ BuildRequires:  wayland-devel
 BuildRequires:  wayland-protocols-devel
 BuildRequires:  ffmpeg-free-devel
 Requires:       quickshell >= 0.3.0
-Requires:       ffmpeg-free
+Requires:       /usr/bin/ffmpeg
 Requires:       libwayland-client
 Requires:       libwayland-cursor
 Requires:       libwayland-egl

diff --git a/fedora/packages/rpm/ryotunes.spec b/fedora/packages/rpm/ryotunes.spec
@@ -31,7 +31,7 @@ Requires:       webkit2gtk4.1
 Requires:       libappindicator-gtk3
 Requires:       mpv-libs
 Requires:       yt-dlp
-Requires:       ffmpeg-free
+Requires:       /usr/bin/ffmpeg
 Requires:       openssl-libs
 Requires:       librsvg2
 Requires:       desktop-file-utils

diff --git a/fedora/packages/translations.tsv b/fedora/packages/translations.tsv
@@ -139,8 +139,8 @@ matugen	ryoku-extras	desktop	Bundled by the Ryoku extras RPM.
 mesa	mesa-dri-drivers mesa-libGL	desktop	
 mise	mise	dev	Ryoku-owned RPM.
 mkinitcpio	dracut	system	
-mpv	mpv	desktop	
-mpv-mpris	mpv-mpris	desktop	
+mpv	mpv	optional	
+mpv-mpris	mpv-mpris	optional	
 nautilus	nautilus	desktop	
 nautilus-python	nautilus-python	desktop	
 neovim	neovim	desktop	
@@ -254,7 +254,7 @@ ttf-readex-pro	ttf-readex-pro	desktop	Ryoku-owned RPM.
 ttf-rubik-vf	google-rubik-fonts	desktop	
 udev	systemd-udev	desktop	
 upower	upower	desktop	
-util-linux-libs	util-linux-libs	hyprland	
+util-linux-libs	-	hyprland	Fedora splits these libraries; RPM soname dependencies install the required providers.
 uv	uv	desktop	
 v4l2loopback-dkms	v4l2loopback v4l2loopback-dkms	optional	Provided by a restricted COPR.
 vdirsyncer	vdirsyncer	desktop	

diff --git a/installation/CHANGELOG.md b/installation/CHANGELOG.md
@@ -1,6 +1,18 @@
 # Changelog: installation/
 
 ## Unreleased
+- **Zsh installs open with Ryoku's configured prompt on the first boot.** The
+  Arch, CachyOS and Void installers copy the packaged startup template after
+  selecting Zsh, while leaving an existing `.zshrc` untouched.
+- **Fresh installs keep the launcher radio while leaving its player removable.**
+  The default-on Apps list owns `mpv` and `mpv-mpris` on Fedora and Void;
+  Arch and CachyOS continue to install both from their base set
+  (`installerplan/components.tsv`, `../ryoku-shell-installer/engine.go`).
+- **Shell conversions install headers for their existing kernels.** The
+  installer skips stock `linux-headers` with the rest of the replacement boot
+  chain, reads each installed kernel's `pkgbase`, and adds its matching header
+  package only when pacman's enabled repositories provide it
+  (`../ryoku-shell-installer/engine.go`).
 
 ### Added
 - **The Arch, CachyOS and Void ISOs have one edition-appropriate Gaming

diff --git a/installation/backend/lib/deploy.sh b/installation/backend/lib/deploy.sh
@@ -24,6 +24,7 @@ ryoku_deploy() {
 
   ryoku_deploy_repo              # [ryoku] stanza + mirrorlist + keyring trust (local)
   ryoku_deploy_packages          # pacman -S the desktop set (needs net)
+  ryoku_seed_login_shell_config
   ryoku_seed_initcpio_hook       # the HOOKS-named trim hook, if that set never came
   ryoku_seed_keymap              # chosen kb_layout into the neutral store
   ryoku_deploy_chown "$u"        # the store seed creates ~/.config as root; hand
@@ -35,6 +36,33 @@ ryoku_deploy() {
   ryoku_deploy_qylock            # qylock writes user files as the now-owning user
 }
 
+ryoku_seed_login_shell_config() {
+  local root=${RYOKU_TARGET_ROOT:-/mnt} template user target
+  [[ ${RYOKU_LOGIN_SHELL:-fish} == zsh ]] || return 0
+  template="$root/usr/share/ryoku/zsh/zshrc"
+
+  if [[ -n ${RYOKU_DRYRUN:-} ]]; then
+    for user in "${RYOKU_ACCOUNT_NAMES[@]}"; do
+      log 'DRYRUN: seed %s from %s when missing' "$root/home/$user/.zshrc" "$template"
+    done
+    return 0
+  fi
+  if [[ ! -f $template ]]; then
+    log 'WARNING: zsh is the login shell but its Ryoku startup template is missing at %s' "$template"
+    return 0
+  fi
+
+  for user in "${RYOKU_ACCOUNT_NAMES[@]}"; do
+    target="$root/home/$user/.zshrc"
+    [[ ! -e $target && ! -L $target ]] || continue
+    install -Dm644 "$template" "$target"
+    if [[ $root == /mnt ]]; then
+      run "$RYOKU_TARGET_CHROOT" /mnt chown "$user:$user" "/home/$user/.zshrc"
+    fi
+    log 'seeded the zsh login config for %s' "$user"
+  done
+}
+
 # deploy_file: one config file, mode 644, parents made.
 deploy_file() {
   local src=$1 dst=$2

diff --git a/installation/installerplan/components.tsv b/installation/installerplan/components.tsv
@@ -11,6 +11,7 @@ yazi	Yazi	terminal	Terminal	yazi	-	on	apps	false	*	-	-	terminal file manager
 cli-tools	Modern CLI tools	terminal	Terminal	eza,bat,fzf,zoxide	-	on	apps	false	*	-	-	ls and cat replacements; fuzzy history and directory search
 git-tools	Git tools	terminal	Terminal	github-cli,lazygit	-	on	apps	false	*	-	-	the gh CLI and lazygit terminal UI
 pavucontrol	PulseAudio GUI	media	Media & tools	pavucontrol	-	on	apps	false	*	-	-	the mixer the bar's audio button opens
+radio	Launcher radio	media	Media & tools	mpv,mpv-mpris	-	on	apps	false	*	-	-	live radio in the launcher
 songrec	Songrec	media	Media & tools	songrec	-	on	apps	false	*	-	-	Recognize Music in the launcher
 openrgb	OpenRGB	media	Media & tools	openrgb	-	on	apps	false	*	-	-	keyboard and mouse lighting follows the wallpaper palette
 upscale	AI upscale	media	Media & tools	waifu2x-ncnn-vulkan	-	on	apps	false	*	-	-	ryoshot Beautify HD and ryowalls Enhance

diff --git a/release/CHANGELOG.md b/release/CHANGELOG.md
@@ -1,6 +1,17 @@
 # Release / Packaging Changelog
 
 ## Unreleased
+- **The desktop package carries the Zsh startup template.** Fresh installers and
+  Doctor can seed it without relying on CachyOS skeleton files or replacing a
+  user's `.zshrc`.
+- **The launcher radio's player can be removed.** `mpv` and `mpv-mpris` are
+  optional desktop packages delivered once on a fresh Ryoku box. Removing them
+  now sticks across upgrades, and the radio offers an install hint instead of
+  failing silently.
+- **Desktop packages no longer force stock Arch kernel headers.**
+  `ryoku-desktop` keeps DKMS but leaves headers to the installed kernels. The
+  CachyOS installer replaces both stock kernel packages, and doctor installs
+  each installed Arch or CachyOS kernel's matching header package.
 
 ### Added
 - **The shell installs its equalizer backend automatically.** `ryoku-shell`
@@ -152,6 +163,10 @@
   the other plugin packages.
 
 ### Fixed
+- **The Hyprland share picker works with Hyprland 0.57 again.** The Arch and
+  Fedora packages now ship upstream 0.3.0, which no longer parses Hyprland's
+  workspace data through `hyprland-rs`. Outputs and Windows load again instead
+  of leaving Discord monitor shares black or forcing Region selection.
 - **Fedora and Arch build the image-border plugin against Hyprland 0.57.**
   Fedora moved `hyprland-devel` and Arch moved `hyprland` to 0.57, whose
   renderer passes an explicit `CRenderContext` and dropped the `m_renderData`

diff --git a/release/packages/README.md b/release/packages/README.md
@@ -54,9 +54,10 @@ full checkout. The Go binaries and QML plugins are built into `$srcdir`, so the
 source tree is never modified, and `makepkg --clean` removes `$srcdir` and
 `$pkgdir` afterward.
 
-The `gpk`, `skwd-paper-bin`, and `ryoku-keyring` PKGBUILDs fetch pinned
-upstream artifacts instead of building from the checkout. `prowl` is also
-pinned upstream, but builds its selected commit from source.
+The `gpk`, `skwd-paper-bin`, `hyprland-preview-share-picker`, and
+`ryoku-keyring` PKGBUILDs fetch pinned upstream artifacts or source instead of
+building from the checkout. `prowl` is also pinned upstream, but builds its
+selected commit from source.
 
 ## Shared package payloads
 

diff --git a/release/packages/hyprland-preview-share-picker/PKGBUILD b/release/packages/hyprland-preview-share-picker/PKGBUILD
@@ -1,8 +1,8 @@
 # Maintainer: Ryoku <releases@ryoku.dev>
 pkgname=hyprland-preview-share-picker
-pkgver=0.2.1.r9.ge2f30ff
+pkgver=0.3.0
 pkgrel=1
-_commit=e2f30ff85486e557018523da45ccbc846e3a499c
+_commit=7e11349d3f6ecae75b42be73d6a258503656cc8f
 pkgdesc="Preview-based screen-share source picker for Hyprland"
 arch=('x86_64')
 url="https://github.com/WhySoBad/hyprland-preview-share-picker"