Command-line copy/paste utilities for Wayland
  • C 83.9%
  • Roff 8.2%
  • Meson 5.6%
  • Shell 2.3%
Find a file
Sergey Bugaev 16cf9d3fcc Update the man page
Mention the new file being read, and bump the date.
History 2026-08-06 11:55:44 +03:00
completions fix: correct spelling issues across docs and helpers 2026-03-22 14:35:50 +03:00
data Update the man page 2026-08-06 11:55:44 +03:00
src wl-paste: set CLIPBOARD_TYPE for the watch command 2026-08-05 14:39:39 +01:00
subprojects Update libffi.wrap from WrapDB 2026-03-22 14:35:50 +03:00
.editorconfig Add an EditorConfig file 2018-12-15 15:13:47 +03:00
.gitignore Add a very basic .gitignore 2018-12-15 15:16:15 +03:00
BUILDING.md Add a package spec example 2026-03-22 14:35:50 +03:00
COPYING Initial commit 2018-01-25 15:32:40 +03:00
meson.build Release wl-clipboard 2.3 2026-03-22 21:46:43 +03:00
meson_options.txt Strongly require protocol dependencies, with opt-out 2023-07-02 15:52:16 +03:00
README.md Split and rewrite Markdown docs 2023-04-22 23:05:51 +03:00

wl-clipboard: Wayland clipboard utilities

This project implements two command-line Wayland clipboard utilities, wl-copy and wl-paste, that let you easily copy data between the clipboard and Unix pipes, sockets, files and so on.

# Copy a simple text message:
$ wl-copy Hello world!

# Copy the list of files in ~/Downloads:
$ ls ~/Downloads | wl-copy

# Copy an image:
$ wl-copy < ~/Pictures/photo.png

# Copy the previous command:
$ wl-copy "!!"

# Paste to a file:
$ wl-paste > clipboard.txt

# Sort clipboard contents:
$ wl-paste | sort | wl-copy

# Upload clipboard contents to a pastebin on each change:
$ wl-paste --watch nc paste.example.org 5555

Please see the wl-clipboard(1) man page for more details.

Installing

wl-clipboard is likely available in your favorite Linux or BSD distro. For building from source, see BUILDING.md.

License

wl-clipboard is free software, available under the GNU General Public License version 3 or later.

Related projects

  • wl-clipboard-x11: A wrapper to use wl-clipboard as a drop-in replacement to X11 clipboard tools.
  • wl-clipboard-rs: A Rust crate (library) for working with the Wayland clipboard which includes a reimplementation of wl-copy and wl-paste.