Licensed land-mobile sites, airport frequencies, amateur repeaters and satellites, split by map square, for Ferrite Console's channel library. Served at https://data.ferritefw.dev.
tafl/: Canada, from ISED's Spectrum Management System extract (the TAFL). Licence: Open Government Licence – Canada (tafl/LICENCE-DATA.md).fcc/: US, from the FCC's ULS weekly files (Land Mobile – Private and Commercial). Public domain in the US (fcc/LICENCE-DATA.md).airports/: the world's airport frequencies (108-137 MHz), from OurAirports. Public domain (airports/LICENCE-DATA.md).repeaters/: the world's operational analog FM amateur repeaters on 2 m, 1.25 m and 70 cm, from HearHam (user-contributed). Free to use in applications, per HearHam.com; no formal data licence (repeaters/LICENCE-DATA.md).satellites/: the amateur satellites a 2 m / 70 cm FM handheld can work: orbit elements from CelesTrak (public data) and transponders from SatNOGS DB. CC BY-SA 4.0, and the derived file is shared the same way (satellites/LICENCE-DATA.md).common/: shared code: bands, name shortening, emission modes, categories, tiles. Tests:python3 -m unittest.build.py: builds every source intoout/..forgejo/workflows/publish.yml: the daily build, on Forgejo's runner at home (the FCC refuses GitHub's runners). Force-pushesout/to thegh-pagesbranch here.- Repeaters, airports and satellites are rebuilt every day.
- The TAFL and the FCC are rebuilt only when their upstream files change (a header-only check of Last-Modified, kept as
upstreamin the top-level index); otherwise their published copy is kept.--forcebuilds everything. stats.csvgets a line per source each time it is built, so the TAFL's and the FCC's lines mark their releases.
.github/workflows/pages.yml: the same by hand on GitHub, as a fallback (Canada and airports refresh; the FCC keeps its last copy).landing.py: writes the landing page (index.html) from the build's index.check.py: both workflows' check that each source looks whole before publishing.
python3 build.py --cache ~/ferrite-data-cache # reuses cached downloads
python3 build.py --cache ~/ferrite-data-cache --download # fetches fresh copies
python3 build.py --cache ~/ferrite-data-cache --only tafl- Python 3.9 or newer, standard library only.
- Downloads: TAFL 64 MB, FCC 505 MB (zips read in place, never unzipped), OurAirports about 15 MB of CSV, HearHam about 10 MB of JSON, CelesTrak and SatNOGS about 6 MB of JSON.
- Keep the cache outside the repository.
- About 1.5 minutes and 1.6 GB of memory (the FCC join).
- A source that fails to build (a refused download) keeps its last published copy from data.ferritefw.dev, or is left out if there is none; the others still deploy.
index.json: build date and the sources (title, source date, licence, attribution, row and tile counts).<source>/index.json: the same for one source, plusformat,level(2 or 4: the tiles' grid size), andtiles: tile -> row count.- Airports' and repeaters' tiles are 2-character fields (
airports/CN.json, 20 x 10 degrees): the data is small. - The other sources' tiles are 4-character grid squares (
CN89.json). A square over 6,000 rows (big cities) is published only as its 6-character subsquares (CN89kg.json) and listed insplit. Empty subsquares have no file. <source>.zip: the whole source in one download (its index and every tile), for apps that keep everything offline. The top-levelindex.jsongives its size and SHA-256.- A tile (
format:columnar-1) is columns, one entry per row, in latitude, longitude, frequency order:n: the tile's licensee names, each once, shortened to 16 characters.c: the row's name, as an index inton.a,o: latitude and longitude in 1/100,000 degree (WGS84), each the difference from the row before (the first from 0).f: transmit frequency in half kHz (469.9875 MHz is 939975), the difference from the row before.m: mode: 0 analog FM under 14 kHz (NFM), 1 analog FM 16-20 kHz, 3 unknown. Missing when every row is unknown (airports: airband is AM). 2 (digital or data only) is reserved: digital-only licences are left out, as Ferrite has no digital modes.s: 1 when the frequency is a mobile's (often a repeater input, or the centre of a mobile area); 0 for bases, repeaters and fixed stations. Missing when every row is 0.k: the licensee's category: 0 business or other, 1 public safety, 2 transit and rail, 3 utilities, 4 marine and ports, 5 schools, 6 government. From the FCC radio service where it decides (the Public Safety Pool), else keywords in the licensee's full name (common.category). Missing when every row is 0 (airports never have it).d: repeaters only: the offset, input minus output, in half kHz (-600 kHz is -1200; 0 simplex). Not a difference: each row's own value. The radio transmits onf + d.pn,pe,pd: repeaters only: tones.pnlists the tile's tones once;pe(encode: the tone to transmit to open the repeater) andpd(decode: the tone it sends, for tone squelch) index it (-1: none). A tone is CTCSS in Hz with one decimal (100.0), or DCS asDand three octal digits (D023;D023Iinverted). HearHam's own spellings (100,151.4*,DCS 43,NAC293/100.0) are read into these forms (common.tone); a value that's no standard tone is none. Missing when a tile has no tones.tn,t: the frequency's use (airports:TWR,GND,ATIS,CTAF, ...), as OurAirports writes it:tnlists the tile's uses once,tindexes it (-1: none). Missing when a source has none.
- To read a tile: keep running sums of
a,oandf; latitude = a / 1e5, longitude = o / 1e5, MHz = f / 2000. - Bands: 136-174 and 400-470 MHz; airports 108-137 MHz; repeaters 136-174, 219-225 and 400-470 MHz (output and input both).
- Repeaters'
mis 0 where HearHam says NFM, else unknown: its FM doesn't say how wide (12.5 kHz in Europe, 20 in North America). stats.csv(at the root): one line per source per build:build_date,source,rows, and for repeaters the raw feed'sfeed_operational(entries marked operational),feed_max_id(its highest id) andfeed_entries(every entry); empty for the others. Each build carries the live site's earlier lines forward and adds its own (a rebuild the same day replaces that day's).- Rows are unique by name, frequency and position.
satellites/index.jsonis the usual source index (rowsis the satellite count,tilesis{"sats.json": count}), plusnewest_epochandoldest_epoch.satellites/sats.json(format:satellites-1, about 15 kB), not tiles:built(date),licence,attribution,newest_epoch,oldest_epoch(the elements' ISO epochs, UTC), andsatellites, ordered by NORAD number.- A satellite:
id(NORAD catalogue number),name(CelesTrak's),short(16 characters at most: the alias in parentheses,AO-7, else the name),status,tle(two lines, 69 characters, made from the elements),elements,transmitters. status:active(SatNOGS: in orbit with an alive transmitter we keep),unknown(its elements are over 30 days older than the newest: probably silent),inactive(reserved: dead and re-entered satellites are left out).elements(CelesTrak's OMM, for SGP4):epoch,n(revs per day),e,i,raan,w(argument of perigee),m(mean anomaly; angles in degrees),bstar,ndot,nddot,rev(at epoch).- A transmitter:
desc(SatNOGS's),mode(FM: voice repeater or transponder;APRS: 1200 baud AFSK digipeater),upanddown([low, high]in Hz; equal for a single channel),tone(the uplink CTCSS in Hz as text,"67.0", read from the description; null when it names none),invert(SatNOGS's flag). arm_tone(optional, FM only): the CTCSS tone in Hz as text ("74.4") to send for about 2 s on the first key-up of a pass, beforetone, to arm the transponder. Missing when it needs none: only SO-50 has one. From a small curated table insatellites/build.py(AMSAT's published tones), which may also fill atoneSatNOGS lacks. Readers ofsatellites-1that don't know it ignore it.- All of a satellite's working transmitters are listed, most useful first: FM voice with a tone, other FM, then APRS (then by downlink).
- Kept: SatNOGS satellites in orbit, with CelesTrak elements, and an alive, active FM or 1200 baud AFSK transmitter that has an uplink, every frequency inside 144-148 or 430-440 MHz. SSB or linear, CW, data and beacon transmitters are dropped.
- Joined by NORAD number. Fewer than 5 satellites fails the build (the last published copy stays).
- Rebuilt every day; the Changes chart counts satellites and transmitters added or removed, not element changes. CelesTrak asks for no more than one fetch per update: once a day is fine.
- GitHub Pages from the
gh-pagesbranch (one fresh commit per build), custom domaindata.ferritefw.dev(CNAME). - The repository is on GitHub (FerriteFW/data) and Forgejo (ferrite/data); push to both.
- Pages sends
Access-Control-Allow-Origin: *, so any site can fetch the tiles. - Wanted later, if a proxy (e.g. Cloudflare) goes in front: allow only
https://console.ferritefw.dev, the Tauri app (tauri://localhost,http://tauri.localhost) andlocalhostfor development. - A failed build deploys nothing: the last good copy stays up.
- Scripts: PolyForm Noncommercial 1.0.0, Alex Harvey (LICENSE.md).
- Data: each source keeps its own licence (above).