Skip to content

murat-cileli/clyp

Repository files navigation

Clyp

Modern, fast, simple clipboard manager for Linux.

Key Features

  • Native application written in Go and GTK4.
  • Modern, clean, simple interface with minimal distractions.
  • Keyboard centric - Navigate, search, copy and delete items with keyboard.
  • High performance - Optimized SQLite backend tested with 10,000+ records.
  • Supports text and image content (up to 3 images) with image previews.
  • Wayland native GUI (watcher module is X11) - Works on both Wayland and X11.

Installation

Debian 13 / Ubuntu 24.04 and Later

  • Download DEB Package
  • apt install ./clyp_0.9.6_amd64.deb

Important

Depends on libgtk-4-bin

Arch Linux / Manjaro

Important

Depends on gtk4

Usage

Starting the Application

clyp

Or launch from your application menu.

Keyboard Shortcuts

Key Action
Ctrl+F Toggle search
a - z Type to search
Enter (On search bar) Focus first item on the list
Enter or Double Click (On the list) Copy selected item to clipboard
Delete Remove selected item
Escape Hide search bar / Close window
↑/↓ Navigate through clipboard history

Basic Operations

  1. Automatic Clipboard Monitoring: Clyp automatically captures text and images copied to your clipboard
  2. Browse History: Use the main window to browse through your clipboard history
  3. Search: Press Ctrl+F to search through your clipboard content
  4. Type to Search: Start typing to search history instantly
  5. Quick Copy: Select any item and press Enter to copy it back to your clipboard
  6. Delete Items: Select unwanted items and press Delete to remove them

Technical Details

The watcher is a minimal headless Gtk application. It monitors the clipboard and notifies the GUI of database changes via a UNIX socket.

Architecture

  • Language: Go 1.25.0
  • GUI Framework: GTK4 via gotk4 bindings
  • Database: SQLite3 for persistent storage
  • Platform: Linux (Wayland/X11)
  • Data Directory: ~/.local/share/bio.murat.clyp/
  • SQLite3 Database File: ~/.local/share/bio.murat.clyp/clyp.db

Building from Source (Ubuntu)

git clone https://github.com/murat-cileli/clyp.git
cd clyp
go mod download
sudo apt install -y \
  libglib2.0-dev \
  libgirepository1.0-dev \
  libgraphene-1.0-dev \
  libcairo2-dev \
  pkg-config \
  build-essential \
  libpango1.0-dev \
  libgdk-pixbuf-2.0-dev \
  libgtk-4-dev
go build .

TODO

  • Add import/export.
  • Add database encryption.

Contributing

Contributions are welcome! Please open an Issue first before submitting any code changes. Unsolicited Pull Requests will not be accepted. This process helps us discuss your ideas and ensure they align with the project goals before implementation.

Contributors

CREDITS