OscarWatch SSTV

Tools → OscarWatch SSTV decodes SSTV pictures sent from space, such as the ARISS SSTV events from the ISS on 145.800 MHz FM. It is receive only: OscarWatch never transmits SSTV.

Modes

OscarWatch decodes the modes used from space:

  • Robot 36 and Robot 72
  • Scottie S1, S2, S3, S4 and DX
  • Martin M1, M2, M3 and M4
  • Wraase SC2-180
  • PD 50, 90, 120, 160, 180, 240 and 290 (the ISS usually sends PD 120 or PD 180)

The mode is picked automatically from the VIS header at the start of each picture. If you need to, choose a mode in the Mode list to decode everything as that mode.

Martin M3 and M4 and Scottie S3 and S4 are half-height versions of M1, M2, S1 and S2. They are only recognised from their VIS header, because their line timing is the same as the full-height modes.

With Use the satellite's known SSTV modes ticked (on by default), OscarWatch looks up the modes the satellite in focus is known to send, for example PD 120, PD 180 and Robot 36 for the ISS, or Robot 36 for UmKA-1 and SakhaCube. A slightly damaged header is then read as one of those modes, and picture searches without a header only try those modes. A complete header for any other mode is still decoded, so a satellite that changes mode is not missed.

Getting started

  1. Connect your receiver audio to the PC (soundcard line in, or the radio's USB audio).
  2. Open Tools → OscarWatch SSTV, press Settings on the toolbar and choose the Input device. The same dialogue holds the slant, AFC, Doppler and saving options.
  3. Press Start. The status line says when it is listening and which satellite is in focus.
  4. Pictures appear line by line as they arrive, and each finished picture is added to Received pictures.

Tip: Set the audio level so the Input level bar sits around half way on the loudest part of a picture. Turn off any noise reduction or audio filtering in the radio, and open the squelch (or set it low) so weak lines are not cut off.

Automatic start

In SSTV Settings, tick Start when the focused satellite rises to listen for the satellite selected in the main window. Listening starts when it climbs through the start elevation, and stops when it sets. The default is −5°, so the radio, Doppler tracking and audio have a few degrees to settle before AOS. You can set the elevation from −15° to 30°. The SSTV window must stay open.

Keeping the computer awake

To leave OscarWatch decoding overnight, tick Keep the computer awake while listening in SSTV Settings. While SSTV is listening, the computer and the display stay out of idle sleep, so the screen saver or power saving cannot drop a USB radio's audio part way through. On macOS this also stops App Nap slowing OscarWatch down. The request ends when listening stops, and decoding a saved recording does not keep the computer awake. It is off by default.

You can still lock the screen. Closing a laptop lid, choosing Sleep, or shutting down still puts the computer to sleep. On Linux this needs systemd-logind for system sleep and a desktop that supports the freedesktop screensaver interface (GNOME, KDE Plasma and Xfce do) for the display. If either is missing, OscarWatch carries on listening and notes it in the log.

Signal display

The Signal panel shows the receive audio as a spectrum (top) and a scrolling waterfall (below), from 900 to 2600 Hz. Markers sit at 1200 Hz (sync), 1500 Hz (black), 1900 Hz (VIS leader, dashed) and 2300 Hz (white). A picture being sent shows a steady stripe on the 1200 Hz marker with picture activity between 1500 and 2300 Hz. If the stripe sits beside the marker, the audio is off tune; AFC corrects small offsets.

Sync, slant and tuning

  • Automatic slant correction measures the line timing from the sync pulses, so clock error in the sender or your soundcard does not lean the picture. With it off, set Clock trim (ppm) by hand. Re-sync redraws the picture with the timing measured across all of it.
  • AFC follows the sync tone frequency line by line, so a tuning error or Doppler drift does not shift the colours. The status strip shows the tuning offset and clock error it has measured.
  • In Robot and PD pictures the colour is smoothed slightly along each line, which removes much of the coloured speckle on a noisy pass. Brightness detail is left as received.
  • Find pictures without a VIS header picks up a picture from its regular sync pulses when the header was lost, for example when the satellite is still low at the start of a pass. A run of syncs with a few missing in a fade still counts, and when fades take out too many syncs for that, the syncs of the last few lines are added together so the picture is still found from the rest. Such pictures are marked found from sync.
  • A VIS header is still read when a short fade takes out part of its leader tone, as long as the header itself comes through cleanly. When noise buries the leader altogether, the header is read from the strength of each bit's tone instead. Every bit must be clearly one tone and, when the satellite's modes are known, the mode must be one of them. A picture started this way is dropped if its syncs do not follow.
  • When the signal goes for about 8 seconds (the sender stops, or the pass ends), the picture is closed and marked partial, so noise is not drawn into the rest of it. Skip picture drops the current picture and listens for the next one.
  • Keep pictures going through long fades (on by default) holds a well locked picture open through a fade of up to 45 seconds, for example when the satellite passes behind a building, and carries on drawing on the same line timing when the signal returns, so one picture is not cut in two. If the signal does not come back before the end of the picture, the rows after the last sync are dropped as before.
  • While receiving, the line timing follows the Doppler shift of the satellite in focus, so the picture stays straight through a fade. After a fade, a single sync away from the line timing is only used once the next line confirms it.
  • Put pictures caught part way through on the right rows (on by default): when reception starts in the middle of a picture and runs to its end, the received part is drawn at the bottom of the picture, where it belongs, instead of at the top.
  • Repair short runs of noisy lines (on by default) redraws up to three noisy lines in a row from the good lines either side, which hides short noise bursts and clicks. Longer damage is left as received.
  • Each pixel counts the moments where the signal dipped (where FM clicks come from) for less than the rest, which slightly lowers the speckle on a weak pass.
  • Where there is only noise (a deep fade, or the antenna pointing away), it is drawn as dim grey grain instead of bright random colour, much as MMSSTV shows it. The steadiness of the signal decides this, not the picture, so a weak picture that is still coming through keeps its colour.
  • When a picture finishes, noisy rows are smoothed and clean rows are left as received. Each pixel moves towards the middle value of itself and its eight neighbours, including the lines above and below, and only as far as the noise in that part of the picture warrants. A strong picture is left alone, and so are fine lines that run the width of the picture. Smooth out speckle on weak pictures (off by default) still does this to every row, which also softens fine detail and small text on a strong picture. Lines that are completely lost are not helped; that is what the repair option and combining repeat copies are for.
  • Match the filter to the mode (on by default) demodulates again, once the mode is known, with a filter suited to that mode's picture detail. It helps narrow modes such as Martin M1 on weak signals. Robot 36 and PD pictures are not changed.

Fixing slant by hand

If a saved picture still leans, select it in Received pictures and press Fix slant. Click the top of an edge that should be vertical, such as the sync edge or the side of a frame, then click the bottom of the same edge. The picture is straightened so that edge stands upright. Press Save picture to keep the straightened copy; the original file is not changed.

Doppler

On FM (the ISS and most SSTV from space) a small frequency error does not move the audio tones, so no correction is needed beyond normal FM Doppler tuning. On SSB, rig control tunes in steps and the audio moves between steps. With Rig Doppler correction (SSB) ticked and CAT tracking running, OscarWatch removes that left-over offset from the audio before decoding. The status strip shows the downlink Doppler and, on SSB, the correction being applied.

Where pictures are saved

Pictures are saved as PNG files in the Save folder chosen in SSTV Settings. Leave it blank to use the default folder:

%AppData%\OscarWatch\sstv\

To keep pictures and receive audio off the system drive, type a folder or press Browse… to pick one. The folder must already exist. If it is missing or cannot be written to (for example an unplugged USB drive), OscarWatch saves to the default folder instead and notes this in the log. Changing the folder does not move pictures already saved, and the picture library shows the folder in use.

File names give the UTC time, the satellite in focus and the mode, for example 20241012_073105Z_ISS_Pd120.png. With Save pictures automatically off, select a picture in the list and press Save picture. Open SSTV folder opens the folder.

With Save receive audio ticked, the receive audio is also kept as a WAV file in the save folder (about 1.4 MB a minute), so you can decode a pass again later. These files are not deleted automatically.

Combining repeat pictures

Satellites often send the same picture several times, on one pass or across several. With Combine repeat copies of a picture ticked (on by default, and used with Save pictures automatically), OscarWatch compares each new picture with earlier ones from the same satellite. When it finds the same picture, it also saves a merged copy that takes the cleanest lines from each copy, with _combined in the file name, for example 20241012_073105Z_ISS_Pd120_combined.png. The single copies are saved as usual.

Sharing with the OscarWatch.org gallery

Tick Share pictures with the OscarWatch.org SSTV gallery in SSTV Settings to send your pictures to the SSTV gallery, credited to the callsign on your website profile. The option is off by default and stays unavailable until an OscarWatch.org API token is saved in Settings → OscarWatch.

Nothing is uploaded during a pass. Pictures wait until the satellite they came from has set, then go one at a time in the background, so decoding is never disturbed. Only finished pictures from live receive with a sync lock of 50% or more and a satellite in focus are shared. Pictures decoded from a recording are not. The queue is kept if you close OscarWatch and carries on next time. A line under the decoder status in the SSTV window shows what is waiting and the result of the last upload. The gallery accepts up to 20 pictures an hour; anything over the limit is sent later.

Picture library

The grid button beside Received pictures opens the picture library, which shows every picture in the SSTV folder grouped by day, newest first. Filter by period (today, the last 7 or 30 days, or your own dates), satellite and mode. Select a picture to see it full size with its details, double-click to open it, or use Show in folder and Delete. New pictures appear as they are saved.

Decoding a recording

Decode recording on the toolbar decodes a WAV or MP3 recording of a pass, including recordings made by OscarWatch pass recording or other software. The file picker opens in the SSTV folder, where saved receive audio is kept. A recording may hold several pictures; each one is added to the list. Formats other than WAV need ffmpeg on PATH.

Decode last session again decodes the receive audio saved from the last live session, using the current settings and the modes of the satellite that was in focus. Use it to try a different setting on a pass you have just received. It needs Save receive audio ticked during the session.

Problems?

  • Nothing decodes: check the input level moves during a picture, and that the right device is selected.
  • "No audio is reaching OscarWatch": the selected input is silent, which usually means it is not the radio's audio interface. System default is often a microphone, especially on Linux. A waterfall on the radio or an SDR can show the signal while OscarWatch hears nothing, so choose the radio's interface in Settings. A recording made this way is silent too, and decoding it says so.
  • Colours are wrong or striped: leave AFC on, and make sure the radio is not on a narrow data filter or audio processing.
  • The picture leans: leave automatic slant correction on and press Re-sync after the picture. If a finished picture still leans, use Fix slant.
  • The picture starts half way down: the start was missed, so the decoder joined from the sync pulses. That is normal early in a pass, and the received part is placed at the bottom of the picture.
  • The picture is cut in two by a fade: check that Keep pictures going through long fades is ticked, then use Decode last session again to see whether it joins the two parts.
OscarWatch
OscarWatch
Toggle sidebar