Clipboard

October 25, 2025 ยท View on GitHub

On supported platforms (macOS, X11, Wayland) nchat uses the system clipboard. For other platforms, or custom behavior, one may configure below parameters in app.conf.

Note: The examples provided below are mainly for reference, not useful as actual configuration values (except the File-based examples), as the main platforms should work with the built-in support in nchat.

clipboard_copy_command

Specifies a custom copy (and cut) command to be used instead of system clipboard. Examples:

PlatformCommand
File-basedtee ~/.clipboard
macOSpbcopy
Waylandwl-copy
X11xclip -selection clipboard

clipboard_has_image_command

Specifies a custom command for checking if the clipboard contains an image. The command shall output 1 if image is present, otherwise 0. Examples:

PlatformCommand
Waylandwl-paste --list-types | grep -m1 'image/png' | wc -l

clipboard_paste_command

Specifies a custom paste command to be used instead of system clipboard. Examples:

PlatformCommand
File-basedcat ~/.clipboard
macOSpbpaste
Waylandwl-paste
X11xclip -o -selection clipboard

clipboard_paste_image_command

Specifies a custom image paste command to be used instead of system clipboard. Examples:

PlatformCommand
Waylandwl-paste --type image/png