vitaliyoliynyk / tgtg

Scanner for Too Good To Go Notifications

TGTG Scanner

TGTG Scanner observes your favorite TGTG Magic Bags for new available items and notifies you via mail, IFTTT, Telegram, pushSafer or any other WebHook. Notifications will be send when the available amount of Magic Bags rises from zero to something.

Additionally the currently available amounts can be provided via a http server.

Running in a docker container the scanner can be seemlessly integrated with openhab, prometheus and other automation, notification and visualization services.

This software is provided as is without warranty of any kind. If you have problems, find bugs or have suggestions for improvement feel free to create an issue or contribute to the project. Before creating an issue please refere to the FAQ.

Disclaimer

Too Good To Go explicitly forbids the use of their plattform the way this tool does. In their Terms and Conditions it says: "The Consumer must not misuse the Platform (including hacking or 'scraping')."

If you use this tool you do it at your own risk. TGTG may stop you from doing so by (temporarily) blocking your access and may even delete your account.

Error 403

If you see the Error 403 in your logs please refere to the FAQ.

Installation

You can install this tool on any computer. For 24/7 notifications I recommended to install the tool on a NAS like Synology or a Raspberry Pi. You can also use a virtual cloud server. Starting at 1,00 €/Month at Strato.de or try AWS free tier.

If you have any problems or questions feel free to create an issue.

You have the following three options to install the scanner, ascending in complexity:

Use prebuild Release

This is the simplest but least flexible solution suitable for most operating systems.

1. Download latest Releases for your OS
2. Unzip the archiv
3. Edit config.ini as described in the file
4. Run scanner

You can run the scanner manually if you need it, add it to your system startup or create a service.

Run with Docker

My prefered method for servers using the pre build multi-arch linux images available on Docker Hub.

1. Install Docker and docker-compose
2. Copy and edit docker-compose.yml as described in the file
3. Run docker-compose up -d

The container creates a volume mounting \tokens where the app saves the TGTG credentials after login. These credentials will be reused on every start of the container to avoid the mail login process. To login with a different account you have to delete the created volume.

Run from source

Method for developers.

1. Install Python>=3.9 and pip
2. Run pip install -r requirements.txt
3. Create src/config.ini as described in the file config.template.ini
4. Run python src/scanner.py

Running

When the scanner is started it will first try to login to your TGTG account. Similar to loging in to the TGTG app, you have to click on the link send to you by mail. This won't work on your mobile phone if you have installed the TGTG app, so you have to check your mailbox on PC.

After a successfull login the scanner will send a test notification on all configured notifiers. If you don't reveive any notifications, please check your configuration.

Metrics

Enabling the metrics option will expose a http server on the specified port supplying the currently available items. You can scrape the data with prometheus to create and visualize historic data or use it with your home automation.

Scrape config:

  - job_name: 'TGTG'
    scrape_interval: 1m
    scheme: http
    metrics_path: /
    static_configs:
    - targets:
      - 'localhost:8000'

Developing

For developement I recommend using docker. The Makefile depends on docker and docker-compose.

Create .env based on sample.env for configuration.

Developing with VSCode you can open the project in the configured developement container.

Makefile commands

make image builds docker image with tag tgtg-scanner:latest

make install installs dependencies

make start short for python src/scanner.py

make bash starts dev python docker image with installed dependencies and mounted project in bash

make executable creates bundled executable in /dist

make test runs unittests

make clean cleans up docker compose

Helper functions

src/helper.py contains some usefull functions. Running python src/helper.py --help displays the available commands.

Usage: helper.py command
  commands:
  - credentials:            displays your TGTG tokens
  - favorites:              displays your favorite magic bags data
  - find [lat] [lng] [rad]: displays items for position and radius
  - add [item_id]:          adds [item_id] to your favorites
  - delete all:             removes all your favorites
  - delete [item_id]:       removes [item_id] from your favorites

Creating new notifiers

Feel free to create and contribute new notifiers for other services and endpoints. You can use an existing notifier as template.

---

If you want to support me, feel free to buy me a coffee.