https://github.com/sgofferj/tak-adsb-id
A collection of interesting ADSB ICAO hexids for ADSB to CoT feeders.
https://github.com/sgofferj/tak-adsb-id
adsb atak cot tak wintak
Last synced: 5 days ago
JSON representation
A collection of interesting ADSB ICAO hexids for ADSB to CoT feeders.
- Host: GitHub
- URL: https://github.com/sgofferj/tak-adsb-id
- Owner: sgofferj
- License: cc-by-sa-4.0
- Created: 2021-08-16T10:52:50.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2025-06-04T16:40:36.000Z (13 days ago)
- Last Synced: 2025-06-04T22:16:18.555Z (12 days ago)
- Topics: adsb, atak, cot, tak, wintak
- Language: Shell
- Homepage:
- Size: 583 KB
- Stars: 12
- Watchers: 4
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE
Awesome Lists containing this project
README
# TAK ADSB ID collection
## Overview
This is a collection of specific ICAO hexids to make ATAK/WinTAK SA displays more meaningful. The idea is to use them in the middleware which feeds ADSB data as CoT objects into a TAK server.
I started out with Finland but pull requests are welcome.
In April 2023, I also added countries.json which classifies ICAO hexid ranges. Together with the cotdb, those 2 files should allow for at least an IFF classification.
## Friendly, hostile, neutral?
I classify the aircraft from the point of view of somebody living in Finland. Finland is not at war with anybody at this point in time, so at the moment I do not classify any aircraft as hostile. If you feel, some aircraft should be classified as hostile, please download the files and use the search and replace function on your local copy.
Civilian aircraft are classified based on their country of registration because it's not always possible to figure out who is actually operating a certain aircraft at any moment in time.
**Update 2022-04-26:** Due to the Ukraine conflict and the changes in Finnish foreign policy, I reclassified all Russian and Belarusian planes as "hostile".
## Other stuff
To assist middlewares with displaying special civilian aircraft, I am developing some conventions for the source files:
- EMS aircraft will have their operator field in the format "EMS (operator)".
- SAR aircraft will have their operator field in the format "SAR (operator)".
- Law enforcement aircraft will have their operator field in the format "LEO (operator)".
## json
Since release 162458ZFEB23 the releases also contain a json file (cotdb.json) which should make integration of the data in 3rd party middleware fairly easy. The format is:
```json
{
"aircraft": [
{
"hexid": "3dd55c",
"cot": "a-n-A-C-H",
"reg": "D-HBAY",
"type": "BK117B2",
"operator": "EMS (ADAC)"
},
{ ... }
]
}
```
The second available JSON format (cotdb_indexed.json) is
```json
{
"3dd55c": ["a-n-A-C-H", "D-HBAY", "BK117B2", "EMS (ADAC)"],
"3dd652": ["a-n-A-C-H", "D-HBKK", "BK117B2", "EMS (ADAC)"]
}
```
## Python example
```Python
import json
import requests
cotdb_url="https://github.com/sgofferj/TAK-ADSB-ID/releases/latest/download/cotdb_indexed.json"
countries_url="https://github.com/sgofferj/TAK-ADSB-ID/releases/latest/download/countries.json"
r = requests.get(cotdb_url)
cotdb = r.json()
r = requests.get(countries_url)
countries = r.json()
def getCountry(hex):
hex=hex.lower()
ret = "u"
for c in countries:
if (hex >= c["start"].lower()) and (hex <= c["end"].lower()):
ret = (c['affil'])
break
return ret
def getCoT(hex):
affil = getCountry(hex)
cot = f"a-{affil}-A"
if hex in cotdb:
cot = cotdb[hex][0]
return(cot)
```
```
>>> getCoT("ae093a")
'a-f-A-M-F-U-L'
```
## Contributing
Please feel free to contribute to the list! Ideally, you would submit a pull request, but you can also open an issue. Please keep in mind what I wrote above under "Friendly, hostile, neutral?".
## Issues
I will try to handle issues fast but this is a hobby, I have a family and a busy work day, so please don't expect wonders!
## License
This repo is published under the Creative Commons Attribution-ShareAlike 4.0 International License.