{"id":48713292,"url":"https://github.com/bloodstalk1/clipo","last_synced_at":"2026-05-02T10:02:03.230Z","repository":{"id":350677289,"uuid":"1207878564","full_name":"bloodstalk1/Clipo","owner":"bloodstalk1","description":"A macOS menu bar clipboard manager with searchable history, image previews, pinning, and auto-paste.","archived":false,"fork":false,"pushed_at":"2026-04-26T02:26:31.000Z","size":1412,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-26T04:21:49.747Z","etag":null,"topics":["appkit","clipboard","clipboard-manager","macos","menubar-app","productivity","sqlite","swift","swiftui","xcodegen"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bloodstalk1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-11T14:25:49.000Z","updated_at":"2026-04-26T02:26:35.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bloodstalk1/Clipo","commit_stats":null,"previous_names":["bloodstalk1/clipo"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/bloodstalk1/Clipo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bloodstalk1%2FClipo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bloodstalk1%2FClipo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bloodstalk1%2FClipo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bloodstalk1%2FClipo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bloodstalk1","download_url":"https://codeload.github.com/bloodstalk1/Clipo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bloodstalk1%2FClipo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32530176,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T01:12:54.858Z","status":"online","status_checked_at":"2026-05-02T02:00:05.923Z","response_time":132,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["appkit","clipboard","clipboard-manager","macos","menubar-app","productivity","sqlite","swift","swiftui","xcodegen"],"created_at":"2026-04-11T15:12:42.044Z","updated_at":"2026-05-02T10:02:03.225Z","avatar_url":"https://github.com/bloodstalk1.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Clipo\n\nClipo is a lightweight clipboard manager for macOS. It lives in the menu bar, keeps a searchable clipboard history, previews images inline, and lets you paste previous items back into the app you were using.\n\n![macOS](https://img.shields.io/badge/macOS-13%2B-blue)\n![Swift](https://img.shields.io/badge/Swift-6.0-orange)\n![License](https://img.shields.io/badge/License-MIT-green)\n\n## Preview\n\nGenerated from the current Clipo UI components so the README stays aligned with the app.\n\n![Clipo workflow](docs/assets/clipo-workflow.gif)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/assets/clipo-overview.png\" alt=\"Clipo overview panel\" width=\"49%\" /\u003e\n  \u003cimg src=\"docs/assets/clipo-search.png\" alt=\"Clipo search and image preview\" width=\"49%\" /\u003e\n\u003c/p\u003e\n\n## Highlights\n\n### Core Features\n- Menu bar app with no Dock icon\n- Global hotkey for quick access (`Cmd + Shift + V`)\n- Searchable clipboard history with FTS5 full-text search\n- Inline image previews with lazy loading\n- Pin important items\n- Automatic history cleanup with pinned-item protection\n- Auto-paste with Accessibility permission\n- Better clipboard parsing for browser and Figma content\n\n### Performance (v2.0.0)\n- **Adaptive polling**: 5s idle → 0.5s focused (saves CPU and battery)\n- **Smart caching**: Instant search results with 5-minute TTL\n- **Lazy image loading**: Images load only when visible\n- **Background I/O**: Non-blocking disk operations\n- **\u003c1% CPU idle**, **\u003c60MB memory**, **\u003c50ms search latency**\n\n### UI/UX (v2.0.0)\n- **Liquid Glass design**: Modern glassmorphism with blur and saturation\n- **100% keyboard navigation**: All features accessible via keyboard\n- **Physics-based animations**: 60fps+ spring animations\n- **Source app icons**: See which app each clipboard item came from\n- **GPU-accelerated rendering**: CoreImage filters for smooth effects\n\n## Install\n\n### Download a release\n\n1. Open [Releases](https://github.com/bloodstalk1/Clipo/releases)\n2. Download the latest `.dmg`\n3. Open the DMG and drag `Clipo.app` into `Applications`\n\n### Build from source\n\n```bash\ngit clone https://github.com/bloodstalk1/Clipo.git\ncd clipo\nxcodegen generate\nopen Clipo.xcodeproj\n```\n\nRun the app from Xcode with `Cmd + R`.\n\n### Package a DMG\n\n```bash\nxcodegen generate\n./scripts/package_dmg.sh\n```\n\nThis creates a drag-to-install DMG with `Clipo.app` and an `Applications` shortcut.\n\n## Usage\n\n1. Open Clipo from the menu bar icon or with `Cmd + Shift + V`\n2. Search or browse your clipboard history\n3. Click an item to restore and paste it\n4. Pin important items so they stay around longer\n5. Remove individual items or clear history when needed\n\n### Keyboard Shortcuts\n\n| Shortcut | Action |\n|----------|--------|\n| `Cmd + Shift + V` | Open clipboard popup |\n| `↑` / `↓` | Navigate items |\n| `Cmd + ↑` / `Cmd + ↓` | Jump to top/bottom |\n| `Enter` | Paste selected item |\n| `Cmd + P` | Toggle pin on selected item |\n| `Cmd + Backspace` | Delete selected item |\n| `Cmd + F` | Focus search field |\n| `Escape` | Clear search or close popup |\n\n## Permissions\n\nClipo needs Accessibility permission only for auto-paste.\n\n1. Open Clipo\n2. Use the permission prompt inside the popup\n3. Enable Clipo in `System Settings \u003e Privacy \u0026 Security \u003e Accessibility`\n\nIf Accessibility is not enabled, Clipo still stores history and restores items to the clipboard. You can paste manually with `Cmd + V`.\n\n## Requirements\n\n- macOS 13 or later\n- Apple Silicon or Intel Mac\n\n## Performance\n\nv2.0.0 delivers significant performance improvements:\n\n| Metric | v1.0.1 | v2.0.0 | Improvement |\n|--------|--------|--------|-------------|\n| CPU (idle) | ~2% | \u003c1% | 50% reduction |\n| Memory (1000 items) | ~80MB | \u003c60MB | 25% reduction |\n| Search latency | ~100ms | \u003c50ms | 50% faster |\n| Popup open latency | ~150ms | \u003c100ms | 33% faster |\n| Scroll frame rate | 30-45fps | 60fps+ | 2x smoother |\n\n**Key optimizations:**\n- Adaptive polling adjusts monitoring frequency based on activity\n- FTS5 full-text search with smart caching\n- Lazy image loading reduces memory footprint\n- Background I/O prevents UI blocking\n- GPU-accelerated rendering for smooth animations\n\n## Tech Stack\n\n### Core\n- Swift 6 with strict concurrency checking\n- SwiftUI + AppKit hybrid architecture\n- GRDB.swift for SQLite with FTS5 full-text search\n- KeyboardShortcuts for global hotkey registration\n- XcodeGen for project generation\n\n### Performance \u0026 Optimization\n- Actor-based concurrency for thread-safe state management\n- CoreImage GPU-accelerated rendering\n- Lazy image loading with task deduplication\n- Background I/O queue with retry logic\n- Performance telemetry collection\n\n### UI Components\n- Liquid Glass material system with visual effects\n- Physics-based spring animations\n- Keyboard navigation handler (NSEvent-based)\n- Virtualized list view for large datasets\n- Toast notification system\n\n## Project Structure\n\n```text\nClipo/\n├── App/\n├── Features/\n├── Models/\n├── Persistence/\n├── Support/\n└── Resources/\n```\n\n## License\n\nMIT License. See `LICENSE` for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbloodstalk1%2Fclipo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbloodstalk1%2Fclipo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbloodstalk1%2Fclipo/lists"}