A discord bot to check for available content on Twitch Prime Gaming and Epic Games Store and posting it in the discord chat.
❗ Disclaimer: Maintenance of this project is currently on halt. Many web scraping methods might no longer work due to changes in the target websites. Furthermore, discord.py is no longer maintained by its developers, therefor a rewrite of this project using pycord would be necessary.
You need to set up a discord bot:
- Navigate to https://discord.com/developers/applications and create a new application. You can choose whatever name fits your need.
- In your new application, navigate to the section
Botand create a bot. You can choose whatever name fits your need. This name will be the default display name of the bot on your discord server. - In your bots settings you will find the
token. Save it for later steps. This token is important. Keep it always a secret! - In your application in the section
OAuth2you will find yourclient ID. With that ID you can invite your new bot to your discord server. To do so, navigate todiscordapp.com/oauth2/authorize?client_id=XXXXXXX&scope=botbut replace the "XXXXXXX" with your client ID. - After inviting the bot, he will appear in the user list of your server. Yet he will be marked as "offline" but that will change as soon as you finished the setup and the bot should be running.
To run this bot, it is advised to use Docker. Docker is a way to run programs in a standardized container that works on any platform.
Download Docker for your system and start it
Download this repository. For the bot to work, you have to write your bot's token into the config file. The config file
is located at bot/ressources/config.yml.
In the section token, replace the "O" with your token.
All other parts of the config are optional for you to configure or keep the default settings. However, one important part
to look out for is the section games_to_inlcude. Only games listed here will be displayed by the bot in the discord chat.
Open a terminal and navigate into the downloaded directory. Issue the following commands to build and start the docker container:
# Build docker image
docker build -t twitch_prime_bot .
# Run docker image as container
docker run -it twitch_prime_botAfter starting the container you are finished with the setup.
It is recommended to run this bot in a Docker Container. However, it is also possible to run it without. For that you need to Download Google Chrome to your system and run the bot.
In the discord chat, you can use the commands listed below. All these commands can be changed to any other phrase you like in the config file.
Make sure the bot has access to the channel you are using. If the bot appears in the user list of that channel, everything should be set up correctly.
| Command | Description |
|---|---|
!twitch |
Displays current content from the prime gaming website. If available, stored data will be used (max 24h old). |
!twitch fetch |
Displays current content from the prime gaming website. Always tries to fetch new data. This might take longer. |
!epic |
Displays current content from the epic games store website. If available, stored data will be used (max 24h old). |
!epic fetch |
Displays current content from the epic games store website. Always tries to fetch new data. This might take longer. |
Example message
Diagram of dataflow from website to Discord chat
The core of this bot is the functionality to gather data from Amazon Prime Gaming. Since there is no API for this purpose, this bot fetches the HTML code from the Prime Gaming Website and extracts all relevant data from it. This is mainly done by using Selenium and BeautifulSoup.
Since fetching new data takes some time, data will be stored locally in a JSON file. New data will first be fetched after 24 hours have passed. This is especially useful when a lot of users use the bot at the same time.
This is wrapped in a discord bot built using the Discord Python API. The discord bot then runs in a Docker container.