eatc-airlines

A command-line tool and API for retrieving scheduled and historical flight data and generating Endless ATC airline configurations.

Features

• Fetch scheduled and past flights (up to 7 days, or 1 year with a subscription) from AirNav Radar.
• Convert flight data into airlines configuration for Endless ATC custom airspace.
• Analyse traffic flow statistics from flight data.
• Simple, fast, and works offline once data is fetched.
• No API key or authentication necessary.

Installation

Requirements

• Node.js and NPM (Latest LTS version recommended).
• A terminal, Command Prompt (cmd.exe), or similar for executing shell commands.

Install Globally

Use your preferred terminal application to run the following command:

npm install -g eatc-airlines

Android Installation (via Termux)

1. Install Termux, a terminal emulator for Android:

2. Install Node.js and NPM:

   pkg install nodejs

3. Install eatc-airlines:

   npm i -g eatc-airlines

Updating

To update to the latest version:

npm install -g eatc-airlines@latest

Usage

Fetching Flight Data

Retrieve scheduled and historical flights (up to 7 days in the past) for a specific airport.

Command:

eatc-airlines fetch <icao> [path]

• <icao> – ICAO airport code (e.g., EGLL for Heathrow).
• [path] – (Optional) File path to save the data. Defaults to a unique file in the current directory.

Example:

mkdir EGLL && cd EGLL
eatc-airlines fetch EGLL

[!CAUTION] Requests might be blocked by Cloudflare. Please see #52.

[!NOTE] The fetched JSON files should not be manually edited unless you know what you are doing.

Generating airlines Configuration for Endless ATC

Convert fetched flight data into an airlines configuration for Endless ATC.

Command:

eatc-airlines gen <paths...>

• <paths...> – One or more JSON files or directories containing flight data.

Example:

# Convert all flight data in the current directory
eatc-airlines gen .

# Convert all files in a specific directory
eatc-airlines gen ./EGLL

# Convert specific files
eatc-airlines gen file1.json file2.json

Analysing Traffic Flow

Generate basic statistics on traffic flow from fetched flight data.

Command:

eatc-airlines flow <paths...>

Uses the same arguments as the gen command.

Example:

eatc-airlines flow ./EGLL

Contributing

This project is free and open-source under the GNU General Public License, Version 3. Contributions are welcome!

For inquiries or collaboration, contact:

| Matrix | @zefir:cloudnode.pro | |--------|------------------------------------------------------------------| | E-mail | [email protected] |

This project is not authorised, endorsed, or associated with AirNav Radar or Endless ATC in any way.