clipArch

A lightweight clipboard history tool that works the same way on GNOME and Hyprland.

01 // The Problem

Most clipboard managers on Linux are either too heavyweight, don't work across both GNOME and Hyprland, or have poor keyboard-driven UX for power users.

02 // The Solution

A lightweight Python clipboard manager that hooks into the system clipboard via xclip/wl-clipboard, stores history in SQLite, and surfaces it through a minimal GTK popup triggered by a keybind. Works seamlessly on both X11 and Wayland.

03 // Architecture

Clipboard daemon

xclip / wl-clipboard

detects clipboard change

Daemon (Python)

captures content, writes to history

SQLite

persisted history

GTK popup

keybind-triggered, search + paste

The same binary runs unmodified on X11 (GNOME) and Wayland (Hyprland).

05 // Operational Outcomes

X11 + Waylandsame binary works on both display servers

0mouse clicks needed to search and paste

Text + Imagesclipboard content types stored in history

SQLitehistory survives reboots

06 // Tech Stack

PythonCSS