explaingit

tranhuuhuy297/cliccy

16RustAudience · developerComplexity · 1/5LicenseSetup · easy

TLDR

Cliccy is a lightweight clipboard history manager for Linux that saves everything you copy, lets you search and paste old items with a keyboard shortcut popup, and works on both X11 and Wayland.

Mindmap

mindmap
  root((cliccy))
    Core feature
      Clipboard history list
      Text and image support
      20-item rolling history
    Interface
      Keyboard shortcut popup
      Search and filter
      System tray icon
    Controls
      Pin items permanently
      Delete individual entries
      Clear full history
    Tech stack
      Rust
      GTK4
      SQLite database
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Retrieve previously copied text or images on Linux without losing them when you copy something new.

USE CASE 2

Search your clipboard history with a keyboard shortcut and paste any older item with a single keypress.

USE CASE 3

Pin frequently used code snippets or text to keep them permanently in your clipboard history.

Tech stack

RustGTK4

Getting it running

Difficulty · easy Time to first run · 5min

One install script handles binary download, GNOME shortcut registration, and autostart, non-GNOME desktops require manual shortcut binding.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Cliccy is a clipboard history manager for Linux. When you copy text or an image, your computer normally forgets whatever was on the clipboard as soon as you copy something new. Cliccy runs quietly in the background and keeps a list of everything you have copied, so you can go back and paste older items without losing them. Pressing a keyboard shortcut (Ctrl+Alt+V by default) opens a small popup window showing your recent copies. You can start typing to filter the list, move through it with arrow keys, and press Enter to paste a chosen item. Images appear as small thumbnails inside the same list. The popup also lets you pin items you want to keep forever, delete individual entries, or clear the full history. A tray icon in the top bar gives you quick access to the same actions. The history is stored in a small database file on your computer, capped at 20 unpinned entries. Pinned items never expire. Everything is handled by a single small background process that wakes up only when the clipboard actually changes, so it does not slow down your computer or poll continuously. Cliccy works on both X11 and Wayland display systems and has been tested on Ubuntu 22.04 and newer. Installing it takes one command: a script downloads a prebuilt binary, registers the keyboard shortcut in GNOME, and sets up the background process to start automatically at login. If you are not on a GNOME desktop, you can bind the shortcut manually in your own desktop environment's keyboard settings. The project is written in Rust and uses GTK4 for its interface. It ships as a single binary with a dark Catppuccin color theme. The license is MIT.

Copy-paste prompts

Prompt 1
Install Cliccy on Ubuntu 22.04 with the one-command install script and set it up to start automatically at login, walk me through each step including how the keyboard shortcut gets registered.
Prompt 2
I'm using Cliccy on a non-GNOME Wayland desktop and need to bind the Ctrl+Alt+V shortcut manually, show me how to configure that in my desktop environment's keyboard settings.
Prompt 3
Show me how to use Cliccy's pin feature to save a code snippet I use constantly so it never gets pushed out of the history by new copies.
Open on GitHub → Explain another repo

← tranhuuhuy297 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.