clipse

clipse [flags] [command]

clipse is a clipboard manager written in Go that provides a terminal user interface for browsing, searching, and managing clipboard history. It supports both text and images, works on Wayland, X11, and macOS, and is built with the BubbleTea TUI framework.
Key features include fuzzy search and filtering, multi-select for bulk operations, pinning important entries to persist through clears, duplicate filtering, configurable history limits (default 100 entries), auto-paste support, and the ability to exclude specific applications from monitoring. The TUI appearance and keybindings are fully customizable.

-listen

Run a background listener process that monitors clipboard changes.

Run the listener in the current terminal for debugging.

Add string to clipboard history without copying to system clipboard. Accepts stdin.

Copy string to the system clipboard. Accepts stdin.

Print the current clipboard content to the console.

Print entire clipboard history to stdout.

Wipe all clipboard history except pinned items.

Wipe the entire clipboard history including pinned items.

Kill any existing background listener processes.

Pause clipboard monitoring for a specified duration (e.g., 5m, 1h).

Print the version.

Display help information.

Configuration stored at ~/.config/clipse/configuration.json. Theme stored separately as custom_theme.json in the same directory. Options include maxHistory, duplicate filtering, auto-paste keybind, excluded apps/windows, and custom theme colors.

On Wayland, requires wl-clipboard installed for text and image clipboard access. Auto-paste on Wayland requires access to /dev/uinput. On X11, may require xlib API headers for building from source. The background listener (clipse -listen) must be started on login/boot to capture clipboard history.

clipse was created by savedra1 on GitHub. The first stable release (v1.0.0) arrived in July 2023 with multi-select, custom theme support, and image/text previews. Version 1.1.0 (October 2023) added custom keybinds, and v1.2.0 (December 2024) brought a major performance overhaul with C API integration for X11/Darwin, auto-paste, and excluded apps support.

xclip(1), xsel(1), wl-copy(1), pbcopy(1)