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

Folders and files

NameName
Last commit message
Last commit date

Latest commit

f4c9940 · Mar 11, 2025
Mar 11, 2025
Feb 19, 2025
Mar 3, 2025
Apr 9, 2022
May 23, 2024
Mar 3, 2025
Nov 27, 2023
Feb 14, 2025
Feb 13, 2025
Nov 26, 2024
Dec 28, 2021
Jul 27, 2024
Jun 4, 2024
Feb 19, 2025
Feb 19, 2025
Feb 19, 2025

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 -m discord_free_game_notifier.main
  • 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 -m discord_free_game_notifier.main
    • 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/.