ICal-checker

This GitHub repository is simply a discord bot (to be hosted) coded in python.

What does it do?

It checks with a given ICal link if there are any events coming up.

How to use it?

Launch the bot a first time, it will create a config.json file.
Fill the config.json file with your bot token and the ICal link you want to check.
Launch the bot a second time and that's it!

Prerequisites

Python 3.9 or higher
discord.py 2.0 or higher
icalendar
pytz
requests
json
asyncio
sys
datetime
os

Here is a command to install all the prerequisites:

pip install discord.py icalendar pytz requests json asyncio sys datetime os

And here is a command to update all the prerequisites:

pip install -U discord.py icalendar pytz requests json asyncio sys datetime os

How to launch the bot?

python main.py

How to launch the bot in background?

Make a service file in /etc/systemd/system/ with the following content:

[Unit]
Description=ICal-checker
After=network.target

[Service]
ExecStart=/usr/bin/python3 /path/to/main.py
WorkingDirectory=/path/to/main.py
Restart=always
User=your_user

[Install]
WantedBy=multi-user.target

Reload the daemon:

sudo systemctl daemon-reload

Start the service:

sudo systemctl start ical-checker.service

Enable the service:

sudo systemctl enable ical-checker.service

How to stop the bot?

sudo systemctl stop ical-checker.service

How to restart the bot?

sudo systemctl restart ical-checker.service

How to check the status of the bot?

sudo systemctl status ical-checker.service

How to launch the bot with a screen?

screen -S ical-checker
python main.py

How to detach the screen?

Ctrl + A + D

How to reattach the screen?

screen -r ical-checker

How to kill the screen?

screen -X -S ical-checker quit

How to kill the bot?

Ctrl + C

And that's it! You can now use the bot!

How to contribute?

You can contribute by forking the repository and making a pull request.

Wiibleyde/Discord-ICal-Checker