Pack formats
Exactly what a pyEfis device reads from each pack, generated from the published packs, never written by hand. Machine-readable index: index.json.
| pack kind | kind | container | schema_version | generated from |
|---|---|---|---|---|
| Airports (regional) | airports | SQLite | 1 | airports-canada 2026.06 |
| Roads & highways | highways | SQLite | 1 | highways-conus 2026q3r1 |
| Navaids & airways | navaids | SQLite | 1 | navaids-conus 2612 |
| Airports & runways | navdata | SQLite | 1 | airports-conus 2612 |
| Obstacles | obstacles | SQLite | 1 | obstacles-conus 261001 |
| Procedures & airways | procedures | SQLite | 1 | procedures-conus 2612 |
| Terrain | terrain | zip | 1 | terrain-alaska 2024edr4, terrain-canada-east 2024edr4, terrain-canada-west 2024edr4, terrain-mexico-central-america 2024edr4, terrain-mosaic 2024edr4, terrain-us-central 2024edr4, terrain-us-east 2024edr4, terrain-us-south 2024edr4, terrain-us-west 2024edr4 |
| Water | water | SQLite | 1 | water-na 2026q4r1 |
The contract
Every pack carries a pack_meta header (a pack_meta(key, value)
table in an SQLite pack, a pack_meta.json member in a zip pack) whose
schema_version names the version of its format. Today it is the version of the
pack_meta header itself, except for the kinds below, whose build reads it from
the pack's content. Editions packed before a kind's rule existed declare 1 whatever they
carry, so a reader should still check for the tables and columns it needs.
| kind | schema_version | what the pack carries |
|---|---|---|
highways | 1 | columns of highway_lines: fclass, id, max_lat, max_lon, min_lat, min_lon, verts |
highways | 2 | adds flags, ref |
procedures | 1 | tables: airway_legs, airways, legs, procedures, transitions |
procedures | 2 | adds msa |
procedures | 3 | adds grid_mora, grid_mora_bands |
procedures | 4 | adds fas_blocks |
The tables and columns on these pages are public and versioned. Readers should look up
columns by name and ignore tables and columns they do not know: new ones are added without
a schema_version change. Removing or changing one is a format change.
What the build enforces today: each pack's test record (check ROW-003) fails when a table
that the previous edition had is gone and schema_version did not change. A
removed or retyped column is not yet checked by the record; the device acceptance check
(ACC-001) only covers the columns pyEfis itself reads.
The pack formats described here are published under the Apache License 2.0, so anyone may write a tool that reads or writes them. The text of these pages is CC BY 4.0. The data inside each pack carries its own licence, named in the pack's manifest entry (license, license_url) and its attribution string.
The catalog: manifest.json
manifest.json lists every pack (manifest_version
1). It is signed: manifest.json.minisig is an ed25519
minisign signature checked against the public key in the repository
(keys/minisign.pub), and each pack is checked against the sha256 its entry
carries before it is installed. Each entry in packs has these fields:
| field | description |
|---|---|
id | Stable pack id, e.g. obstacles-conus. A device subscribes to ids. |
kind | Pack kind; decides which reader opens the pack and where it installs. |
cycle | Edition: an AIRAC cycle (2612), a date (261001) or an edition tag (2026q3r1). A hyphen-suffixed cycle is a test build and never outranks the canonical one. |
bytes | Size of the pack file. |
sha256 | SHA-256 of the pack file; checked before the pack is installed. |
url | Where to download the pack. |
effective | First day the edition is current (ISO date). Absent for packs with no currency window. |
expires | First day the edition is no longer current (ISO date, exclusive). Absent means it does not expire. |
regions | Coverage regions the pack belongs to (see the manifest's regions block). |
attribution | Attribution text to show the pilot. |
license | Short licence tag for the data (an SPDX id, LicenseRef-*, or e.g. ODbL-1.0). Empty means unspecified. |
license_url | Link to the licence's full text. |
min_pyefis | Oldest pyEfis version that can read this pack, when there is one. |
tiles_bbox | Bounding box of the pack's tiles: [lat_min, lon_min, lat_max, lon_max]. |
report_url | The pack's test record (pack-report/1), bound to the signature by report_sha256. |
report_sha256 | SHA-256 of that test record. |
origin | Where the data came from: federal, community or user-supplied. A pedigree label, not a score. |
notice | The standing use notice. |
build_commit | The makerplane-data commit that built the pack. |
The header inside every pack: pack_meta
A pack still identifies itself when it is copied away from the catalog. Its
pack_meta fields are a subset of its manifest entry:
| field | description |
|---|---|
id | Stable pack id; equals the manifest entry's id. |
kind | Pack kind; equals the manifest entry's kind. |
cycle | Edition; equals the manifest entry's cycle. |
effective | First day current (ISO date); absent for packs with no currency window. |
expires | First day no longer current (ISO date, exclusive); absent means it does not expire. |
attribution | Attribution text to show the pilot. |
license | Short licence tag for the data. Empty means unspecified. |
license_url | Link to the licence's full text. |
pyefis_commit | Full pyEfis commit sha whose tools built the pack. Absent for packs built by no pyEfis code and for editions published before CERT5a. |
schema_version | Version of the pack's format (see The contract). |
Experimental / Amateur-Built use only. Not certified. This data is provided as-is with no warranty and any use of the data is at your own risk.