PlexBot | ||
.flake8 | ||
.gitignore | ||
.pre-commit-config.yaml | ||
docker-compose.yml | ||
Dockerfile | ||
Jenkinsfile | ||
LICENSE | ||
pyproject.toml | ||
README.md | ||
requirements.txt | ||
sample-config.yaml |
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.
- Clone the repository and
cd
into it:
$ git clone https://github.com/jarulsamy/Plex-Bot
$ cd Plex-Bot
- 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
-
Create a Discord bot application:
-
Go to the Discord developer portal, here.
-
Log in or create an account
-
Click New App
-
Fill in App Name and anything else you'd like to include
-
Click Create App This will provide you with your Client ID and Client Secret
-
Click Create Bot User This will provide you with your bot Username and Token
-
Fill in all the necessary numbers in
config/config.yaml
-
-
Get your plex token:
Refer to the official plex documentation.
Add it to
config/config.yaml
in the appropiate spot. -
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
Reach out to me at one of the following places!
- Email (Best) at joshua.gf.arul@gmail.com
- Twitter at
@jarulsamy_