TooGoodToGoNotifier

TooGoodToGoNotifier is a .NET 7 web api application that send email notifications when any of your or any of your friends favourite baskets are available in the TooGoodToGo mobile application. This project started when I saw the lack of notification functionality when a basket is available in the official application. The new README is in progress, please see the console-version branch to use the old version that was a simple console application without any database requirement and with a complete documentation.

[WIP] Prerequisites

• a TooGoodToGo account
• an email account that will be used to send notifications
• .NET 7 runtime unless a self-contained release is used

[WIP] Configuration

• Open the TooGoodToGo application and mark as favorite every basket that you wish to receive notifications

• Open the appsettings.json configuration file of TooGoodToGoNotifier

• Configure your TooGoodToGo account's email

  "TooGoodToGoApiOptions": {
      "AccountEmail": "TooGoodToGoEmailAccount"
    }

• Configure the email recipients. For a personal usage you can use the DefaultRecipients to add your own email and leave SubscribedBasketsIdByRecipients empty

  "NotifierOptions": {
    "DefaultRecipients": ["defaultRecipientEmail"],
    "SubscribedBasketsIdByRecipients" : []
  }

TooGoodToGoNotifier can also be used with multiple users using the SubscribedBasketsIdByRecipients option. You can specify precisely which recipient will be notified for each basket. In this example, oneRecipientEmail will only receive a notification if the basket with id 210534 is seen as available, whereas anotherRecipientEmail will receive notifications for the baskets 210534 and 215324. Basket's ids can be found using the share functionality on the TooGoodToGo app. If a basket is not filtered, DefaultRecipients will be used. Please note that this is an advanced usage and is subject to change in future versions

  "NotifierOptions": {
    "DefaultRecipients": ["defaultRecipientEmail"],
    "SubscribedBasketsIdByRecipients" : [
      {
        "Recipients": ["oneRecipientEmail"],
        "BasketIds": [210534]
      },
      {
        "Recipients": ["anotherRecipientEmail"],
        "BasketIds": [210534, 215324]
      }
    ]
  }

• Configure the email server used to send notifications

  "EmailNotifierOptions": {
    "SmtpServer": "smtpServer",
    "SmtpPort": 465,
    "useSsl": true,
    "SmtpUserName": "smtpUserName",
    "SmtpPassword": "smtpPassword"
  }

• Scanning for favorite baskets happens every day every 20 seconds by default. This value is configured using the ScanningInterval option and it's value must be between 1 and 59 seconds. Scanning is also restricted between the configured range with StartTime and EndTime options to avoid scanning when businesses are closed. Keep in mind that TooGoodToGo's services may flag you as a bot and serve a reCAPTCHA if too many requests are sent during a short period of time.

  "NotifierOptions": {
    "ScanningInterval": 20,
    "StartTime": "08:00:00",
    "EndTime": "20:00:00"
  }

[WIP] How it works

At startup TooGoodToGoNotifier must authenticate to the TooGoodToGo services using your credentials. Since TooGoodToGo use a passwordless authentication, you will receive an email from them in your inbox and you must navigate to the given link in a browser. DO NOT click the link directly on your phone with the TooGoodToGo app installed otherwise the authentication will fail. Once the application is authenticated, it will check for available favourite baskets every 20 seconds by default. If a favourite basket is seen as available, an email notification will be sent to every configured recipient. Once a basket has been notified, it won't be notified again unless it's seen as out of stock.