Update documentation

This commit is contained in:
2020-12-29 15:28:31 +01:00
parent 14f19bdf48
commit 81119c2d17
7 changed files with 166 additions and 25 deletions

View File

@ -1,48 +1,74 @@
Discord-reminder-bot
=========
# Discord-reminder-bot
Discord bot that allows you to set reminders.
![Bot](/Bot.png)
<sup>Theme is [DiscordNight by KillYoy](https://github.com/KillYoy/DiscordNight)<sup>
## Environment Variables
* `BOT_TOKEN` - Discord bot token ([Where to get one](https://discord.com/developers/applications))
* `TIMEZONE` - Your time zone ([List of time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones))
* `SQLITE_LOCATION` - (Optional) Where to store the database. Docker users need to change this to "/data/jobs.sqlite"
* `LOG_LEVEL` - Can be CRITICAL, ERROR, WARNING, INFO or DEBUG
## Installation
* Install latest version of Python 3.
* Install pipenv
* `pip install pipenv`
* Install requirements and make virtual enviroment
* `pipenv install`
* Rename .env-example to .env and fill in.
* Start the bot
* `pipenv run python main.py`
You have two choices, install directly on your computer or using [Docker](https://registry.hub.docker.com/r/thelovinator/discord-reminder-bot).
[hub.docker.com/r//thelovinator/discord-reminder-bot](https://registry.hub.docker.com/r/thelovinator/discord-reminder-bot)
[docker-compose.yml](docker-compose.yml)
[Dockerfile](Dockerfile)
### Install directly on your computer
* Install latest version of Python 3 for your operating system
* (Optional) Create a virtual environment:
* `python -m venv .venv`
* Activate virtual environment:
* Windows: `.\.venv\Scripts\activate`
* Not windows: `source .venv/bin/activate`
* Install requirements
* `pip install -r requirements.txt`
* Rename .env.example to .env and fill it out.
* Start the bot (inside the virtual environment if you made one):
* `python main.py`
### Start the bot when your Linux server boots
## Autostart - Linux (systemd)
* Keep services running after logout
* `loginctl enable-linger`
* `loginctl enable-linger`
* Move service file to correct location (You may have to modify WorkingDirectory and/or ExecStart)
* `cp discord-reminder-bot.service ~/.config/systemd/user/discord-reminder-bot.service`
* `cp discord-reminder-bot.service ~/.config/systemd/user/discord-reminder-bot.service`
* Start bot now and at boot
* `systemctl --user enable --now discord-reminder-bot`
* `systemctl --user enable --now discord-reminder-bot`
#### systemd examples
systemd examples:
* Start bot automatically at boot
* `systemctl --user enable discord-reminder-bot`
* `systemctl --user enable discord-reminder-bot`
* Don't start automatically
* `systemctl --user disable discord-reminder-bot`
* `systemctl --user disable discord-reminder-bot`
* Restart
* `systemctl --user restart discord-reminder-bot`
* `systemctl --user restart discord-reminder-bot`
* Stop
* `systemctl --user stop discord-reminder-bot`
* `systemctl --user stop discord-reminder-bot`
* Start
* `systemctl --user start discord-reminder-bot`
* `systemctl --user start discord-reminder-bot`
* Check status
* `systemctl --user status discord-reminder-bot`
* `systemctl --user status discord-reminder-bot`
* Reading the journal
* `journalctl --user-unit discord-reminder-bot`
* `journalctl --user-unit discord-reminder-bot`
## Help
* Email: tlovinator@gmail.com
* Discord: TheLovinator#9276
* Steam: https://steamcommunity.com/id/TheLovinator/
* Steam: [steamcommunity.com/id/TheLovinator/](https://steamcommunity.com/id/TheLovinator/)
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details