For Hyprland · Built with Quickshell

Your desktop. Reimagined.

A dynamic-island-inspired shell for Hyprland, built with Quickshell. Designed to make your Linux desktop feel uniquely yours.

Explore Ukishima View on GitHub

Free & open source
MIT licensed
Hyprland + Quickshell

Ukishima running on a live Hyprland desktop: the compact pill at the top of the screen and the floating dock at the bottom edge, over the desktop wallpaper. — Ukishima on Arch Linux + Hyprland — captured from the live desktop, not a mockup.

Live capture · Hyprland

Showcase

See it in action.

Three recordings of the live shell on an empty workspace, captured full screen at 60 fps and driven over Quickshell IPC.

One pill, multiple views

Switch between the clock, calendar, and system monitor without moving the pill or opening separate windows.

A full Ukishima desktop: the pill at the top of the screen opens the calendar in place, collapses, then opens the system monitor over the same desktop.

Quick actions, no clutter

Search and launch apps with a ranked list that updates as you type. Open the power menu from the same interface, then dismiss it when you're done.

A full Ukishima desktop: the pill opens the launcher, the app list narrows to Firefox as keys are typed, the launcher closes and the power menu opens from the same pill.

Wallpapers, mixer and clipboard

Open the wallpaper strip, the mixer with its quick tiles, and the clipboard history from the same pill.

A full Ukishima desktop: the pill opens the wallpaper strip, then the mixer with its quick tiles as the game mode tile toggles on and off, then the clipboard list, before collapsing back to the idle pill.

Features

Small island. Serious range.

A capability index, grouped by what you want to do. Surfaces open in place, from the pill or the dock, rather than in windows of their own.

Desktop & island

The pill is the shell. It sits at the top of every monitor, and every surface grows out of it, in place.

Morphing pill — a compact clock at rest that expands in place into the control centre — no window, no overlay.
Dock — pinned and running apps along the bottom edge, with hover magnification and multi-window previews, auto-hide, and its own theme and glass.
Per monitor — one pill and dock per output; an empty IPC argument targets the monitor you are on.
Self-contained — it never edits your Hyprland config — you add the launch line, the wallpaper daemon and the binds.

The Ukishima dock: a floating bar of pinned and running application icons at the bottom edge of the screen.

The dock at rest, along the bottom edge.

Media & audio

Playback and levels, driven by whatever is actually on the session.

MPRIS players — playback controls and artwork for every player on the session, with a cava visualiser over the pill.
Mixer — faders for the default output and input, plus every other sink and source you have.
OSD — volume, brightness and media keys flash up over the pill instead of in a floating box.

The Ukishima media surface, with playback controls and the current track.

The media surface, opened from the pill while something is playing.

System & utilities

The tools you reach for mid-task, one keybind each.

System monitor — uptime with live CPU, memory, network, disk and swap readouts.
Power menu — lock, log out, suspend, reboot and shut down — hold to confirm the destructive ones.
Screen recorder — fps, quality, cursor and mic/desktop levels, with a filmstrip of what you have captured.
Clipboard & scratchpad — clipboard history and a shelf of plain-text notes.
Notifications — a notification centre grouped per app, with a do-not-disturb toggle.
Extras — night light, game mode, keep-awake and an in-app updater.

Personalization

Accent, theme and glass, carried across the pill, the dock and every surface.

Accent — preset or custom accent colours; pick one and the whole interface retints to match.
Theme — Light, Dark, Dynamic and Manual dock themes — Dynamic follows your wallpaper.
Glass — let the desktop show through the pill, with a text-contrast control.
Fonts & text — pick the UI family and override the text colour.
Interface — UI scale, reduced motion, pill auto-hide and a memory saver.

See the settings

Wallpaper & lock screen

Paint the desktop, then lock it.

Wallpaper bag — a shuffled awww bag — set, hold or delete the current pick, with per-wallpaper fit.
Wallhaven — flip the strip to Wallhaven and fire tag searches straight from the surface.
Live wallpapers — mpvpaper video wallpapers, with a palette that retints the UI to match.
Session lock — the built-in Quickshell lock screen over a blurred still of your desktop, or a hand-off to your own hyprlock.conf — whichever the Lock setting points at.

The Ukishima wallpaper surface open over the desktop: a strip of wallpaper thumbnails from the awww bag, with the set and hold-to-delete hints on the current pick.

The wallpaper surface over the desktop: the awww bag as a strip of picks, with set and hold-to-delete on the current one.

Customization

Make it yours.

Pick an accent and a theme, and the whole shell retints to match — pill, dock and every surface. These are the real settings, captured live.

The theme settings with Light, Dark, Dynamic and Manual modes.

> theme settings · captured live

Installation

Set it up in four steps.

One command installs Ukishima and checks the dependencies. Then you add an auto-launch line, the keybinds and a lock bind to your own Hyprland config — the installer prints them, and nothing is changed behind your back.

Linux + Wayland

A Hyprland session (recent 0.4x / 0.5x)

Quickshell 0.3.0+

Hyprland, Wayland and Io modules

CLI tools

The installer checks them — see DEPENDENCIES.md

1
Run the installer
Clones Ukishima to ~/.local/share/quickshell/ukishima, then checks every dependency and reports what is missing. Re-run it any time to update.
bash
```
curl -fsSL https://raw.githubusercontent.com/amanhex/Ukishima/master/remote-install.sh | bash
```
Run it as your normal user — not with sudo.
2
Auto-launch it with Hyprland
Add these lines to your Hyprland config. launch.sh applies jemalloc decay settings to keep memory near the live working set (~250 MB RSS), and starts the wallpaper daemon so it is up before the shell restores your wallpaper.
```
exec-once = ~/.local/share/quickshell/ukishima/launch.sh
exec-once = awww-daemon
```

Add the keybinds

Every surface answers over Quickshell IPC. An empty monitor argument targets the focused monitor. Hyprlang and Lua are both listed — pick whichever your config uses.

bind = SUPER, SHIFT+W, exec, qs -p ~/.local/share/quickshell/ukishima ipc call ukishima wallpaper ""
bind = SUPER, SHIFT+V, exec, qs -p ~/.local/share/quickshell/ukishima ipc call ukishima clipboard ""
bind = SUPER, SHIFT+S, exec, qs -p ~/.local/share/quickshell/ukishima ipc call ukishima scratch ""
bind = SUPER, slash,   exec, qs -p ~/.local/share/quickshell/ukishima ipc call ukishima launcher ""
bind = SUPER, N,       exec, qs -p ~/.local/share/quickshell/ukishima ipc call ukishima notifications ""

Other IPC handlers: mixer, calendar, media, power, battery, sysmon, recorder, gameMode, peek, hide, page.

4
Bind the lock
Locking is a script rather than an IPC surface, so it gets its own bind. Which lock you get is the Lock setting in the shell: your own hyprlock, or the built-in Quickshell lockscreen, which hands back to hyprlock if it cannot lock the session.
```
bind = SUPER, L, exec, ~/.local/share/quickshell/ukishima/scripts/lock.sh
```

Read the script first

The installer downloads and executes a shell script. If you would rather see exactly what it does first, open remote-install.sh and read it before running it. The same goes for any install one-liner you find on the internet.

Open the repository Read the dependency list

FAQ

Common questions

Answers to what people usually ask before installing.

What is Ukishima?

Ukishima (浮島, “floating island”) is a dynamic-island-style shell for Hyprland, built with Quickshell. It puts a morphing pill at the top of every monitor that expands in place into a control centre, plus a floating dock at the bottom edge for pinned and running apps. It is self-contained and makes no changes to your existing Hyprland config.

What is Quickshell?

Quickshell is the Qt/QML-based shell toolkit Ukishima is built on. It provides the runtime, the Wayland integration and the Hyprland IPC that every Ukishima surface talks to. Quickshell documentation ↗

Does Ukishima require Hyprland?

Yes. Ukishima targets Linux on Wayland with a recent Hyprland (0.4x / 0.5x) and Quickshell 0.3.0+. It also expects a set of standard CLI tools — the installer checks for them and tells you what is missing. Dependencies ↗

Will it touch my Hyprland configuration?

No. Ukishima is self-contained and does not modify your existing config. You add the auto-launch line, the wallpaper daemon and the keybinds yourself — the installer prints them for you to copy.

How do I install it, and how do I update?

Run the install one-liner; it clones to ~/.local/share/quickshell/ukishima and checks dependencies. Re-running the same command updates it, as does the Update surface inside the shell's settings. Install steps ↗

How do I report a bug or contribute?

Open an issue on GitHub — bug reports, feature requests and pull requests all live there. Open an issue ↗

What license does Ukishima use?

Ukishima is free and open source, released under the MIT License. View the license ↗

Make your desktop feel like yours.

Free and open source. It works with the wallpaper bag, lock screen and CLI tools you already have.

Star it on GitHub Get started