ACARS DRAMA LIVE

ACARS DRAMA

@acarsdrama

RECENTLY RECEIVED DRAMA STATUS: DRAMA INGESTION ACTIVE

LIVE FEED BELOW

Welcome to ACARS Drama, the leading provider of sky-based drama ingestion services

ACARS Drama is a project powered by a global network of aviation enthusiasts on the hunt for interesting ACARS and VDLM2 messages sent from passing aircraft.

INFORMATION
What is ACARS Drama?

A project to map out every broken coffee maker in the sky

A question I’ve been asked a few times since I took a little project I had... and turned it into a social media bot.

Plane flying over

Drama occurs onboard

Pilot reports drama via FMS keypad

Transmits unencrypted data over VHF

Signal captured by SDR

Operated by a sky drama farmer

Software decodes ACARS

Message parsed & cleaned

Posted to Drama engine

Message enters drama processing

Engine examines message

If drama found → post to feeds

When an aircraft is flying overhead, various radio signals are being transmitted and received by said aircraft constantly. Some examples of the radio signals, of course, are voice communications between pilots and air traffic controllers, that most people are familiar with. These are, of course, critical for safety, and ensuring planes are at the right altitude, going in the right direction, and at the right speed.

In addition to voice, there are also a boat-load, well, plane-load I guess, of data signals. Amongst these data signals are the two types of signal that feed the bot’s insatiable thirst for drama. They are ACARS and VDLM2.

ACARS, which stands for Aircraft Communications Addressing and Reporting System, is a 1970’s era protocol that is still used today. A bunch of ground stations around the world are used to translate messages between computers in dispatch, maintenance and operations control rooms of the various airlines and their aircraft, and vice-versa, from the aircraft cockpit back to those airline computers.

VDLM2, which stands for VHF Data Link Mode 2, is similar in that it is a data transmission protocol that works over very high frequency (VHF) radio-waves, but it’s a bit more modern, uses different frequencies, is a bit faster, and can also carry ACARS messages.

So, in summary, ACARS is where the drama usually is, sometimes transmitted in raw ACARS form, other times it is encapsulated in VDLM2. Same result all round really, you just have to look in a slightly different place to decode the ACARS inside of VDLM2 messages.

Because I am a massive nerd when it comes to both radio stuff and planes (I was a PPL, almost did commercial but got rejected by the flight school I wanted to train at age 17 because I was ‘too quiet’, a problem I later rectified), I was able to buy a few relatively cheap bits of equipment that can listen for these signals from planes flying over my house, and using some open source software that other, much smarter people than me wrote, I was able to decode them. I then wrote some extra bits of software that fixes up the message (extracts only the human readable interesting bits, removes bad formatting etc), and turns it into the posts you see on ACARS Drama. That software also does the job of finding the aircraft photo and adding the tracking link too.

Below is an image of an FMC from a cockpit:

An FMC from a cockpit— source http://www.b737.org.uk/fmc.htm

Now, because of how the system works, it is extremely hard to capture the ground to air signals, unless you live in close proximity to an airport or ground station, which I do not. So this means that pretty much 99% of what you see on ACARS Drama is air to ground. Essentially one side of a conversation, from the plane to folks on the ground. Sometimes it picks up ground to air, but it’s rare, and I honestly don’t know why it works when it does. If you do see a ground to air message, the bot will say “ACARS Message To” instead of “ACARS Message From”.

Because of the sheer volume of the messages it picks up, around 2,000 an hour, most of which are just position and weather data, and automated readings from equipment, it would not be reasonable to post them all via the bot. That would just be annoying. So, I have carefully curated a list of keywords that the bot looks for in the messages received, to ensure that it only shares the ones with human-entered, “free-text” content. So when you see a message on the bot, it means that a pilot or crew member on the aircraft typed that into their ACARS terminal, which is usually a Flight Management Computer (FMC) device, like the one shown above.

As a message is typed and sent via ACARS, if that plane is in range of one of my antennas (there are two currently being used for the ACARS drama bot), and on a frequency I’m monitoring (I currently monitor five total — 3 ACARS and 2 VDLM2), then it’ll be processed by my software and turned into the bot post that you see on Masto like this:

Example image showing ACARS message details

In this example, the message was captured in a VDLM2 frequency. The transmitting aircraft registration was N305SY, and its flight number was OO3682. OO is the code for Skywest Airlines, and N305SY is an Embraer 175 aircraft. The Track Aircraft link in the bot points to the registration, so you can see where in the sky the plane is at any given time, unless it’s on the ground of course.

Nowadays, the ACARS Drama bot also receives data captured via a team of volunteers from all over the world who have built the same setup - meaning we get a lot more coverage, and have to parse a lot more messages - currently around 200,000 an hour.

It’s fair to say that the overwhelming majority of messages transmitted are extremely routine and boring, contrary to the name of the bot — which to be honest, is part of the joke. So, you’ll mostly see things about asking for gate confirmations, reporting “snags” with the aircraft, usually toilet or coffee maker related, but occasionally you’ll see reports of drunk passengers, fights onboard — you know, air travel things. That’s what makes it an interesting and fun project. You also get to see the pilots’ personalities shine through as well, which I love. We all have good days and bad days at work, so you might see the occasional snarky message — but ultimately, these are professionals doing a wonderful job in not always the easiest of circumstances.

So that’s what you’re seeing and how the bot works. You can follow along at https://live.acarsdrama.com/@acarsdrama if you aren’t already.

