{"id":25459779,"url":"https://github.com/ines-om/pixel-pomodoro","last_synced_at":"2026-04-18T03:32:45.498Z","repository":{"id":277074783,"uuid":"931198434","full_name":"ines-om/pixel-pomodoro","owner":"ines-om","description":"Customizable and animated Pomodoro timer featuring pixel-art characters. Users can choose a character, set study and break times, and stay focused with engaging animations. The app runs as an Electron desktop application with custom window controls and an optional always-on-top mode.","archived":false,"fork":false,"pushed_at":"2025-02-12T01:25:06.000Z","size":2495,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-17T01:36:22.316Z","etag":null,"topics":["electron","electron-app","pomodoro"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/ines-om.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}},"created_at":"2025-02-11T21:54:10.000Z","updated_at":"2025-05-14T18:37:30.000Z","dependencies_parsed_at":"2025-02-12T01:40:59.103Z","dependency_job_id":"f73df9a9-1859-484d-a89a-9f3cf0d40c97","html_url":"https://github.com/ines-om/pixel-pomodoro","commit_stats":null,"previous_names":["ines-om/pbezzmodoro"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/ines-om/pixel-pomodoro","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ines-om%2Fpixel-pomodoro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ines-om%2Fpixel-pomodoro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ines-om%2Fpixel-pomodoro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ines-om%2Fpixel-pomodoro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ines-om","download_url":"https://codeload.github.com/ines-om/pixel-pomodoro/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ines-om%2Fpixel-pomodoro/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31955717,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T00:39:45.007Z","status":"online","status_checked_at":"2026-04-18T02:00:07.018Z","response_time":103,"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":["electron","electron-app","pomodoro"],"created_at":"2025-02-18T04:39:13.236Z","updated_at":"2026-04-18T03:32:45.481Z","avatar_url":"https://github.com/ines-om.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pomodoro Pixel Timer\r\n\r\nPomodoro Pixel Timer is a **custom Pomodoro app** built with **React and Electron**, featuring **animated pixel-art characters** that accompany users during their study and break sessions. The app includes a **frameless, custom-designed window**, character selection, and the ability to stay **always on top** for a distraction-free workflow.\r\n\r\n## 🚀 Features\r\n- **Custom Pomodoro Timer**: Set your study time, break time, and number of rounds.\r\n- **Animated Pixel Characters**: Choose from multiple characters, each with unique frame-based animations.\r\n- **Frameless Electron Window**: A sleek, custom-designed UI with built-in **close and minimize** buttons.\r\n- **Always-on-Top Mode**: Keep the app visible on top of other windows for better focus.\r\n- **Character Selection Carousel**: Easily switch between characters before starting a session.\r\n- **Smooth UI \u0026 Controls**: Pause, reset, and manually start breaks or study sessions.\r\n\r\n## 🛠️ Installation\r\n1. Clone the repository:\r\n   - git clone https://github.com/ines-om/pixel-pomodoro\r\n   - cd pixel-pomodoro\r\n     \r\n2. Install dependencies:\r\n     - npm install\r\n\r\n3. Run the app:\r\n     - npm run electron:dev\r\n\r\n## 📦 Packaging \u0026 Distribution\r\nTo create a **standalone** version of the app:\r\n\r\n1️⃣ Build the React App \r\n   - npm run build\r\n\r\n2️⃣ Package the App\r\nUsing Electron Packager:\r\n   - npx electron-packager . PixelPomodoro --platform=win32 --arch=x64 --out=release-build --overwrite\r\n     \r\n\r\n## 🔧 Technologies Used\r\n- React (Frontend UI)\r\n- Electron (Desktop App Framework)\r\n- CSS \u0026 Bootstrap (Styling)\r\n- React Router (Navigation)\r\n- Node.js \u0026 IPC (Electron communication)\r\n\r\n## 📸 Screenshots\r\n![Pomodoro Timer UI - HomePage](https://i.imgur.com/TBVRmkH.png) \r\n![Pomodoro Timer UI - Character Selection](https://i.imgur.com/SLCpNj7.png) \r\n![Pomodoro Timer UI - Pomodoro Timer](https://i.imgur.com/dOVDOWE.png)\r\n\r\n\r\n\r\n## ❓ How to Use\r\nSet Study \u0026 Break Durations and Number of Rounds.\r\nSelect Your Character from the animated carousel.\r\nClick Start to begin the Pomodoro session.\r\nThe character animation will play during your study and break phases.\r\nUse Pause, Reset, and Manual Start to control the timer.\r\n\r\n## 🛠️ Customization\r\nModify the character frames in /assets/ to add new animations.\r\n\r\nAdjust the window settings in main.js for transparency, resizing, or always-on-top behaviour.\r\n\r\n## 👨‍💻 Author\r\nCreated by Inês O. Martins\r\n\r\nGitHub: @ines-om\r\n\r\n## 📜 License\r\nThis project is licensed under the MIT License.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fines-om%2Fpixel-pomodoro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fines-om%2Fpixel-pomodoro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fines-om%2Fpixel-pomodoro/lists"}