{"id":15211437,"url":"https://github.com/thatcodechap/pomodi","last_synced_at":"2026-01-24T11:38:58.526Z","repository":{"id":252553515,"uuid":"840758021","full_name":"thatcodechap/pomodi","owner":"thatcodechap","description":"Discord bot that enables users to create and manage Pomodoro sessions directly within Discord voice channels. It helps maintain focus during work sessions and ensures timely breaks by providing real-time notifications and updates.","archived":false,"fork":false,"pushed_at":"2024-08-12T18:32:35.000Z","size":8,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-29T21:43:26.908Z","etag":null,"topics":["bot","discord","discordjs","pomodoro","timer"],"latest_commit_sha":null,"homepage":"https://discord.com/oauth2/authorize?client_id=1271435477450231870\u0026scope=bot\u0026permissions=10240","language":"JavaScript","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/thatcodechap.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}},"created_at":"2024-08-10T15:40:13.000Z","updated_at":"2024-08-12T18:32:39.000Z","dependencies_parsed_at":"2024-09-28T08:41:24.191Z","dependency_job_id":"cfcc408f-97bf-4afc-9c62-572913126c59","html_url":"https://github.com/thatcodechap/pomodi","commit_stats":{"total_commits":3,"total_committers":2,"mean_commits":1.5,"dds":"0.33333333333333337","last_synced_commit":"5124f53bc0b1f950f92f51a22e651372dd6c820d"},"previous_names":["thatcodechap/pomodi"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/thatcodechap/pomodi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thatcodechap%2Fpomodi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thatcodechap%2Fpomodi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thatcodechap%2Fpomodi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thatcodechap%2Fpomodi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thatcodechap","download_url":"https://codeload.github.com/thatcodechap/pomodi/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thatcodechap%2Fpomodi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28727080,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T10:24:43.181Z","status":"ssl_error","status_checked_at":"2026-01-24T10:24:36.112Z","response_time":89,"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":["bot","discord","discordjs","pomodoro","timer"],"created_at":"2024-09-28T08:41:19.911Z","updated_at":"2026-01-24T11:38:58.511Z","avatar_url":"https://github.com/thatcodechap.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PomoDi Bot\n\nThis Discord bot enables users to create and manage Pomodoro sessions directly within Discord voice channels. It helps maintain focus during work sessions and ensures timely breaks by providing real-time notifications and updates.\n\n## Features\n\n- **Pomodoro Session Management**: Start and stop Pomodoro sessions in your Discord voice channels.\n- **Real-Time Notifications**: Alerts for the start of work sessions and breaks, with periodic updates on remaining time.\n- **Flexible Timers**: Customize work and break durations to suit your needs.\n- **Voice Channel Integration**: Sessions are linked to specific voice channels, ensuring all participants are on the same page.\n\n## Try\n[Bot Invite Link](https://discord.com/oauth2/authorize?client_id=1271435477450231870\u0026scope=bot\u0026permissions=10240)\n\n## Installation\n\n1. **Clone the Repository**:\n   ```bash\n   git clone https://github.com/thatcodechap/pomodi.git\n   ```\n2. **Navigate to the Project Directory**:\n   ```bash\n   cd pomodi\n   ```\n3. **Install Dependencies**:\n   ```bash\n   npm install\n   ```\n4. **Set Up Discord Bot**:\n   - Create a bot on the [Discord Developer Portal](https://discord.com/developers/applications).\n   - Add your bot token to the `app.js` file:\n     ```javascript\n     const TOKEN = '\u003cYour Discord Bot Token Here\u003e';\n     ```\n\n5. **Register Commands**:\n   - In your bot's application page, navigate to **\"Bot\"** \u003e **\"OAuth2\"** \u003e **\"URL Generator\"**.\n   - Select the `applications.commands` scope and generate an OAuth2 URL.\n   - Use the URL to invite the bot to your server.\n   - Once the bot is in your server, you can register commands using the Discord API:\n     - Create a new `commands.js` file or add the following code to an existing file:\n\n       ```javascript\n       import { REST, Routes } from 'discord.js';\n\n       const commands = [\n           {\n               name: 'start',\n               description: 'Start a Pomodoro session',\n               options: [\n                   {\n                       name: 'timer',\n                       type: 'STRING',\n                       description: 'Set the work and break time (e.g., 25-5)',\n                       required: true,\n                       choices: [\n                        {\n                            \"name\": \"25 Minutes work, 5 Minutes break\",\n                            \"value\": \"25-5\"\n                        }\n                       ]\n                   },\n               ],\n           },\n           {\n               name: 'stop',\n               description: 'Stop the active Pomodoro session',\n           },\n       ];\n\n       const rest = new REST({ version: '10' }).setToken('\u003cYour Discord Bot Token Here\u003e');\n\n       (async () =\u003e {\n           try {\n               console.log('Started refreshing application (/) commands.');\n\n               await rest.put(\n                   Routes.applicationGuildCommands('\u003cYour Client ID\u003e', '\u003cYour Guild ID\u003e'),\n                   { body: commands },\n               );\n\n               console.log('Successfully reloaded application (/) commands.');\n           } catch (error) {\n               console.error(error);\n           }\n       })();\n       ```\n\n     - Replace `\u003cYour Client ID\u003e` and `\u003cYour Guild ID\u003e` with your actual client and guild IDs.\n     - Run the script to register the commands:\n\n       ```bash\n       node commands.js\n       ```\n\n6. **Run the Bot**:\n   ```bash\n   npm start\n   ```\n\n## Usage\n\n1. **Start a Pomodoro Session**:\n   - Join a voice channel and use the `/start timer \u003cwork-time\u003e-\u003cbreak-time\u003e` command to begin a session. For example:\n     ```\n     /start timer 25-5\n     ```\n   - The bot will notify all members in the voice channel when the session starts and provide periodic updates on the remaining time.\n\n2. **Stop a Session**:\n   - Use the `/stop` command to end an active session in your voice channel.\n\n3. **Check Status**:\n   - The bot automatically provides updates on the remaining time for work and break periods.\n\n## Files Overview\n\n- **`app.js`**: Main bot file handling command interactions, session management, and bot startup.\n- **`DiscordSession.js`**: Manages Discord-specific session behavior, including notifications in text channels.\n- **`Pomodoro.js`**: Core Pomodoro timer logic, including session control and observer notifications.\n\n## Screenshots\n\u003cimg src=\"https://i.imgur.com/a8paG6A.png\" width=\"200px\"\u003e   \u003cimg src=\"https://i.imgur.com/2Ck1A1i.png\" width=\"200px\"\u003e\n\n## Contributing\n\nFeel free to submit issues or pull requests for new features or improvements. Contributions are welcome!\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthatcodechap%2Fpomodi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthatcodechap%2Fpomodi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthatcodechap%2Fpomodi/lists"}