DISCORD PLEX TRIAL BOT

A Discord bot for sending Plex invites and removing users from the Plex server after a trial period has ended.

HOW IT WORKS

The bot will send a DM to a user when they receive the specfied role that you set in the config.json file. The DM will ask the user to reply with their Plex email address. When a user replies with their email address the bot will automtically send the user an invite to the Plex server. Once the trial period has ended the bot will automatically remove the user from the Plex server.

All trials begin from the time the invite was sent, and a user can only request one trial, if they try to request another one, they will recieve a denial message. The bot checks for trials to remove users every 15 minutes, this even includes invites that were sent and not accepted.

If you want to change the timeframe the bot checks for removing trials, you can edit the code on line 106 minutes=15. You can change it to any amount of any unit of time you would like. Examples: seconds=30 or hours=1


Reaction Roles are a great way to fully automate your trials, otherwise if you want to have more control over your invites, you can manually add the role to the user.

LOGGING

You can set the bot to log all actions to a specified channle of your choice

DATABASE

There is a sqlite database file that will automatically be made upon starting the bot. You can view and make modifications to the file, in case a user replies with an incorrect email address, or you want to make adjustments. Simply remove the entry from the database, then the user can make a new request for a trial.

MESSAGES

You can set custom messages that the bot will DM user with.

• When a user is denied from trying to request another trial before their cooldown period has ended.
• When an invite has successfully been sent after replying with a confirmed Plex email address.
• When the users trial has ended.

SETUP

STEP 1

Download this repository HERE

STEP 2

Learn how to create a Discord Bot and find a Discord ID.

If you already know how to do this continue to STEP 3.

DISCORD BOT

1. Go to Discord Developer
2. Create a Application.
3. Create a Bot.
4. Enable intents for PRESENCE INTENT, SERVER MEMBERS INTENT, MESSAGE CONTENT INTENT
5. Create a token by selecting Reset Token, then copy and save the token, you will need it later.
6. Under OAuth2 select URL Generator, then enable bot & Administator under Scopes & Permissions.
7. Copy the generated url at he bottom of the page, and paste it into your browsers address bar.
8. Follow the Discord popup steps for inviting the bot to your Discord server.

DISCORD ID

1. Login to your Discord Account.
2. Select the gear icon to open your user settings.
3. Select the Advance tab on the side bar.
4. Enable developer mode.
5. Right click on your Guild or Channel.
6. Now copy the ID.

STEP 3

Configure config.json and save the file.

DATA	TYPE	DESCRIPTION
token	String	Your custom Discord bot token
plex_user	String	Your Plex account username
plex_pass	String	Your Plex account password
admin_channel_id	Integer	The Discord channel ID of where the bot actions are logged
guild_id	Integer	Your Discord servers ID
role_name	String	The Discord role a user must have for the bot to DM a user (Don't Add @)
trial_period	Integer	An integer value for the length of time in hours
deny_message	String	The messages sent when a user requests a trial before their cooldown period has ended
success_message	String	The messages sent when a Plex invite has successfully been sent
end_message	String	The messages sent when a users trial has ended

INSTALL

DOCKER CLI

Simply run the command.

docker run -d -v /PATH-TO-CONFIG/config.json:/bot/config.json -v /PATH-TO-DATABASE/users.db:/bot/users.db zluckytraveler/discord-plex-trial

Replace PATH-TO-CONFIG & PATH-TO-DATABASE with the path to where you stored the files from STEP 1

DOCKER BUILD

STEP 1

Change the directory to where the files are stored.

cd <PATH TO DIRECTORY>

STEP 2

Build the image. The image name must be all lowercase without any spacing

docker build -t <YOUR IMAGE NAME> .

STEP 3

Start the container by using the Docker run command.

docker run -d <YOUR IMAGE NAME>

LOCAL

PREREQUISITES

• Python 3
• Pip

STEP 1

Change the directory to where the files are stored.

cd <PATH TO DIRECTORY>

STEP 2

Install the requirements.

pip install -r requirements.txt

STEP 3

Run the Bot.

Mac & Linux
python3 bot.py

Windows
py bot.py