A Rust-based tool for synchronizing clipboards between local and remote machines over SSH. It continuously monitors clipboard changes on both ends and automatically syncs the content, making it easy to copy-paste between machines.

• Bidirectional clipboard synchronization
• Works over SSH
• Configurable clipboard commands for different platforms
• Automatic reconnection on connection loss
• Ping/pong mechanism to ensure connection health
• Support for customizable clipboard commands

• Rust toolchain or rust-script installed
• SSH client
• Clipboard command-line tools:
  • macOS: pbcopy and pbpaste (built-in)
  • Linux: xclip or similar (apt install xclip)
  • Windows: TBD

• Rust toolchain or rust-script installed
• X server running (for headless servers, you can use Xvfb)
• xclip or similar clipboard tool
• Proper environment variables set (DISPLAY, etc.)

1. Install clipcast on local and remote machines

# Install locally
cargo install clipcast
# Copy to remote machine (replace 'remote-host' with your host)
ssh remote-host "cargo install clipcast"

2. For headless servers, ensure X server is running:

# Install Xvfb if not present
sudo apt install xvfb xclip

# Start Xvfb (typically on display :99)
Xvfb :99 -screen 0 1024x768x16 &

# Set DISPLAY variable
export DISPLAY=:99

The tool has two modes: server and client.

In server mode server gets messages over stdin and replys over stdout using one json message per line protocol. Server will be launched by the client on the remote machine.

clipcast server [OPTIONS]

Options:

• --write-clipboard-cmd: Command to write to clipboard (default: "xclip -selection clipboard")
• --read-clipboard-cmd: Command to read from clipboard (default: "xclip -selection clipboard -o")

Client using ssh launches server on the remote host and syncs clipboards between machines using json per line protocol over stdin and stdout.

clipcast client --host REMOTE_HOST [OPTIONS]

Options:

• --host: SSH host to connect to (required)
• --ssh-args: Arguments for SSH session invoked by clipcast (default: "")
• --write-clipboard-cmd: Local command to write to clipboard (default: "pbcopy")
• --read-clipboard-cmd: Local command to read from clipboard (default: "pbpaste")
• --remote-server-cmd: Remote clipcast command (default: "clipcast")
• --remote-write-clipboard-cmd: Remote command to write to clipboard (default: "xclip -selection clipboard")
• --remote-read-clipboard-cmd: Remote command to read from clipboard (default: "xclip -selection clipboard -o")

# On local machine, connecting to remote with specific environment setup
clipcast client \
  --host remote-host \
  --remote-server-cmd "source ~/.cargo/env && DISPLAY=:99 clipcast"

Create the following three files, editing as needed

~/.ssh/config

Include ~/.ssh/default_config

# Overload included default configuration and execute clipcast
Host DOMAIN1* DOMAIN2* DOMAIN3*
  LocalCommand $HOME/.ssh/clipcast.sh %h

~/.ssh/default_config

Host DOMAIN1* DOMAIN2* DOMAIN3*
  HostName %h.REMAINING
  User USER
  IdentityFile ~/.ssh/PRIVATE_KEY
  ForwardX11 yes

~/.ssh/clipcast.sh

#!/bin/bash

# Get domain from remote host; e.g., domain from domain.example.com
host="${1%%.*}"

# Run clipcast using default config to prevent recursive LocalCommand spawning in ~/.ssh/config
clipcast client --ssh-args "-F $HOME/.ssh/default_config" --host $host > /dev/null 2>&1 &
pid=$!

(
  # Block until parent SSH process no longer exists
  while kill -0 $PPID 2>/dev/null; do
    sleep 1
  done

  # Kill all clipcast child process and created clipcast
  pkill -P $pid
  kill $pid
) &

~/.ssh/default_config should contain the default setup for your SSH sessions. ~/.ssh/config overloads default_config and runs the clipcast.sh script. We use this setup such that when clipcast.sh runs clipcast (which itself then runs SSH), the LocalCommand to run clipcast will not recursively execute.

1. The client establishes an SSH connection to the remote server and launches server
2. Both sides monitor their local clipboards for changes
3. When a change is detected, the new clipboard content is sent to the other side
4. The receiving side updates its local clipboard
5. Regular ping/pong messages ensure the connection stays alive
6. On connection loss, the client automatically attempts to reconnect

1. Clipboard Not Syncing

   • Verify X server is running on remote machine
   • Check DISPLAY environment variable is set correctly
   • Ensure clipboard tools (xclip, pbcopy, etc.) are installed and working

2. Connection Issues

   • Check SSH connectivity
   • Verify proper permissions on the clipcast binary
   • Check firewall settings

3. Permission Errors

   • Ensure the binary is executable (chmod +x)
   • Verify user has permission to access clipboard tools

• RUST_LOG: Controls logging level (default: "info")
  • Available levels: error, warn, info, debug, trace

Feel free to open issues and pull requests for:

• Bug fixes
• New features
• Documentation improvements
• Platform support expansion

This project is open source and available under the MIT License.