Skip to main content

aprscot - APRS Cursor-on-Target Gateway.

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:

Concept:

APRSCOT concept diagram.

Support Development

Tech Support: Email support@undef.net 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!

Installation

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 https://github.com/ampledata/pytak/releases/latest/download/python3-pytak_latest_all.deb
$ sudo apt install -f ./python3-pytak_latest_all.deb
$ wget https://github.com/ampledata/aprs-python/releases/latest/download/python3-aprslib_latest_all.deb
$ sudo apt install -f ./python3-aprslib_latest_all.deb
$ wget https://github.com/ampledata/aprscot/releases/latest/download/python3-aprscot_latest_all.deb
$ 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 https://github.com/ampledata/aprscot.git
$ cd aprscot/
$ python3 setup.py install

Usage

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
  -c CONFIG_FILE, --CONFIG_FILE CONFIG_FILE

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:

[aprscot]
COT_URL = tcp://takserver.example.com:8088

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

[aprscot]
COT_URL = tcp:takserver.example.com:8088
APRSIS_FILTER = f/W6PW-10/50

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:

[aprscot]
COT_URL = tcp:takserver.example.com:8088

[W2GMD-9]
COT_TYPE = a-f-G-U-C
COT_STALE = 600
COT_NAME = Medic 52

[NB6F-2]
COT_NAME = Transport 2

Source

Github: https://github.com/ampledata/aprscot

Author

Greg Albrecht W2GMD oss@undef.net

https://ampledata.org/

License

Copyright 2022 Greg Albrecht <oss@undef.net>

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 http://www.apache.org/licenses/LICENSE-2.0

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.

Metadata

Release files for aprscot 6.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aprscot 6.1.0
File Size Uploaded
aprscot-6.1.0.tar.gz 7.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for aprscot 6.1.0
File Interpreter ABI Platform
aprscot-6.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 17.7 kB

Release files / aprscot-6.1.0.tar.gz

Download URL aprscot-6.1.0.tar.gz
Size 7.3 kB
Tags Source
SHA-256 checksum
How to use checksums
fb13a122a7a1487b25f5c32b4220f281f62430dd65cb4076440ac0979a6bd0d8
BLAKE2b-256 checksum
How to use checksums
8370ec94528f806ad4db5504efa895896f50a0a89e5409f4e05bfcb6c55899fb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.14

Release files / aprscot-6.1.0-py3-none-any.whl

Download URL aprscot-6.1.0-py3-none-any.whl
Size 10.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5336bd3857f3daf3497f7be69aca28bcbc2f7137b04010279b9514221165dc54
BLAKE2b-256 checksum
How to use checksums
27e4fc5aff17f87f8a81aac68c8df6a609ffcb875e8857267f969e08ebafdf3a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.14

Release history Release notifications | RSS feed

This release

6.1.0 This release

2 release files

6.0.0

2 release files

5.0.5

2 release files

5.0.4

2 release files

5.0.3

2 release files

5.0.2

2 release files

5.0.1

2 release files

5.0.0

2 release files

4.0.0

1 release file

3.2.0

1 release file

3.1.0

1 release file

3.0.2

1 release file

3.0.1

1 release file

3.0.0

1 release file

2.0.1

1 release file

2.0.0

1 release file

1.0.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page