Never Miss a TooGoodToGo Box Again!
The TooGoodToGo Notifier is a simple yet powerful application designed to keep you updated about available boxes from your favorite stores on TooGoodToGo. It automates the process of checking for boxes and sends notifications to your preferred platforms whenever a box becomes available.
- Instant notifications when your favorite TooGoodToGo stores have boxes available.
- Flexibility to run the application as a one-time check or continuously in server mode with a customizable interval.
- Option to utilize Redis for data storage, enabling stateless application runs.
Before using the application, you'll need your TooGoodToGo user ID and refresh token. If you don't have them yet, you can obtain them with this command:
$ tgtg authFor Docker users, you can run the command within a Docker container:
$ docker run -it --rm ghcr.io/hugo-vrijswijk/tgtg:latest authThe command will guide you through obtaining your user ID and refresh token.
You have two options for running the application:
- Download a Binary from the Latest Release: Release Page
- Use the Docker Image:
$ docker run ghcr.io/hugo-vrijswijk/tgtg:latestThe application operates in two modes:
- One-shot Mode: Checks for boxes once and then exits.
- Server Mode: Continuously monitors for boxes at a customizable interval (default: 5 minutes) without exiting.
To run the application, provide your TooGoodToGo user ID and refresh token as environment variables (TGTG_USER_ID and TGTG_REFRESH_TOKEN) or as arguments (--user-id and --refresh-token) and a notification provider.
For detailed information about available options, use the following command:
$ tgtg --helpChoose your preferred notification platform for available box alerts:
- Gotify:
--gotify-urland--gotify-token. - Pushbullet:
--pushbullet-token. - Pushover:
--pushover-tokenand--pushover-user. - Custom Webhook URL:
--webhook-url- This will send a POST request to the URL with a JSON body containing a
titleandmessage.
- This will send a POST request to the URL with a JSON body containing a
Each of these options can also be set as environment variables (in SCREAMING_SNAKE_CASE).
By default, tgtg stores authentication tokens and notification history cache in a local file named cache.json. For a stateless application, Redis can be used to manage this state.
To use Redis, specify the Redis host with the --redis-host option:
$ tgtg --redis-host <REDIS_HOST>Alternatively, set the Redis host as an environment variable (REDIS_HOST).
The TooGoodToGo Notifier was developed using the following technologies:
- Scala CLI (and GraalVM)
- Cats Effect (and FS2)
- Decline
- Sttp
- Woof
- Circe
- Rediculous
This application drew inspiration from tgtg-python. We express our gratitude to the developers of tgtg-python for their valuable contributions.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
![github-actions[bot] avatar](https://avatars.githubusercontent.com/in/15368?v=4 "github-actions[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent