A sleek clipboard viewer for Wayland/X11 with GTK3
Instantly preview and manage your clipboard content with a beautiful, responsive interface
Features • Installation • Usage • Building • Contributing
- Rich Text Viewing: Display clipboard text content in a scrollable, word-wrapped interface
- Live Editing: Modify clipboard text directly in the viewer
- One-Click Copy: Instantly copy modified text back to clipboard
- Multi-Format Support: PNG, JPEG, and GIF image formats
- Smart Scaling: Automatic image scaling while maintaining aspect ratio
- Original Size Display: View images at their native resolution
- GTK3 Native: Clean, system-integrated appearance
- Modal Dialog: Always-on-top, focused viewing experience
- Responsive Design: Adapts to different content sizes and screen resolutions
- Custom Icon: Distinctive application branding
- Wayland Native: Full support for modern Wayland compositors
- X11 Fallback: Seamless operation on traditional X11 systems
- Smart Detection: Automatic protocol selection
# Using your favorite AUR helper
yay -S waypin
# or
paru -S waypin
# Clone the repository
git clone https://github.com/xxanqw/waypin.git
cd waypin
# Build and install
cargo build --release
sudo cp target/release/waypin /usr/local/bin/
gtk3
- GUI frameworkgdk-pixbuf2
- Image loading and processingwl-clipboard
- Wayland clipboard utilities
Simply run Waypin to view your current clipboard content:
waypin
- Text Content: Opens an editable text viewer with copy functionality
- Image Content: Displays images with scaling and navigation controls
- File Lists: Safely ignored to prevent accidental operations
- Empty Clipboard: Provides helpful error messaging
- Ctrl+C: Copy modified text (in text viewer)
- Scroll: Navigate through large images
- Escape: Close the viewer window
# Arch Linux
sudo pacman -S rust gtk3 gdk-pixbuf2 wl-clipboard git
# Ubuntu/Debian
sudo apt install cargo libgtk-3-dev libgdk-pixbuf2.0-dev wl-clipboard git
# Fedora
sudo dnf install cargo gtk3-devel gdk-pixbuf2-devel wl-clipboard git
git clone https://github.com/xxanqw/waypin.git
cd waypin
cargo build --release
# Run in debug mode
cargo run
# Run tests
cargo test
- Developer Workflow: Quickly preview copied code snippets or error messages
- Content Creation: Review copied text before pasting into documents
- Image Editing: Preview copied images before processing
- System Administration: Examine clipboard content for security purposes
- General Productivity: Universal clipboard inspection tool
- Document Viewer Support: View PDF, DOCX, ODT, and other document formats
- GUI Redesign: Modern interface overhaul with improved user experience
- Hotkey Support: Global shortcuts for instant access
We welcome contributions! Here's how you can help:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'Add amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
- Follow Rust naming conventions
- Add tests for new features
- Update documentation for API changes
- Ensure GTK3 compatibility
This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.
Ivan Potiienko - Initial work - @xxanqw
- GTK Team - For the excellent GUI framework
- Wayland Developers - For the modern display protocol
- Rust Community - For the amazing ecosystem and tools
Made with ❤️ and 🦀 Rust