mirror of
https://github.com/alexbelgium/hassio-addons.git
synced 2026-08-15 09:32:30 +02:00
165 lines
7.1 KiB
Markdown
165 lines
7.1 KiB
Markdown
# Home Assistant add-on: Free Games Claimer
|
|
|
|
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.
|
|
|
|
[![Buy me a coffee][donation-badge]](https://www.buymeacoffee.com/alexbelgium)
|
|
[![Donate via PayPal][paypal-badge]](https://www.paypal.com/donate/?hosted_button_id=DZFULJZTP3UQA)
|
|
|
|
## Add-on information
|
|
|
|
|
|
|
|
|
|
[](https://github.com/alexbelgium/hassio-addons/actions/workflows/weekly-supelinter.yaml)
|
|
[](https://github.com/alexbelgium/hassio-addons/actions/workflows/onpush_builder.yaml)
|
|
|
|
[donation-badge]: https://img.shields.io/badge/Buy%20me%20a%20coffee-%23d32f2f?logo=buy-me-a-coffee&style=flat&logoColor=white
|
|
[paypal-badge]: https://img.shields.io/badge/Donate%20via%20PayPal-0070BA?logo=paypal&style=flat&logoColor=white
|
|
|
|
## About
|
|
|
|
This add-on is based on
|
|
[Free Games Claimer Remaster](https://github.com/P-Adamiec/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`:
|
|
|
|
```text
|
|
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:
|
|
|
|
```env
|
|
# 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](https://github.com/P-Adamiec/Free-Games-Claimer-Remaster#configuration)
|
|
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:
|
|
|
|
1. The existing `config.env` remains at the same configured location.
|
|
2. Legacy `epic-games.json`, `prime-gaming.json`, and `gog.json` claim history
|
|
is imported into the remaster SQLite database at `/data/fgc.db`.
|
|
3. Existing database rows are detected and are not duplicated if migration is
|
|
retried.
|
|
4. A pre-migration database backup is created when an existing `fgc.db` is
|
|
present.
|
|
5. 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
|
|
|
|
1. Add this add-on repository to the Home Assistant add-on store.
|
|
2. Install **Free Games Claimer**.
|
|
3. Configure the add-on options as needed.
|
|
4. Start the add-on and review its log.
|
|
5. Open noVNC if an account needs manual authentication.
|
|
|
|
[](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Falexbelgium%2Fhassio-addons)
|
|
|
|
## Custom scripts and environment variables
|
|
|
|
- [Running custom scripts in add-ons](https://github.com/alexbelgium/hassio-addons/wiki/Running-custom-scripts-in-Addons)
|
|
- [Passing environment variables to an add-on](https://github.com/alexbelgium/hassio-addons/wiki/Add-Environment-variables-to-your-Addon-2)
|
|
|
|
## Support
|
|
|
|
Open an issue in the
|
|
[add-on repository](https://github.com/alexbelgium/hassio-addons/issues).
|