clipbud

Crates.ioclipbud
lib.rsclipbud
version0.1.0
created_at2025-09-05 22:19:09.885263+00
updated_at2025-09-05 22:19:09.885263+00
descriptionAI powered clipboard assistant
homepagehttps://github.com/evilsocket/clipbud
repositoryhttps://github.com/evilsocket/clipbud
max_upload_size
id1826341
size376,134
Simone Margaritelli (evilsocket)

documentation

README

Clipboard Buddy

Release Rust Report CI License Human Coded

Join the project community on our server!

Clipboard Buddy (clipbud) is a cross platform utility that interacts with your system clipboard and augments it with AI capabilities. You can register a set of custom action prompts and recall them at any time on your clipboard contents using a custom global hotkey. The power of this mechanism is that it works with any application since it reads and writes directly from and to the system clipboard. Avoid repetitive copy/paste to and from your LLM!

Clipboard Buddy

Quick Start

clipbud is published as a binary crate on crates.io. If you have Cargo installed, you can:

cargo install clipbud

This will compile its sources and install the binary in $HOME/.cargo/bin/clipbud. You are now ready to go! 🚀

export OPENAI_API_KEY=...

clipbud -c /path/to/config.yml

An example configuration file:

# if this is not set, clipbud will show itself at every clipboard change
hotkey: "CMD+CTRL+C"

actions:
  - label: "Fix"
    prompt: "Fix typos and grammar of the following text, but keep the original meaning and structure, only return the fixed text and nothing else:"
    key: "T" # optional shortcut key
    model: "gpt-4o"
    provider: "openai"

  - label: "Summarize"
    prompt: "Summarize the following text in less than 200 words, only return the summary and nothing else:"
    key: "S"
    model: "gpt-4o"
    provider: "openai"

  - label: "Friendly"
    prompt: "Make the following text more friendly, only return the friendly text and nothing else:"
    key: "F"
    model: "gpt-4o"
    provider: "openai"

  - label: "ELI5"
    prompt: "Explain the following text in a way that is easy to understand for a 5 year old, only return the explanation and nothing else:"
    key: "E"
    model: "gpt-4o"
    provider: "openai"

Contributors

Clipboard Buddy project contributors

Star History

Star History Chart

License

Clipboard Buddy is released under the GPL 3 license. To see the licenses of the project dependencies, install cargo license with cargo install cargo-license and then run cargo license.

Commit count: 58

cargo fmt