{"id":50293158,"url":"https://github.com/mattcheramie/gophertrunk","last_synced_at":"2026-05-28T07:03:13.807Z","repository":{"id":355732649,"uuid":"1229361862","full_name":"MattCheramie/GopherTrunk","owner":"MattCheramie","description":"Pure-Go, cross-platform RTL-SDR scanner and audio processing toolkit.","archived":false,"fork":false,"pushed_at":"2026-05-26T17:13:46.000Z","size":30045,"stargazers_count":65,"open_issues_count":14,"forks_count":7,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-05-26T17:15:05.714Z","etag":null,"topics":["d-star","dmr","edacs","golang","ltr","nxdn","open-source","p25","rf","rtl-sdr","sdr","tetra"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MattCheramie.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"docs/support.md","governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"MattCheramie","patreon":null,"open_collective":null,"ko_fi":"Mrcheramie","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2026-05-05T01:01:05.000Z","updated_at":"2026-05-26T16:42:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/MattCheramie/GopherTrunk","commit_stats":null,"previous_names":["mattcheramie/gophertrunk"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/MattCheramie/GopherTrunk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MattCheramie%2FGopherTrunk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MattCheramie%2FGopherTrunk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MattCheramie%2FGopherTrunk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MattCheramie%2FGopherTrunk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MattCheramie","download_url":"https://codeload.github.com/MattCheramie/GopherTrunk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MattCheramie%2FGopherTrunk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33597808,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-28T02:00:06.440Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["d-star","dmr","edacs","golang","ltr","nxdn","open-source","p25","rf","rtl-sdr","sdr","tetra"],"created_at":"2026-05-28T07:03:09.716Z","updated_at":"2026-05-28T07:03:13.801Z","avatar_url":"https://github.com/MattCheramie.png","language":"Go","funding_links":["https://github.com/sponsors/MattCheramie","https://ko-fi.com/Mrcheramie","https://buymeacoffee.com/Mrcheramie"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/assets/gophertrunk-logo.png\" alt=\"GopherTrunk logo\" width=\"220\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eGopherTrunk\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003ePure-Go digital-trunking radio scanner engine for RTL-SDR · HackRF · Airspy · Airspy HF+.\u003c/strong\u003e\u003cbr\u003e\n  P25 · DMR · TETRA · NXDN · Motorola Type II · EDACS · LTR · MPT 1327 · dPMR · D-STAR · YSF.\u003cbr\u003e\n  Zero CGO, single static binary, headless daemon + Bubbletea TUI cockpit + browser web console.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/MattCheramie/GopherTrunk/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://github.com/MattCheramie/GopherTrunk/actions/workflows/ci.yml/badge.svg\" alt=\"CI\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/MattCheramie/GopherTrunk/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/MattCheramie/GopherTrunk?include_prereleases\u0026sort=semver\u0026color=155799\" alt=\"Release\"\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/MattCheramie/GopherTrunk?color=155799\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003ca href=\"go.mod\"\u003e\u003cimg src=\"https://img.shields.io/github/go-mod/go-version/MattCheramie/GopherTrunk?color=155799\" alt=\"Go version\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://goreportcard.com/report/github.com/MattCheramie/GopherTrunk\"\u003e\u003cimg src=\"https://goreportcard.com/badge/github.com/MattCheramie/GopherTrunk\" alt=\"Go Report Card\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://gophertrunk.org\"\u003e\u003cimg src=\"https://img.shields.io/badge/docs-gophertrunk.org-155799\" alt=\"Docs\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## What is this?\n\nGopherTrunk is a software-defined-radio scanner that follows digital\ntrunked-radio voice calls and decodes them to audio. It runs on a\npool of RTL-SDR (every osmocom tuner), HackRF (One / Jawbreaker /\nRad1o), Airspy R2 / Mini, and Airspy HF+ dongles, has no C\ndependencies at build or runtime (no `librtlsdr` / `libhackrf` /\n`libairspy` / `libairspyhf` / `libusb` / `libasound2` /\n`libmp3lame`), and ships as a single ~10 MB static binary for Linux,\nmacOS, and Windows.\n\nCompleted calls stream to Broadcastify Calls, RdioScanner, OpenMHz,\nand live Icecast / ShoutCast mountpoints out of the box. Why does\nthis exist? Read **[The Story of GopherTrunk](https://gophertrunk.org/story.html)**.\n\n## Quick start\n\n```sh\n# Linux x86_64 — see https://gophertrunk.org/downloads.html for macOS, Windows, ARM64.\nVERSION=v0.2.4\ncurl -L -o gophertrunk.tar.gz \\\n  https://github.com/MattCheramie/GopherTrunk/releases/download/${VERSION}/gophertrunk-${VERSION}-linux-amd64.tar.gz\ntar xzf gophertrunk.tar.gz \u0026\u0026 cd gophertrunk-${VERSION}-linux-amd64\ncp config.example.yaml config.yaml\n./gophertrunk version\n# Plain `./gophertrunk` (no subcommand, on a TTY) drops into the\n# interactive launcher: pick [1] TUI, [2] Web, or [3] Headless.\n# Skip the prompt with -tui / -web / -headless.\n./gophertrunk -config config.yaml\n```\n\nWindows users get a one-click installer that bundles Zadig for\nWinUSB driver setup; macOS users get notarised tarballs for Apple\nSilicon and Intel. Full per-OS recipes at\n**[gophertrunk.org/downloads.html](https://gophertrunk.org/downloads.html)**.\n\n## Features\n\n- **Trunked control-channel decoders** — P25 Phase 1 + Phase 2 (full\n  TIA-102 chain), DMR Tier II + Tier III (vendor-aware: Capacity\n  Plus / Capacity Max grants and rest-channel tracking), NXDN,\n  Motorola Type II / SmartZone, EDACS / GE-Marc, LTR, MPT 1327,\n  dPMR Mode 3, TETRA TMO. Amateur-radio: D-STAR and Yaesu System\n  Fusion.\n- **POCSAG paging** — protocol layer for the dominant wireline\n  FSK pager protocol (CCIR 584): BCH(31,21) FEC, batch carve-up,\n  numeric (5 BCD/codeword) + alphanumeric (7-bit packed ASCII)\n  decoders. Foundation for fire / EMS dispatch text alongside\n  the trunked-voice pipeline; DSP wiring follows in the next PR.\n  See [docs/pocsag.md](docs/pocsag.md).\n- **APRS / AX.25 packet** — end-to-end pipeline for the\n  amateur-radio APRS metadata bus (position beacons, messages,\n  bulletins, status). Bell-202 AFSK DSP frontend (FM demod →\n  FFSK tone discriminator → symbol-time recovery → NRZI →\n  HDLC framer), AX.25 frame parser with CRC-16-CCITT, APRS\n  info-field decoders, plus `events.KindAPRSPacket` bus event,\n  SQLite `aprs_log`, `GET /api/v1/aprs/packets`, and `/aprs`\n  web panel. See [docs/aprs.md](docs/aprs.md).\n- **Pure-Go voice path** — IMBE (P25 Phase 1) and AMBE+2 (P25\n  Phase 2 / DMR) vocoders in Go, no DVSI / mbelib dependency.\n  Per-call WAV + raw-frame sidecars; live PCM playback via direct\n  ALSA / WASAPI / CoreAudio.\n- **Pure-Go SDR drivers** — RTL-SDR, HackRF, Airspy R2 / Mini,\n  Airspy HF+ family. USB transport on Linux (USBDEVFS), Windows\n  (WinUSB), macOS (IOKit). USB-disconnect self-healing recovers\n  dongles that drop off the bus and re-enumerate without\n  restarting the daemon. See\n  [docs/hardware.md](docs/hardware.md).\n- **Remote rtl_tcp SDRs** — Mount any number of `rtl_tcp`\n  endpoints as virtual tuners alongside local USB dongles. The\n  SDR can live on a Raspberry Pi at the antenna while the daemon\n  runs on a beefier host; one entry per remote in `sdr.rtl_tcp`.\n- **Live spectrum / waterfall** — In-browser FFT waterfall served\n  off the same IQ stream the trunking decoder consumes. New\n  `internal/sdr/iqtap` multi-consumer fan-out lets future\n  trunking-adjacent decoders (paging, AIS, ADS-B, ...) tap the\n  same source without disturbing CC decode. `GET /api/v1/spectrum/devices`\n  + `WS /api/v1/spectrum/stream`; web panel under `/spectrum`.\n- **CC Activity panel** — focused web view of the trunked control-\n  channel chatter (grants, affiliations, registrations, patches,\n  talker aliases, CC lock / loss). Pure filter over the events\n  stream with per-row payload rendering; web panel at `/cc`. RIDs\n  in the feed are clickable chips that pivot into the per-radio\n  detail view.\n- **Radio IDs panel** — per-radio (subscriber-unit) entity browser\n  with the same shape as Talkgroups. Merges the operator-configured\n  alias catalogue (per-system `rid_alias_file` CSV or JSON: alias,\n  owner, tag, group, priority, lockout, watch) with the live\n  affiliation tracker (last talkgroup, last seen, call count,\n  decoded talker alias). Detail modal pulls the last 50 calls for\n  the RID from the persisted call log. Web panel at `/rids`; REST\n  at `/api/v1/rids`; gRPC `RIDService`. Talker-alias decoders\n  cover the Motorola vendor TSBK form (control channel) and the\n  Motorola voice-channel LCs (P25 Phase 1 LDU1 LCO 0x15 header\n  + N × LCO 0x17 data blocks, run through Motorola's\n  reverse-engineered alias cipher).\n- **Constellation viewer** — live IQ scatter visualization that\n  taps the same broker the trunking decoder reads. Useful for\n  identifying signal shape (PSK / QPSK / FSK / C4FM / AM /\n  noise), spotting frequency offset, and checking demod /\n  equalizer health. Decimated to 2 ksps for the wire; canvas\n  scatter with energy banner. Web panel at `/constellation`.\n- **Bookmarks / frequency manager** — UI-managed conventional\n  channel list (marine VHF, NOAA weather, FRS/GMRS, repeater\n  outputs, public-safety fall-back channels) stored in the\n  daemon's SQLite database. Edit / create / delete from the web\n  panel under `/bookmarks`; REST at `/api/v1/bookmarks`.\n- **One dongle, many carriers** — `role: wideband` pins a single\n  SDR to a centre frequency and runs an internal channelizer so\n  one dongle decodes every DMR Tier II conventional repeater, DMR\n  Tier III control channel, P25 Phase 1 control channel, AND P25\n  Phase 2 control channel that fit inside its IQ bandwidth (e.g.\n  several 12.5 kHz carriers inside a 2.4 MHz IQ window). Mix\n  protocols on the same dongle.\n- **One dongle, control + voice** — with `voice_taps: N` on a\n  wideband entry, the daemon allocates per-grant DDC tuners from\n  the dongle's IQ stream so trunked voice grants (DMR T3, P25\n  Phase 1, P25 Phase 2) decode inline on the same SDR that's\n  already hosting the control channel — no separate `role: voice`\n  dongle needed for grants inside the wideband window. Out-of-\n  window grants spill over to a physical voice SDR when present.\n  See [docs/hardware.md](docs/hardware.md) and\n  [samples/dmr-tier2-multichannel/](samples/dmr-tier2-multichannel/).\n- **DSP** — Polyphase channelizer, Kaiser / RRC / Gaussian FIRs,\n  FM / C4FM / GFSK / FFSK / DQPSK / π/4-DQPSK / π/8-H-DQPSK\n  demods, Mueller-Müller + Gardner clock recovery, LMS + CMA\n  equalizers, diversity combining.\n- **APIs** — gRPC + HTTP/SSE + WebSocket; optional TLS +\n  bearer-token auth on mutations; Prometheus `/metrics`; pure-Go\n  SQLite call log; in-process pub/sub event bus.\n- **Hamlib `rigctld` integration** — optional TCP server speaking\n  the standard Hamlib wire protocol so loggers, satellite\n  trackers, and amateur-radio tooling (Cloudlog, GridTracker,\n  PSTRotator, `rigctl(1)`) can read and set the control SDR's\n  frequency. RX-only backend; see\n  [docs/rigctld.md](docs/rigctld.md).\n- **Outbound call streaming** — Broadcastify Calls, RdioScanner,\n  OpenMHz, live Icecast / ShoutCast with pre-encoded silence keep-alive.\n  Pure-Go MP3 encoder. See `internal/broadcast`.\n- **Baseband recording + offline replay** — Two-channel 16-bit WAV\n  capture and a replay driver that mounts captures back into the\n  SDR pool as virtual tuners. Looping replay simulates a\n  continuous source.\n- **Operator surfaces** — Bubbletea TUI cockpit with 12 panels,\n  pure-browser React SPA web console, runtime config editing via\n  `PATCH /api/v1/settings`, RadioReference PDF / CSV importer with\n  a config-builder wizard.\n- **Location + affiliation** — NMEA-0183 GGA / RMC over the air\n  decoded into a SQLite `location_log`; protocol-agnostic\n  affiliation tracker fed from grants / registrations / affiliation\n  events.\n\nFor the full per-protocol FEC chain reference, receiver internals,\nframe layouts, and API routes, see\n[docs/architecture.md](docs/architecture.md) and\n[docs/opt-in-features.md](docs/opt-in-features.md).\n\n## Status snapshot\n\nOnce a `grant` event lands on the bus, the engine + recorder pipeline\nruns end-to-end: voice device is allocated, the composer pulls IQ →\nPCM, the recorder writes a WAV, the call is logged to SQLite, and\nthe API + TUI surfaces all light up. Every trunked control\nmodulation in the Features list has an end-to-end IQ → CC chain\nshipping. SDRtrunk-parity subsystems (outbound streaming, baseband\nrecording, GPS / location, affiliation tracking, decoded-message\nlog, per-talkgroup policy) all ship.\n\n**Remaining gaps:**\n\n- **Digital-voice composer chains.** FM, DMR, P25 Phase 1 / 2 decode\n  to audio. NXDN, dPMR, TETRA, YSF, D-STAR voice (plus EDACS\n  ProVoice) are followed and logged but not yet turned into PCM.\n- **Additional SDR validation.** HackRF / Airspy / HF+ drivers\n  exercise the documented USB vendor protocols under unit tests\n  against a mock transport; on-air validation against attached\n  hardware is the documented follow-up.\n- **FEC inner-layer real-air validation.** NXDN per-protocol\n  interleaver and TETRA on-air recovery margins need live captures\n  to characterise.\n- **Vocoder level calibration** awaits reference WAVs in\n  `internal/voice/{imbe,ambe2}/testdata/`.\n\nThe long-form status, per-protocol detail, and shipping-vs-pending\nchecklist live in **[docs/status.md](docs/status.md)**. Near-term\nplans live in **[docs/roadmap.md](docs/roadmap.md)**. Released work\nlives in **[CHANGELOG.md](CHANGELOG.md)**.\n\n## Build from source\n\n```sh\nmake dist     # SPA + daemon — single binary that serves the web console at /\nmake build    # Go-only — fast iteration; daemon shows a helpful 404 at / until bundled\nmake test     # go test -race ./...\nmake vet      # go vet ./...\nmake integration  # daemon end-to-end test (no SDR required)\n```\n\nThe per-protocol \"lights up\" integration tests\n(`make integration-cc-\u003cproto\u003e`) and the DVSI hardware-backend tests\n(`make test-dvsi`) are documented in\n[`CONTRIBUTING.md`](CONTRIBUTING.md).\n\nA bare `go build ./cmd/gophertrunk` works too — the binary\nauto-stamps its version line from Go's built-in VCS info. Useful\nwhen attaching a log to an issue and you want the commit hash in\nthe build-info line.\n\n### Docker\n\n```sh\ndocker compose up -d\ncurl -s http://localhost:8080/api/v1/health\ncurl -s http://localhost:8080/metrics | grep gophertrunk_build_info\n```\n\nUSB pass-through recipe and the operator hardening playbook (TLS,\nbearer-token auth, Prometheus catalogue, smoke tests) live in\n[docs/hardening.md](docs/hardening.md).\n\n## Documentation\n\nOperator-facing docs live at **[gophertrunk.org](https://gophertrunk.org)**\n(rendered from this `docs/` tree):\n\n- **Install** — [Downloads](https://gophertrunk.org/downloads.html) ·\n  [Hardware](docs/hardware.md) ·\n  [Linux](docs/install-linux.md) ·\n  [macOS](docs/install-macos.md) ·\n  [Windows](docs/install-windows.md)\n- **Operate** — [Launcher](docs/launcher.md) ·\n  [Windows user guide](docs/user-guide-windows.md) ·\n  [TUI](docs/tui.md) ·\n  [Web console](docs/web.md) ·\n  [Live config editing](docs/live-edits.md) ·\n  [Import (PDF / CSV)](docs/import.md) ·\n  [Hardening](docs/hardening.md)\n- **Reference** — [Architecture](docs/architecture.md) ·\n  [Vocoders](docs/vocoders.md) ·\n  [Voice calibration](docs/voice-calibration.md) ·\n  [DMR encryption](docs/dmr-encryption.md) ·\n  [Opt-in features](docs/opt-in-features.md) ·\n  [Status](docs/status.md) ·\n  [Roadmap](docs/roadmap.md) ·\n  [Cutting a release](docs/release.md)\n- **Project metadata** — [CHANGELOG](CHANGELOG.md) ·\n  [CONTRIBUTING](CONTRIBUTING.md) ·\n  [SECURITY](SECURITY.md) ·\n  [THIRD_PARTY_LICENSES](THIRD_PARTY_LICENSES.md)\n\n## Support the project\n\nGopherTrunk is developed in the open and powered entirely by\ncommunity support. If it's useful to you, please consider chipping\nin:\n\n- [Sponsor on GitHub](https://github.com/sponsors/MattCheramie)\n- [Tip on Ko-fi](https://buymeacoffee.com/Mrcheramie)\n\nMore ways to help: [docs/support.md](docs/support.md).\n\n## License\n\nSee [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattcheramie%2Fgophertrunk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmattcheramie%2Fgophertrunk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattcheramie%2Fgophertrunk/lists"}