CopyMan Repository

Welcome to the CopyMan project repository. This repository contains the CopyMan clipboard manager and related documentation.

📦 What's Inside

CopyMan — Cross-Platform Clipboard Manager

A lightweight, fast, and feature-rich clipboard manager for Linux, Windows, and macOS. Built with Flutter for a native desktop experience.

Status: ✅ Phase 2 Complete | License: MIT | Built with: Flutter 3.38.9

Platform Support:

• ✅ Linux: Production-ready (.deb, Snap)
• ✅ macOS: Supported (.dmg) — clipboard images, paste, app detection via osascript
• 🔄 Windows: Code structure ready, requires platform validation

---

📥 Installation

Linux (Ubuntu/Debian)

Method 1: One-Line Installer (Recommended)

The easiest way to install CopyMan:

curl -sSL https://raw.githubusercontent.com/richeshgupta/CopyMan/master/install.sh | bash

This will automatically:

• Download the latest .deb package
• Install CopyMan and its dependencies
• Set up the application

Method 2: Download .deb Package

wget https://github.com/richeshgupta/CopyMan/releases/download/v0.1.0/copyman_0.1.0_amd64.deb
sudo dpkg -i copyman_0.1.0_amd64.deb
sudo apt-get install -f  # Install dependencies if needed

Method 3: From GitHub Releases

1. Visit Releases Page
2. Download copyman_0.1.0_amd64.deb
3. Double-click the file to install (GUI method)
4. Or use: sudo dpkg -i copyman_0.1.0_amd64.deb

macOS

Method 1: Download DMG (Recommended)

1. Download copyman_0.1.0_macos.dmg from the Releases Page
2. Open the DMG and drag CopyMan to Applications
3. On first launch, grant Accessibility permissions when prompted

Method 2: Build from Source

cd copyman
flutter pub get
flutter build macos --release
open build/macos/Build/Products/Release/CopyMan.app

System Requirements

Linux (Ubuntu 20.04+):

• GTK 3.0+, xclip, xdotool, x11-utils
• Dependencies are automatically installed with the .deb package

macOS (10.14 Mojave+):

• No additional dependencies required (uses built-in osascript)
• Grant Accessibility permissions on first launch for paste simulation

First Launch

After installation:

	Linux	macOS
Open CopyMan	Ctrl+Alt+V	Control+Option+V
System tray	System tray icon	Menu bar icon

Copy something to see it in the clipboard history!

Quick Start

• Open: Ctrl+Alt+V (Linux) / Control+Option+V (macOS)
• Search: Just start typing
• Copy: Enter
• Copy & Paste: Ctrl+Enter / Control+Enter
• Help: Shift+/ (shows all shortcuts)

---

📚 Documentation

Quick Links

Document	Purpose
FEATURES & ARCHITECTURE	Complete feature list, tech stack, services, performance
CONTRIBUTING	Contribution guidelines & development setup
DEVELOPMENT	Detailed development guide & architecture
SECURITY	Security policy & data handling
CHANGELOG	Release history & version changes
LICENSE	MIT License

Getting Started

1. New User? Start with FEATURES & ARCHITECTURE for complete feature list and quick start
2. Want to Contribute? Read CONTRIBUTING for setup & guidelines
3. Developer? See DEVELOPMENT for architecture & dev workflow
4. Have a Security Concern? Check SECURITY for reporting process

---

🛠️ Build from Source

Want to build CopyMan yourself? See our Development Guide for detailed instructions.

Quick build:

cd copyman
flutter pub get
flutter build linux --release
./build/linux/x64/release/bundle/copyman

For developers:

cd copyman
flutter pub get
flutter run -d linux

---

🤝 Contributing

CopyMan is open source and welcomes contributions!

• Report Issues: GitHub Issues
• Suggest Features: GitHub Discussions
• Submit Code: See CONTRIBUTING

---

🗓️ Upcoming Plans

Next Milestones

Phase	Status	Features
Phase 2	✅ Complete	Keyboard-first UI, configurable shortcuts, groups, sequential paste, image capture
Phase 3	✅ Complete	macOS support (osascript clipboard, paste, app detection, .dmg packaging)
Phase 4	🔄 Testing	Windows support (code ready, requires comprehensive testing)
Phase 5	📋 Future	Cross-device sync (LAN P2P, E2EE), cloud backup, mobile apps

Current Focus

• ✅ Linux Production — Fully functional, 177 tests passing, ready for daily use
• ✅ macOS Release — Image capture, paste, app detection via osascript, .dmg packaging
• 🔄 Windows Testing — App detection and clipboard code ready, needs platform testing

Known Limitations

• ⚠️ No cross-device sync — Data stays on this machine (Phase 5 future feature)
• ⚠️ No cloud backup — Local SQLite database only
• ⚠️ Performance at scale — Not tested with 10,000+ items

---

📋 Project Structure

.
├── copyman/                    # Flutter application (main)
├── docs/                       # Documentation & guides
├── .github/                    # GitHub configuration
│   └── workflows/              # CI/CD workflows (GitHub Actions)
├── README.md                   # This file
├── CONTRIBUTING.md             # Contribution guidelines
├── DEVELOPMENT.md              # Development guide (in docs/)
├── SECURITY.md                 # Security policy
├── CHANGELOG.md                # Release history
├── LICENSE                     # MIT License
└── research/                   # Research & reference materials

---

📄 License

CopyMan is licensed under the MIT License. See LICENSE for details.

---

👤 Author

Richesh Gupta — GitHub

---

CopyMan — Copy smarter. Paste faster. ⚡