{"id":36964538,"url":"https://github.com/mberrishdev/clipai","last_synced_at":"2026-01-13T19:38:37.052Z","repository":{"id":328324252,"uuid":"1113028528","full_name":"mberrishdev/clipai","owner":"mberrishdev","description":"A modern clipboard history manager ","archived":false,"fork":false,"pushed_at":"2025-12-12T12:48:48.000Z","size":2528,"stargazers_count":1,"open_issues_count":12,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-12-14T00:30:04.177Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mberrishdev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2025-12-09T12:28:49.000Z","updated_at":"2025-12-12T12:40:16.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mberrishdev/clipai","commit_stats":null,"previous_names":["mberrishdev/clipai"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/mberrishdev/clipai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mberrishdev%2Fclipai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mberrishdev%2Fclipai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mberrishdev%2Fclipai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mberrishdev%2Fclipai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mberrishdev","download_url":"https://codeload.github.com/mberrishdev/clipai/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mberrishdev%2Fclipai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28397826,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T14:36:09.778Z","status":"ssl_error","status_checked_at":"2026-01-13T14:35:19.697Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2026-01-13T19:38:36.181Z","updated_at":"2026-01-13T19:38:37.043Z","avatar_url":"https://github.com/mberrishdev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# clipai\n\n[![Release](https://img.shields.io/github/v/release/mberrishdev/clipai)](https://github.com/mberrishdev/clipai/releases)\n[![Issues](https://img.shields.io/github/issues/mberrishdev/clipai)](https://github.com/mberrishdev/clipai/issues)\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\n\nA modern clipboard history manager built with Electron, React, and Bun. Runs in your system tray (macOS menu bar / Windows taskbar) with a beautiful transparent UI.\n\n![clipai screenshot](assets/screen1.png)\n\n## Features\n\n- **Automatic Clipboard Monitoring** - Captures clipboard text and images automatically\n- **Image Support** - Save and preview screenshots and copied images\n- **Smart Content Detection** - Detects JSON, URLs, colors, emails, and base64\n- **Syntax Highlighting** - Beautiful JSON formatting with syntax highlighting\n- **Transparent UI** - Beautiful frosted glass effect (toggleable)\n- **System Tray App** - Runs in background, accessible from system tray\n- **Cross-Platform** - Works on macOS and Windows\n- **Settings** - Customize transparency and other options\n- **Fast** - Built with Bun for lightning-fast performance\n- **In-Memory Storage** - Clipboard history stored in memory (clears on restart)\n\n## Tech Stack\n\n- **Electron** - Desktop app framework\n- **React** - UI library\n- **Bun** - JavaScript runtime and bundler\n- **TypeScript** - Type safety\n- **Vite** - Frontend tooling\n\n## Project Structure\n\n```\nsrc/\n├── main/\n│   ├── main.ts              # Electron main process\n│   ├── preload.ts           # Preload script (IPC bridge)\n│   ├── clipboardManager.ts  # Clipboard monitoring logic\n│   ├── database.ts          # SQLite database manager\n│   └── configManager.ts     # App configuration management\n├── renderer/\n│   ├── pages/\n│   │   ├── ClipboardHistory.tsx  # Main clipboard history view\n│   │   ├── ClipboardHistory.css\n│   │   ├── Settings.tsx          # Settings page\n│   │   └── Settings.css\n│   ├── components/\n│   │   └── ClipboardItem.tsx     # Individual clipboard item component\n│   ├── main.tsx             # React entry point\n│   ├── App.tsx              # Main app component with routing\n│   └── types.d.ts           # TypeScript definitions\n└── models/\n    └── ClipboardItem.ts     # Data models and interfaces\n```\n\n## Prerequisites\n\n- [Bun](https://bun.sh) v1.0 or higher\n- macOS or Windows\n\n## Installation\n\n### From Release (Recommended)\n\nDownload the latest release from the [Releases page](https://github.com/mberrishdev/clipai/releases).\n\n**macOS Users:**\n\n1. Download the `.dmg` file (choose `arm64` for Apple Silicon or `x64` for Intel Macs)\n2. Open the `.dmg` file\n3. Drag clipai to your Applications folder\n4. **Important:** Remove macOS quarantine (required for unsigned apps)\n\n   Open Terminal and run:\n   ```bash\n   xattr -cr /Applications/clipai.app\n   ```\n\n   This is safe - it just removes the quarantine flag that macOS adds to downloaded files. Required because the app is not code-signed.\n\n5. Launch clipai from Applications\n\n**Alternative method if you see \"unidentified developer\" warning:**\n- Right-click (or Control-click) on clipai in Applications\n- Click \"Open\"\n- Click \"Open\" again in the dialog\n\n**Note:** If you see \"app is damaged and can't be opened\", you must use the Terminal command above.\n\n**Windows Users:**\n\nYou may see a Windows SmartScreen warning because the app is not code-signed. This is normal for open-source apps. To install:\n\n1. Download the `.exe` installer\n2. Run the installer\n3. If you see a SmartScreen warning:\n   - Click \"More info\"\n   - Click \"Run anyway\"\n\n**Note:** These warnings appear because the app doesn't have a commercial code signing certificate ($300-400/year). The app is completely safe and open-source.\n\n### From Source\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/mberrishdev/clipai.git\ncd clipai\n```\n\n2. Install dependencies:\n```bash\nbun install\n```\n\n## Development\n\nStart the development server:\n\n```bash\nbun run dev\n```\n\nThis will:\n- Start Vite dev server for the renderer (React UI)\n- Compile the preload script in watch mode\n- Launch Electron app\n\n## Build\n\nBuild for production:\n\n```bash\nbun run build\n```\n\nThis creates:\n- `dist/renderer/` - Built React app\n- `dist/main/` - Compiled Electron main process\n\nPackage the app:\n\n```bash\nbun run package\n```\n\nCreates platform-specific installers in `release/`:\n- **macOS**: `.dmg` and `.zip` files (Intel x64 and Apple Silicon arm64)\n- **Windows**: `.exe` installer (NSIS) and portable `.exe`\n\n## Usage\n\n### System Tray\n- **macOS**: Look for the icon in the menu bar (top-right)\n- **Windows**: Look for the icon in the system tray (bottom-right, notification area)\n- Click the tray icon to show/hide the window\n- Right-click (or left-click on Windows) for menu options:\n  - **Show Clipboard History** - View all copied items\n  - **Settings** - Configure app preferences\n  - **Quit** - Exit the application\n\n### Settings\n- **Window Transparency** - Toggle transparent/opaque background\n\n### Clipboard History\n- Automatically saves all clipboard text and images\n- Smart detection: JSON, URLs, colors, emails\n- Click URLs to open in default browser\n- Click items to copy back to clipboard\n- Ignores empty or whitespace-only entries\n- Persistent storage using SQLite database\n- Load more history with pagination\n\n## Logs\n\n**macOS:**\n```bash\n~/Library/Logs/clipai/main.log\n\n# Open in default editor\nopen ~/Library/Logs/clipai/main.log\n\n# Tail logs in real-time\ntail -f ~/Library/Logs/clipai/main.log\n```\n\n**Windows:**\n```\nC:\\Users\\\u003cYourUsername\u003e\\AppData\\Roaming\\clipai\\logs\\main.log\n```\n\nTo open the logs folder:\n```cmd\n# Open in File Explorer\nexplorer %APPDATA%\\clipai\\logs\n\n# Open log file directly in Notepad\nnotepad %APPDATA%\\clipai\\logs\\main.log\n\n# View in Command Prompt\ntype %APPDATA%\\clipai\\logs\\main.log\n```\n\n**Note:** If the logs folder doesn't exist, the app may not have been launched yet, or electron-log may not have initialized. Launch the app once and the log file will be created automatically.\n\n## Scripts\n\n- `bun run dev` - Start development mode\n- `bun run dev:renderer` - Start Vite dev server only\n- `bun run dev:preload` - Build preload script\n- `bun run dev:electron` - Start Electron only\n- `bun run build` - Build for production\n- `bun run build:renderer` - Build React app\n- `bun run build:main` - Build main process\n- `bun run build:preload` - Build preload script\n- `bun run package` - Package app for distribution\n- `bun run package:dir` - Package without creating installer (faster for testing)\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmberrishdev%2Fclipai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmberrishdev%2Fclipai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmberrishdev%2Fclipai/lists"}