Repository files navigation

Claims free games periodically on

• Epic Games Store
• Amazon Prime Gaming
• GOG
• Unreal Engine (Assets) (experimental, same login as Epic Games)

Pull requests welcome :)

Works on Windows/macOS/Linux.

Raspberry Pi (3, 4, Zero 2):requires 64-bit OS like Raspberry Pi OS or Ubuntu (Raspbian won't work since it's 32-bit).

Easy option:install Docker (orpodman) and run this command in a terminal:

docker run --rm -it -p 6080:6080 -v fgc:/fgc/data --pull=always ghcr.io/vogler/free-games-claimer

This currently gives you a captcha challenge for epic-games. Untilissue #183 is fixed, it is recommended to just runnode epic-games without docker (see below).

This will runnode epic-games; node prime-gaming; node gog - if you only want to claim games for one of the stores, you can override the default command by appending e.g.node epic-games at the end of thedocker run command, or if you want severalbash -c "node epic-games.js; node gog.js".Data (including json files with claimed games, codes to redeem, screenshots) is stored in the Docker volumefgc.

All scripts start an automated Firefox instance, either with the browser GUI shown or hidden (headless mode). By default, you won't see any browser open on your host system.

• When running inside Docker, the browser will be shown only inside the container. You can openhttp://localhost:6080 to interact with the browser running inside the container via noVNC (or use other VNC clients on port 5900).
• When running the scripts outside of Docker, the browser will be hidden by default; you can useSHOW=1 ... to show the UI (see options below).

When running the first time, you have to login for each store you want to claim games on.You can login indirectly via the terminal or directly in the browser. The scripts will wait until you are successfully logged in.

There will be prompts in the terminal asking you to enter email, password, and afterwards some OTP (one time password / security code) if you have 2FA/MFA (two-/multi-factor authentication) enabled. If you want to login yourself via the browser, you can press escape in the terminal to skip the prompts.

After login, the script will continue claiming the current games. If it still waits after you are already logged in, you can restart it (and open an issue). If you run the scripts regularly, you should not have to login again.

Options are set viaenvironment variables which allow for flexible configuration.

TODO:On the first run, the script will guide you through configuration and save all settings todata/config.env. You can edit this file directly or runnode fgc config to run the configuration assistant again.

Available options/variables and their default values:

Seesrc/config.js for all options.

You can add options directly in the command or put them in a file to load.

You can pass variables using-e VAR=VAL, for exampledocker run -e EMAIL=foo@bar.baz -e NOTIFY='tgram://bottoken/ChatID' ... or using--env-file fgc.env wherefgc.env is a file on your host system (seedocs). You can alsodocker cp your configuration file to/fgc/data/config.env in thefgc volume to store it with the rest of the data instead of on the host (example).If you are usingdocker compose (or Portainer etc.), you can put options in theenvironment: section.

On Linux/macOS you can prefix the variables you want to set, for exampleEMAIL=foo@bar.baz SHOW=1 node epic-games will show the browser and skip asking you for your login email. On Windows you have to useset,example.You can also put options indata/config.env which will be loaded bydotenv.

The scripts will try to send notifications for successfully claimed games and any errors like needing to log in or encountered captchas (should not happen).

apprise is used for notifications and offers many services including Pushover, Slack, Telegram, SMS, Email, desktop and custom notifications.You just need to setNOTIFY to the notification services you want to use, e.g.NOTIFY='mailto://myemail:mypass@gmail.com' 'pbul://o.gn5kj6nfhv736I7jC3cj3QLRiyhgl98b' - refer to their list of services andexamples.

If you set the options for email, password and OTP key, there will be no prompts and logins should happen automatically. This is optional since all stores should stay logged in since cookies are refreshed.To get the OTP key, it is easiest to follow the store's guide for adding an authenticator app. You should also scan the shown QR code with your favorite app to have an alternative method for 2FA.

• Epic Games: visitpassword & security, enable 'third-party authenticator app', copy the 'Manual Entry Key' and use it to setEG_OTPKEY.
• Prime Gaming: visit Amazon 'Your Account › Login & security', 2-step verification › Manage › Add new app › Can't scan the barcode, copy the bold key and use it to setPG_OTPKEY
• GOG: only offers OTP via email

Beware that storing passwords and OTP keys as clear text may be a security risk. Use a unique/generated password! TODO: maybe at least offer to base64 encode for storage.

Runnode epic-games (locally or in Docker).

Runnode prime-gaming (locally or in Docker).

Claiming the Amazon Games works out-of-the-box, however, for games on external stores you need to either link your account or redeem a key.

• Stores that require account linking: Epic Games, Battle.net, Origin.

• Stores that require redeeming a key: GOG.com, Microsoft Games, Legacy Games.

  Keys and URLs are printed to the console, included in notifications and saved indata/prime-gaming.json. A screenshot of the page with the key is also saved todata/screenshots.TODO:redeem keys on external stores.

Epic Games usually has two free gamesevery week, before Christmas every day.Prime Gaming has new gamesevery month or more often during Prime days.GOG usually has one new game every couples of weeks.Unreal Engine has new assets to claimevery first Tuesday of a month.

It is safe to run the scripts every day.

The container/scripts will claim currently available games and then exit.If you want it to run regularly, you have to schedule the runs yourself:

• Linux/macOS:crontab -e (example)
• macOS:launchd
• Windows:task scheduler (example),other options, or just put the command in a.bat file in Autostart if you restart often...
• any OS: use a process manager likepm2
• Docker Composecommand: bash -c "node epic-games; node prime-gaming; node gog; echo sleeping; sleep 1d" additionally addrestart: unless-stopped to it.

TODO:add some server-mode where the script just keeps running and claims games e.g. every day.

Check the openissues and comment there or open a new issue.

If you're a developer, you can usePWDEBUG=1 ... toinspect which opens a debugger where you can step through the script.

Logo with smaller aspect ratio (for Telegram bot etc.): 👾 -emojipedia