discord-message-scheduler

KO | EN

gitlite — search

#javascript #python #hacktoberfest #android #machine-learning #rust #macos #java #windows #awesome #vue #security #mcp #openai

discord-message-scheduler

(★ 41)

A simple Discord Bot that can send scheduled messages.

discord-message-scheduler 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">

<h3 align="center">Discord Message Scheduler</h3>

A simple Discord Bot that can send scheduled messages.
 
 <a href="https://github.com/Taaku18/discord-message-scheduler#about-the-project">Explore the docs »</a>
 
 
 <a href="https://github.com/Taaku18/discord-message-scheduler/issues">Report Bug</a>
 ·
 <a href="https://github.com/Taaku18/discord-message-scheduler/issues">Request Feature</a>
 
</div>

<details>
 <summary>Table of Contents</summary>
 <ol>
 <li>
 <a href="#about-the-project">About The Project</a>
 <ul>
 <li><a href="#features">Features</a></li>
 <li><a href="#built-with">Built With</a></li>
 </ul>
 </li>
 <li>
 <a href="#getting-started">Getting Started</a>
 <ul>
 <li><a href="#prerequisites">Prerequisites</a></li>
 <li><a href="#installation">Installation</a></li>
 <li><a href="#usage">Usage</a></li>
 <li><a href="#docker-experimental">Docker (experimental)</a></li>
 </ul>
 </li>
 <li><a href="#commands-guide">Commands Guide</a></li>
 <li><a href="#roadmap">Roadmap</a></li>
 <li><a href="#contributing">Contributing</a></li>
 <li><a href="#license">License</a></li>
 <li><a href="#contact">Contact</a></li>
 <li><a href="#acknowledgments">Acknowledgments</a></li>
 </ol>
</details>

## About The Project

![Schedule creator screenshot][product-screenshot]

Discord Message Scheduler provides a convenient bot interface to grant users the ability to create scheduled messages via the bot.

(<a href="#readme-top">back to top</a>)

### Features

* Supports both prefixed and slash commands
* Uses SQLite database
* Modern Discord Modal interface
* Easy to set up
* Docker support

### Built With

[![Python][Python.org]][Python-url] [![discord.py][Discord.py]][Discordpy-url]

(<a href="#readme-top">back to top</a>)

## Getting Started

Follow these instructions to deploy your own Discord Message Scheduler bot.

### Prerequisites

This bot is build on Python 3.13. You will need to download the latest version of Python using any of the methods below.

