I maintain this and other Home Assistant add-ons in my free time. Keeping up with upstream changes, Home Assistant changes, and testing on real hardware takes a significant amount of time.

Add-on information

About

This add-on is based on Free Games Claimer Remaster. It can claim free games from:

Epic Games Store
Amazon Prime Gaming
GOG
Steam
GamerPower-supported stores, when explicitly enabled

For compatibility with previous add-on releases, the default store selection remains Epic Games, Prime Gaming, and GOG.

Web interface

The noVNC interface remains available on port 6080:

http://homeassistant:6080

It can be used for initial sign-in, CAPTCHA handling, or other manual browser interaction. Set VNC_PASSWORD in config.env to protect the VNC session.

Add-on options

Option	Default	Description
`CONFIG_LOCATION`	`/config/config.env`	Persistent environment configuration file
`RUN_ONCE`	`true`	Run all selected claimers once, then stop the add-on as previous releases did
`STORES`	empty	Optional comma-separated override, such as `epic,prime,gog,steam`
`CMD_ARGUMENTS`	`node epic-games ; node prime-gaming ; node gog`	Deprecated compatibility option; recognized legacy command names are converted to `STORES`
`env_vars`	`[]`	Additional environment variables passed to the add-on

Run modes

With RUN_ONCE: true, the add-on performs one claiming pass and stops. This is the default and preserves the behavior of the former vogler-based add-on.

With RUN_ONCE: false, the remaster remains running and uses its internal scheduler. Set SCHEDULER_HOURS in config.env to control the interval.

Environment configuration

The add-on keeps its configuration in CONFIG_LOCATION, which defaults to /config/config.env. From Home Assistant this is stored in the add-on's private addon_configs directory and can be edited with a compatible file browser add-on.

A template is created on first start. Common examples are:

# Preserve the former default selection
STORES=epic,prime,gog

# Epic Games
EG_EMAIL=your-email@example.com
EG_PASSWORD=your-password
EG_OTPKEY=

# Amazon Prime Gaming
PG_EMAIL=your-amazon-email@example.com
PG_PASSWORD=your-password
PG_OTPKEY=

# GOG
GOG_EMAIL=your-gog-email@example.com
GOG_PASSWORD=your-password

# Optional Steam support
STEAM_USERNAME=your-steam-username
STEAM_PASSWORD=your-password

# Optional notifications
NOTIFY=tgram://bot-token/chat-id
# DISCORD_WEBHOOK=https://discord.com/api/webhooks/...

Existing variables such as EG_EMAIL, EG_PASSWORD, PG_EMAIL, PG_PASSWORD, PG_OTPKEY, GOG_EMAIL, GOG_PASSWORD, SHOW, WIDTH, HEIGHT, TIMEOUT, LOGIN_TIMEOUT, DRYRUN, and NOTIFY remain compatible. See the upstream configuration reference for all available settings.

Upgrade from version 1.8

Version 2.0 changes the application engine from vogler/free-games-claimer (Node.js, Playwright, and Firefox) to P-Adamiec/Free-Games-Claimer-Remaster (Python, nodriver, and Chromium). The add-on performs the following migration automatically on first start:

The existing config.env remains at the same configured location.
Legacy epic-games.json, prime-gaming.json, and gog.json claim history is imported into the remaster SQLite database at /data/fgc.db.
Existing database rows are detected and are not duplicated if migration is retried.
A pre-migration database backup is created when an existing fgc.db is present.
All old files remain under /data/data for rollback or manual recovery.

Browser sessions cannot be converted because the old add-on used a shared Firefox profile while the remaster uses separate Chromium profiles per store. Credentials remain available through config.env, but accounts that require interactive authentication may need a one-time login through noVNC after the upgrade. The old Firefox profile is retained and is never deleted.

The external noVNC port remains 6080, although the standalone remaster image normally uses port 7080.

Upstream update policy

The image is built from an explicit upstream commit in the Dockerfile. This keeps amd64 and aarch64 images reproducible and prevents an upstream branch or container tag from changing without an add-on review and version bump.

The repository updater is intentionally paused for this add-on because the add-on uses its own 2.x version series while the replacement upstream uses a 1.x version series. An automatic replacement would risk a Home Assistant version regression and would not safely update the pinned commit. A maintainer upstream update must therefore update UPSTREAM_REF, upstream_version, the add-on version, and CHANGELOG.md together.

Installation

Add this add-on repository to the Home Assistant add-on store.
Install Free Games Claimer.
Configure the add-on options as needed.
Start the add-on and review its log.
Open noVNC if an account needs manual authentication.

Custom scripts and environment variables

Support

Open an issue in the add-on repository.