Plex-Bot-Music/README.md
Joshua Arulsamy f5958e1d44 📝 Add docs
2020-08-04 04:18:28 -06:00

1.9 KiB
Raw Blame History

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.

  1. Clone the repository and cd into it:
$ git clone https://github.com/jarulsamy/Plex-Bot
$ cd Plex-Bot
  1. 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
  1. Create a Discord bot application:

    1. Go to the Discord developer portal, here.

    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

  2. Get your plex token:

    Refer to the official plex documentation.

    Add it to config/config.yaml in the appropiate spot.

  3. 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!