Python GUI for decoding and viewing SSDV images in real time from SSDV frames streamed over UDP/IP.
The viewer requires PySide6 and Matplotlib. Install both packages, then run it from the repository root:
python src/SSDV_Viewer.pyThe viewer listens for SSDV frames on UDP port 5030. The SSDV decoder executable
must be available at src/ssdv-win.exe on Windows or src/ssdv on other platforms.
Use the top-right menu button and choose Source to select UDP, a .bin file
from data, Demo, or Radio;
Radio is a placeholder. UDP listens for frames on port 5030 from an external
transmitter; it does not start a transmitter itself. Demo starts
SSDV_UDP_Tx.py with no arguments, so it repeatedly sends the .bin files in
data (twice per file) to the viewer over UDP on port 5030. The viewer receives
Demo frames through the same UDP listener used by UDP mode. The demo transmitter
stops when you switch to another source or close the viewer.
Press Print and select the connected printer in the print dialog. The image
is printed centered on postcard-size 4 x 6 photo paper; select the Canon SELPHY
CP1500 if it is not the system's default printer. Choose Print Settings in
the menu to configure the logo and banner options.
When Include logo is checked, the SilverSat logo is overlaid at the bottom
right of the image at about 0.64 inch tall, with www.silversat.org beneath it.
The website text switches between dark and white based on the image brightness
under its position.
When Include banner is checked, the complete saved banner message is
overlaid near the top-left of the image in Footlight MT Light or a system
substitute, reduced as needed to fit. Its red-orange text color is controlled by
the BANNER_TEXT_COLOR setting in src/SSDV_Viewer.py.
Run the UDP transmitter with an optional file or folder, destination IP, and port:
python src/SSDV_UDP_Tx.py [file-or-folder] [ip] [port]With no file or folder argument, it repeatedly sends each .bin file in data
twice before moving to the next file. File mode repeats the file continuously.
To encode JPEGs in data as SSDV .bin files with 195-byte packets, run:
python src/SSDV_Generator.pyEach JPEG gets a sequential image ID, starting at 1.