rustyclip

Crates.iorustyclip
lib.rsrustyclip
version0.1.5
created_at2025-09-16 09:08:23.714145+00
updated_at2025-09-25 15:00:22.97737+00
description🦀 RustyClip: A simple clipboard history manager for macOS/Linux
homepage
repositoryhttps://github.com/bvdwalt/rustyclip
max_upload_size
id1841231
size41,275
Barend van der Walt (bvdwalt)

documentation

README

📋 RustyClip 🦀✂️

Crates.io Docs.rs License: MIT CI Release


A simple cross-platform clipboard history manager written in Rust.
RustyClip lets you save, search, and reuse snippets you’ve copied to your clipboard.


🚀 Installation

Via Cargo (recommended if you have Rust installed)

cargo install rustyclip

Make sure $HOME/.cargo/bin is in your $PATH to run rustyclip globally.


Prebuilt Binaries

Download the latest release from GitHub Releases:

Platform Binary
Linux rustyclip-linux.tar.gz
macOS rustyclip-macos.tar.gz
Windows rustyclip-windows.zip

Extract the archive and place the binary somewhere in your $PATH.


🛠 Usage

rustyclip add       # Save the current clipboard text
rustyclip list      # Show saved clipboard history
rustyclip get 0     # Print (and soon restore!) entry at index 0
rustyclip clear     # Clear all saved history

📂 Example Workflow

  1. Copy some text in your system (e.g., Ctrl+C / Cmd+C).
  2. Run:
rustyclip add

→ Saves it with a timestamp.

  1. See your history:
rustyclip list

→ Displays a list of saved entries.

  1. Retrieve an entry:
rustyclip get 0

→ Prints it to stdout (future versions will restore it to clipboard automatically).


📦 Roadmap

  • Save and list clipboard history
  • Clear history
  • Restore clipboard entries with get
  • Search entries by keyword
  • Configurable storage path
  • Hotkey/TUI picker
  • Prebuilt binaries for all platforms

🤝 Contributing

Pull requests and feature suggestions are welcome!
Open an issue to discuss.


📜 License

This project is licensed under the MIT License.

Commit count: 28

cargo fmt