Clave Install

Clave 1.1.4

Hyprland, finished.

A complete desktop for Arch Linux. Tiling kept.

Install Watch the tour
The Clave desktop: a terminal and Files floating over a dark wallpaper, with the menu bar and the Dock

Clave turns Hyprland into a desktop you can live in. A menu bar. A Dock. Overview. Control Center. System Settings. Every piece drawn in one style, and every piece off when you do not want it.

Get the highlights.

Overview with every window and Space
Overview. Every window on every Space, one key away.
Control Center open in the top right corner
Control Center. Network, sound, display and focus from the menu bar.
System Settings on the Appearance pane
System Settings. One pane for each part. Search finds any setting.
Search open over the desktop
Search. Open any app from the keyboard. The calculator works offline.
Apps showing the standard app set
Apps. The apps you open on purpose. Helpers stay out of the way.
The capture toolbar at the bottom of the screen
Screenshots. Press Print for the screen, a window, an area or a recording.
Activity Monitor listing processes
Activity Monitor. See what runs. Quit what you do not need.
Calendar month view with events
Calendar. Plain .ics files on your disk. No account.

Everything has a place.

Built in. Drawn in one style. Off means off.

Control Center

One click from the menu bar.

Control Center with Wi-Fi, Bluetooth, Focus, Night Light, display and sound

System Settings

A pane for each part of the desktop.

System Settings on the Appearance pane

The Dock

Pin what you use. Minimize with a genie effect.

The Dock

Screenshots

Press Print. Pick a screen, a window or an area.

The capture toolbar

Calendar

Plain .ics files. Yours to keep.

Calendar with a month of events

Activity Monitor

CPU, memory, disk and network at a glance.

Activity Monitor
FilesText EditorCalculatorCalendarClock
VideosCameraConsoleSystem InformationDisk UtilityKeychainBackupsActivity Monitor

Every app comes from the Arch repositories and runs no background service.

Safe from the start.

Secure and quiet by default. Nothing to set up.

Hardened by default

A firewall, AppArmor and a hardened kernel from the first install.

Private by design

No accounts. It works offline, and online features stay off until you want them.

Light on its feet

A feature you turn off starts nothing and uses no memory.

What the hardening changes
  • The linux-hardened kernel with lockdown, IOMMU and init_on_free.
  • An nftables firewall that drops inbound traffic. OpenSnitch asks before apps connect out.
  • AppArmor with apparmor.d, auditd and a sysctl lockdown.
  • USBGuard, faillock, a stricter sudo, umask 027 and a noexec /tmp.
  • An AIDE baseline and a daily arch-audit check.

Good to know. USB devices you plug in later are blocked until you allow them. Three wrong passwords lock the account for 15 minutes. Skip it all with --no-harden.

Read the recovery guide

How updates stay safe

Every release is signed, and clave-update installs only signed releases.

clave-doctor checks that Clave still works with what Arch installed. A pacman hook warns after an upgrade this release was not tested with.

The whole tour. Twenty seconds.

Overview, Control Center, Apps, System Settings and Search.

Recorded in a virtual machine, so animations run slower than on real hardware.

Every arch needs a keystone.

An arch is built from stones that cannot stand on their own. The last stone goes in at the top. It locks the others in place, and the arch holds.

Arch Linux gives you the stones. A kernel, a compositor, a shell and a hundred good tools. Clave is the keystone that locks them into one desktop.

ClaveSpanish, architecture

The keystone. The stone that holds an arch together.

ClaveSpanish, everyday

A key. The thing that opens what you need.

ClaveMusic

The rhythm the whole band keeps time to.

The mark is a keystone. It comes in seven stones.

Inside, every part is named for what it does.

OverviewSearchAppsFilesControl CenterNight LightSystem Settings

Nothing new to learn.

Install in one line.

On Arch Linux, as your normal user.

$ bash <(curl -fsSL https://raw.githubusercontent.com/Andrew-most-likely/clave/main/setup.sh)

Then log out and choose Hyprland. The installer asks before it changes anything.

Install by hand

Preview every change with --dry-run first.

git clone https://github.com/Andrew-most-likely/clave ~/.local/src/clave
cd ~/.local/src/clave
./install.sh --dry-run
./install.sh
Installer options
--yesNo questions. Hardening is included.
--no-hardenSkip the hardening.
--extrasAlso install the optional apps.
--personalUse fonts, a cursor and sounds you supply.
--user-onlyOnly your home folder. No sudo.
--dry-runShow what would happen. Change nothing.
Uninstall

Every file the installer replaced comes back. Packages stay installed.

~/.local/src/clave/uninstall.sh
~/.local/src/clave/uninstall.sh --system

The second line also removes the login screen, boot splash and hardening.

Six keys to start.

Press Super / for the rest.

Super+Space
Search
Super+Tab
Overview
Super+Return
Terminal
Super+,
System Settings
Print
Screenshot
Super+M
Minimize

Questions.

Will it replace my Hyprland config?

It moves your old config aside to a dated backup and keeps your screens, wallpapers and Dock apps. uninstall.sh puts everything back.

Where do my own settings go?

~/.config/hypr/custom.lua for any Hyprland setting. The installer never replaces it.

Can I use my own logo?

Yes. Put an SVG at ~/.config/clave/branding/logo.svg.

Something broke. What now?

Run clave-doctor, then open an issue on GitHub with its output and ~/.cache/clave/install.log.