Quick Start

Quick Start

Get from a clone to a working clipboard history in a couple of minutes.

Prerequisites

  • Go 1.25 or newer
  • A C toolchain (the SQLite driver uses cgo)
  • Linux with X11 or Wayland clipboard support

Clone and build

Build both binaries with the included Makefile:

			git clone https://github.com/geodask/clipboard-manager.git
cd clipboard-manager
make build

This produces bin/clipd (the daemon) and bin/clipctl (the CLI).

Start the daemon

			./bin/clipd

The daemon starts monitoring your clipboard, stores history in ./clipboard.db, and serves its API on /tmp/clipd.sock. All of these locations are configurable.

Copy something, then look at your history

Copy some text anywhere on your system, then:

			./bin/clipctl list

You should see your most recent clipboard entries, newest first.

Search and inspect

			./bin/clipctl search "some text"   # full-text search
./bin/clipctl get 1                # show entry with ID 1
./bin/clipctl stats                # totals and database info

Sensitive data never lands in history

Try copying a line like password: hunter2. The analyzer detects it and skips storage entirely, so it will not appear in clipctl list.

Next steps