Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
  ADS-B to Cursor-On-Target Gateway.

Screenshot of ADS-B PLI in ATAK.

The ADSBXCOT ADS-B to Cursor-On-Target Gateway transforms Automatic Dependent Surveillance-Broadcast (ADS-B) aircraft position information into Cursor-On-Target (COT) Position Location Information for display on Situational Awareness applications such as the Android Team Awareness Kit (ATAK), WinTAK, RaptorX, TAKX, iTAK, et al. ADS-B data is provided by and requires an API key from that service.

For more information on the TAK suite of tools, see:


Support Development

Tech Support: Email or Signal/WhatsApp: +1-310-621-9598

This tool has been developed for the Disaster Response, Public Safety and Frontline Healthcare community. This software is currently provided at no-cost to users. Any contribution you can make to further this project's development efforts is greatly appreciated.

Support Development: Buy me a coffee!


ADSBXCOT's functionality provided by a command-line program called adsbxcot.

Installing as a Debian / Ubuntu Package [Recommended]:

$ sudo apt update
$ wget
$ sudo apt install -f ./python3-aircot_latest_all.deb
$ wget
$ sudo apt install -f ./python3-pytak_latest_all.deb
$ wget
$ sudo apt install -f ./python3-adsbxcot_latest_all.deb

Install from the Python Package Index (PyPI) [Advanced Users]:

$ pip install adsbxcot

Install from this source tree [Developers]:

$ git clone
$ cd adsbxcot/
$ python install


The adsbxcot command-line program has 2 runtime arguments:

usage: adsbxcot [-h] [-c CONFIG_FILE]

optional arguments:
  -h, --help            show this help message and exit
  -c CONFIG_FILE, --CONFIG_FILE CONFIG_FILE. Default: config.ini


Configuration parameters can be specified either via environment variables or in a INI-stile configuration file.


  • ADSBX_URL: API or Rapid API URL.
  • COT_URL: (optional) Destination for Cursor-On-Target messages. See PyTAK for options.
  • POLL_INTERVAL: (optional) Period in seconds to poll API. Default: 30
  • KNOWN_CRAFT: (optional) CSV-style aircraft hints file for overriding callsign, icon, COT Type, etc.
  • INCLUDE_TISB: (optional) If set, will also including TIS-B identified aircraft.
  • INCLUDE_ALL_CRAFT: (optional) If set & KNOWN_CRAFT is set, will include aircraft not in KNOWN_CRAFT.

There are other configuration parameters available via PyTAK.

Configuration parameters are imported in the following priority order:

  1. config.ini (if exists) or -c <filename> (if specified).
  2. Environment Variables (if set).
  3. Defaults.


ADSBXCOT source can be found on Github:


ADSBXCOT is written and maintained by Greg Albrecht W2GMD


ADSBXCOT is Copyright 2022 Greg Albrecht


Copyright 2022 Greg Albrecht <>

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.