GamesHub icon indicating copy to clipboard operation
GamesHub copied to clipboard

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

:white_check_mark: Gather Steam free games from SteamDB.

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

:white_check_mark: Use ASF to redeem games

Requirements

  • python3
    • requirements.txt

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! :)

Changelog