Skip to content

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_lib and selected nrsc5 source 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.