v5.1.0

The nature of this project is rolling release, so minor version release notes don't carry much weight. However I deprecated some stuff and upgraded all the dependencies, so it's somewhat notable.

Deprecated

• bullseye-slim tag has been changed to debian.
  • The image is now Debian Buster based, so the "Bullseye" name doesn't really apply. The bullseye-slim tag will still be updated with the latest changes for a long while. Or try out the latest tag based on Alpine. It seems to be fine these days.
• Removed notificationTimeout setting (89c8ea4)
  • It now auto-detects timeout based on next scheduled run

Notable features since v5.0.0

• Generic webhook notifier (#380)
• OS base image upgrade, ESM migration, Chromium upgrade, and dependency upgrades (#383)

v5.0.0

Due to improved automation detection preventing solving of captchas on login and purchase, the project is taking a different approach:

• Captchas are avoided. Prepopulated cart checkout links are sent to the user rather than captcha pages. You will need to sign in to your Epic Games account on your notified device to complete the purchase.
  • If you were previously solving the captchas for several users, I recommend sending the notification to each appropriate user, as logging in and out on one device can be cumbersome.
• Login is still used to track what games you already own, however it is only set via cookie import or the new device code auth method.
  • Device code auth will send you a login prompt from an application like "Fortnite". This is a simple and secure way to get users authenticated. This only stores short-lived tokens to check your ownership of games. More details here.

Breaking Changes

• Your cronSchedule should run at least every 6 hours (0 0,6,12,18 * * *). This ensures that the device auth refresh token does not expire after 8 hours and prevents it from requesting a login at every run. More details here.

Changes

• Removed captcha solving portal
• Checkout URLs are now sent to the user for them to complete on their own signed-in device
• Login is now handled by cookie import, or a new device code auth alternative.
• Account credentials are no longer used.
• URL in notifications are now optional as preparation for future work
• Puppeteer usage is now minimal in preparation for Firefox support
• Several config options are no longer used. Details here.

v4.1.0

Everything is puppeteer now...

Breaking changes

• Remove puppeteerPurchase config. Everything needs to use puppeteer now, so this is useless.

Features

• A single browser is shared per account free game check session. This reduces browser creation and destruction as much as possible.

Bug fixes

• Fix 403 error when doing pretty much anything (#241)

v4.0.0

Breaking changes

• Removed arm/v6 and arm/v7 architecture support. v4 uses Chromium for browser automation, and arm/v6/arm/v7 does not have any Chromium builds easily available for Alpine Linux. arm64 is still supported.
• Added captcha bypass via hCaptcha accessibility token. See this guide to set it up. (#124)
• Moved email, baseUrl, and onlyWeekly configs. See this guide for migration steps.

Features

• Added additional notification means (Discord, Telegram, email) (#101)
• Per-account notification configuration (#70, #120)
• New captcha solving web portal that uses remote browser screencast rather than proxied UI calls
• Version check on boot
• Improved config validation. Stricter value validation and error reporting.
• Added automatic default config file creation when one isn't present.
• Config file path and name configurable via environment variables

Bug fixes

• Fixed login issue due to Talon. Bypassed by using browser automation via puppeteer (#97)
• Fixed free game search (#129)
• Support path-based reverse proxy (#75)
• Timezone configurable via config file (#130)

3.0.0: hCaptcha Support

POTENTIALLY BREAKING CHANGE:

• If you use a non-root URL as your baseUrl (e.g. https://me.com/epic), you may run into issues with this release. If you are in this use-case and experience issues, please open a GitHub issue so I can prioritize a fix.

Changes:

• Large rewrite to support hCaptcha for login. This resolves current login issues that came up with the hCaptcha rollout.
• Still supports Arkose catpchas as they are still used for purchase.
• Some purchase logic and game selection logic fixes.

2.0.0: Captcha Emails

• Removes Google Speech-to-text for automatic Captcha solving
• Adds an email service that notifies you when a Captcha needs to be solved
  • See the Readme on how to configure the email SMTP and webserver
• Runs account checks in parallel