Sources and third-party components¶
Use this inventory to trace a decoder, dataset or browser dependency to its upstream source. The component notices and build manifests identify what ships.
Project license and import review¶
rfSentry uses GPL-3.0-or-later. The project license states the terms, and the license decision records why they were chosen. Upstream components retain their own notices.
components/rfsentry-web/THIRD_PARTY_LICENSES.md is the dependency/decoder
license register. Before an import or redistribution, record exact upstream
identity/version/revision, license and transitive inputs, whether code is
linked/WASM/vendored/patched or merely executed externally, attribution and
source-distribution requirements, local modifications, and codec patent or
hardware-vocoder considerations where relevant. Use that register, notices,
source provenance and build manifests together; a table row or manifest does
not establish compliance by itself.
Changing the project's licensing/distribution model needs explicit review of the dependency matrix before imports. A separate process or private deployment does not automatically resolve every obligation. Current selected-source integrations are inventoried below; unbundled candidates are separate.
Decoder and protocol sources¶
| Upstream | Exact revision | Local use/path | Relationship | License |
|---|---|---|---|---|
| readsb | 3b5368a195e7006a98c428d05560b0b4baffd2ed |
decoders/adsb/rfsentry_adsb1090.c |
fractional 2.4 MS/s slicer and preamble logic adapted into RF Sentry ABI/parser policy | GPL-3.0-or-later |
| dump978-fa v11.1 | f40aa9a0d2d0a0067c0c628b44ba316f7049b8ce |
decoders/uat/rfsentry_uat978.c |
phase discriminator, sync, frame geometry, shortened RS adapted; no receiver/socket code | BSD-2-Clause; libfec portions LGPL-2.0-or-later |
| fisb-decode | c3d3b0473429336b1a98672b2e8b276c24d49765 |
src/aviation/uat978.ts |
APDU/DLAC/product geometry independently adapted; no Python runtime imported | BSD-2-Clause Plus Patent |
| goestools | 80ece1a7ab8a93fb5dfa50d47387ae7c4a8f2a73 |
decoders/goes/, SATCOM product parsers, public/satcom/ |
bounded physical/FEC and product behavior adapted; native receiver/filesystem code not shipped | BSD-2-Clause |
Phil Karn libfec |
version represented by pinned goestools/dump978 sources | GOES and UAT fixed-memory RS procedures | algorithm/source portions adapted | LGPL-2.0-or-later |
| libaec | 1.1.3 | src/satcom/ Rice decoder/tests |
TypeScript decoder independently adapted; upstream native encoder used for regression oracle | BSD-2-Clause |
| SatDump | 1aedd602055c154401384a8cc7876713bb371254 |
reference only | reviewed as independent GOES protocol oracle; not bundled | GPL-3.0 |
| WebFT8 / mfsk-core | b5ec75f59ac3d0aee82b87219b7fcfa5c262fa59 |
decoders/vendor/mfsk_web, decoders/vendor/wasm |
pinned FT8 Rust/WASM binding and loader | GPL-3.0-or-later |
| ft8_lib | 9fec6ca39886edbf96f4f5e71edc76da5074e871 |
decoders/vendor/ft8_lib |
vendored FT4 decode/message sources | MIT |
| Signal-Decoder | eac2c95026a3273c1dc1d52f894ed3b982f69a1e |
decoders/vendor/wrappers/ft8_wasm.c |
adapted Emscripten wrapper provenance | 0BSD |
| WSJT-X 3.0.2 | ccdfaf3c1c109010d15399674ce278167cfde848 |
qualification reference | official example WAVs/reference decoding, not runtime | GPL-3.0 |
| theori-io/nrsc5 3.2.0 | a5c09723b135327aeef157770caae9aebf597547 |
decoders/vendor/nrsc5 |
selected DSP/framing/FEC/metadata sources vendored; CLI/RTL/file/network paths excluded | GPL-3.0-or-later |
| FFTW | 3.3.10 | NRSC-5 build cache/static WASM input | hash-verified upstream archive, used for FFT processing | GPL-2.0-or-later |
| FAAD2 | 2.11.2 | NRSC-5 build with upstream HDC patch | hash-verified audio decoder input | GPL-2.0-or-later |
| Emscripten runtime | 3.1.69 | generated NRSC-5 browser host | generated runtime/loader | MIT OR NCSA |
| LLVM compiler-rt ASan | 19.1.7 | NRSC-5 diagnostic artifacts | statically embedded instrumentation | Apache-2.0 WITH LLVM-exception |
The full reviewed source hashes and qualification results are recorded in
components/rfsentry-web/decoders/vendor/PROVENANCE.md. Decoder catalog
notices ship under /decoder-notices/. Upstream NRSC-5 RF fixture content is
fetched by pinned hash into an ignored private test cache because its capture
has no redistribution grant.
Research candidates¶
This preserves the upstream research list from the original WEBSDR plan. It is not an import allowlist, license audit, current upstream feature-count survey or promise to ship those decoders. New integrations require exact revisions, transitive-license/codec review, browser/worker suitability, malformed-input tests and independent recorded-IQ qualification. Prefer suitable components and references over importing an entire application/backend.
| Project / source | Intended research | RF Sentry relationship |
|---|---|---|
| radiom | decoder inventory and adapter model | research only; its Node/container backend is not the appliance architecture |
| SDR++ | interaction and DSP architecture | research only; not the browser DSP runtime |
| SDRangel | channel/decoder plugin structure | research only |
| liquid-dsp | DSP components/algorithms | research candidate, not the current channelizer implementation |
| ft8_lib | weak-signal decode/message logic | pinned FT4 source already used; not the current FT8 engine |
| WSJT-X documentation | weak-signal reference behavior | pinned WSJT-X qualification evidence above; not a bundled runtime |
| multimon-ng | paging, signalling and tone paths | candidate, not current browser protocol support |
| Dire Wolf | packet-radio modem/application paths | candidate; qualify each intended protocol separately |
| libacars, dumpvdl2, dumphfdl | aviation messaging and application interpretation | planned candidates; current 1090ES/UAT sources are inventoried separately |
| rtl_433 | ISM protocol definitions and fixtures | candidate; GOES DCS parsing does not establish this RF integration |
| redsea | RDS/RBDS | candidate, not current analog-FM RDS support |
| nrsc5 | FM/AM HD Radio DSP, services and public objects | pinned selected source already used; wider qualification gates remain open |
| DSD-FME | digital voice/trunking | candidate; codec/vocoder and lawful-content constraints remain explicit |
| welle.io | DAB/DAB+ | candidate, not current browser support |
| gr-satellites | satellite/CCSDS/mission-specific protocols | candidate; shared GOES machinery does not qualify those RF profiles |
The original radiom note mentioned roughly 88 decoder paths and outstanding
real-world/rtl_tcp validation without pinning a revision. That is historical
research context, not a verified current count or an RF Sentry acceptance claim.
The requested-mode roadmap retains the full capability
scope; the generated catalog identifies actual modules.
Runtime libraries and browser assets¶
| Component | Version/source | Use | Distribution/license |
|---|---|---|---|
| React / React DOM | 18.3.1 | application UI | bundled JS, MIT |
| MapLibre GL JS | 6.8.0 | 2D/globe map and camera | bundled split runtime/worker, BSD-3-Clause |
| Astronomy Engine | 2.1.19 | Sun, Moon, sidereal orientation, terminator | bundled JS, MIT |
| satellite.js | 6.0.1 | SGP4/SDP4 propagation | bundled JS, MIT |
| SQLite WASM | 3.53.0-build1 | browser FCC SQLite/FTS5/OPFS | pinned local JS/WASM, Apache-2.0 |
| zip.js | 2.11.2 | streaming FCC archive import | pinned local JS, BSD-3-Clause |
| Mermaid | 12.1.0, mermaid-js/mermaid | offline documentation diagrams | vendored unmodified minified browser bundle at documentation/assets/vendor/mermaid/, MIT |
| MkDocs | 1.6.1 | documentation build | build only, BSD-2-Clause |
| Material for MkDocs | 9.7.7 | documentation theme/search | build output bundled locally, MIT |
Exact npm/Python transitive versions are pinned in package-lock.json and
documentation/requirements.lock. MkDocs, Node, Vite, TypeScript, and Vitest
are build/development tools, not appliance daemons.
Data and presentation sources¶
| Source | Exact identity | Local artifact/use | License/provenance |
|---|---|---|---|
| Natural Earth via world-atlas | world-atlas 2.0.2; vector 5.1.2 inputs with hashes | public/map/basemap/ generated GeoJSON/styles |
public domain |
| HYG Database v4.4 | 53e3df311869e813ace5f1ad2ec4ce909f13256c |
25,790 stars through visual magnitude 7.5 in stars-v1.bin |
CC BY-SA 4.0 |
| NASA SVS CGI Moon Kit | local LRO 1k texture, manifest SHA-256 b246064f… |
public/map/celestial/moon-lroc-1k.jpg |
NASA credit retained |
| wx-star C02 curve and C02/C13 LUT | goestools 80ece1a7…; Harry Dove-Robinson / wx-star |
public/satcom/ hash-verified false-color assets |
distributed in BSD-2-Clause goestools tree; original credit retained |
| CTY.DAT from WSJT-X | b4f9a431bcf6449df8f37b56de79d48b665b044c; source SHA-256 5dbff84c… |
public/enrichment/vendor/cty/ |
upstream MIT-style dataset notice |
| U.S. Census TIGER/Line/Gazetteer | updater-selected documented vintages | appliance-built local geocoder generations | U.S. Government public domain |
| CelesTrak GP elements | updater fetch with generation provenance | local orbital catalog | upstream data terms |
| SatNOGS DB transmitter data | independently fetched/joined by NORAD ID | local RF/transmitter enrichment | CC BY-SA 4.0 |
| FCC Amateur weekly archive | configured fixed public source | browser SQLite/OPFS corpus via streaming relay | U.S. public regulatory data; source metadata retained |
| FAA aircraft references | configured aviation updater inputs | versioned Pi-local enrichment artifacts | source-specific provenance retained in generation |
Modified versus unmodified¶
- Project-owned adapters and parsers are in RF Sentry source and identify the upstream algorithm/revision they adapt.
ft8_liband selectednrsc5source trees are vendored with RF Sentry wrappers/build patches documented beside them.- Prebuilt FT8/FT4 WASM artifacts are hash-pinned to their recorded sources and generated into content-addressed public names.
- Mermaid's production bundle is vendored unmodified with its license.
- Map, celestial, CTY, SQLite, zip, and wx-star inputs are hash-verified before copying or transforming.
- SatDump and the independent GOES recording are qualification references, not distributed runtime components.
When a source diverges, update this inventory, its local provenance manifest, notices, build hashes, and tests together. “Some library from GitHub” is not a revision and has never once helped reproduce a decoder.