Skip to content
Telegram bot for ADS-B proximity alerts
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Telegram 1090

An airplane tracking bot that supplies users with data from a dump1090 datasource.

Read more about my setup on my blog:

Bot features


  • subscribe - Subscribe to notifications of nearby planes
  • unsubscribe - End notifications of nearby planes



  1. Install dump1090 - FlightAware's fork of it is available through their official Raspbian repo. You can follow the instructions on their site, skipping the PiAware installation and going straight to the dump1090-fa installation. The great thing about the FlightAware fork is it automatically runs at boot and provides a nice web UI to check your data.
  2. Install Node.js 10 or newer - The required version isn't included in Raspbian's default repos, so you can will need to either get it directly from the Node.js website, from NodeSource's binary packages, or using nvm.
  3. Clone this repo to a convenient location - git clone
  4. Prepare the configuration - copy config.json.example to config.json and updated the values where necessary. Primarily the home lat/lon and telegram token.
  5. Run the bot in the foreground - npm start in the repo directory.

Running as a service

  1. Build the TypeScript code for direct use with Node - npm run build in the repo directory.
  2. Prepare the systemd service unit file by copying telegram1090.service.example and updating the User, Environment=PATH and WorkingDirectory lines.
  3. Copy or symlink this updated file - sudo ln -s telegram1090.service /lib/systemd/system/telegram1090.service
  4. Test the service to make sure it's working:
    • Trigger a systemd reload of services for new/changed service files - sudo systemctl daemon-reload
    • Try to start the service - sudo systemctl start telegram1090
    • Check the status of the service - sudo systemctl status telegram1090
    • Check the logs - journalctl -fn 20
  5. Enable the service sudo systemctl enable telegram1090
  6. Reboot and check check the status of the service to ensure it started up properly

Removing the service

  1. Disable the service - sudo systemctl disable telegram1090
  2. Remove the service unit file - sudo rm /lib/systemd/system/telegram1090.service


If updates are availble, simply git pull origin to update your local repo, run npm run build, and restart the service sudo systemctl restart telegram1090 or reboot.

Extra reading

You can’t perform that action at this time.