Skip to content

About

Translate airport codes to geographic information

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

✈️ Airport Code Lookup Tool

Screenshot 2026-06-17 at 10 46 49

A lightweight Zsh utility script to quickly lookup airport names, cities, and countries from your terminal using standard three-letter IATA codes (e.g., SFO) or four-letter ICAO codes (e.g., KSFO).

It securely caches the massive airportsdata dataset locally so lookups are lightning-fast after the first run.

🚀 Features

  • Dual Format Support: Accepts both IATA (LHR, DXB) and ICAO (EGLL, OMDB) codes.
  • Smart Input Sanitization: Automatically handles lowercase inputs and strips out trailing identifiers (e.g., sfo123 becomes SFO).
  • ASCII Map Visualization: Pass the --map flag to render an equirectangular ASCII world map directly in your terminal, pinpointing the exact location of the airport.
  • Offline First: Downloads the database once and saves it locally (~/.airport_codes_cache.csv) for subsequent instant lookups.

📋 Prerequisites

This script is optimized for macOS or any system running:

  • Zsh (Z Shell)
  • Python 3 (installed by default on modern operating systems)
  • curl (for the initial dataset download)

About

Translate airport codes to geographic information

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages