Skip to content

Send webhook to Discord when a new game releases on Steam, Epic Games Store, Ubisoft Connect or GOG.

License

Notifications You must be signed in to change notification settings

TheLovinator1/discord-free-game-notifier

Repository files navigation

discord-free-game-notifier

Theme is https://github.com/KillYoy/DiscordNight

Send webhook to Discord when a game goes from paid from free on Steam, Epic, GOG and Ubisoft.

Docker

There is a docker-compose.yml file in the root of the repository. Please fill in the values in the .env file and run docker-compose up -d.

Usage (Windows)

  • Install Python
    • Add Python to PATH during installation.
  • Download or clone the repository.
  • Open the extracted folder in File Explorer.
  • Shift + Right-click in the folder and select "Open PowerShell window here".
  • Set the execution policy to allow running scripts.
    • Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
    • Type Y and press Enter.
  • Create a virtual environment and activate it.
    • python -m venv .venv
    • .\.venv\Scripts\Activate.ps1
  • Install the dependencies.
    • pip install -r requirements.txt
  • Rename .env.example to .env and fill in the values.
    • Rename-Item .env.example .env
    • notepad .env
  • Start the bot.
    • python .\discord_free_game_notifier\main.py
  • The bot will now check for free games every 15 minutes and send a message to the webhook.
  • Data is stored in %appdata%\TheLovinator\discord_free_game_notifier.
  • To stop the bot, press Ctrl + C in the PowerShell window.

Usage (GNU/Linux)

  • Install Python
    • Ubuntu/Debian: sudo apt install python3 python3-pip
    • Fedora/RHEL: sudo dnf install python3 python3-pip
    • Arch/Manjaro: sudo pacman -S python python-pip
  • Download or clone the repository.
  • Change directory to the root of the repository.
    • cd discord-free-game-notifier
  • Create a virtual environment and activate it.
    • python -m venv .venv
    • source .venv/bin/activate
  • Install the dependencies.
    • pip install -r requirements.txt
    • Or poetry install if you have Poetry installed.
  • Rename .env.example to .env and fill in the values.
    • mv .env.example .env
    • nano .env
  • Start the bot.
    • python ./discord_free_game_notifier/main.py
    • Or poetry run bot if you used Poetry.
  • The bot will now check for free games every 15 minutes and send a message to the webhook.
  • Data is stored in ~/.local/share/discord_free_game_notifier/.