A powerful, modern, and intelligent clipboard manager built with Flutter
Features • Installation • Usage • Architecture • Contributing
- 🎯 Automatic Clipboard Monitoring - Seamlessly captures everything you copy
- 📝 Smart Content Detection - Automatically identifies and categorizes text and code snippets
- 🔍 Advanced Search & Filtering - Find any clipboard item instantly with powerful search
- ⭐ Favorites System - Mark important items for quick access
- 🗑️ Soft Delete - Safely remove items with recovery options
- 📊 Real-time Analytics - Track your clipboard usage patterns
- 💻 Language Detection - Automatically identifies programming languages in code snippets
- 🎨 Syntax Awareness - Special handling for code content
- 📦 Code Organization - Filter and manage code snippets separately
- 🌓 Theme Support - Light, Dark, and System theme modes
- 🎨 Customizable Accent Colors - Personalize your experience
- 🔔 Smart Notifications - Stay informed with configurable alerts
- 📱 Responsive Design - Optimized for all screen sizes
- ✨ Glassmorphism UI - Modern, beautiful interface with blur effects
- 📈 Productivity Score - Measure your clipboard efficiency
- ⏰ Peak Usage Hours - Discover when you're most active
- 📊 Content Distribution - Visualize your clipboard patterns
- 🔄 Access Patterns - Track frequently used items
- 💾 Storage Metrics - Monitor database usage
- 🔁 Duplicate Detection - Identify and manage duplicate entries
- Flutter SDK (3.10.4 or higher)
- Dart SDK (3.0 or higher)
- A supported platform: Windows, macOS, or Linux
git clone https://github.com/kaiumallimon/copi.git
cd copiflutter pub get# Development mode
flutter run
# Release mode
flutter run --releaseflutter build windowsflutter build macosflutter build linuxThe built application will be available in the build/ directory.
- Enable Monitoring - Grant clipboard access permissions when prompted
- Configure Settings - Customize theme, colors, and notification preferences
- Start Copying - Copi automatically captures everything you copy
- View All Items - Navigate to the Clipboards page to see your history
- Search - Use the search bar to find specific content
- Filter - Toggle between All Items, Text Only, Code Only, and Favorites
- Mark as Favorite - Click the heart icon on any item
- Copy Again - Click the copy button to reuse content
- View Full Content - Click the eye icon for detailed view
- Delete - Remove items with the delete button
- Productivity Score - View your clipboard efficiency rating
- Usage Patterns - Analyze when you copy items most
- Content Types - See the distribution of text vs. code
- Most Accessed - Find your frequently used items
- Storage Info - Monitor database size and usage
(Coming soon)
Ctrl/Cmd + Shift + V- Open clipboard historyCtrl/Cmd + F- Focus searchCtrl/Cmd + ,- Open settings
copi/
├── lib/
│ ├── main.dart # Application entry point
│ └── app/
│ ├── configs/ # App configuration
│ │ ├── _app_config.dart
│ │ └── _app_theme.dart # Theme definitions
│ ├── models/ # Data models
│ │ └── _clipboard_model.dart
│ ├── router/ # Navigation
│ │ └── _app_router.dart
│ ├── services/ # Business logic
│ │ ├── _clipboard_hive_service.dart
│ │ ├── _clipboard_monitor_service.dart
│ │ ├── _analytics_service.dart
│ │ └── _settings_service.dart
│ ├── utils/ # Utilities
│ │ └── _code_detector.dart
│ └── views/ # UI layer
│ ├── shared/
│ │ └── widgets/ # Reusable widgets
│ │ ├── blurred_header.dart
│ │ └── productivity_score_card.dart
│ └── pages/
│ ├── home/ # Dashboard
│ │ └── widgets/
│ ├── clipboards/ # Clipboard management
│ │ ├── widgets/
│ │ └── utils/
│ ├── analytics/ # Analytics dashboard
│ ├── settings/ # Settings page
│ │ └── widgets/
│ └── favorites/ # Favorites view
├── assets/
│ ├── fonts/ # Custom fonts
│ └── images/ # Images and icons
├── android/ # Android-specific
├── ios/ # iOS-specific
├── linux/ # Linux-specific
├── macos/ # macOS-specific
├── windows/ # Windows-specific
└── web/ # Web-specific
- Flutter - Cross-platform UI framework
- Material Design 3 - Modern design system
- Custom Animations - Smooth transitions and effects
- Hive - Fast, lightweight NoSQL database
- Shared Preferences - Settings persistence
- Local Storage - Secure data management
- StatefulWidget - Built-in Flutter state management
- Provider Pattern - Service-based architecture
dependencies:
flutter:
sdk: flutter
hive: ^2.2.3
hive_flutter: ^1.1.0
blur: ^4.0.2
go_router: ^17.0.1
font_awesome_flutter: ^10.12.0
uuid: ^4.5.2
clipboard_watcher: ^0.3.0
path_provider: ^2.1.5- Service Layer Pattern - Separation of business logic
- Repository Pattern - Data access abstraction
- Widget Composition - Modular, reusable components
- Responsive Design - Adaptive layouts for all screens
Copi supports three theme modes:
- Light Mode - Clean and bright
- Dark Mode - Easy on the eyes
- System - Follows your OS preference
Choose from 10 beautiful accent colors:
- Purple (Default)
- Blue
- Green
- Orange
- Pink
- Cyan
- Deep Orange
- Deep Purple
- Indigo
- Amber
Configure to your preferences:
- Enable/disable clipboard monitoring
- Toggle notifications
- Sound effects on/off
- Auto-cleanup options (coming soon)
- Local Storage Only - All data stays on your device
- No Cloud Sync - Your clipboard history never leaves your computer
- No Analytics - We don't track your usage
- Open Source - Fully transparent codebase
- Soft Delete - Recover accidentally deleted items
- Keyboard shortcuts
- Import/Export functionality
- Cloud sync (optional)
- Multiple clipboard support
- Rich text support
- Image clipboard support
- File clipboard support
- Smart paste
- Clipboard templates
- Plugin system
- Mobile support (Android/iOS)
- Team collaboration features
- Encrypted storage
- Advanced search with regex
- Custom themes
We welcome contributions from the community! Here's how you can help:
- Report Bugs - Found a bug? Open an issue
- Suggest Features - Have an idea? We'd love to hear it
- Submit Pull Requests - Code contributions are welcome
- Improve Documentation - Help others understand the project
- Share Feedback - Tell us what you think
# Fork the repository
git clone https://github.com/kaiumallimon/copi.git
cd copi
# Create a feature branch
git checkout -b feature/amazing-feature
# Make your changes and commit
git commit -m "Add amazing feature"
# Push to your fork
git push origin feature/amazing-feature
# Open a Pull Request- Follow Effective Dart guidelines
- Use meaningful variable and function names
- Add comments for complex logic
- Write tests for new features
- Keep widgets small and focused
Follow the Conventional Commits specification:
feat: Add keyboard shortcuts
fix: Resolve clipboard monitoring issue
docs: Update README with new features
style: Format code according to style guide
refactor: Restructure settings page
test: Add unit tests for analytics service
When reporting bugs, please include:
- Description - Clear description of the issue
- Steps to Reproduce - How to recreate the bug
- Expected Behavior - What should happen
- Actual Behavior - What actually happens
- Screenshots - If applicable
- Environment - OS, Flutter version, etc.
This project is licensed under the MIT License - see the LICENSE file for details.
MIT License
Copyright (c) 2025 Copi Contributors
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
- Flutter - UI framework
- Hive - Fast NoSQL database
- Material Design 3 - Design system
- Ditto - Windows clipboard manager
- CopyQ - Cross-platform clipboard manager
- Clipy - macOS clipboard manager
Thanks to all contributors who help make Copi better!
- Issues - GitHub Issues
- Discussions - GitHub Discussions
- Email - support@copi-app.com
- Twitter - @CopiApp