SteamDBFreeGamesClaimer

project GitHub license GitHub stars

docker Build Status

This project is inspired by SteamDB-FreeGames

Seems that SteamDB really don't want people scraping their site.

Features

✅ Gather Steam free games from SteamDB.

✅ Use telegram bot to send free games information. (channel)

✅ Use ASF to redeem games

Requirements

Usage

Direct run

  1. Clone repository
    git clone https://github.com/lupohan44/SteamDBFreeGamesClaimer.git
  2. Go into SteamDBFreeGamesClaimer directory
    cd SteamDBFreeGamesClaimer
  3. Install requirements
    pip3 install -r requirements.txt
    playwright install webkit || python3 -m playwright install webkit
  4. Copy config.example.json5 to config.json5, change settings in it according to the comment.
  5. Run
    python3 app.py

Docker (For Linux only)

  1. Create a folder for record and config, let's say folder name is /var/SteamDBFreeGamesClaimer

    Please note that this folder name must be absolute path.

    export STEAM_DB_FOLDER_NAME=/var/SteamDBFreeGamesClaimer
    mkdir -p "$STEAM_DB_FOLDER_NAME"
  2. Download config.example.json5 and rename to config.json5 into the folder created in step 1, change settings in it according to the comment.

    wget -c "https://raw.githubusercontent.com/lupohan44/SteamDBFreeGamesClaimer/main/config.example.json5" -O "$STEAM_DB_FOLDER_NAME/config.json5" || curl -o "$STEAM_DB_FOLDER_NAME/config.json5" "https://raw.githubusercontent.com/lupohan44/SteamDBFreeGamesClaimer/main/config.example.json5"
  3. Run with docker

    docker pull lupohan44/steamdb_free_games_claimer:latest && docker run -v $STEAM_DB_FOLDER_NAME:/home/wd --rm lupohan44/steamdb_free_games_claimer:latest

    All changes by script inside docker will be permanently save to this folder.

Known issue

  1. Playwright does not support CentOS. (issue)
    • Use docker

Support me

Star would be great! :)