Skip to content

Spectrum analyzer on your terminal/ssh console with ASCII art ~ RTLSDR

License

Notifications You must be signed in to change notification settings

r4d10n/retrogram-rtlsdr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

retrogram~rtlsdr

          _                                      /\/|    _   _ _________________ 
         | |                                    |/\/    | | | /  ___|  _  \ ___ \
 _ __ ___| |_ _ __ ___   __ _ _ __ __ _ _ __ ___    _ __| |_| \ `--.| | | | |_/ /
| '__/ _ \ __| '__/ _ \ / _` | '__/ _` | '_ ` _ \  | '__| __| |`--. \ | | |    / 
| | |  __/ |_| | | (_) | (_| | | | (_| | | | | | | | |  | |_| /\__/ / |/ /| |\ \ 
|_|  \___|\__|_|  \___/ \__, |_|  \__,_|_| |_| |_| |_|   \__|_\____/|___/ \_| \_|
                         __/ |                                                   
                        |___/                                                    

Wideband Spectrum analyzer on your terminal/ssh console with ASCII art. Hacked from Ettus UHD RX ASCII Art DFT code for RTLSDR. Adapted from retrogram~plutosdr.

retrogram-rtlsdr-vhf [Tuning on VHF band while transmitting on 145.500 MHz with Handheld Radio]

retrogram-rtlsdr-gsm [Spotting FCCH (Freq. Correction) burst in the local GSM BCCH (Broadcast Control Channel) @ 938.2 MHz]

Pan & Zoom spectrum using keyboard controls [decrement-Increment]. [Full feature demo]

  • Center Frequency using keys [f-F]
  • PPM correction using keys [p-P]
  • Sampling rate using keys [r-R]
  • Gain using keys [g-G]
  • Reference level using keys [l-L]
  • Dynamic Range using keys [d-D]
  • Frame rate using keys [s-S]
  • Tuning step using keys [t-T]
  • Hide/Show Controls using keys [c-C]
  • Quit program using keys [q-Q]

Tuning step applies for decrementing / Incrementing Center Frequency and Sampling Rate.


retrogram~rtlsdr - ASCII Art Spectrum Analysis for RTLSDR

Allowed options:
  --help                   help message
  --dev arg (=0)           rtl-sdr device index
  --ppm arg (=0)           ppm error adjustment [p-P]
  --rate arg (=1000000)    rate of incoming samples (sps) [r-R]
  --freq arg (=100000000)  RF center frequency in Hz [f-F]
  --gain arg (=0)          gain for the RF chain [g-G]
  --frame-rate arg (=15)   frame rate of the display (fps) [s-S]
  --ref-lvl arg (=0)       reference level for the display (dB) [l-L]
  --dyn-rng arg (=80)      dynamic range for the display (dB) [d-D]
  --step arg (=100000)     tuning step for rate/bw/freq [t-T]
  --show-controls arg (=1) show the keyboard controls

Requires: librtlsdr, libcurses, libboost-program-options

sudo apt install librtlsdr-dev libncurses5-dev libboost-program-options-dev

Build:

For running on a Linux host with RTLSDR

make

Run:

./retrogram-rtlsdr --rate 1.8e6 --freq 100e6 --step 1e5

TODO:

  • Generic support for osmosdr / soapysdr devices
  • Direct Freq Entry / parameter change
  • Mouse tuning
  • Modularize / Optimize with std::vector transform
  • Waterfall (!) / Markers / Demodulators (!!) :)
  • HTML output / Web(sockets)-server

About

Spectrum analyzer on your terminal/ssh console with ASCII art ~ RTLSDR

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published