Clipcat

Clipcat is a clipboard manager written in Rust Programming Language.

Architecture

Clipcat uses the Client-Server architecture. There are two role types in this architecture: Server and Client.

Clipcat Server

A clipcat server (as known as daemon) is running as the background process and does the following routines:

• Watching the changes of X11 clipboard.
• Caching the content of X11 clipboard.
• Inserting content into X11 clipboard.
• Serving as a gRPC server and waiting for remote procedure call from clients.

Clipcat Client

A clipcat client sends requests to the server for the following operations:

• List: list the cached clips from server.
• Insert: replace the current content of X11 clipboard with a clip.
• Remove: remove the cached clips from server.

List of Implementations

Quick Start

Installation

Usage

0. Setup configurations for clipcat.

$ mkdir -p                       $XDG_CONFIG_HOME/clipcat
$ clipcatd default-config      > $XDG_CONFIG_HOME/clipcat/clipcatd.toml
$ clipcatctl default-config    > $XDG_CONFIG_HOME/clipcat/clipcatctl.toml
$ clipcat-menu default-config  > $XDG_CONFIG_HOME/clipcat/clipcat-menu.toml

1. Start clipcatd for watching clipboard events.

$ clipcatd

2. Copy arbitrary text from other X11 process with your mouse or keyboard.

3. You can run following commands with clipcatctl or clipcat-menu:

Note: Supported finders for clipcat-menu:

• built-in finder (integrate with crate skim)
• skim
• fzf
• rofi
• dmenu

Configuration

Configuration for clipcatd

daemonize = true          # run as a traditional UNIX daemon
max_history = 50          # max clip history limit
log_level = 'INFO'        # log level

[monitor]
load_current = true       # load current clipboard content at startup
enable_clipboard = true   # watch X11 clipboard
enable_primary = true     # watch X11 primary clipboard

[grpc]
host = '127.0.0.1'        # host address for gRPC
port = 45045              # port number for gRPC

Configuration for clipcatctl

server_host = '127.0.0.1' # host address of clipcat gRPC server
server_port = 45045       # port number of clipcat gRPC server
log_level = 'INFO'        # log level

Configuration for clipcat-menu

server_host = '127.0.0.1' # host address of clipcat gRPC server
server_port = 45045       # port number of clipcat gRPC server
finder = 'rofi'           # the default finder to invoke when no "--finder=<finder>" option provided

[rofi]                    # options for "rofi"
line_length = 100         # length of line
menu_length = 30          # length of menu

[dmenu]                   # options for "dmenu"
line_length = 100         # length of line
menu_length = 30          # length of menu

[custom_finder]           # customize your finder
program = 'fzf'           # external program name
args = []                 # arguments for calling external program

Integration

Integrating with Zsh

For zsh user, it will be useful to integrate clipcat with zsh.

Add the following command in your zsh configuration file (~/.zshrc):

if type clipcat-menu >/dev/null 2>&1; then
    alias clipedit=' clipcat-menu --finder=builtin edit'
    alias clipdel=' clipcat-menu --finder=builtin remove'

    bindkey -s '^\' "^Q clipcat-menu --finder=builtin insert ^J"
    bindkey -s '^]' "^Q clipcat-menu --finder=builtin remove ^J"
fi

Integrating with i3 Window Manager

For i3 window manager user, it will be useful to integrate clipcat with i3.

Add the following options in your i3 configuration file ($XDG_CONFIG_HOME/i3/config):

exec_always --no-startup-id clipcatd                # start clipcatd at startup

set $launcher-clipboard-insert clipcat-menu insert
set $launcher-clipboard-remove clipcat-menu remove

bindsym $mod+p exec $launcher-clipboard-insert
bindsym $mod+o exec $launcher-clipboard-remove

Note: You can use rofi or dmenu as the default finder.

Compiling from Source

clipcat requires the following tools and packages to build:

• git
• rustc
• cargo
• pkgconfig
• protobuf
• clang
• libclang
• libxcb

With the above tools and packages already installed, you can simply run:

$ git clone https://github.com/xrelkd/clipcat.git
$ cd clipcat
$ cargo build --release --features=all

License

Clipcat is licensed under the GNU General Public License version 3. See LICENSE for more information.