Skip to content

VCWG/Air-Sea

Repository files navigation

Air+Sea

An open source ATAK-CIV plugin that displays real-time ship and aircraft positions from AIS and ADS-B data sources as CoT markers.

air-sea-demo2.mp4

Features

  • Converts real-time ship and aircraft position information from AIS and ADS-B to CoT standard markers
  • Gathers and displays all ships and aircraft within a map-selected area
  • Tags ships and aircraft with their current speed and heading (if available)
  • Identify which ships or aircraft are underway at a glance; contacts with speed vectors are labeled with an arrow indicating their direction of travel
  • CoT markers are labeled with ship name or aircraft callsign, and are auto-assigned specific CoT types based on their broadcasted category code
  • Locally stored and updated ICAO database can identify an aircraft's military affiliation, type, and owner/operator without an internet connection and regardless of ADS-B source
  • Includes additional ship information remarks (MMSI, rate of turn, IMO Number, Ship Type, Draught, Destination, ETA)
  • Includes additional aircraft information remarks (ICAO, Registration, Type, Altitude, Speed, Squawk, Category, Type, Owner/Operator)
  • User can set update frequency, broadcast status, and default team affiliation for generated CoTs
  • User can edit CoT team affiliation or specific CoT type, and edits persist across tracking updates

Setup

Maritime Tracking APIs

  • This plugin uses aisstream.io as the ship data source.
  • This data source is free, but users must register on aisstream.io and generate an API key to input into the plugin.

Air Traffic APIs

  • adsb.fi, airplanes.live, and adsb.lol are supported without any API key provided.
  • ADS-B Exchange is supported with a user-provided API key available through RapidAPI.
  • OpenSky is supported with an optional API key to increase request limits. In testing, it has been observed that OpenSky does not reliably broadcast aircraft category codes, and air contacts may not auto-assign the correct CoT types if using OpenSky as the data source.

Hardware

RTL-SDR

  • This plugin supports ADS-B monitoring with a RTL-SDR receiver connected via USB. Follow the setup instructions below:
    • Install the RTL-SDR Driver App from Signalware, available on Play Store.
    • Disable battery optimization for the RTL-SDR Driver App/allow to run in background
    • Select the ADS-B data source as "USB: RTL-SDR"
    • Click "START" next to the RTL-SDR port number to automatically launch the RTL-SDR service with the specified port number
    • Click "START SYNC" to begin monitoring

Installation

  • Install ATAK-CIV version matching the version number supported by Air+Sea build
  • Install the Air+Sea plugin APK
  • Load the plugin in ATAK:
    • Open ATAK-->Settings-->Tool Preferences-->Package Management
    • Scroll to Air+Sea and check "Loaded"
    • Air+Sea plugin should now appear in ATAK main menu

Build

Requires ATAK-CIV SDK and Android Studio with Java.

License

GNU General Public License v3.0