Skip to content

Repository files navigation

Grayline

Amateur radio digital mode applications in Rust, over a shared signal processing and platform core.

Each mode ships as its own application rather than as one multimode program, because what a mode needs on screen follows from the kind of signal it carries: an image mode wants a raster and a receive library, a text mode wants a waterfall and a transmit buffer. The core underneath them is shared; the interfaces are not.

Applications

Application Directory Status
Grayline SSTV apps/sstv/ Released
Grayline WEFAX apps/wefax/ Receive implemented
Grayline RTTY Planned
Grayline PSK Planned

apps/web-demo/ builds the SSTV receive path for WebAssembly, running at https://rssstv.kb10uy.dev/.

Layout

  • apps/ — one directory per application, plus the browser demo.
  • crates/ — the libraries. Directory names carry no prefix; the packages they hold are named grayline-*.
  • tools/ — development command-line tools that are not shipped. One directory per mode, named <mode>-cli, holding the package grayline-<mode>-cli and the binary gl-<mode>.
  • assets/ — data shipped outside any one crate, such as the ported MMSSTV templates under assets/templates/.
  • docs/memo/ — development documentation, divided by subject and indexed by docs/memo/README.md.
  • docs/help/ — the operator's manual the release archives carry.
  • docs/reference/mmsstv/ — the original MMSSTV source, a submodule kept as the behavioral reference.

The libraries divide into a mode-independent core — dsp, tone-tx, audio, rig, and shell — and the crates implementing one mode, which carry that mode's name. shell is what an application is built out of before it knows which signal it carries: the window, the platform integration, the message lookup, and the log. crates/sstv-rx still holds the SSTV receive front end whole; the parts of it that are not specific to SSTV move down into the core as the second mode needs them.

Building

cargo build --workspace
cargo test --workspace

License

LGPL-3.0-or-later. See LICENSE.

Special Thanks

About

Amateur Radio Software Stack on Rust

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages