Skip to content
StudentWeisPublic

About

Cross-platform, lightweight clipboard manager written in Rust and GPUI.

Topics

Resources

Contributing

Stars

210 stars

Watchers

1 watching

Forks

Repository files navigation

Ropy Logo

Ropy Organizes Previous Yanks

License Release Language
Stars Issues

Cross-platform, lightweight clipboard manager written in Rust and GPUI.

English | 简体中文

Ropy

Features

  • Native desktop application built with Zed's GPUI.
  • Cross-platform support for Windows, macOS, and Linux (X11 and native Wayland), with compositor-dependent clipboard and shortcut capabilities.
  • Tracks text, rich text (HTML/RTF), image, and file path clipboard history with content-based deduplication.
  • Switchable list and grid layout modes for browsing history.
  • Search the loaded history with case-sensitive and whole-word options.
  • Favorite and pin records; automatic cleanup preserves pinned and favorited items.
  • Preview text and images via configurable hover delay or by holding Space.
  • Configurable global hotkey, theme, language, autostart, and confirm mode.
  • System tray integration plus in-app update check, download, and install flow.

Installation

Download pre-built binaries from Releases, or install via a package manager below.

macOS

Install with the self-hosted Homebrew tap (brew upgrade --cask ropy to update; updates are managed by Homebrew, while in-app update checks remain available):

brew install --cask studentweis/tap/ropy

For a manual DMG install, verify that you trust the download source and drag Ropy.app to Applications.

Note

Current releases are unsigned and not notarized. The Homebrew Cask removes com.apple.quarantine automatically; for manual DMG installs, allow Ropy in System Settings → Privacy & Security or run:

xattr -r -d com.apple.quarantine /Applications/Ropy.app

Prefix with sudo if you see a permission error.

Windows

Install with Scoop (scoop update ropy to update; Ropy detects standard Scoop installations and leaves updates to Scoop, while in-app update checks remain available):

scoop bucket add extras
scoop install ropy

Linux (X11 and Wayland)

  • Arch Linux: Build ropy-bin using the AUR packaging instructions (check publishing and validation steps there before assuming AUR availability).
  • Wayland: Current source supports native Wayland without XWayland or DISPLAY (check release notes for pre-built binaries) and opens the window via ropy --show. Clipboard capture requires data-control and auto-paste requires virtual-keyboard; native Sway is tested, while GNOME, KDE, and Niri are unvalidated. See the Wayland guide for activation, floating rules, and capability limits.

Build from source

See Development for prerequisites, locked source builds, Make targets, and optional Git hooks. Source builds reflect the current checkout rather than a specific release.

Usage

  • Launch Ropy — it starts hidden in the system tray and begins recording clipboard history.
  • Use the global hotkey or the tray icon to open the history window.
  • Press / to focus search, then refine results with case-sensitive, whole-word, and type filters.
  • Use Up/Down or J/K to move through items, and Enter or 1-5 to confirm a selection.
  • Press Shift+Enter to paste as plain text when a rich-text record is selected.
  • In grid mode, use H/L to move between columns.
  • Hold Space to preview the selected record, press F to favorite it, and Delete or D to remove it.
  • Use row actions to pin records so they are excluded from storage cleanup.
  • Choose between copy_to_clipboard and paste_immediately confirm modes in Settings.

History shortcuts can be customized in Settings or Help, including disabling individual aliases such as D for deletion. Use custom themes to preview, duplicate and edit a palette without changing bundled themes.

Documentation

Use the documentation index to find user guides, development and testing commands, architecture, release acceptance and historical measurements. Start with configuration and recovery for settings files or load errors, or Contributing to submit a change.

Limitations and scope

  • The system clipboard does not expose the original application source for copied items.
  • Plugin/extension system: no current plans — Ropy focuses on simplicity and small footprint.
  • Cloud sync: not supported at this time.
  • Full command-line history management: Ropy is primarily a GUI application; Linux ropy --show opens that GUI.

Acknowledgements

  • Inspired by clipboard managers such as Ditto, Maccy and CopyQ.
  • Thanks to the Rust community and all upstream projects used by Ropy: GPUI Kit, clipboard-rs, redb and others.

Star History

Star History Chart

About

Cross-platform, lightweight clipboard manager written in Rust and GPUI.

Topics

Resources

Contributing

Stars

210 stars

Watchers

1 watching

Forks

Releases

Contributors

Languages