A lightweight, cross-platform clipboard manager built with Tauri and React. Clipray provides a seamless clipboard history experience similar to Windows' "Windows + V" functionality, but available on Windows, macOS, and Linux.

• 📋 Clipboard History: Automatically saves text and image clipboard content
• ⚡ Quick Access: Invoke with customizable global hotkeys (default: Ctrl+Shift+V)
• 🔍 Smart Search: Filter clipboard history with real-time search
• 📌 Pin Items: Mark important items as favorites to prevent auto-deletion
• 🖼️ Image Support: Store and preview clipboard images
• 🎨 Theme Support: Multiple built-in themes for personalization
• ⚙️ Configurable: Customize history limit, hotkeys, and appearance
• 🔒 Privacy-First: All data stored locally, no external data transmission
• 🌐 Cross-Platform: Native support for Windows, macOS, and Linux

Visit the Releases page to download the latest version for your platform:

• Windows: clipray-setup.exe
• macOS: clipray.dmg
• Linux: clipray.AppImage or clipray.deb

• Node.js (v16 or higher)
• Rust (latest stable)
• Tauri CLI

1. Clone the repository:

git clone https://github.com/yourusername/clipray.git
cd clipray

2. Install dependencies:

npm install

3. Build the application:

npm run tauri --release

The built application will be available in src-tauri/target/release/bundle/.

1. Start Clipray: Launch the application (it will run in the background)
2. Copy Content: Copy text or images as usual (Ctrl+C / Cmd+C)
3. Access History: Press Ctrl+Shift+V (or your configured hotkey)
4. Select Item: Use arrow keys or click to select from history
5. Paste: Press Enter or click to paste the selected item

Access settings by pressing Ctrl+S or clicking the gear icon:

• History Limit: Set maximum number of items to store (default: 50)
• Global Hotkey: Customize the activation shortcut
• Theme: Choose from available themes
• Auto-start: Enable/disable startup with system

1. Clone and install dependencies:

git clone https://github.com/yourusername/clipray.git
cd clipray
npm install

2. Start development server:

npm run tauri dev

clipray/
├── src/                    # React frontend
│   ├── components/         # UI components
│   ├── hooks/             # Custom React hooks
│   ├── types/             # TypeScript type definitions
│   └── utils/             # Utility functions
├── src-tauri/             # Rust backend
│   ├── src/libs/          # Core functionality
│   │   ├── clipboard.rs   # Clipboard monitoring
│   │   ├── database.rs    # SQLite database
│   │   └── commands.rs    # Tauri commands
│   └── tauri.conf.json    # Tauri configuration
└── package.json           # Node.js dependencies

• npm run dev - Start Vite development server
• npm run build - Build frontend for production
• npm run tauri dev - Start Tauri development mode
• npm run build:release - Build release version

• npm run test - Run all tests

We welcome contributions! Please follow these guidelines:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes
4. Test thoroughly
5. Commit with clear messages: git commit -m 'Add amazing feature'
6. Push to your fork: git push origin feature/amazing-feature
7. Open a Pull Request

• Follow the existing code style
• Write clear commit messages
• Add tests for new features
• Update documentation as needed
• Ensure cross-platform compatibility

When reporting bugs, please include:

• Operating system and version
• Clipray version
• Steps to reproduce
• Expected vs actual behavior
• Screenshots (if applicable)

We love new ideas! Please:

• Check existing issues first
• Describe the feature clearly
• Explain the use case
• Consider implementation complexity

This project is licensed under the MIT License - see the LICENSE file for details.

• Built with Tauri for cross-platform desktop apps
• UI powered by React and TypeScript
• Icons from Lucide
• Database powered by SQLite

• Documentation
• Issue Tracker
• Discussions
• Changelog

Made with ❤️ by the Clipray team