This is a Discord bot for organising watch-parties, named Popcorn. A University of Auckland SOFTENG 310 Team 2 creation. You're welcome!
Add this bot to your Discord server and let it help you select the best movie or TV show to watch with your friends.
Popcorn is not just great at selecting media based on you and your friends' preferences, it also keeps track of what you've already watched!
| Release | Description |
|---|---|
| Release 1 | Bot that can be run by an individual from their machine with a local memory that can be accessed by all server members. Basic adding, deleteing, viewing, notifications, and permissions functionality is implemented. Basic user experience to use bot for watchlists in servers fullly implemented. |
| Release 2 | We will work on adding tags and statuses to individual media for better filtering. More thorough user experience will be implemented, with more specific commands. |
| Release 3 | We will add permissions to different users to determine if the specific user could create or modify the watchlist. Voting implementation will be implemented, possibly with a discord event set up as well. Other features include adding ratings, reviews and descriptions to media. |
See the Github Cloning Guide if unfamiliar. Or download the files manually from Github.
Version 3.11.4 is recommended for running this bot and contributing to its development. See Download Python
Set up a Python environment for the code editor of your choice. It is recommended to use a virtual Python environment to avoid installing packages globally. For help with this simply google the name of your preferred IDE and "virtual python environment".
In the root folder of the project - the one with your .venv folder in it - use the terminal to install nextcord using pip install nextcord, and install dotenv using pip install python-dotenv. You can check your .venv folder's Lib folder to see that these dependencies have been installed successfully in your virtual environment.
Use the existing Bot: You can invite the existing bot to your Discord server via this link: Invite Popcorn Bot. The bot will need to be invited by a member of the server with admin priviledges. NOTE: The bot currently has access to message content for debugging purposes.
Using this method, you will only be able to use the bot when it is being run for testing at this stage of development, and not all features may work correctly. To use the bot anytime with complete freedom you can create your own personal version through the discord developer portal outlined below.
Create your own bot from the Discord Developer's Portal. Follow this Creating a Discord Bot Guide.
Give the bot the following Scopes:
And the following Permissions:
Make sure Message Content Intent is toggled on (above bot permissions):
Make sure Server Members Intent is toggled on (above Message Content Intent):
Then copy the generated URL, paste it into your browser, and you will be prompted to add the bot to one of your servers. Once the bot is invited, it will not be able to perform any functions until bot.py is configured for your bot's token and your server's guild ID. bot.py will also need to be running with an internet connection for any commands to work.
Create a file called .env in the root project folder (same level as bot.py):
In that file, copy your bot token from the Discord Developer Application page:
The bot token goes here:
IMPORTANT:
Do not share your bot token with anyone! Make sure to include the .env file in your .gitignore, so your bot token is never uploaded to the repository! If you accidentally leak your bot's token, you will have to regenerate the token from the discord developers portal.
The Guild ID for a server can be found by right-clicking the server's name in the top left, and selecting the "Copy Guild ID" option form the dropdown:
You must turn on Developer Mode to see this (Settings > Advanced > Developer Mode)
The Guild ID goes here:
If everything is configured properly, run bot.py and you should see your bot go online in your server (where you obtained the guild ID).
Use the '/' prefix to issue bot commands in your server's text channels:
If you type /popcorn, you should see a popup list of all of the commands. You can also use the /help command for the same list.
After run bot.py. Go to the server setting and change the bot permission to Administrator
Your bot is now working, hooray!
- Fork, clone, and install the bot by following the Contributing guidelines.
For additional information about the bot, contact email: jwei578@aucklanduni.ac.nz