Skip to main content

APRS Cursor-on-Target Gateway.

Project description

Screenshot of APRS PLI in ATAK.

The APRS to Cursor On Target Gateway (APRSCOT) provides beyond line-of-sight blue force tracking capabilities using commercial off the shelf components. This gateway uses the Automatic Packet Reporting System (APRS) and APRS-IS network to forward APRS position reports to Cursor On Target (COT) clients such as the Android Team Awareness Kit (ATAK), WinTAK, et al. Other situational awareness & common operating picture platforms are supported through use of COT, such as TAKX & COPERS.

APRS Frames can also be transformed or callsigns normalized before forwarding as COT. Almost any network destination is available, including TCP & UDP Mulitcast.

Features of aprscot:

  • Handles APRS-IS transported APRS Frames from over-the-air or Internet-based stations.

  • Can transform APRS station callsign, COT Type and COT Icon for display in TAK systems.

  • Can run as a service (‘daemon’) on any Linux system.

  • Can send COT Events to any destination supported by PyTAK: TLS/SSL, TCP, UDP, UDP Multicast.

See also:


APRSCOT concept diagram.

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!


The APRS to COT gateway is service started with a command-line tool called aprscot. There are three options for installing aprscot, in order preferred option they are:

Option I: Install as a Debian / Ubuntu Package:

$ wget
$ sudo apt install -f ./python3-pytak_latest_all.deb
$ wget
$ sudo apt install -f ./python3-aprslib_latest_all.deb
$ wget
$ sudo apt install -f ./python3-aprscot_latest_all.deb

Option II: Install from the Python Package Index (PyPI):

$ python3 -m pip install aprscot

Option III: Install from this source tree:

$ git clone
$ cd aprscot/
$ python3 install


The aprscot program has one command-line argument:

$ aprscot -h
usage: aprscot [-h] [-c CONFIG_FILE]

optional arguments:
  -h, --help            show this help message and exit

You must create a configuration file, see example-config.ini in the source repository.

An example config, COT_URL is our COT destination server or client:

COT_URL = tcp://

APRS-IS Server-side Filter Commands can be used to filter incoming APRS Frames:


PLI Transforms can be created using per-station sections. In this example, we’re overriding W2GMD-9’s COT Type & Callsign, and NB6F-2’s Callsign:


COT_TYPE = a-f-G-U-C
COT_NAME = Medic 52

COT_NAME = Transport 2




Greg Albrecht W2GMD


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.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aprscot-6.1.0.tar.gz (7.3 kB view hashes)

Uploaded source

Built Distribution

aprscot-6.1.0-py3-none-any.whl (10.4 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page