Cross-platform, lightweight clipboard manager written in Rust and GPUI.
English | 简体中文
- 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.
Download pre-built binaries from Releases, or install via a package manager below.
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/ropyFor 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.appPrefix with sudo if you see a permission error.
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- Arch Linux: Build
ropy-binusing 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 viaropy --show. Clipboard capture requiresdata-controland auto-paste requiresvirtual-keyboard; native Sway is tested, while GNOME, KDE, and Niri are unvalidated. See the Wayland guide for activation, floating rules, and capability limits.
See Development for prerequisites, locked source builds, Make targets, and optional Git hooks. Source builds reflect the current checkout rather than a specific release.
- 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/DownorJ/Kto move through items, andEnteror1-5to confirm a selection. - Press
Shift+Enterto paste as plain text when a rich-text record is selected. - In grid mode, use
H/Lto move between columns. - Hold
Spaceto preview the selected record, pressFto favorite it, andDeleteorDto remove it. - Use row actions to pin records so they are excluded from storage cleanup.
- Choose between
copy_to_clipboardandpaste_immediatelyconfirm 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.
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.
- 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 --showopens that GUI.
- 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.

