Merenda - Snack-sized clipboard syncronization over SSH

A tiny server/client application to synchronize clipboards over SSH in Rust, inspired by similar tools like Lemonade.

Installation

cargo install merenda

Local setup

After installation, run merenda server on your main machine - the one you'll use to SSH into other systems. It will listen for connections requesting to read/write your clipboard, and you'll generally want to have it running in the background. On its own, it also works as a roundabout way to read/write your clipboard, by using merenda get and merenda set on your local machine.

If you're using systemd, you can copy the provided user service to ~/.config/systemd/user, which you can activate with systemctl --user start merenda.service and enable at boot with systemctl --user enable merenda.service.

By default, the server will listen on 127.0.0.1, port 3660. You can change either with the -H/--address and -p/--port arguments.

CAUTION: Think carefully before changing the default listen address. Merenda has absolutely no authentication or encryption, so listening on anything other than loopback will allow anyone able to reach that IP address to read/write to your clipboard at will. A safer alternative is to set up an SSH local reverse port forwarding, so that the port is exposed only on the other end of the SSH connection. More on that later.

Remote setup

After installation, set up your preferred editors/tools to use merenda to store data to the clipboard when an SSH connection is available. For example, I use NeoVim and my config looks like this:

if !empty($SSH_CONNECTION)
    set clipboard+=unnamed
    let g:clipboard= {
        \   'name': 'merenda',
        \   'copy': {
        \       '*': ['merenda', 'set'],
        \   },
        \   'paste': {
        \       '*': ['merenda', 'get'],
        \   },
        \   'cache_enabled': 1,
        \ }
endif

Forwarding over SSH

You can forward the port merenda is listening on to your remote host by adding a RemoteForward option to your ~/.ssh/config file.

For example:

Host myothercomputer
    User username
    RemoteForward 3660 localhost:3660
    Hostname 10.1.1.251

Now you can use merenda set and merenda get to read/write the clipboard from the remote host!

License

This project and all contributions to it are licensed under the GPL General Public License v3.