{"id":37428001,"url":"https://github.com/cyvid7-darus10/task-floater","last_synced_at":"2026-01-26T05:02:11.809Z","repository":{"id":332244019,"uuid":"1133174743","full_name":"Cyvid7-Darus10/task-floater","owner":"Cyvid7-Darus10","description":"A beautiful, modern floating task manager for macOS with glassmorphism design","archived":false,"fork":false,"pushed_at":"2026-01-23T22:21:55.000Z","size":4399,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-24T09:41:09.235Z","etag":null,"topics":["electron","glassmorphism","macos","pomodoro","productivity","task-manager","typescript"],"latest_commit_sha":null,"homepage":null,"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/Cyvid7-Darus10.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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-01-13T01:38:46.000Z","updated_at":"2026-01-23T22:22:05.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Cyvid7-Darus10/task-floater","commit_stats":null,"previous_names":["cyrus-reap/task-floater","cyvid7-darus10/task-floater"],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/Cyvid7-Darus10/task-floater","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyvid7-Darus10%2Ftask-floater","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyvid7-Darus10%2Ftask-floater/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyvid7-Darus10%2Ftask-floater/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyvid7-Darus10%2Ftask-floater/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cyvid7-Darus10","download_url":"https://codeload.github.com/Cyvid7-Darus10/task-floater/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyvid7-Darus10%2Ftask-floater/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28767013,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T03:54:34.369Z","status":"ssl_error","status_checked_at":"2026-01-26T03:54:33.031Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":["electron","glassmorphism","macos","pomodoro","productivity","task-manager","typescript"],"created_at":"2026-01-16T06:32:30.242Z","updated_at":"2026-01-26T05:02:11.803Z","avatar_url":"https://github.com/Cyvid7-Darus10.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"build/icon.svg\" width=\"128\" height=\"128\" alt=\"Task Floater Icon\"\u003e\n\n# Task Floater\n\n**A minimalist, always-on-top task manager for macOS with integrated Pomodoro timer**\n\n[![macOS](https://img.shields.io/badge/platform-macOS%2010.13+-blue.svg)](https://www.apple.com/macos)\n[![License](https://img.shields.io/github/license/cyrus-reap/task-floater)](LICENSE)\n[![Latest Release](https://img.shields.io/github/v/release/cyrus-reap/task-floater)](https://github.com/cyrus-reap/task-floater/releases/latest)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.3+-3178c6.svg)](https://www.typescriptlang.org/)\n[![Electron](https://img.shields.io/badge/Electron-28.0-47848f.svg)](https://www.electronjs.org/)\n\n[Features](#features) • [Installation](#installation) • [Documentation](#documentation) • [Contributing](#contributing)\n\n\u003c/div\u003e\n\n---\n\n## Overview\n\nTask Floater is a productivity application designed to stay visible above all windows, providing instant access to your task list without disrupting your workflow. Built with modern design principles, it features a glassmorphism UI, integrated Pomodoro timer system, and focus mode for distraction-free work.\n\n**Key Capabilities:**\n- Always-on-top floating window with glassmorphism design\n- **NEW:** Screenshot-based task capture with OCR (bulk import tasks from images)\n- Integrated Pomodoro timer with customizable durations\n- Focus mode for minimizing distractions\n- Automatic task persistence and updates\n- Full keyboard navigation support\n\n## Screenshots\n\n\u003cdiv align=\"center\"\u003e\n\n| Full View | Command Palette |\n|:-:|:-:|\n| \u003cimg width=\"340\" alt=\"Full View\" src=\"https://github.com/user-attachments/assets/bb3aa356-50db-4c30-85ba-bf19d70e3b55\" /\u003e | \u003cimg width=\"403\" height=\"631\" alt=\"Screenshot 2026-01-13 at 20 46 48\" src=\"https://github.com/user-attachments/assets/c761ee9f-5d05-49a1-ba73-a99687b6edb7\" /\u003e\n |\n\n| Focus Timer | Focus Mode | Compact Mode |\n|:-:|:-:|:-:|\n| \u003cimg width=\"260\" alt=\"Focus Timer\" src=\"https://github.com/user-attachments/assets/c95ac21b-27db-4a95-8dcb-02d115ec64cd\" /\u003e | \u003cimg width=\"260\" alt=\"Focus Mode\" src=\"https://github.com/user-attachments/assets/0193c4d2-9d19-4ae7-86c8-571fc37e420c\" /\u003e | \u003cimg width=\"260\" alt=\"Compact Mode\" src=\"https://github.com/user-attachments/assets/beb7f1b6-142e-4393-a66a-c6fbbb7776e3\" /\u003e |\n\n### Light Theme\n\n| Full View | Compact | Focus Timer |\n|:-:|:-:|:-:|\n| \u003cimg width=\"280\" alt=\"Light Full View\" src=\"https://github.com/user-attachments/assets/16e8d26e-eeef-4bf5-82aa-da8c7cc8467e\" /\u003e | \u003cimg width=\"280\" alt=\"Light Compact\" src=\"https://github.com/user-attachments/assets/beab797e-2940-4a1c-b6fa-fef701d74288\" /\u003e | \u003cimg width=\"280\" alt=\"Light Focus Timer\" src=\"https://github.com/user-attachments/assets/38fab15d-b163-4a8e-9f75-bcd9a2bec75a\" /\u003e |\n\n\u003c/div\u003e\n\n## Features\n\n### Task Management\n- **Always-on-top window** - Remains visible across all workspaces and full-screen apps\n- **Screenshot-based capture** - Bulk import tasks from screenshots using local OCR\n- **Glassmorphism UI** - Modern frosted glass aesthetic with smooth animations\n- **Drag \u0026 drop reordering** - Organize tasks by dragging\n- **Inline editing** - Double-click any task to edit in place\n- **Automatic persistence** - Changes saved instantly to local storage\n- **Search functionality** - Real-time task filtering\n\n### Pomodoro Timer System\n- **Integrated timers** - Optional timer for each task\n- **Quick presets** - 15min, 25min, 30min, 45min, 1hr, 90min durations\n- **Visual progress** - Animated progress bar with real-time countdown\n- **Auto-advance** - Automatically proceeds to next task on completion\n- **Audio notifications** - Alert sounds when timers complete\n- **Persistent state** - Timer state survives app restarts\n\n### Focus Mode\n- **Distraction-free interface** - Hides completed tasks and UI chrome\n- **Active task emphasis** - Running timers highlighted with visual effects\n- **Keyboard shortcut** - Toggle with `Cmd+Shift+F`\n- **Immersive design** - Darker background for concentration\n\n### Developer Features\n- **Security hardened** - Input validation, XSS prevention, Electron sandbox\n- **Auto-updates** - Automatic update notifications via GitHub Releases\n- **Type-safe** - Built with TypeScript strict mode\n- **Well-documented** - Comprehensive guides and API documentation\n\n## Installation\n\n### Pre-built Application\n\n**[📥 Download Latest Release](https://github.com/cyrus-reap/task-floater/releases/latest)**\n\n#### macOS Installation\n\n1. Download the appropriate DMG:\n   - **Apple Silicon** (M1/M2/M3): `Task Floater-X.X.X-arm64.dmg`\n   - **Intel**: `Task Floater-X.X.X.dmg`\n\n2. Open the DMG file\n\n3. **⚠️ First launch only** - Bypass Gatekeeper (one-time setup):\n\n   This app is unsigned (free distribution). macOS will show a security warning:\n\n   ```\n   a. macOS shows: \"Apple could not verify Task Floater.app\"\n   b. Click \"Cancel\" or \"Done\"\n   c. Go to Applications folder\n   d. Right-click (or Control+click) Task Floater.app\n   e. Select \"Open\" from the menu\n   f. Click \"Open\" in the confirmation dialog\n   ```\n\n   **Alternative (Terminal):**\n   ```bash\n   xattr -cr \"/Applications/Task Floater.app\" \u0026\u0026 open \"/Applications/Task Floater.app\"\n   ```\n\n4. Drag to Applications folder\n\n5. Launch from Applications\n\n**Why unsigned?** This is a free, open-source app. Code signing requires a $99/year Apple Developer membership. The app is 100% safe - review the [source code](https://github.com/cyrus-reap/task-floater) yourself!\n\n**Subsequent launches:** The app will open normally. Updates are delivered automatically.\n\n### Build from Source\n\n**Requirements:** macOS 10.13+, Node.js 16+\n\n```bash\ngit clone https://github.com/cyrus-reap/task-floater.git\ncd task-floater\nnpm install\nnpm start\n```\n\n**Development mode:**\n```bash\nnpm run dev  # Watch mode with auto-reload\n```\n\n## Usage\n\n### Basic Operations\n\n**Add task:** Type in the input field and press Enter\n**Add from screenshot:** Click camera icon or press `Cmd+Shift+S`\n**Set timer:** Click a duration preset before adding the task\n**Start timer:** Click the play button (▶)\n**Complete task:** Click the checkbox\n**Delete task:** Click the delete button\n**Reorder tasks:** Drag and drop\n**Edit task:** Double-click the task title\n\n### Screenshot-Based Task Capture\n\nQuickly bulk-add tasks from any screen content using native macOS screenshot tool:\n\n1. **Trigger capture:** Click the camera icon OR press `Cmd+Shift+S`\n2. **Select region:** Just like `Cmd+Shift+4`, drag to select area containing tasks\n3. **Review tasks:** Preview extracted tasks in modal (remove unwanted items)\n4. **Bulk add:** Click \"Add X Tasks\" to import all at once\n\n**Supported formats:**\n- Plain text (each line becomes a task)\n- Bullet points (-, •, *, ‣)\n- Numbered lists (1., 2., etc.)\n- Checkboxes ([ ], [x], ☐, ☑)\n- Duration extraction (e.g., \"30min\", \"1h\", \"45m\" automatically parsed)\n\n**Native UX:** Uses macOS's built-in screenshot tool for familiar, fast region selection. Press `Esc` to cancel anytime.\n\n**Privacy:** Uses local OCR (Tesseract.js) - no cloud services, all processing happens on your machine.\n\n### Keyboard Shortcuts\n\n| Shortcut | Action |\n|----------|--------|\n| `Cmd+K` | Open Command Palette |\n| `Cmd+Shift+S` | Capture tasks from screenshot |\n| `Cmd+Shift+F` | Toggle Focus Mode |\n| `Cmd+F` | Focus search |\n| `↑` / `↓` | Navigate tasks |\n| `Space` | Toggle task completion |\n| `Enter` | Edit selected task |\n| `Esc` | Clear input/selections |\n\n[View all shortcuts →](docs/guides/SHORTCUTS.md)\n\n### Focus Mode\n\nPress `Cmd+Shift+F` or click the focus button to enter distraction-free mode:\n- Hides completed tasks\n- Removes UI chrome (search, stats, input)\n- Emphasizes active timer\n- Enables immersive dark theme\n\nPerfect for deep work sessions and Pomodoro technique.\n\n[Learn more about Focus Mode →](docs/guides/FOCUS-MODE.md)\n\n## Architecture\n\nTask Floater uses Electron's multi-process architecture with strict security boundaries:\n\n**Main Process** (`src/main.ts`)\n- Window lifecycle management\n- IPC request handlers\n- File system operations\n- Auto-update coordination\n\n**Preload Script** (`src/preload.ts`)\n- Secure IPC bridge via `contextBridge`\n- API exposure with type safety\n- Context isolation enforcement\n\n**Renderer Process** (`src/renderer.ts`)\n- UI logic and event handling\n- DOM manipulation\n- Timer state management\n\n**Security Model:**\n- Context isolation enabled\n- Node integration disabled\n- Chromium sandbox active\n- Content Security Policy enforced\n- Input validation on all operations\n\n[View security documentation →](docs/architecture/SECURITY.md)\n\n## Technology Stack\n\n| Component | Technology | Purpose |\n|-----------|-----------|---------|\n| Runtime | Electron 28.0 | Desktop application framework |\n| Language | TypeScript 5.3+ | Type-safe development |\n| UI | HTML/CSS3 | Glassmorphism design system |\n| OCR | Tesseract.js 7.0 | Local screenshot text extraction |\n| Build | electron-builder | Production packaging |\n| Updates | electron-updater | Automatic updates |\n| Security | Custom validation | Input sanitization \u0026 XSS prevention |\n\n## Documentation\n\nComplete documentation is available in the [`docs/`](docs/) directory:\n\n**User Guides:**\n- [Building from Source](docs/guides/BUILD.md) - Development setup and compilation\n- [Release Management](docs/guides/RELEASING.md) - Version control and distribution\n- [Focus Mode](docs/guides/FOCUS-MODE.md) - Distraction-free productivity\n- [Keyboard Shortcuts](docs/guides/SHORTCUTS.md) - Complete shortcut reference\n\n**Technical Documentation:**\n- [Security Implementation](docs/architecture/SECURITY.md) - Threat model and mitigations\n- [Code Standards](docs/architecture/BEST_PRACTICES.md) - Development guidelines\n- [Feature Documentation](docs/architecture/FEATURES.md) - Technical specifications\n\n**[📖 Full Documentation Index](docs/README.md)**\n\n## Development\n\n### Commands\n\n```bash\nnpm start          # Build and launch application\nnpm run dev        # Development mode with auto-reload\nnpm run build      # Compile TypeScript\nnpm run validate   # Run type checking, linting, and formatting\nnpm run dist:mac   # Build production DMG\n```\n\n### Project Structure\n\n```\nsrc/\n├── main.ts          # Main process (Electron)\n├── preload.ts       # IPC bridge (security)\n├── renderer.ts      # UI logic\n├── constants.ts     # Configuration constants\n├── validation.ts    # Input validators\n├── types.d.ts       # Type definitions\n└── index.html       # UI markup\n\ndocs/                # Documentation\n├── guides/          # User guides\n├── architecture/    # Technical specs\n└── reports/         # Analysis reports\n\nbuild/               # Build assets (icons)\nscripts/             # Build scripts\n```\n\n## Data Storage\n\nTask data is stored locally in JSON format:\n\n**Location:** `~/Library/Application Support/task-floater/`\n- `tasks.json` - Task data\n- `settings.json` - Application preferences\n\n**Privacy:** All data remains on your machine. No cloud sync or telemetry.\n\n## Contributing\n\nContributions are welcome! Please follow these steps:\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/your-feature`)\n3. Make your changes with tests\n4. Run validation (`npm run validate`)\n5. Commit using conventional commits (`feat:`, `fix:`, etc.)\n6. Push to your fork\n7. Open a Pull Request\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.\n\n## Roadmap\n\n**Planned Features:**\n- Linear issue integration\n- Custom theme support\n- Cloud backup option\n- Windows and Linux support\n- Task categories and tagging\n- Recurring task templates\n- Priority indicators\n- Import/export functionality\n\n## License\n\nThis project is licensed under the MIT License. See [LICENSE](LICENSE) for details.\n\n## Author\n\n**Cyrus David Pastelero**\nGitHub: [@cyrus-reap](https://github.com/cyrus-reap)\nEmail: cyrus@pastelero.ph\n\n## Acknowledgments\n\nBuilt with [Electron](https://www.electronjs.org/) and [TypeScript](https://www.typescriptlang.org/).\nDesign inspired by macOS Big Sur glassmorphism principles.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**[Download](https://github.com/cyrus-reap/task-floater/releases/latest)** • **[Documentation](docs/README.md)** • **[Report Issue](https://github.com/cyrus-reap/task-floater/issues)**\n\nMade with care for productivity enthusiasts\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyvid7-darus10%2Ftask-floater","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcyvid7-darus10%2Ftask-floater","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyvid7-darus10%2Ftask-floater/lists"}