Meet copyzen: The Minimalist Wayland Clipboard Manager I Built

Tired of buggy Wayland clipboard managers missing crucial features, I built an all-in-one solution. Meet copyzen: minimalist, fast, customizable, and perfectly suited for your workflow.

3 min read
By Harduex
Meet copyzen: The Minimalist Wayland Clipboard Manager I Built

Switch to Wayland, they said. It's the future, they said.

And it is—especially with the sleek new Pop!_OS COSMIC desktop. But when it came to managing my clipboard history, the ecosystem felt unpolished. I tried almost every clipboard manager out there. Most were either buggy, bloated, missing crucial features, or forced a rigid UI that completely clashed with my system's aesthetic.

I didn't want to adapt my workflow to a buggy app. I wanted an all-in-one solution that met a very strict set of criteria:

  1. Minimalist. It should do exactly one thing—manage history—and stay out of my way.
  2. Customizable. It needs to look and feel native to my workflow and match my vibe.
  3. Pinning / Favorites. I need to be able to save important snippets forever.
  4. Keyboard-driven. My hands shouldn't have to leave the home row (though it still needs to work with a mouse).
  5. Fast. No loading delays, no heavy memory footprint.
  6. Shortcut-triggered. It must be instantly accessible via Super+V (the standard Windows-style muscle memory).

Nothing out there checked every single box.

So, I built it myself.

Enter copyzen

copyzen is a minimalist, daemon-free Wayland clipboard manager built specifically for Pop!_OS COSMIC and other Wayland compositors.

Instead of building a massive app, copyzen acts like a silent backend. It uses standard tools (wl-clipboard for the heavy lifting and fuzzel for the UI) to give you a blazing-fast, entirely customizable clipboard history.

Here is what makes it different:

  • Fast and Fluid: The moment you hit your shortcut, the picker appears. You can navigate with your keyboard or mouse. Press Enter (or click) to select the item you want, and it instantly loads into your active clipboard. Then, just paste normally with Ctrl+V wherever you are.
  • Smart Pinning: Need a snippet to stick around forever? Press Ctrl+S on any entry in the picker to pin it. Pinned entries get a ★, jump to the top of your list, and survive total history wipes.
  • Immortal Images: Ever copy a screenshot, close the snippet tool, and find you can't paste the image anymore? copyzen fixes this. It keeps images alive in the background and even generates thumbnail previews right in your picker.
  • Total Control: Want to clean house? Ctrl+Shift+D deletes a specific snippet, and Ctrl+Shift+C wipes your history entirely (leaving your pinned favorites safe).
  • Your Vibe: Because it uses fuzzel as the frontend, it inherently respects your system's styling and scaling. It doesn't look like a bolted-on third-party app; it looks like it belongs there.

It's not a bloated Swiss Army knife. It's a single, perfectly sharpened blade.

Getting Started in 60 Seconds

I wanted the installation to be as frictionless as using the tool itself. As long as you have wl-clipboard and fuzzel installed on your system, you can grab the latest version of copyzen with a single command.

Drop this into your terminal:

# Downloads, verifies, and installs copyzen and its background service
curl -fsSL https://github.com/Harduex/copyzen/releases/latest/download/install.sh | sh

The script sets up everything automatically—the binaries, the background watcher, and the configuration. It is completely idempotent, meaning you can run it again later to update.

Map it to your keyboard

To make it truly seamless, you just need to bind it to a shortcut. If you are daily-driving COSMIC:

  1. Open SettingsDesktopKeyboardCustom Shortcuts.
  2. Click Add Shortcut.
  3. Set the Command to: copyzen-menu
  4. Set the Shortcut to: Super+V (or whatever combo you prefer).

Press Super+V, find your snippet, hit Enter, and paste it.

Customize Your Theme and Settings

Since copyzen relies entirely on fuzzel for its user interface, customizing it is incredibly straightforward. During installation, a scoped configuration file is automatically created for you.

To change how the picker looks—whether you want to tweak the colors, adjust the font, or set the perfect opacity to match your desktop's theme—simply edit the configuration file located at:

~/.config/copyzen/fuzzel.ini

Inside this file, you can define your own aesthetic without affecting other tools on your system. You can tweak everything from background transparency and text colors to the exact border widths, paddings, and fonts you prefer.

When the ecosystem doesn't have the exact tool you need, you have two choices: compromise your workflow, or open your code editor.

I built copyzen because I was tired of compromising with buggy clipboard managers. If you've been looking for a Wayland solution that respects your memory, your workflow, and your aesthetic, give it a try.

Happy copying!