This project consists of lists of 'interesting' aircraft, formatted as CSV files. The list is designed to work with the excellent https://github.com/kx1t/docker-planefence.

Warning Please only suggest/make any changes to the plane-alert-db.csv, plane-alert-twitter-blocked.csv, plane-alert-pia.csv, plane-alert-ukraine.csv and plane_images.csv files on GitHub - all other files (except PIA) are generated from this file, and if you do not make your changes there, they will be overwritten and lost.

• Current Content
• Description of Categories
• Planefence
• Contributing
• Disclaimer, excuses and dodges
• Data Sources

There currently are about 12848 unique aircraft in 49 categories found in this repository. This Dashboard contains details of the main list and the most recent additions. These aircraft are divided into five main databases:

• plane-alert-db.csv - A list of interesting aircraft with tags, categories and links. (12848)
• plane-alert-pia.csv: A list that contains PIA planes. (52)
• plane-alert-twitter-blocked.csv: A list of aircraft that will cause your Twitter account to be banned when used with docker-planefence. Please use it with care. (9)
• plane-alert-ukraine.csv: A list with Ukrainian planes. (24)
• plane_images.csv: A accompanying list that contains aircraft images. (12881)

Based on these main databases, several derivative databases are created using a GitHub action:

• plane-alert-civ.csv - Civilian Registered Aircraft, includes Historic and Distinctive. (3310)
• plane-alert-mil.csv - Military Only. (7065)
• plane-alert-pol.csv - Police Forces. (862)
• plane-alert-gov.csv - Governments, Gov Agencies and Dictators. (1590)

A second version of each of the above lists contains up to 4 image links per aircraft. These lists are created in GitHub action using the plane_images.csv database. Please consider this experimental, do not come to rely on any of the image links

• plane-alert-db-images.csv
• plane-alert-twitter-blocked-images.csv
• plane-alert-ukraine-images.csv
• plane-alert-civ-images.csv
• plane-alert-mil-images.csv
• plane-alert-pol-images.csv
• plane-alert-gov-images.csv

This Dashboard contains details of the main, twitter-blocked, and Ukraine lists.

Think of categories like groups, with similar or related aircraft listed together. This allows you to easily select a subset of the list for your own use. The category names (and tags) come from my rather idiosyncratic sense of humour. If you have better suggestions I'm all ears.

