rustyclip 0.1.3

🦀 RustyClip: A simple clipboard history manager for macOS/Linux
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104


# 📋 RustyClip 🦀✂️

[![Crates.io](https://img.shields.io/crates/v/rustyclip.svg)](https://crates.io/crates/rustyclip)
[![Docs.rs](https://docs.rs/rustyclip/badge.svg)](https://docs.rs/rustyclip)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![CI](https://github.com/bvdwalt/rustyclip/actions/workflows/ci.yml/badge.svg)](https://github.com/yourusername/rustyclip/actions/workflows/ci.yml)
[![Release](https://github.com/bvdwalt/rustyclip/actions/workflows/release.yml/badge.svg)](https://github.com/bvdwalt/rustyclip/actions/workflows/release.yml)

---

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)

~~~bash
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](https://github.com/bvdwalt/rustyclip/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

~~~bash
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:  

~~~bash
rustyclip add
~~~

→ Saves it with a timestamp.  

3. See your history:  

~~~bash
rustyclip list
~~~

→ Displays a list of saved entries.  

4. Retrieve an entry:  

~~~bash
rustyclip get 0
~~~

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

---

## 📦 Roadmap

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

---

## 🤝 Contributing

Pull requests and feature suggestions are welcome!  
Open an [issue](https://github.com/bvdwalt/rustyclip/issues) to discuss.

---

## 📜 License

This project is licensed under the [MIT License](LICENSE).