rtl_sdr(1)

rtl_sdr1

An i/q recorder for rtl2832 based dvb-t receivers

Usage

rtl_sdr [-f freq] [OPTIONS] [output file]

Overview

Uses a re-purposed DVB-T receiver as a software defined radio to receive signals in I/Q data form. Written for and incorporated in the osmocom rtl-sdr project.

In-Phase and Quadrature Phase data can faithfully represent all of the information in a band of frequencies centered on a carrier signal frequency.

Much software is available for the RTL2832. Most of the user-level packages rely on the librtlsdr library which comes as part of the rtl-sdr codebase. This codebase contains both the library itself and also a number of command line tools such as rtl_test, rtl_sdr, rtl_tcp, and rtl_fm. These command line tools use the library to test for the existence of RTL2832 devices and to perform basic data transfer functions to and from the device.

Because most of the RTL2832 devices are connected using USB, the librtlsdr library depends on the libusb library to communicate with the device.

Usage

This program captures information from a band of frequencies and outputs the data in a form useful to other software radio programs.

Options

-f frequency_to_tune_to [Hz]
-s samplerate (default: 2048000 Hz)
-d device_index (default: 0)
-g gain (default: 0 for auto)
-p ppm_error (default: 0)
-b output_block_size (default: 16 * 16384)
-n number of samples to read (default: 0, infinite)
-S force sync output (default: async)
tfilename

(a '-' dumps samples to stdout)

Examples

Example: To tune to 392.0 MHz, and set the sample-rate to 1.8 MS/s, use:

./rtl_sdr /tmp/capture.bin -s 1.8e6 -f 392e6

to record samples to a file or to forward the data to a fifo.

If the device can't be opened, make sure you have the appropriate rights to access the device (install udev-rules from the repository, or run it as root).

Releases

7 releases since Debian 8 (Jessie); the text changed 2 times.

  1. 8–10
  2. 11–13
  3. Arch

Author

This manual page was written by Maitland Bottoms for the Debian project (but may be used by others).

From rtl-sdr 1:2.0.3-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.