📋 nu_plugin_clipboard

A nushell plugin for interacting with the clipboard, allowing you to copy/paste text, objects, and tables.

✨ Features

clipboard copy: Copies input text to the clipboard.
- Daemon Behavior: Since version 0.105.2, using env variables will try to detect display server. This config will override this behavior, if you need to override this please report and issue:
```
$env.config.plugins.clipboard.NO_DAEMON = true
```
- To make this setting permanent, add it to your config env.
clipboard paste: Retrieves the current clipboard content.

⚠️ Important

If you face the error Error: × Clipboard Error: The clipboard contents were not available in the requested format... Try disabling the daemon mode, as mentioned in #20.

📌 Usage Examples

Copying a string (supports only strings for now)

echo "test value" | clipboard copy

Using clipboard content

clipboard paste | echo $in

Copying tables and objects

Tables and objects are internally converted to JSON.
When pasting, clipboard paste tries to parse JSON into a table or object.
If parsing fails, the content is returned as a string.

$env | clipboard copy
clipboard paste

ps | clipboard copy
clipboard paste

🔧 Installation

🚀 Recommended: Using nupm

This method automatically handles dependencies and features:

git clone https://github.com/FMotalleb/nu_plugin_clipboard.git
nupm install --path nu_plugin_clipboard -f

⚙️ Supported Features

use-wayland: Prioritizes the Wayland API, but falls back to X11 if needed.
enforce-daemon: (Deprecated) Now always enabled on Linux. Disable with:
```
$env.config.plugins.clipboard.NO_DAEMON = true
```

🛠️ Manual Compilation

git clone https://github.com/FMotalleb/nu_plugin_clipboard.git
cd nu_plugin_clipboard
cargo build -r
plugin add target/release/nu_plugin_clipboard

📦 Install via Cargo (using git)

cargo install --git https://github.com/FMotalleb/nu_plugin_clipboard.git
plugin add ~/.cargo/bin/nu_plugin_clipboard

📦 Install via Cargo (crates.io) Not Recommended

Since I live in Iran and crates.io won't let me update my packages like a normal person, most of the time crates.io is outdated.

cargo install nu_plugin_clipboard
plugin add ~/.cargo/bin/nu_plugin_clipboard

2.5 KiB Raw Blame History Unescape Escape