Skip to main content
Ryoku ships a small, curated toolkit, not a grab bag of everything on the AUR. Everything below is installed, wired to a key, and working the moment you log in: a terminal, an editor, a browser, two file managers, a media player, and a command palette that reaches the rest. Want more software? Extras adds whole bundles in one click.

​
Core apps

Each core app has a launch key. Mod is Super. Neovim comes set up with a LazyVim configuration. mpv has no launch bind: it opens the media you hand it, and it is the audio engine behind RyoTunes. See Keybindings for the complete, authoritative bind list.

​
The launcher

Press Mod + Space to open the launcher, Ryoku’s command palette. Start typing to search apps, open windows, files, and snippets at once, or lead with a prefix to talk to one provider directly.
Type with no prefix and the launcher fans your query across apps, files, open windows, and snippets at once, ranked by score and by how often you launch each app.
The \ Rashin lane needs the optional Rashin agent enabled; see Rashin.

​
RyoTunes

RyoTunes is Ryoku’s built-in free music, and the launcher is its front door. There is no account and no API key, because YouTube Music’s public endpoints are keyless.
  • Search and play. Type @ then a song or artist. Results show real songs (clean title, artist, album, duration, and album art). Pick one and it plays inline.
  • Endless radio. Playing a track seeds a ~50-track YouTube Music radio and keeps the queue full, so the music never stops.
  • Paste a link. Paste a YouTube or YouTube Music URL (with or without @): a bare track seeds its radio, a ?list= link queues the whole playlist.
  • Saved playlists. Played playlists appear as a chip row under the now-playing card and replay instantly with no network round-trip.
  • Real transport. mpv-mpris publishes the stream as a normal MPRIS player, so the media keys, Next/Prev, shuffle, and the seekbar all work, and playing a YouTube track pauses your other players so audio never stacks.
RyoTunes needs yt-dlp, mpv (with mpv-mpris), and curl, all in the base set. Signing into a default browser lifts yt-dlp’s rate limit. This is streaming only; there is no library sync.

​
Screenshots

Press Mod + S to open Ryoshot, the screenshot and annotation tool.
1

Capture

Choose full screen, a region, or a single window.
2

Annotate

Draw with the rectangle, line, arrow, pen, marker, blur, or text tools, with undo and redo.
3

Save

The PNG is written to ~/Pictures/Screenshots.

​
Clipboard, voice, and the visualizer

Voice dictation types the transcription straight into the focused app (wtype). Press Mod + Shift + M to raise the visualizer over your windows instead of leaving it on the wallpaper. Clipboard history is also reachable in the launcher with the ; prefix.

​
Shell and CLI tools

The default login shell is fish, with the Starship prompt. The terminal comes stocked with modern replacements for the classic tools.

​
Extra helpers

Smaller tools power specific features, and they are on PATH if you want them directly.
Need software that isn’t here? Extras installs curated bundles (gaming, dev, office, security, and more) in one click, and the launcher’s package provider (install <name>) grabs anything from the repos.
Colors follow your wallpaper across every one of these tools; see Themes & wallpapers.

Keybindings

The complete, authoritative list of every shipped bind.

Extras

Add whole software bundles: gaming, dev, office, security.

Themes & wallpapers

How every app recolors to your wallpaper.

Rashin

The optional local AI agent behind the \ launcher lane.
Last modified on July 4, 2026