Merge pull request #2 from jarulsamy/docker

📝 Add docs
This commit is contained in:
Joshua Arulsamy 2020-08-04 04:19:15 -06:00 committed by GitHub
commit bcfea22178
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -1,4 +1,75 @@
# Python-Template
# Plex-Bot
A Python-based Plex music bot for discord.
## Setup
Plex-Bot runs entirely in a Docker container. Ensure you have Docker and docker-compose installed according to the official Docker [documentation](https://docs.docker.com/get-docker/).
1. Clone the repository and `cd` into it:
```
$ git clone https://github.com/jarulsamy/Plex-Bot
$ cd Plex-Bot
```
2. Create a configuration folder:
Create a new `config` folder and copy the sample config file into it:
```
$ mkdir config
$ cp sample-config.yaml config/config.yaml
```
3. Create a Discord bot application:
1. Go to the Discord developer portal, [here](https://discord.com/developers/applications).
2. Log in or create an account
3. Click New App
4. Fill in App Name and anything else you'd like to include
5. Click Create App
This will provide you with your Client ID and Client Secret
6. Click Create Bot User
This will provide you with your bot Username and Token
7. Fill in all the necessary numbers in `config/config.yaml`
4. Get your plex token:
Refer to the official [plex documentation](https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/).
Add it to `config/config.yaml` in the appropiate spot.
5. Start the service:
```
$ docker-compose up --build
```
## Usage
```
General:
kill - Stop the bot.
Plex:
np - View currently playing song.
pause - Pause currently playing song.
play - Play a song from the Plex library.
resume - Resume a paused song.
skip - Skip a song.
stop - Stop playing.
No Category:
help Shows this message
Type ?help command for more info on a command.
You can also type ?help category for more info on a category.
```
## Support