SSTV generator in pure Python

PySSTV generates SSTV modulated WAV files from any image that PIL can open (PNG, JPEG, GIF, and many others). These WAV files then can be played by any audio player connected to a shortwave radio for example.

My main motivation was to understand the internals of SSTV in practice, so performance is far from optimal. I tried keeping the code readable, and only performed such optimizations that wouldn't have complicated the codebase.

Command line usage

$ python -m pysstv -h
usage: __main__.py [-h]
              [--mode {MartinM1,MartinM2,ScottieS1,ScottieS2,ScottieDX,Robot36,PasokonP3,PasokonP5,PasokonP7,PD90,PD120,PD160,PD180,PD240,PD290,WraaseSC2120,WraaseSC2180,Robot8BW,Robot24BW}]
              [--rate RATE] [--bits BITS] [--vox] [--fskid FSKID]
              [--chan CHAN] [--resize] [--keep-aspect-ratio]
              [--keep-aspect] [--resample {nearest,bicubic,lanczos}]
              image.png output.wav

Converts an image to an SSTV modulated WAV file.

positional arguments:
  image.png             input image file name
  output.wav            output WAV file name

options:
  -h, --help            show this help message and exit
  --mode {MartinM1,MartinM2,ScottieS1,ScottieS2,ScottieDX,Robot36,PasokonP3,PasokonP5,PasokonP7,PD90,PD120,PD160,PD180,PD240,PD290,WraaseSC2120,WraaseSC2180,Robot8BW,Robot24BW}
                        image mode (default: Martin M1)
  --rate RATE           sampling rate (default: 48000)
  --bits BITS           bits per sample (default: 16)
  --vox                 add VOX tones at the beginning
  --fskid FSKID         add FSKID at the end
  --chan CHAN           number of channels (default: mono)
  --resize              resize the image to the correct size
  --keep-aspect-ratio   keep the original aspect ratio when resizing
                            (and cut off excess pixels)
  --keep-aspect         keep the original aspect ratio when resizing
                            (not cut off excess pixels)
  --resample {nearest,bicubic,lanczos}
                        which resampling filter to use for resizing
                            (see Pillow documentation)

Python interface

The SSTV class in the sstv module implements basic SSTV-related functionality, and the classes of other modules such as grayscale and color extend this. Most instances implement the following methods:

__init__ takes a PIL image, the samples per second, and the bits per sample as a parameter, but doesn't perform any hard calculations
gen_freq_bits generates tuples that describe a sine wave segment with frequency in Hz and duration in ms
gen_values generates samples between -1 and +1, performing sampling according to the samples per second value given during construction
gen_samples generates discrete samples, performing quantization according to the bits per sample value given during construction
write_wav writes the whole image to a Microsoft WAV file

The above methods all build upon those above them, for example write_wav calls gen_samples, while latter calls gen_values, so typically, only the first and the last, maybe the last two should be called directly, the others are just listed here for the sake of completeness and to make the flow easier to understand.

License

The whole project is available under MIT license.

Useful links

receive-only "counterpart": https://github.com/windytan/slowrx
free SSTV handbook: http://www.sstv-handbook.com/
robot 36 encoder/decoder in C: https://github.com/xdsopl/robot36/

Dependencies

Python 3.5 or later
Python Imaging Library (Debian/Ubuntu package: python3-pil)

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pysstv-0.5.9.tar.gz (16.6 kB view details)

Uploaded Jul 27, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pysstv-0.5.9-py3-none-any.whl (20.9 kB view details)

Uploaded Jul 27, 2026 Python 3

File details

Details for the file pysstv-0.5.9.tar.gz.

File metadata

Download URL: pysstv-0.5.9.tar.gz
Upload date: Jul 27, 2026
Size: 16.6 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.11.2 {"installer":{"name":"uv","version":"0.11.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for pysstv-0.5.9.tar.gz
Algorithm	Hash digest
SHA256	`2773599a5a90bb6def7e4a85ffd296176e5009055aa25d91081d4d6c111cdf87`
MD5	`278f64508e52af4c9334c4dfa2a8651b`
BLAKE2b-256	`600dd583337f2ee0f6e9e7519b9ff628ce44ec056401b294566d9e6532cdd4df`

See more details on using hashes here.

File details

Details for the file pysstv-0.5.9-py3-none-any.whl.

File metadata

Download URL: pysstv-0.5.9-py3-none-any.whl
Upload date: Jul 27, 2026
Size: 20.9 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.11.2 {"installer":{"name":"uv","version":"0.11.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for pysstv-0.5.9-py3-none-any.whl
Algorithm	Hash digest
SHA256	`74b1b4e4b3b8711014618a4f222c0ec74e23e6bce5d4bab4ed99179232a2b3cb`
MD5	`b3947b0c959b8ca51d393f2f2fd4f10b`
BLAKE2b-256	`6e9b953ac1b0c6769dfc6728735cc97a27de35f6f77fe76694118e2843f4c464`