TGTG Notifier

A command line tool that monitors your favorite TooGoodToGo stores and notifies you, when they have items available.

---

Usage

1. Create an .env file according to the template.

• Your GMail data is used to send emails via nodemailer:

GMAIL_USER=
GMAIL_PW=

• Configure your outgoing nodemailer settings (these will also be used to send you notifications about any erros that might occur):

NODEMAILER_SENDER=
NODEMAILER_SENDER_NAME=

• Enter your alertzy key, if you want to receive push notifications isntead of emails (this is optional):

ALERTZY_KEY=

• Finally, enter your TGTG login data and any coordinates as your origin (this is needed for getting any stores, and I didn't feel like generating random coordinates):

TGTG_EMAIL=
TGTG_PASSWORD=
TGTG_USER_ORIGIN=

2. Configure notification recipients

• Create a recipients.jsonc according to the template. This file is read every iteration, so you don't need to restart the service if you change any information.

{
  "name": "firstName lastName",
  "trigger": "always | available",
  "alertzyKey": "key",
  "email": "[email protected]",
  "locations": [
    "item_id", // comment
  ]
}

• name is the name used for sending out emails
• trigger defines, when a user should be notified.
  • always notifies whenever there is a change in available items (eg: 3 -> 2 -> 1, but only for >0 )
  • available only notifies users, once the stock changes from 0 to >0
• alertzyKey is the users alertzyKey to receive push notifications
• email is the users email adress to receive notification emails
• locations is an array of item ids (which you will need to find out yourself 😉)

You can supply either the email info (name, adress) or the alertzy key. If both are present, the alertzy key will take precendence over email.

3. Adjust your execution intervals

• In src/lib/cron.js you can tweak, when the tool should check for available items

4. Start the service

• install and compile
  npm i && npx tsc
• run
  npm start