https://github.com/FMotalleb/nu_plugin_clipboard
A nushell plugin to copy text into clipboard or get text from it. supports json<->object/table conversion out of box
https://github.com/FMotalleb/nu_plugin_clipboard
clipboard-manager nu-plugin
Last synced: 20 days ago
JSON representation
A nushell plugin to copy text into clipboard or get text from it. supports json<->object/table conversion out of box
- Host: GitHub
- URL: https://github.com/FMotalleb/nu_plugin_clipboard
- Owner: FMotalleb
- License: mit
- Created: 2023-11-13T12:24:18.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-21T10:31:53.000Z (about 1 month ago)
- Last Synced: 2025-03-29T14:08:36.463Z (24 days ago)
- Topics: clipboard-manager, nu-plugin
- Language: Rust
- Homepage:
- Size: 155 KB
- Stars: 52
- Watchers: 1
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-nu - nu_plugin_clipboard
README
# 📋 nu_plugin_clipboard
A [nushell](https://www.nushell.sh/) 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.100.1**, the daemon is always enabled on Linux. To disable it, set:
```bash
$env.config.plugins.clipboard.NO_DAEMON = true
```
- To make this setting permanent, add it to your `config env`. (I do not recommend changing this unless needed, please create an issue)- **`clipboard paste`**: Retrieves the current clipboard content.
## 📌 Usage Examples
### Copying a string (supports only strings for now)
```bash
echo "test value" | clipboard copy
```### Using clipboard content
```bash
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.```bash
$env | clipboard copy
clipboard pasteps | clipboard copy
clipboard paste
```## 🔧 Installation
### 🚀 Recommended: Using [nupm](https://github.com/nushell/nupm)
This method automatically handles dependencies and features:
```bash
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:
```bash
$env.config.plugins.clipboard.NO_DAEMON = true
```### 🛠️ Manual Compilation
```bash
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)
```bash
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.
```bash
cargo install nu_plugin_clipboard
plugin add ~/.cargo/bin/nu_plugin_clipboard
```