{"id":27902759,"url":"https://github.com/mnhlt/timer-overlay","last_synced_at":"2026-05-08T09:35:38.157Z","repository":{"id":291310270,"uuid":"977245451","full_name":"mnhlt/timer-overlay","owner":"mnhlt","description":"A global, customizable countdown timer that works across all applications. Trigger timers instantly with hotkeys, switch between setup and overlay modes, and boost your productivity with minimal, intuitive design.","archived":false,"fork":false,"pushed_at":"2025-05-03T19:38:22.000Z","size":94,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-25T07:10:42.172Z","etag":null,"topics":["cross-platform","desktop-app","electron","hotkey","overlay","productivity","react","time-management","timer","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/mnhlt.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}},"created_at":"2025-05-03T18:50:05.000Z","updated_at":"2025-05-03T19:38:15.000Z","dependencies_parsed_at":"2025-05-05T21:38:00.433Z","dependency_job_id":null,"html_url":"https://github.com/mnhlt/timer-overlay","commit_stats":null,"previous_names":["mnhlt/timer-overlay"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mnhlt/timer-overlay","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mnhlt%2Ftimer-overlay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mnhlt%2Ftimer-overlay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mnhlt%2Ftimer-overlay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mnhlt%2Ftimer-overlay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mnhlt","download_url":"https://codeload.github.com/mnhlt/timer-overlay/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mnhlt%2Ftimer-overlay/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32775158,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"ssl_error","status_checked_at":"2026-05-08T08:22:45.650Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6: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":["cross-platform","desktop-app","electron","hotkey","overlay","productivity","react","time-management","timer","typescript"],"created_at":"2025-05-05T21:37:52.154Z","updated_at":"2026-05-08T09:35:38.140Z","avatar_url":"https://github.com/mnhlt.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Timer Overlay\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"public/timer-icon.png\" alt=\"Timer Overlay Icon\" width=\"128\" height=\"128\"\u003e\n\u003c/div\u003e\n\n\u003e A global countdown timer that floats above your applications with hotkey/mouse trigger support\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"#key-features\"\u003eKey Features\u003c/a\u003e •\n  \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e •\n  \u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e •\n  \u003ca href=\"#screenshots\"\u003eScreenshots\u003c/a\u003e •\n  \u003ca href=\"#faq\"\u003eFAQ\u003c/a\u003e •\n  \u003ca href=\"#development\"\u003eDevelopment\u003c/a\u003e •\n  \u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\n\u003c/div\u003e\n\n## Key Features\n\n- **Global Overlay Timer**: Countdown timer that remains visible on top of all other applications\n- **Flexible Triggers**: Start your timer with customizable keyboard shortcuts or mouse buttons\n- **Dual-Mode Interface**:\n  - **Setup Mode**: Configure your timer and triggers with an intuitive interface\n  - **Overlay Mode**: Minimalist, transparent display that stays out of your way\n- **Advanced Hotkey Support**:\n  - Up to three keys per shortcut (including modifiers)\n  - Supports all major modifier keys (Ctrl, Alt, Shift, Command)\n  - Dedicated mouse button trigger options\n- **Transparency Control**: Adjust the overlay visibility to your preferences\n- **Draggable Interface**: Position the timer anywhere on your screen\n- **Lock/Unlock Function**: Prevent accidental movement during use\n- **Cross-Platform**: Works on Windows, macOS, and Linux\n\n## Installation\n\n### Windows\n\n1. Download the latest `Timer-Overlay-Setup-x.x.x.exe` from the [Releases](https://github.com/mnhlt/timer-overlay/releases) page\n2. Run the installer and follow the on-screen instructions\n3. Launch Timer Overlay from your Start menu or desktop shortcut\n\n### macOS\n\n1. Download the latest `Timer-Overlay-x.x.x.dmg` from the [Releases](https://github.com/mnhlt/timer-overlay/releases) page\n2. Open the DMG file and drag Timer Overlay to your Applications folder\n3. Launch Timer Overlay from your Applications folder or Launchpad\n\n### Linux\n\n1. Download the latest `Timer-Overlay-x.x.x.AppImage` from the [Releases](https://github.com/mnhlt/timer-overlay/releases) page\n2. Make the AppImage executable: `chmod +x Timer-Overlay-x.x.x.AppImage`\n3. Run the AppImage: `./Timer-Overlay-x.x.x.AppImage`\n\n## Usage\n\n### Quick Start\n\n1. Launch Timer Overlay\n2. Set your desired countdown duration (in seconds)\n3. Configure your preferred hotkey combination or mouse button\n4. Click \"Switch to Overlay\" to enable the transparent overlay\n5. Use your configured hotkey or mouse button to trigger the timer from any application\n6. Click \"Main\" to return to the setup interface\n\n### Setting Up Keyboard Shortcuts\n\n1. In the Hotkey Setup section, select \"Keyboard Shortcut\" as the trigger type\n2. Choose your preferred modifier keys (Control, Alt, Shift, etc.)\n3. Select a trigger key (letter, number, or function key)\n4. Your hotkey is saved automatically\n\n### Setting Up Mouse Triggers\n\n1. In the Hotkey Setup section, select \"Mouse Button\" as the trigger type\n2. Select your preferred mouse button from the dropdown menu\n3. Your mouse trigger is saved automatically\n\n### Working with the Overlay\n\n- **Move**: Click and drag the overlay to position it anywhere on your screen\n- **Lock**: Click the lock button (🔒) to prevent accidental movement\n- **Unlock**: Click the unlock button (🔓) to make the overlay movable again\n- **Return to Main**: Click the \"Main\" button to go back to the setup interface\n\n## Screenshots\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"public/screenshots/setup-mode.png\" alt=\"Setup Mode\" width=\"400\"\u003e\n  \u003cp\u003e\u003cem\u003eSetup Mode - Configure your timer and triggers\u003c/em\u003e\u003c/p\u003e\n  \n  \u003cimg src=\"public/screenshots/overlay-mode.png\" alt=\"Overlay Mode\" width=\"400\"\u003e\n  \u003cp\u003e\u003cem\u003eOverlay Mode - Minimal interface that stays on top\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n## FAQ\n\n**Q: Why isn't my hotkey working?**  \nA: Some applications may capture certain hotkeys before Timer Overlay can detect them. Try using a different combination that doesn't conflict with your applications.\n\n**Q: Can I use Timer Overlay with streaming software?**  \nA: Yes! Timer Overlay works great with OBS, Streamlabs, and other streaming software. The transparent overlay can be captured in your streaming window.\n\n**Q: Does Timer Overlay work with multiple monitors?**  \nA: Yes, you can place the overlay on any connected display.\n\n**Q: Will the overlay appear in screenshots or recordings?**  \nA: Yes, the overlay will be visible in screenshots and screen recordings.\n\n## Development\n\nFor information on building and contributing to Timer Overlay, please see [DEVELOPMENT.md](DEVELOPMENT.md).\n\n## License\n\nMIT\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  Created with ❤️ for productivity enthusiasts everywhere\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmnhlt%2Ftimer-overlay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmnhlt%2Ftimer-overlay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmnhlt%2Ftimer-overlay/lists"}