Divent/README.md

57 lines
1.8 KiB
Markdown
Raw Normal View History

2022-05-08 14:02:19 +00:00
# Divent
> The discord scheduled event calendar generator
[![Docker Hub](https://img.shields.io/docker/pulls/xefir/divent)](https://hub.docker.com/r/xefir/divent)
Simple website that guides you to invite a bot to read and format scheduled events to a subscribable calendar.
## Installing / Getting started
### 1) Create the bot
- Go to the [Discord Developer Portal](https://discord.com/developers/applications) and create a new application.
- Enable the `Build-A-Bot` option in the `Bot` panel.
- Click on `Reset Token` and keep it in a safe place, you will need it.
2022-09-12 18:06:43 +00:00
- Click on `Reset Secret` in the `OAuth2` panel, copy both `Client ID` and `Client Secret` and keep it in a safe place, you will need it.
2022-05-08 14:02:19 +00:00
- Configure the rest of your app and bot as you like (name, icon, username, etc.)
### 2) With Docker
- Install [Docker](https://docs.docker.com/get-docker/)
2022-09-12 18:08:49 +00:00
- Run
```bash
docker run -p 5000 \
-e DISCORD_TOKEN=your_bot_token \
-e OAUTH2_CLIENT_ID=your_client_id \
-e OAUTH2_CLIENT_SECRET=your_client_secret \
xefir/divent
```
2022-05-08 14:02:19 +00:00
### 2) Without Docker
- Install [Python 3](https://www.python.org/downloads/)
2022-09-12 20:21:38 +00:00
- Install [Pip](https://pip.pypa.io/en/stable/installation/)
2022-05-08 14:02:19 +00:00
- Run `pip install divent`
2022-09-12 18:08:49 +00:00
- Run
```bash
DISCORD_TOKEN=your_bot_token \
OAUTH2_CLIENT_ID=your_client_id \
OAUTH2_CLIENT_SECRET=your_client_secret \
divent
```
2022-09-12 18:10:26 +00:00
2022-09-12 18:11:03 +00:00
### 3) Open your browser
2022-09-12 18:10:26 +00:00
The app is accessible at http://localhost:5000
2022-05-08 14:02:19 +00:00
## Links
- [Project homepage](https://divent.crystalyx.net/)
- [Source repository](https://git.crystalyx.net/Xefir/Divent)
- [Issue tracker](https://git.crystalyx.net/Xefir/Divent/issues)
- [My other projects](https://git.crystalyx.net/Xefir)
2022-09-08 18:21:40 +00:00
- [The WTFPL licence](http://www.wtfpl.net/)
2022-05-08 14:02:19 +00:00
- [Docker hub](https://hub.docker.com/r/xefir/divent)
- [Pypi](https://pypi.org/project/Divent/)
- [Donations](https://paypal.me/Xefir)