Skip to content

Configuring file outputs

Jump to bottom
Tomasz Lemiech edited this page Jan 28, 2018 · 10 revisions

RTLSDR-Airband can record MP3-compressed audio to local files for archiving purposes.

Syntax

outputs is a list of outputs where the audio stream of a particular channel is to be routed. An output is a group of settings enclosed in braces { }. The number of outputs per channel is unlimited.

outputs: (
  {
    type = "file";
    directory = "/home/pi";
    filename_template = "TOWER";
#   continuous = false;
#   append = true;
  }
);

Want more outputs? Just repeat the braced section several times and separate individual sections with a comma, like this:

outputs: (
  {
    # ... settings for output 1
  },
  {
    # ... settings for output 2
  }
# , ... more outputs here
);

Remember, do not put a comma after the closing brace of the last output. This is a syntax error.

Settings description

  • type (string, required) - type of this output. Put "file" here.
  • directory (string, required) - the directory path where audio files will be stored. It must be created beforehand.
  • filename_template (string, required) - the file name prefix. RTLSDR-Airband appends the current date and UTC time to it and creates a new file on top of every hour. A .mp3 suffix is added automatically.
  • continuous (boolean, optional) - whether RTLSDR-Airband shall record the audio continuously (true) or skip silence periods when squelch is closed (false). The default is false.
  • append (boolean, optional) - if set to true (the default), RTLSDR-Airband will append the recording to the file, if it already exists. When false, the old file will be overwritten.

Marking of recording interruptions

When append option is set to true and RTLSDR-Airband is about to continue writing to an existing file, a series of short beeps will be appended to the file first to indicate the place where discontinuity of the recording has occurred. When continuous option is also set to true, RTLSDR-Airband will append a period of silence of appropriate length to preserve the time scale continuity in the file.

Now you may want to read about configuring other output types for your channels:

or jump straight to:

Clone this wiki locally