Skip to content

Latest commit

 

History

History
113 lines (70 loc) · 4.07 KB

README.md

File metadata and controls

113 lines (70 loc) · 4.07 KB

TooGoodToGo Notifier

Never Miss a TooGoodToGo Box Again!

Actions Status

Introduction

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.

Key Features

  • Instant notifications when your favorite TooGoodToGo stores have boxes available.
  • Flexibility to run as a one-time check or continuously with customizable intervals or CRON schedules.
  • Option to utilize Redis for data storage, enabling stateless application runs.

Getting Started

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 auth

For Docker users, you can run the command within a Docker container:

$ docker run -it --rm ghcr.io/hugo-vrijswijk/tgtg:latest auth

The command will guide you through obtaining your user ID and refresh token.

Installation

You have two options for running the application:

  1. Download a Binary from the Latest Release: Release Page
  2. Use the Docker Image:
$ docker run ghcr.io/hugo-vrijswijk/tgtg:latest

Usage

The application operates in two modes:

  1. One-shot Mode: Checks for boxes once and then exits.
  2. Server Mode: Continuously monitors for boxes at configured schedules 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 --help

Notifications

Choose your preferred notification platform for available box alerts:

  • Gotify: --gotify-url and --gotify-token.
  • Pushbullet: --pushbullet-token.
  • Pushover: --pushover-token and --pushover-user.
  • Custom Webhook URL: --webhook-url
    • This will send a POST request to the URL with a JSON body containing a title and message.

Each of these options can also be set as environment variables (in SCREAMING_SNAKE_CASE).

Schedules

To enable server mode, specify intervals or CRON schedules for checking TooGoodToGo boxes:

  • Intervals: --interval <duration> (e.g., --interval 5m for every 5 minutes).
  • CRON Schedules: --cron <cron> (e.g., --cron "0 0 0 * * ?" for every day at midnight).

tgtg will run immediately, and then at the specified intervals or CRON schedules.

Intervals and CRON schedules can be combined as many times as needed. For example:

$ tgtg --interval 5m --cron "0 0 0 * * ?" --cron "0 0 12 * * ?"

Utilizing Redis for Application State (advanced)

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).

Development

The TooGoodToGo Notifier was developed using the following technologies:

Acknowledgments

This application drew inspiration from tgtg-python. We express our gratitude to the developers of tgtg-python for their valuable contributions.