sea-shell 7.0 · back on Linux

A desktop for Hyprland.

The bar, dock, launcher, lock screen, notifications, widgets and control center are one Quickshell process, and your wallpaper picks every colour.

bash <(curl -fsSL https://raw.githubusercontent.com/MiyukiVigil/sea-shell/main/bootstrap.sh)

For CachyOS and Arch, Hyprland 0.55+ and Quickshell 0.3. Use bash <(…), not a pipe, so sudo can still ask for your password.

New in 7.0

A fresh start, from the lock screen up.

7.0 rebuilds what you see before and after the desktop, groups your notifications, gives every dropdown the same controls, and teaches the widgets to read the wallpaper.

lock

Lock screen

Built into sea-shell
New

Your clock in your profile font, and what arrived while you were away, grouped by app. Any key brings up your picture and the password field.

  • Caps Lock, keyboard layout and fingerprint prompts under the field
  • Runs as its own process; if it fails to come up, hyprlock takes over the locked session
  • Admin password prompts are sea-shell dialogs too, on the monitor you are using
Settings, Your profile page, with a live preview of the lock screen.
power_settings_new

Power menu

Hold to confirm
Redesigned

Log out, restart and shut down fill a ring while you hold them, so a stray click never ends your session.

  • Lists the apps that would close
  • Shut down in 15 min, 30 min or an hour
  • Hold F for firmware setup on UEFI machines
notifications

Notifications

Grouped by app

A second message from the same app joins the first instead of stacking. Expand a group, mute an app, or dismiss it whole, then undo with Ctrl+Z.

search

Launcher

Finds open windows

Your open windows come first, labelled by workspace, then apps by how often you use them. Enter goes straight to the window.

tune

Dropdowns

One set of parts

Bluetooth, sound, battery and the calendar are built from the same header, sections and rows as Wi-Fi. Sound outputs are named by what they are, not by their ALSA path.

Bluetooth dropdown. Sound dropdown with named outputs. Battery dropdown with power profiles. Calendar dropdown with timers and world clock.
widgets

Widgets

They read the wallpaper
New kinds

Calendar and battery widgets join clock, weather, media and system, each in three sizes.

  • Text turns light or dark with what is underneath it
  • Placed around what is in the wallpaper, not on top of it
  • Gauges sweep to new readings instead of jumping

The desktop

Everything, in one process.

No waybar, rofi, mako or swaync. One Quickshell process draws all of it, so the launcher opens without a spawn delay and the dock already knows what the bar knows.

view_agendaBarWorkspaces, the focused app, media, tray and status pills, each one movable.
menuGlobal menuThe focused window's menu bar, for Qt, GTK, KDE, Firefox and Electron.
dock_to_bottomDockPinned and running apps on any edge, per monitor.
appsLauncherWindows, apps, maths, files, web, clipboard and emoji.
graphic_eqAudioRouting, per-app volume, synced lyrics, bit-perfect detection.
screenshot_regionCaptureScreenshots with an editor, OCR, and a screen recorder.
backupUpkeepUpdates, a health check, backups and a bar supervisor.
grid_view

Overview

Every workspace at once

See what is open everywhere and jump to it with the arrow keys or a number.

settings

Control center

Twenty-four pages

A search field that finds any setting, a live preview on Appearance and Profile, and changes that apply as you make them.

  • Appearance, fonts, icons and wallpaper
  • Your profile, used on the lock and power menu
  • Desktop widgets, dock, keybinds, idle and more

Colour

Your wallpaper picks the colours.

Change the wallpaper and the whole desktop follows: the bar, every panel, the widgets, GTK and Qt apps, and the sea-shell logo itself.

palette

Try it on this page

The sea takes the accent; the sunset stays warm

Install

One line.

The bootstrap clones the repo and runs the installer, which keeps a backup of anything it replaces and can put it all back.

arrow_forward

Three steps

About ten minutes on a fresh CachyOS
  1. Run the bootstrap
    bash <(curl -fsSL https://raw.githubusercontent.com/MiyukiVigil/sea-shell/main/bootstrap.sh)
  2. Log in to Hyprland

    A short setup tour opens on first start. Upgrading from 6.x shows what is new in 7.0 instead.

  3. Configs only, on another distro
    ./install.sh --no-deps
check_circle

Built for

What it is tested on
  • check_circleCachyOS or another Arch base
  • check_circleHyprland 0.55 or newer
  • check_circleQuickshell 0.3
  • check_circlekitty, fish and starship

Read the full guide ›