Skip to content

Command line options

Oona Räisänen edited this page Jun 20, 2024 · 12 revisions

Input options

If no options are given, the input is assumed to come via stdin as raw 16-bit signed-integer PCM at 171 kHz.

short long argument description
-c --channels number Number of channels in the raw input signal if more than 1. Channels are interleaved streams of samples that are demodulated independently.
-f --file file name Use an audio file as MPX input. All formats readable by libsndfile should work; the file will be resampled if necessary.
-i --input {bits, hex, mpx, tef} Decode stdin as FORMAT (see Input formats for more info).
-r --samplerate number Set stdin sample frequency in Hz. Will use CPU effort to resample if this differs from 171000 Hz.

Output options

short long argument description
-e --feed-through Echo the input signal to stdout and print decoded groups to stderr.
-E --bler Display the average block error rate, or the percentage of blocks that had errors before error correction. Averaged over the last 12 groups. For hex input, this is the percentage of missing blocks.
-p --show-partial Print multi-group data such as PS names, RadioText, and alternative frequencies as soon as it arrives, even if not fully received. Useful for real-time displays or noisy conditions. Data is in partial_{ps,radiotext,alt_kilohertz}
-R --show-raw Show raw group data as hex in the JSON stream.
-t --timestamp format string Add time of decoding to JSON or hex groups; see man strftime for formatting options (or try "%c").
-u --rbds RBDS mode; use North American program type names and "back-calculate" the station's call sign from its PI code. Note that this calculation gives an incorrect call sign for most stations that transmit TMC; and that the calculation does not make sense outside North America.
-x --output-hex Output hex groups in the RDS Spy format, suppressing JSON output.

General

short long argument description
-l --loctable directory Load a TMC location table from a directory in TMC Exchange format. This option can be specified multiple times to load several location tables.
--no-fec Disable forward error correction; always reject blocks with incorrect syndromes. In noisy conditions, fewer errors will slip through, but also fewer blocks in total. See wiki for discussion.
-v --version Print version string and exit.