README

SatDump



A generic satellite data processing software.
Thanks Crosswalkersam for the icon!

There now also is a Matrix room if you want to chat! Otherwise, a Discord bridge to the Matrix is also available.

 Introduction

Note : This is a very basic "how-to" skipping details and assuming some knowledge of what you are doing. For more details and advanced use cases, please see the detailed documentation. 

 GUI Version

 Processing recorded data
Quick-Start :
- Open the processing menu by selecting File  Processing
- Select the appropriate pipeline
- Select the input file (baseband, frames, soft symbols...)
- Set the appropriate input level (what type your input file is)
- Check settings shown below are right (such as sample rate)
- Press "Start"!

!Image showing the processing window

!As described below
SatDump (1.0) demodulating a DVB-S2 baseband

 Live processing or recording (directly from your SDR)

Quick-Start :
- Add a recorder by selecting Add  Recorder
- Select and start your SDR Device
- Choose a pipeline
- Start it, and done!


!SatDump as described below
SatDump tuned to 103 MHz using a HydraSDR

 CLI Version

!Satdump CLI initializing

 Offline processing


Usage : satdump pipeline [pipeline_id] [input_level] [input_file] [output_file_or_directory] [additional options as required]
Extra options can be found by adding --help to the end of the command 
Sample command :
satdump pipeline metop_ahrpt baseband /home/user/metop_baseband.cs16 metop_output_directory --samplerate 6e6 --baseband_format cs16


You can find a list of Satellite pipelines and their parameters Here.

 Live processing


Usage : satdump legacy live [pipeline_id] [output_file_or_directory] [additional options as required]
Extra options (examples. Any parameter used in modules or sources can be used here) :
  --samplerate [baseband_samplerate] --baseband_format [cf32/cs32/cs16/cs8/w8] --dc_block --iq_swap
  --source [airspy/rtlsdr/etc] --gain 20 --bias
As well as --timeout in seconds
Sample command :
satdump legacy live metop_ahrpt metop_output_directory --source airspy --samplerate 6e6 --frequency 1701.3e6 --general_gain 18 --bias --timeout 780


You can find a list of all SDR Options Here. Run satdump sdr_probe to get a list of available SDRs and their IDs.

 Recording


Usage : satdump legacy record [output_baseband (without extension!)] [additional options as required]
Extra options (examples. Any parameter used in sources can be used here) :
  --samplerate [baseband_samplerate] --baseband_format [cf32/cs32/cs16/cs8/cu8/w16] --dc_block --iq_swap
  --source [airspy/rtlsdr/etc] --gain 20 --bias
As well as --timeout in seconds
Sample command :
satdump legacy record baseband_name --source airspy --samplerate 6e6 --frequency 1701.3e6 --general_gain 18 --bias --timeout 780 --baseband_format cf32



 Building / Installing

 Windows
The fastest way to get started is to head over to the Releases page, where you can download SatDump's installer or portable app - no compilat