# Clipper
> **The Ultimate Cross-Platform Clipboard Manager for Developers**
[](https://badge.fury.io/py/clipper-dev)
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
[](https://github.com/psf/black)
[](https://github.com/Rklearns/clipper-dev)
[](https://github.com/Rklearns/clipper-dev)
<div align="center">
**Never lose your clipboard content again. Clipper is the developer's best friend for managing clipboard history with style.**
[**Documentation**](#-features) • [ **Quick Start**](#-quick-start) • [💡 **Examples**](#-examples) • [🤝 **Contributing**](#-contributing) • [📄 **License**](#-license)
</div>
---
## ✨ Why Clipper?
**Clipper** is not just another clipboard manager—it's a **developer productivity powerhouse** designed from the ground up for modern development workflows.
### 🎯 **Built for Developers, by Developers**
- **Lightning Fast**: Instant search across thousands of clipboard entries
- **Beautiful UI**: Rich terminal output that makes your terminal look professional
- **Smart Search**: Fuzzy search with intelligent ranking and highlighting
- **Cross-Platform**: Seamless experience across macOS, Linux, and Windows
- **Real-time Monitoring**: Automatic clipboard tracking with configurable intervals
- **Interactive TUI**: Beautiful terminal user interface for power users
### 🏆 **What Makes Clipper Special**
| Feature | Clipper | Others |
|---------|-----------|---------|
| **Speed** | ⚡ Instant | 🐌 Slow |
| **Search** | 🔍 Fuzzy + Smart | 📝 Basic |
| **UI** | 🎨 Rich + Beautiful | 📱 Plain |
| **Cross-Platform** | 🌍 All OS | 🖥️ Limited |
| **Developer Focus** | 👨💻 Built for devs | 👥 Generic |
---
## 🚀 Quick Start
### 📦 **Installation**
```bash
# Install from PyPI (recommended)
pip install clipper-dev
# Or install from source
git clone https://github.com/Rklearns/clipper-dev.git
cd clipper-dev
pip install -e .
```
### 🎯 **First Steps**
```bash
# Save current clipboard content
clipper add
# View your clipboard history
clipper list
# Search for specific content
clipper search "python code"
# Restore the last copied item
clipper pop
```
---
## 🎨 Features
### 🔥 **Core Functionality**
- **📋 Smart History**: Intelligent duplicate detection and content organization
- **🔍 Advanced Search**: Fuzzy search with configurable algorithms and scoring
- **⚡ Real-time Monitoring**: Automatic clipboard tracking with customizable intervals
- **🎯 Content Types**: Automatic detection and categorization of different content types
- **📊 Rich Statistics**: Comprehensive analytics and usage insights
### 🎭 **User Experience**
- **🎨 Rich Terminal Output**: Beautiful, colorful interface using Rich library
- **📱 Interactive TUI**: Full-featured terminal user interface
- **🔧 Configurable**: Extensive customization options
- **📱 Cross-Platform**: Consistent experience across all operating systems
- **⚡ Performance**: Optimized for speed and efficiency
### 🛠️ **Developer Tools**
- **📦 Easy Packaging**: Simple setup for distribution and deployment
- **🧪 Comprehensive Testing**: Full test coverage with pytest
- **📚 Documentation**: Extensive inline documentation and examples
- **🔧 Configuration**: Flexible configuration management
- **📊 Monitoring**: Built-in performance and usage monitoring
---
## 📖 Command Reference
### 🎯 **Essential Commands**
| Command | Description | Example |
|---------|-------------|---------|
| `add` | Save current clipboard content | `clipper add` |
| `list` | Display clipboard history | `clipper list` |
| `search <query>` | Fuzzy search history | `clipper search "api key"` |
| `pop` | Restore last item | `clipper pop` |
| `restore <index>` | Restore specific item | `clipper restore 3` |
### 🔍 **Advanced Commands**
| Command | Description | Example |
|---------|-------------|---------|
| `peek` | Show last copied item | `clipper peek` |
| `clear` | Clear entire history | `clipper clear` |
| `export <file>` | Export to JSON/CSV | `clipper export backup.json` |
| `import <file>` | Import from JSON/CSV | `clipper import backup.json` |
| `stats` | Show usage statistics | `clipper stats` |
| `info` | System information | `clipper info` |
| `tui` | Interactive terminal UI | `clipper tui` |
| `monitor` | Start clipboard monitoring | `clipper monitor` |
---
## 🎭 Interactive TUI
Experience Clipper in its full glory with our beautiful terminal user interface:
```bash
clipper tui
```
**Features:**
- 📋 **History Browser**: Navigate through your clipboard history
- 🔍 **Live Search**: Real-time search with instant results
- 📊 **Statistics Dashboard**: Visual representation of your usage
- ⚙️ **Settings Panel**: Configure Clipper to your preferences
- 🎨 **Rich Interface**: Beautiful colors and formatting
---
## ⚙️ Configuration
### 📁 **Configuration Files**
Clipper stores its configuration and history in:
- **History**: `~/.clipper.json`
- **Config**: `~/.clipper/config.toml`
### 🔧 **Customization Options**
```toml
# ~/.clipper/config.toml
[storage]
max_history = 200
storage_type = "json" # or "sqlite" (future)
[display]
max_preview_length = 80
show_timestamps = true
color_scheme = "auto"
[clipboard]
auto_track = true
track_interval = 1.0
```
---
## 🧪 Development
### 🚀 **Setting Up Development Environment**
```bash
# Clone the repository
git clone https://github.com/Rklearns/clipper-dev.git
cd clipper-dev
# Create virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install development dependencies
pip install -r requirements-dev.txt
# Install in development mode
pip install -e .
```
### 🧪 **Running Tests**
```bash
# Run all tests
pytest
# Run with coverage
pytest --cov=clipper --cov-report=html
# Run specific test file
pytest tests/test_clipboard.py
```
### 🔧 **Code Quality**
```bash
# Format code
black clipper/ tests/
# Lint code
flake8 clipper/ tests/
# Type checking
mypy clipper/
# Run all quality checks
make check
```
---
## 🤝 Contributing
We love contributions! Here's how you can help make Clipper even better:
### 🎯 **Ways to Contribute**
- 🐛 **Report Bugs**: Open an issue with detailed bug reports
- 💡 **Suggest Features**: Share your ideas for new features
- 📝 **Improve Documentation**: Help make our docs even better
- 🔧 **Fix Issues**: Pick up issues and submit pull requests
- 🌟 **Star the Project**: Show your support by starring
### 📋 **Contribution Guidelines**
1. **Fork** the repository
2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)
3. **Commit** your changes (`git commit -m 'Add amazing feature'`)
4. **Push** to the branch (`git push origin feature/amazing-feature`)
5. **Open** a Pull Request
### 🏗️ **Development Setup**
```bash
# Install pre-commit hooks
pre-commit install
# Run pre-commit on all files
pre-commit run --all-files
```
---
## 📊 Performance
### ⚡ **Speed Benchmarks**
- **Search**: 1000+ items in <10ms
- **Add**: New items in <5ms
- **Startup**: Ready in <100ms
- **Memory**: Efficient memory usage
### 📈 **Scalability**
- **History Size**: Tested up to 10,000 items
- **Search Performance**: O(log n) complexity
- **Storage**: Optimized JSON with compression
- **Memory**: Intelligent caching and cleanup
---
## 🌟 Show Your Support
If Clipper has helped you become more productive, please consider:
- ⭐ **Starring** this repository
- 🚀 **Sharing** with your developer friends
- 💬 **Joining** our community discussions
- ☕ **Buying us a coffee** (if you're feeling generous)
---
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
**MIT License** means you can:
- ✅ Use Clipper commercially
- ✅ Modify and distribute
- ✅ Use privately
- ✅ Sublicense
- ❌ Hold authors liable
- ❌ Provide warranty
---
## 🙏 Acknowledgments
- **Rich**: For beautiful terminal output
- **Typer**: For excellent CLI framework
- **Textual**: For amazing TUI capabilities
- **pyperclip**: For cross-platform clipboard access
- **rapidfuzz**: For lightning-fast fuzzy search
---
<div align="center">
**Made with ❤️ by developers, for developers**
</div>
Raw data
{
"_id": null,
"home_page": null,
"name": "clipper-dev",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Rishit Kar <rishitkar@example.com>",
"keywords": "clipboard, manager, terminal, cli, productivity, developer-tools",
"author": null,
"author_email": "Rishit Kar <rishitkar@example.com>",
"download_url": "https://files.pythonhosted.org/packages/2c/f1/7346ee22eceaa5600a17092d10d23acae7f0d38b6aa92f787d97bb0a2907/clipper_dev-0.1.2.tar.gz",
"platform": null,
"description": "# Clipper\n\n> **The Ultimate Cross-Platform Clipboard Manager for Developers**\n\n[](https://badge.fury.io/py/clipper-dev)\n[](https://www.python.org/downloads/)\n[](https://opensource.org/licenses/MIT)\n[](https://github.com/psf/black)\n[](https://github.com/Rklearns/clipper-dev)\n[](https://github.com/Rklearns/clipper-dev)\n\n<div align=\"center\">\n\n\n**Never lose your clipboard content again. Clipper is the developer's best friend for managing clipboard history with style.**\n\n[**Documentation**](#-features) \u2022 [ **Quick Start**](#-quick-start) \u2022 [\ud83d\udca1 **Examples**](#-examples) \u2022 [\ud83e\udd1d **Contributing**](#-contributing) \u2022 [\ud83d\udcc4 **License**](#-license)\n\n</div>\n\n---\n\n## \u2728 Why Clipper?\n\n**Clipper** is not just another clipboard manager\u2014it's a **developer productivity powerhouse** designed from the ground up for modern development workflows.\n\n### \ud83c\udfaf **Built for Developers, by Developers**\n\n- **Lightning Fast**: Instant search across thousands of clipboard entries\n- **Beautiful UI**: Rich terminal output that makes your terminal look professional\n- **Smart Search**: Fuzzy search with intelligent ranking and highlighting\n- **Cross-Platform**: Seamless experience across macOS, Linux, and Windows\n- **Real-time Monitoring**: Automatic clipboard tracking with configurable intervals\n- **Interactive TUI**: Beautiful terminal user interface for power users\n\n### \ud83c\udfc6 **What Makes Clipper Special**\n\n| Feature | Clipper | Others |\n|---------|-----------|---------|\n| **Speed** | \u26a1 Instant | \ud83d\udc0c Slow |\n| **Search** | \ud83d\udd0d Fuzzy + Smart | \ud83d\udcdd Basic |\n| **UI** | \ud83c\udfa8 Rich + Beautiful | \ud83d\udcf1 Plain |\n| **Cross-Platform** | \ud83c\udf0d All OS | \ud83d\udda5\ufe0f Limited |\n| **Developer Focus** | \ud83d\udc68\u200d\ud83d\udcbb Built for devs | \ud83d\udc65 Generic |\n\n---\n\n## \ud83d\ude80 Quick Start\n\n### \ud83d\udce6 **Installation**\n\n```bash\n# Install from PyPI (recommended)\npip install clipper-dev\n\n# Or install from source\ngit clone https://github.com/Rklearns/clipper-dev.git\ncd clipper-dev\npip install -e .\n```\n\n### \ud83c\udfaf **First Steps**\n\n```bash\n# Save current clipboard content\nclipper add\n\n# View your clipboard history\nclipper list\n\n# Search for specific content\nclipper search \"python code\"\n\n# Restore the last copied item\nclipper pop\n```\n\n---\n\n## \ud83c\udfa8 Features\n\n### \ud83d\udd25 **Core Functionality**\n\n- **\ud83d\udccb Smart History**: Intelligent duplicate detection and content organization\n- **\ud83d\udd0d Advanced Search**: Fuzzy search with configurable algorithms and scoring\n- **\u26a1 Real-time Monitoring**: Automatic clipboard tracking with customizable intervals\n- **\ud83c\udfaf Content Types**: Automatic detection and categorization of different content types\n- **\ud83d\udcca Rich Statistics**: Comprehensive analytics and usage insights\n\n### \ud83c\udfad **User Experience**\n\n- **\ud83c\udfa8 Rich Terminal Output**: Beautiful, colorful interface using Rich library\n- **\ud83d\udcf1 Interactive TUI**: Full-featured terminal user interface\n- **\ud83d\udd27 Configurable**: Extensive customization options\n- **\ud83d\udcf1 Cross-Platform**: Consistent experience across all operating systems\n- **\u26a1 Performance**: Optimized for speed and efficiency\n\n### \ud83d\udee0\ufe0f **Developer Tools**\n\n- **\ud83d\udce6 Easy Packaging**: Simple setup for distribution and deployment\n- **\ud83e\uddea Comprehensive Testing**: Full test coverage with pytest\n- **\ud83d\udcda Documentation**: Extensive inline documentation and examples\n- **\ud83d\udd27 Configuration**: Flexible configuration management\n- **\ud83d\udcca Monitoring**: Built-in performance and usage monitoring\n\n---\n\n## \ud83d\udcd6 Command Reference\n\n### \ud83c\udfaf **Essential Commands**\n\n| Command | Description | Example |\n|---------|-------------|---------|\n| `add` | Save current clipboard content | `clipper add` |\n| `list` | Display clipboard history | `clipper list` |\n| `search <query>` | Fuzzy search history | `clipper search \"api key\"` |\n| `pop` | Restore last item | `clipper pop` |\n| `restore <index>` | Restore specific item | `clipper restore 3` |\n\n### \ud83d\udd0d **Advanced Commands**\n\n| Command | Description | Example |\n|---------|-------------|---------|\n| `peek` | Show last copied item | `clipper peek` |\n| `clear` | Clear entire history | `clipper clear` |\n| `export <file>` | Export to JSON/CSV | `clipper export backup.json` |\n| `import <file>` | Import from JSON/CSV | `clipper import backup.json` |\n| `stats` | Show usage statistics | `clipper stats` |\n| `info` | System information | `clipper info` |\n| `tui` | Interactive terminal UI | `clipper tui` |\n| `monitor` | Start clipboard monitoring | `clipper monitor` |\n\n---\n\n## \ud83c\udfad Interactive TUI\n\nExperience Clipper in its full glory with our beautiful terminal user interface:\n\n```bash\nclipper tui\n```\n\n**Features:**\n- \ud83d\udccb **History Browser**: Navigate through your clipboard history\n- \ud83d\udd0d **Live Search**: Real-time search with instant results\n- \ud83d\udcca **Statistics Dashboard**: Visual representation of your usage\n- \u2699\ufe0f **Settings Panel**: Configure Clipper to your preferences\n- \ud83c\udfa8 **Rich Interface**: Beautiful colors and formatting\n\n---\n\n## \u2699\ufe0f Configuration\n\n### \ud83d\udcc1 **Configuration Files**\n\nClipper stores its configuration and history in:\n- **History**: `~/.clipper.json`\n- **Config**: `~/.clipper/config.toml`\n\n### \ud83d\udd27 **Customization Options**\n\n```toml\n# ~/.clipper/config.toml\n[storage]\nmax_history = 200\nstorage_type = \"json\" # or \"sqlite\" (future)\n\n[display]\nmax_preview_length = 80\nshow_timestamps = true\ncolor_scheme = \"auto\"\n\n[clipboard]\nauto_track = true\ntrack_interval = 1.0\n```\n\n---\n\n## \ud83e\uddea Development\n\n### \ud83d\ude80 **Setting Up Development Environment**\n\n```bash\n# Clone the repository\ngit clone https://github.com/Rklearns/clipper-dev.git\ncd clipper-dev\n\n# Create virtual environment\npython -m venv venv\nsource venv/bin/activate # On Windows: venv\\Scripts\\activate\n\n# Install development dependencies\npip install -r requirements-dev.txt\n\n# Install in development mode\npip install -e .\n```\n\n### \ud83e\uddea **Running Tests**\n\n```bash\n# Run all tests\npytest\n\n# Run with coverage\npytest --cov=clipper --cov-report=html\n\n# Run specific test file\npytest tests/test_clipboard.py\n```\n\n### \ud83d\udd27 **Code Quality**\n\n```bash\n# Format code\nblack clipper/ tests/\n\n# Lint code\nflake8 clipper/ tests/\n\n# Type checking\nmypy clipper/\n\n# Run all quality checks\nmake check\n```\n\n---\n\n## \ud83e\udd1d Contributing\n\nWe love contributions! Here's how you can help make Clipper even better:\n\n### \ud83c\udfaf **Ways to Contribute**\n\n- \ud83d\udc1b **Report Bugs**: Open an issue with detailed bug reports\n- \ud83d\udca1 **Suggest Features**: Share your ideas for new features\n- \ud83d\udcdd **Improve Documentation**: Help make our docs even better\n- \ud83d\udd27 **Fix Issues**: Pick up issues and submit pull requests\n- \ud83c\udf1f **Star the Project**: Show your support by starring\n\n### \ud83d\udccb **Contribution Guidelines**\n\n1. **Fork** the repository\n2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)\n3. **Commit** your changes (`git commit -m 'Add amazing feature'`)\n4. **Push** to the branch (`git push origin feature/amazing-feature`)\n5. **Open** a Pull Request\n\n### \ud83c\udfd7\ufe0f **Development Setup**\n\n```bash\n# Install pre-commit hooks\npre-commit install\n\n# Run pre-commit on all files\npre-commit run --all-files\n```\n\n---\n\n## \ud83d\udcca Performance\n\n### \u26a1 **Speed Benchmarks**\n\n- **Search**: 1000+ items in <10ms\n- **Add**: New items in <5ms\n- **Startup**: Ready in <100ms\n- **Memory**: Efficient memory usage\n\n### \ud83d\udcc8 **Scalability**\n\n- **History Size**: Tested up to 10,000 items\n- **Search Performance**: O(log n) complexity\n- **Storage**: Optimized JSON with compression\n- **Memory**: Intelligent caching and cleanup\n\n---\n\n## \ud83c\udf1f Show Your Support\n\nIf Clipper has helped you become more productive, please consider:\n\n- \u2b50 **Starring** this repository\n- \ud83d\ude80 **Sharing** with your developer friends\n- \ud83d\udcac **Joining** our community discussions\n- \u2615 **Buying us a coffee** (if you're feeling generous)\n\n---\n\n## \ud83d\udcc4 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n**MIT License** means you can:\n- \u2705 Use Clipper commercially\n- \u2705 Modify and distribute\n- \u2705 Use privately\n- \u2705 Sublicense\n- \u274c Hold authors liable\n- \u274c Provide warranty\n\n---\n\n## \ud83d\ude4f Acknowledgments\n\n- **Rich**: For beautiful terminal output\n- **Typer**: For excellent CLI framework\n- **Textual**: For amazing TUI capabilities\n- **pyperclip**: For cross-platform clipboard access\n- **rapidfuzz**: For lightning-fast fuzzy search\n\n---\n\n\n<div align=\"center\">\n\n**Made with \u2764\ufe0f by developers, for developers**\n\n\n\n</div>\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A powerful, cross-platform clipboard manager for developers",
"version": "0.1.2",
"project_urls": {
"Bug Tracker": "https://github.com/Rklearns/clipper-dev/issues",
"Documentation": "https://github.com/Rklearns/clipper-dev#readme",
"Homepage": "https://github.com/Rklearns/clipper-dev",
"Release Notes": "https://github.com/Rklearns/clipper-dev/releases",
"Repository": "https://github.com/Rklearns/clipper-dev.git"
},
"split_keywords": [
"clipboard",
" manager",
" terminal",
" cli",
" productivity",
" developer-tools"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "832fbc3f1394a3875bbbf3dc08fb07b0b53b1524d412c9951c0550bcab9b0c06",
"md5": "bcb2df25a7269adea34cab37586de7cd",
"sha256": "f2780e6d38ba7a8d45e80e81bcc505bb99ad49c21fbf804ce782bcff62255768"
},
"downloads": -1,
"filename": "clipper_dev-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bcb2df25a7269adea34cab37586de7cd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 21726,
"upload_time": "2025-08-30T11:18:24",
"upload_time_iso_8601": "2025-08-30T11:18:24.462346Z",
"url": "https://files.pythonhosted.org/packages/83/2f/bc3f1394a3875bbbf3dc08fb07b0b53b1524d412c9951c0550bcab9b0c06/clipper_dev-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2cf17346ee22eceaa5600a17092d10d23acae7f0d38b6aa92f787d97bb0a2907",
"md5": "9c6e46b86d622b92a6c3266e53b6685f",
"sha256": "5670813b4d2343ac97f3c68a43e95f59adea086d3406f1c48f0571223f0f97aa"
},
"downloads": -1,
"filename": "clipper_dev-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "9c6e46b86d622b92a6c3266e53b6685f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 27327,
"upload_time": "2025-08-30T11:18:26",
"upload_time_iso_8601": "2025-08-30T11:18:26.086988Z",
"url": "https://files.pythonhosted.org/packages/2c/f1/7346ee22eceaa5600a17092d10d23acae7f0d38b6aa92f787d97bb0a2907/clipper_dev-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-30 11:18:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Rklearns",
"github_project": "clipper-dev",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "typer",
"specs": [
[
">=",
"0.9.0"
]
]
},
{
"name": "rich",
"specs": [
[
">=",
"13.0.0"
]
]
},
{
"name": "pyperclip",
"specs": [
[
">=",
"1.8.2"
]
]
},
{
"name": "rapidfuzz",
"specs": [
[
">=",
"3.0.0"
]
]
},
{
"name": "textual",
"specs": [
[
">=",
"0.40.0"
]
]
},
{
"name": "click",
"specs": [
[
">=",
"8.0.0"
]
]
}
],
"lcname": "clipper-dev"
}
JSON