SCOPE
Coverage Area
Heat intensity ≈ contributor presence.
CONTRIBUTE
Harvest your sky drama!

If you’d like to contribute, it’s easy with an RTL-SDR, an antenna, some open-source software, and Internet access.

Quick Start
  • Send ACARS to feedthe.acarsdrama.com:5550
  • Send VDLM2 to feedthe.acarsdrama.com:5555

UDP or TCP (UDP preferred), JSON format. Use acars_router to split feeds if you already feed elsewhere.

Set a unique FEED ID (include your nearest airport ICAO). Email feeders [at] acarsdrama [dot] com to confirm reception.

Need a bit more guidance?

Deep dive: acarsdec / dumpvdlm2 / acars_router
Sample docker: docker-compose.yml
ADSB.im Image + guide: ADSB.im step-by-step
Ask questions in the "ACARS Drama Club" Discord: Join here

RECOMMENDED SETUP
Recommended Equipment
  • RTL-SDR Blog V3/V4 — reliable, inexpensive SDR dongles for ACARS and VDLM2 reception.
  • NooElec NESDR Mini — compact SDR with strong performance for aviation band monitoring.
Tip: Use a VHF air-band antenna and mount it as high and clear as possible for best results.
Recommended Software
  • docker-acarshub — community-maintained ACARS/VDLM2 stack with built-in routing.
  • ADSB.im — preconfigured images for Raspberry Pi and other devices with ACARS Drama feeder support.
Combine with acars_router to feed multiple networks efficiently.
FILTERED TRAFFIC
A quick note about feeds

We understand the main ACARS Drama social feed is very busy (remember, we process 200,000 messages an hour, and the tiny fraction of those we post is still quite a lot). Therefore, we offer different ways for you to enjoy our project if you aren't interested in all the raw messages. See below for some more heavily filtered feeds, and also some RSS options.

Mastodon Regional and Quieter Feeds
RSS
ACARS GLOSSARY
Common terms you’ll see in messages

Tip: ACARS/VDLM2 messages are terse and very “ops”-y. This glossary decodes the most common shorthand.

APU
Auxiliary Power Unit
CA
Captain
CL
Cabin Log
CS
Customer Service
DCT
Direct (routing)
EFB
Electronic Flight Bag
ECAM
Electronic Centralized Aircraft Monitor (Airbus)
EICAS
Engine Indication and Crew Alerting System (Boeing)
EDCT
Estimated Departure Clearance Time
EFC
Expect Further Clearance
FA
Flight Attendant
FMS
Flight Management System
FO
First Officer
FOB
Fuel on Board
GPU
Ground Power Unit
INOP
Inoperable / broken
JL
Journey Log
MEL
Minimum Equipment List
PAX
Passengers
PIREP
Pilot Inflight Weather Report
QRH
Quick Reference Handbook
RON
Remaining Overnight
RVR
Runway Visual Range
SELCAL
Selective Calling system
TCAS
Traffic Alert and Collision Avoidance System
UM
Unaccompanied Minor
WX
Weather
ACARS
Aircraft Communications Addressing and Reporting System
ATC
Air Traffic Control
ATIS
Automatic Terminal Information Service
AOG
Aircraft On Ground
CDU/FMC
Control Display Unit / Flight Management Computer
CPDLC
Controller–Pilot Data Link Communications
ETA / ETD
Estimated Time of Arrival / Departure
OOOI
Out / Off / On / In times
METAR / TAF
Weather report / Forecast
NOTAM
Notice to Air Missions
SID / STAR
Standard Departures / Arrivals
ZFW / TOW / MLW
Weights
HF / VHF
Radio bands
CTA / FIR
Airspace regions
ETOPS
Extended-range Twin-engine Ops
PNR
Passenger Name Record
See a term we’re missing? Ping us on Mastodon or Discord and we’ll add it.
NOTAMS / RULES
Content Moderation + Legal Things

Since it's inception in the 1970's, ACARS messages have been readable to anyone nearby with an air-band radio attached to a computer. ACARS has long been treated as a public communications channel due to the lack of encryption. ACARS messages have been publicly searchable in a variety of places on the internet for decades. Pilots are advised not to use ACARS for sensitive data transmission, and to instead use airline specific encrypted apps over IP networks.

All that said...we know that sometimes ACARS messages can contain personally identifiable information about passengers and the like (EVEN THOUGH THEY ARE TRANSMITTED UNENCRYPTED), so the underlying code that posts these messages has checks to filter out things like names, medical details, and also PNR's (passenger number records) - you'll see the actual characters replaced by X's when this happens. The same is true for any security-related content that may have a safety impact. The last thing we want to do is cause any issues there.

Sometimes things slip through, and we remove the content very shortly after. Other times, they might not be noticed immediately. If you see something that you feel does not belong on ACARS Drama, please report it to us via our Mastodon instance, and we'll take a look.

Information shared on ACARS Drama is not to be used for flight planning or during the course of live flight operations.

ACARS Drama makes no claims or representation that the information shared on our platform is always completely accurate. The nature of the ACARS protocol is such that it is very possible to spoof messages declaring to be from a specific aircraft, when in fact it is not. We have built and are continually refining spoofed message detection, but this is the reality of protocols that do not include any sort of authentication or integrity checking mechanism.

ACARS Drama exists for every aviation fan to enjoy another perspective on the world of commercial aviation. We do not tolerate hate-speech, or any other discriminatory behavior on our platforms or tooling, and will remove anyone who doesn't treat others with respect.