• Aerobatic Teams - Red Arrows, Blue Angels etc. (65)
• Army Air Corp - UK Army Air Corp. Mainly Helicopters (94)
• As Seen on TV - Companies and Brands (368)
• Big Hello - Large Helicopters (sic) (104)
• Bizjets - Fancy pants planes for fancy pants people (38)
• Climate Crisis - Oil Companies, Large Business Jets - BBJs and ACJs (169)
• Coastguard - Coastguard, Customs and Border Patrols (434)
• Da Comrade - Russian or Soviet Aircraft. I love their design, so they get their own category (91)
• Dictator Alert - People of potentially questionable morals and values (322)
• Distinctive - Unique and/or special aircraft e.g. The AN-225 Myria, NASA aircraft, Testbeds (178)
• Dogs with Jobs - Aircraft with specific roles and/or modifications (163)
• Don't you know who I am? - Famous People. I was going to say notable, but I'll go with Famous (21)
• Flying Doctors - Air Ambulance and Medical Flights (658)
• Football - Actual, Aussie Rules or American. We don't discriminate. (2)
• GAF - Aircraft of the German Air Force, thank to Rhodan76 (401)
• Gas Bags - Would you like to ride in my beautiful balloon? (14)
• Governments - Aircraft registered to Governments (237)
• Gunship - Brrrrrrrrrrrrrrrrrrrt (256)
• Hired Gun - Why do the dirty work when someone else can do it for you? (135)
• Historic - It's older than I am and most likely has a prop. (355)
• Jesus he Knows me - Aircraft owned and operated by Religious organisations (20)
• Joe Cool - Cool Planes. Or at least I think they are cool. (197)
• Jump Johnny Jump - de Havilland Chipmunks. Air Cadets of a certain age will understand. (388)
• Nuclear - Nuclear Emergency Support Team etc. (16)
• Oligarch - I made this money all by myself. (41)
• Other Air Forces - Air Force aircraft that are not RAF or USAF (1991)
• Other Navies - Navy Aircraft that are not Royal Navy Fleet Air Arm or United States Navy (188)
• Oxcart - Intelligence gathering aircraft (687)
• Perfectly Serviceable Aircraft - Why do you keep jumping out of a Perfectly Serviceable Aircraft aka Skydiving planes (43)
• PIA - Privacy ICAO Address....you can run, but you cannot hide (16)
• Police Forces - Your friendly neighbourhood flying (insert local colloquialism here) (845)
• Ptolemy would be proud - Mapping and Aerial Survey aircraft. (110)
• Quango - Nato, United Nations, World Bank etc. (32)
• Radiohead - Very Very special aircraft. Think VC25. (6)
• RAF - Aircraft of the Royal Air Force (229)
• Royal Aircraft - Aircraft used or owned by the UK Royal Family (8)
• Royal Navy Fleet Air Arm - Aircraft of the Royal Navy Fleet Air Arm (97)
• Sam Tân - Firefighting Aircraft. (301)
• Special Forces - The best of the best of the best. Sir. (161)
• Toy Soldiers - Armies from around the world (553)
• UAV - It's not natural, I tell 'ya (21)
• UK National Police Air Service - Your friendly neighbourhood flying bobby (24)
• United States Navy - United States naval avaitors. Some say they are the best of the best. (243)
• USAF - Aircraft of the United States Air Force (2138)
• Vanity Plate - Distinctive registrations (66)
• Watch Me Fly - Flying and Training Schools (75)
• You came here in that thing? - Microlights, tiny planes and helis..think Yakima Super Breezy (thanks skstrand). (98)
• Zoomies - Fast jets, fighters. Anything that moves fast. (134)

The list takes the form:

To use this list with Planefence, configure your planefence.config setup to include the following line:

PF_ALERTLIST=https://raw.githubusercontent.com/Sportsbadger/plane-alert-db/main/plane-alert-db.csv

If you want to add the list in addition to your local plane-alert-db.csv list, you can do the following:

PF_ALERTLIST=plane-alert-db.csv,https://raw.githubusercontent.com/Sportsbadger/plane-alert-db/main/plane-alert-gov.csv,https://raw.githubusercontent.com/Sportsbadger/plane-alert-db/main/plane-alert-pol.csv

Note The priority of use is first-to-last, so if you want your local list to be interpreted first, move it to the front of the list.

Add these characters to the column headers to control the behaviour of PlaneAlert

• $ - Tweet this column as #hashtag.
• # - Don't show on the website (it will ignore this for the ICAO field, which is always shown).
• $# - Don't show on the website; tweet as a #hashtag.

Feel free to open an issue if you have ideas on improving this repository or want to report a bug! All contributions are welcome 🚀. Please consult the contribution guidelines for more information. You can also check out the TODOS page if you want to contribute to this repository but need some ideas.

Warning As also explained above, this repository contains five main databases to which people can contribute. The other databases are created automatically using GitHub action. As a result, please only suggest/make any changes to these main databases. Changes made to all other CSV files will be overwritten and lost.

This is not intended to be a definitive list, especially when it comes to aircraft models. Where the same model of aircraft is made by several manufacturers I won't always have the correct one. If you thought it was a Beechcraft King Air 200 and actually it was a Textron Super King Air B200GT, I won't be losing any sleep. There are other data sources (see below) if you want absolute accuracy.

This data has been gathered from far too many sources to mention, but some sites have been really useful:

• https://github.com/iatacodes/whatisflying-db
• https://github.com/The-CFR-Project/whatisflying-db
• https://www.flightdb.net/index.php
• http:https://www.rotorspot.nl/
• http:https://www.dtvmovements.co.uk/
• http:https://www.ads-b.nl/
• https://www.live-military-mode-s.eu/
• https://dictatoralert.org/
• http:https://www.j-hangarspace.jp/
• https://scramble.nl/
• https://www.foxtrotcharlie.ovh/
• https://www.planelogger.com/
• https://www.jetphotos.com/