* From official website (Any OS): [https://www.python.org/downloads/](https://www.python.org/downloads/).
* Using [Homebrew](https://brew.sh) (macOS/Linux):
  ```sh
  brew install python@3.13
  ```
* Using APT (Debian/Ubuntu):
  ```sh
  sudo add-apt-repository ppa:deadsnakes/ppa
  sudo apt update
  sudo apt install python3.13 python3.13-dev software-properties-common
  curl -sS https://bootstrap.pypa.io/get-pip.py | python3.13
  ```

You will also need a Discord bot.
1. Create a Discord application at [https://discord.com/developers/applications](https://discord.com/developers/applications)
2. Within the settings page, navigate to the **Bot** tab and create a bot
3. (Optional) If you don't want others to invite your bot, then disable **PUBLIC BOT**.
4. Enable **SERVER MEMBERS INTENT** and **MESSAGE CONTENT INTENT** under the Privileged Gateway Intents settings
5. Navigate to **Oauth2** → **URL Generator** tab, click both **bot** and **applications.commands**, and check the following buttons:
   * Read Messages/View Channels
   * Send Messages
   * Send Messages in Thread
   * Send TTS Messages
   * Embed Links
   * Attach Files
   * Read Message History
   * Mention Everyone
   * Use External Emojis
   * Use External Stickers
   * Add Reactions
   * Use Slash Commands
6. Open the link in the **Generated URL** box at the bottom to invite your bot.

### Installation

1. Clone or [download](https://github.com/Taaku18/discord-message-scheduler/archive/refs/heads/main.zip) the repo
   ```sh
   git clone https://github.com/Taaku18/discord-message-scheduler.git
   ```
2. Install Python dependencies, choose a method from below:
   1. (Recommended) Using PDM
      1. [Install PDM](https://pdm.fming.dev/latest/#recommended-installation-method)
      2. Run `pdm install --prod -G speed --no-lock --no-editable`
   2. Using pip
      ```sh
      python3.13 -m pip install -U pip
      python3.13 -m pip install -U -r requirements.txt
      ```
3. Rename `.env.example` to `.env` and replace `BOT-TOKEN` with your bot's token and `BOT-PREFIX` with your desired bot prefix.
   Example `.env` file:
      ```dotenv
       TOKEN=VTDkXNDUzC3KyFoIxNzYx2_d4OQ.PK5K1A.9p0q3Kdi26j0eCa_vu3Ke_39KsL3Kkso83E_gB0
       PREFIX=?
       SYNC_SLASH_COMMANDS=on
      ```
   `SYNC_SLASH_COMMANDS` should be set to "on" the first time you start the bot and every time you update. It should be set to "off" during normal usage since syncing slash commands may take a long time.

(<a href="#readme-top">back to top</a>)

## Usage

To start the bot, simply run:
```sh
python3.13 start.py
```

(<a href="#readme-top">back to top</a>)

## Docker (experimental)

[![Docker Pulls][docker-pulls-shield]][docker-pulls-url]
[![Docker Size][docker-size-shield]][docker-size-url]

Alternatively, you can use Docker to deploy this bot.

Ensure you have the latest version of [Docker](https://docs.docker.com/get-docker/) installed (v19.03.0+). You will also need the [Docker Compose Plugin](https://docs.docker.com/compose/install/compose-plugin/).

> Pre-built images are provided at [taaku18/dms](https://hub.docker.com/repository/docker/taaku18/dms).

1. Clone or [download](https://github.com/Taaku18/discord-message-scheduler/archive/refs/heads/main.zip) the repo
 ```sh
 git clone https://github.com/Taaku18/discord-message-scheduler.git
 ```
2. Rename `.env.example` to `.env` and set your environment variables (<a href="#installation">see step 3 above</a>)
3. Deploy your bot (this will use the pre-built image provided for `amd64` and `arm64`)
 ```sh
 docker pull taaku18/dms:stable
 docker compose up -d
 ```
 If you wish to build your own image instead, replace `taaku18/dms:stable` with `dms:latest` in `docker-compose.yml`. Then run
 ```sh
 docker build -t dms:latest .
 docker compose up -d
 ```

You can stop the bot by running `docker compose down`.

To access your bot logs, run `docker ps`. This will show a list of containers.
```sh
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
58e6aao4c8bd dms:latest "python start.py" 14 seconds ago Up Less than a second discord-message-scheduler
```
Find the **CONTAINER ID** of the container named "discord-message-scheduler" and run `docker logs <CONTAINER ID>`.

### Docker Tags

- `latest` - the most recent commit on `main`
- `stable` - the most recent published tag commit
- `x.y.z` - version `x.y.z` tag commit

The default tag is `stable`. To use a different tag, replace the "stable" of `taaku18/dms:stable` with your desired tag in `docker-compose.yml`.

(<a href="#readme-top">back to top</a>)

## Commands Guide

This bot accepts both prefixed and slash commands.

<details>
 <summary>Table of Contents</summary>
 <ol>
 <li> Schedule related:
 <ul>
 <li><a href="#schedule-create-channel"><code>/schedule create</code></a></li>
 <li><a href="#schedule-list-channel"><code>/schedule list</code></a></li>
 <li><a href="#schedule-show-event-id"><code>/schedule show</code></a></li>
 <li><a href="#schedule-edit-event-id-new-channel"><code>/schedule edit</code></a></li>
 <li><a href="#schedule-delete-event-id"><code>/schedule delete</code></a></li>
 </ul>
 </li>
 <li> General:
 <ul>
 <li><a href="#info"><code>/info</code></a></li>
 <li><a href="#help-category-or-command"><code>=help</code></a> (only prefixed command)</li>
 </ul>
 </li>
 </ol>
</details>

> The default bot prefix is `=`.

`[arg]` - Optional `<arg>` - Required

### `/schedule create [channel]`

Creates a scheduled message. You can optionally supply a `channel` argument to specify a channel for the message.

A Discord modal prompt will open, asking for the following:

- `Message` - The message that the bot should send at the scheduled time.
- `Scheduled Time` - The time to send the message, accurate to the second.

Formats:
  - Just date: `2/24/2023` (Month/Day/Year), `December 12`, `nov 26 2023`
  - Just time: `1:12am`, `midnight`, `13:42`, `7pm`
  - Date and time: `02/24/23 19:31:03`
  - Other date formats: `March 30 2023 4:10pm`
  - Simple time: `tomorrow`, `next week`, `thursday at noon`
  - Slightly complicated relative time: `in 1 day, 2 hours and 10 minutes`
  - ISO 8601 format: `2023-08-11T01:59:41.981897`
- `Timezone` - The timezone to parse your time.

Formats:
  - Formal [TZ database name](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones): `America/Los_Angeles`, `Europe/Berlin`, `Asia/Shanghai`
  - [Time zone abbreviation](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones): `GMT`, `UTC`, `CEST`, `PDT`, `EST`, `ET` (not recommended, may be inaccurate)
  - Timezone offset: `+12:30`, `-3000`, `+0123`, `UTC+1232`, `UTC-12:32`
- `Repeat` - The number of minutes between every repeat of the scheduled message. Set `0` to disable.

### `/schedule list [channel]`

Shows you a list of upcoming scheduled messages. You can optionally supply a `channel` argument to specify a channel to check for your upcoming scheduled messages.

### `/schedule show <event-id>`

Shows you the full details of a scheduled message. To find the `event-id`, use the [`/schedule list`](#schedule-list-channel) command.

### `/schedule edit <event-id> [new-channel]`

> Due to limitations with the bot, it is not possible to edit the time or timezone. You will need to delete and re-create the schedule event.

Edits the contents of an upcoming scheduled message. To find the `event-id`, use the [`/schedule list`](#schedule-list-channel) command.

To change the current channel, set `new-channel` to the channel that you want.

### `/schedule delete <event-id>`

Deletes/un-schedules an upcoming scheduled message. To find the `event-id`, use the [`/schedule list`](#schedule-list-channel) command.

### `/info`

Shows info about this bot.

### `=help [category-or-command]`

> This command is only available as a prefixed command.

Shows the help page. Optionally, set `category-or-command` to be a category or command name to view more info on the subject.

Note: `[category-or-command]` is case-sensitive.

(<a href="#readme-top">back to top</a>)

## Roadmap

- [x] Basic help and schedule command interfaces
- [x] Create a Docker image
- [x] Implement list/delete command
    - [ ] Allow server staff access to these commands
- [ ] Implement reporting interface to remove abusive scheduled messages
- [ ] Permissions system
- [x] Add GitHub workflow for testing, linting, building Docker image
- [x] Auto generate requirements.txt from PDM using pre-commit
- [ ] Revise pyright config, add to contributing guidelines
- [ ] Replace the README screenshot and add a bot logo

See the [open issues](https://github.com/github_username/repo_name/issues) for a full list of proposed features (and known issues).

(<a href="#readme-top">back to top</a>)

## Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. If you made any code changes, use `black .` to format the code
4. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
5. Push to the Branch (`git push origin feature/AmazingFeature`)
6. Open a Pull Request

We use [PDM](https://pdm.fming.dev/latest/) as our dependency manager. See their [installations page](https://pdm.fming.dev/latest/#recommended-installation-method) on how to install this tool.
* Add package: `pdm add <package name>`
* Update package: `pdm update <package name>`
* Remove package: `pdm remove <package name>`
* Install dependencies: `pdm sync --clean -G:all` (this will also remove all non-project dependencies)

Optionally add `-dG <group name>` (development group) or `-G <group name>` (optional group) to the above commands if the package belongs to a specific group (ex. `lint`, `speed`).

When making dependencies changes, always export the requirements to `requirements.txt` with
```sh
pdm export --pyproject --without-hashes --prod -G:all -o requirements.txt
```

To simplify some common processes, such as linting with black and generating `requirements.txt`, we use [pre-commit](https://pre-commit.com/).
It's recommended to install `pre-commit` by following the [quick start guide](https://pre-commit.com/#quick-start) and run `pre-commit run -a` to run the pre-commit actions.

(<a href="#readme-top">back to top</a>)

## License

Distributed under GNU General Public License v3.0. See `LICENSE.txt` for more information.

(<a href="#readme-top">back to top</a>)

## Contact

Contact me via Discord:

Taku - [taku#3343](https://discord.com/)

Project Link: [https://github.com/Taaku18/discord-message-scheduler](https://github.com/Taaku18/discord-message-scheduler)

(<a href="#readme-top">back to top</a>)

## Acknowledgments

* Inspired by [bjsbrar/DiscordMessageScheduler](https://github.com/bjsbrar/DiscordMessageScheduler)

(<a href="#readme-top">back to top</a>)

[docker-pulls-shield]: https://img.shields.io/docker/pulls/taaku18/dms?color=E78963
[docker-pulls-url]: https://hub.docker.com/r/taaku18/dms
[docker-size-shield]: https://img.shields.io/docker/image-size/taaku18/dms?color=6661AB
[docker-size-url]: https://hub.docker.com/r/taaku18/dms
[product-screenshot]: docs/demo.gif
[Python.org]: https://img.shields.io/badge/Python-3.13-45697E?style=for-the-badge&logo=python&logoColor=white
[Python-url]: https://python.org
[Discord.py]: https://img.shields.io/badge/discord.py-0769AD?style=for-the-badge&logo=data:image/png;base64,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
[Discordpy-url]: https://github.com/Rapptz/discord.py

discord-message-scheduler

discord-message-scheduler 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

discord-message-scheduler

discord-message-scheduler 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README