Skip to content
Display an airport's incoming flights with the FlightAware v3 API and Flapper split-flap display simulator.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Display an airport's incoming flights with the FlightAware v3 API and Flapper split-flap display simulator.

Incoming Flights Example

That's just an animated gif - here is the actual animation. Note that the flights aren't up to date - it's just a static example.

Requires a FlightAware v3 API account. As of 2018-09, that's up to 500 queries per month free (one update every ~90 minutes), or an update every 18 minutes for $13/mo, or every 2 minutes for $50/mo.

Built with Flapper for the gorgeous split-flap display simulator. Built by David R. on Upwork - highly recommended for web projects.


Register for a FlightAware account, then sign up for v3 API access. You can use the free tier, but you'll be capped at 500 responses per month. If you choose a paid tier, configure your account so that it doesn't automatically upgrade to the higher tier - otherwise, when someone finds your web page, they might just leave it open and rack up a bill on your card.

Copy the env.php.sample file to env.php and edit it. FLIGHTAWARE API USER is your FlightAware username, and FLIGHTAWARE API KEY is the API key you were assigned during API registration. Keep those secret since someone else could rack up a heck of a bill with your account.

To set your airport, edit the index.php file. Look for this line:

$endpoint = "/json/FlightXML3/AirportBoards?airport_code=SAN&type=enroute&howMany=$limit";

And change the SAN airport code to your own airport code.

Upload the files to your web server. You probably don't want them in a publicly accessible place since any visitor can exhaust your API request limit.

Leave the web page open, and it'll automatically refresh itself every 10 minutes with the 3 closest flights to your airport.

Issues? Requests?

Incoming-flights works good enough for me, so before you file an issue or complaint, be ready to make the necessary code changes yourself. I'm sharing it here for folks to play with, but unfortunately I'm not able to do support. I welcome code contributions though.


Incoming-flights is licensed under the MIT License, as is Flapper.

You can’t perform that action at this time.