{"id":26722689,"url":"https://github.com/thelovinator1/discord-reminder-bot","last_synced_at":"2025-04-14T06:55:22.379Z","repository":{"id":38079969,"uuid":"310776974","full_name":"TheLovinator1/discord-reminder-bot","owner":"TheLovinator1","description":"Discord reminder bot","archived":false,"fork":false,"pushed_at":"2025-03-27T19:00:26.000Z","size":845,"stargazers_count":23,"open_issues_count":10,"forks_count":8,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-14T06:55:16.012Z","etag":null,"topics":["bot","discord","discord-bot","discord-reminder-bot","discord-webhooks","docker","hacktoberfest","python","reminders"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheLovinator1.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":"2020-11-07T05:46:56.000Z","updated_at":"2025-04-01T20:40:17.000Z","dependencies_parsed_at":"2023-11-20T04:32:57.632Z","dependency_job_id":"f4409f1f-1a3e-4109-84a7-399ea0f0c169","html_url":"https://github.com/TheLovinator1/discord-reminder-bot","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheLovinator1%2Fdiscord-reminder-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheLovinator1%2Fdiscord-reminder-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheLovinator1%2Fdiscord-reminder-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheLovinator1%2Fdiscord-reminder-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheLovinator1","download_url":"https://codeload.github.com/TheLovinator1/discord-reminder-bot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248837281,"owners_count":21169374,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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","discord-bot","discord-reminder-bot","discord-webhooks","docker","hacktoberfest","python","reminders"],"created_at":"2025-03-27T20:36:38.982Z","updated_at":"2025-04-14T06:55:22.347Z","avatar_url":"https://github.com/TheLovinator1.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Discord-reminder-bot\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"Bot.png\" title=\"/remind add message_reason: Remember to feed the cat! message_date: 2 November 2025 14:00 CET\"/\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\u003csup\u003eTheme is https://github.com/KillYoy/DiscordNight\u003csup\u003e\u003c/p\u003e\n\nA discord bot that allows you to set a date, [cron](https://en.wikipedia.org/wiki/Cron), and interval reminders.\n\n## Usage\n\nType `/remind` in a Discord server where this bot exists to get a list of slash commands you can use.\n\n## Installation\n\nYou have two choices, [install directly on your computer](#install-directly-on-your-computer) or\nusing [Docker](https://hub.docker.com/r/thelovinator/discord-reminder-bot).\n\n### Creating a Discord bot token\n\n- Create a [New Application](https://discord.com/developers/applications).\n- Create a bot by going to Bot -\u003e Add Bot -\u003e Yes, do it!\n- You can change Icon and Username here.\n- Copy the bot token and paste it into the `BOT_TOKEN` environment variable.\n- Go to the OAuth2 page -\u003e URL Generator\n  - Select the `bot` and `applications.commands` scope.\n  - Select the bot permissions that you want the bot to have. Select `Administrator`. (TODO: Add a list of permissions\n      that are needed)\n  - Copy the generated URL and open it in your browser. You can now invite the bot to your server.\n\n### Install directly on your computer\n\n- Install the latest version of needed software:\n  - [Python](https://www.python.org/)\n    - You should use the latest version.\n    - You want to add Python to your PATH.\n    - Windows: Find `App execution aliases` and disable python.exe and python3.exe\n  - [Poetry](https://python-poetry.org/docs/master/#installation)\n    - Windows: You have to add `%appdata%\\Python\\Scripts` to your PATH for Poetry to work.\n- Download project from GitHub with Git or download\n  the [ZIP](https://github.com/TheLovinator1/discord-reminder-bot/archive/refs/heads/master.zip).\n  - If you want to update the bot, you can run `git pull` in the project folder or download the ZIP again.\n- Rename .env.example to .env and open it in a text editor (e.g., VSCode, Notepad++, Notepad).\n  - If you can't see the file extension:\n    - Windows 10: Click the View Tab in File Explorer and click the box next to File name extensions.\n    - Windows 11: Click View -\u003e Show -\u003e File name extensions.\n- Open a terminal in the repository folder.\n  - Windows 10: \u003ckbd\u003eShift\u003c/kbd\u003e + \u003ckbd\u003eright-click\u003c/kbd\u003e in the folder and select `Open PowerShell window here`\n  - Windows 11: \u003ckbd\u003eShift\u003c/kbd\u003e + \u003ckbd\u003eright-click\u003c/kbd\u003e in the folder and Show more options\n      and `Open PowerShell window here`\n- Install requirements:\n  - Type `poetry install` into the PowerShell window. Make sure you are\n      in the repository folder with the [pyproject.toml](pyproject.toml) file.\n    - You may have to restart your terminal if it can't find the `poetry` command. Also double check it is in\n          your PATH.\n- Start the bot:\n  - Type `poetry run bot` into the PowerShell window.\n    - You can stop the bot with \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003ec\u003c/kbd\u003e.\n\nNote: You will need to run `poetry install` again if poetry.lock has been modified.\n\nNote: It can take up to one hour for the slash commands to be visible in the Discord server.\n\n### Docker\n\nDocker Hub: [thelovinator/discord-reminder-bot](https://hub.docker.com/r/thelovinator/discord-reminder-bot)\n\n- Rename .env.example to .env and open it in a text editor (e.g., VSCode, Notepad++, Notepad).\n  - If you can't see the file extension:\n    - Windows 10: Click the View Tab in File Explorer and click the box next to File name extensions.\n    - Windows 11: Click View -\u003e Show -\u003e File name extensions.\n- Open a terminal in the extras folder.\n  - Windows 10: \u003ckbd\u003eShift\u003c/kbd\u003e + \u003ckbd\u003eright-click\u003c/kbd\u003e in the folder and select `Open PowerShell window here`\n  - Windows 11: \u003ckbd\u003eShift\u003c/kbd\u003e + \u003ckbd\u003eright-click\u003c/kbd\u003e in the folder and Show more options\n      and `Open PowerShell window here`\n- Run the Docker Compose file:\n  - `docker-compose up`\n    - You can stop the bot with \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003ec\u003c/kbd\u003e.\n    - If you want to run the bot in the background, you can run `docker-compose up -d`.\n\n## Help\n\n- Email: tlovinator@gmail.com\n- Discord: TheLovinator#9276\n- Send an issue: [discord-reminder-bot/issues](https://github.com/TheLovinator1/discord-reminder-bot/issues)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthelovinator1%2Fdiscord-reminder-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthelovinator1%2Fdiscord-reminder-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthelovinator1%2Fdiscord-reminder-bot/lists"}