Ham Radio Frequency Waterfall Display UI for iOS

A ham radio frequency waterfall display turns a signal into a scrolling spectrogram: you run a fast Fourier transform on each chunk of samples to get its frequency content, map magnitude to color, and scroll those rows down the screen over time. On iOS the FFT runs on the Accelerate framework for real speed, the source is audio from AVAudioEngine or IQ data from a connected software-defined radio, and the waterfall is drawn efficiently with SwiftUI Canvas. The radio UI around it is fastest to start from a free VP0 design, and the audio pipeline shares ground with an anonymous voice changer pitch slider.

What a waterfall actually is

The display has a simple definition once you see it. Each horizontal row is the frequency content of one short slice of the signal: the FFT of that slice, with each frequency bin’s magnitude mapped to a color. Stack those rows over time, newest at the top, scrolling down, and you get the waterfall, a picture of how the spectrum changes moment to moment. So the whole app is a loop: grab samples, transform, color a row, scroll.

That makes the architecture clear. The signal pipeline produces rows; the view scrolls and renders them. Get those two right and the rest is tuning controls and chrome.

The FFT belongs on Accelerate

The transform is the performance-critical part, because a waterfall computes an FFT many times a second. Apple’s Accelerate framework provides vDSP, a hardware-optimized signal-processing library with a fast FFT built for exactly this load. Running the transform there keeps it fast enough to feed a smooth display, where a hand-rolled FFT in a Swift loop would stutter. This is the single decision that makes real-time spectrum analysis feasible on a phone.

Feed vDSP a window of samples, get back the frequency-domain magnitudes, and you have one row’s worth of data ready to color.

Where the samples come from

The pipeline needs a steady stream of sample chunks, and there are two common sources. For audio-frequency work, AVAudioEngine taps the microphone or an input node and hands you sample buffers you transform directly. For radio, a connected software-defined radio provides IQ samples over its own link, which you process the same way. The waterfall does not care which one it is; it cares about a reliable flow of sample chunks arriving to be transformed.

Drawing it smoothly

Rendering is the other half. SwiftUI Canvas draws the scrolling spectrogram efficiently, letting you paint rows without rebuilding a whole view hierarchy each frame. Map magnitude to color with a precomputed palette rather than recomputing per pixel, do the FFT and mapping off the main thread, and bound the history to the visible height so memory stays flat. That tight pipeline is what keeps the waterfall fluid, the same real-time render discipline behind a CGM glucose chart where data streams continuously.

What to choose

For a ham radio waterfall display on iOS, build the signal pipeline first: take sample chunks from AVAudioEngine or a connected SDR, run the FFT on the Accelerate framework’s vDSP, map each bin’s magnitude to a color from a precomputed palette, and scroll the rows with SwiftUI Canvas. Keep the transform and mapping off the main thread and bound the history to the visible height so it stays smooth and memory stays flat. The Accelerate FFT is the decision that makes it real-time; the Canvas render is what keeps the scroll fluid. Start the surrounding radio interface from a free, $0 VP0 design and put your effort into the pipeline.

Frequently asked questions

How do I build a waterfall display on iOS?

Run a fast Fourier transform on each chunk of incoming samples to get its frequency content, map each bin’s magnitude to a color, and draw that as one row, then scroll the rows down over time to form the waterfall. On iOS the FFT belongs on the Accelerate framework’s vDSP for speed, the samples come from AVAudioEngine for audio or from a connected SDR for radio, and the scrolling spectrogram renders well with SwiftUI Canvas. Build the surrounding radio UI from a free VP0 design.

Why use the Accelerate framework for the FFT?

Because a waterfall computes an FFT many times a second, and a naive transform in plain Swift cannot keep up. Accelerate’s vDSP provides a hardware-optimized FFT built for exactly this signal-processing load, so the transform stays fast enough to feed a smooth, scrolling display. Doing the FFT yourself in a loop is the classic reason a waterfall stutters; vDSP is the part that makes real-time spectrum analysis feasible on a phone.

Where does the signal data come from?

Two common sources. For audio-frequency work, AVAudioEngine taps the microphone or an input and hands you sample buffers. For radio, a connected software-defined radio provides IQ samples over its own connection, which you transform the same way. Either way you get chunks of samples, run the FFT, and feed the magnitudes to the display. The waterfall code does not care about the source; it cares about a steady stream of sample chunks.

How do I keep the waterfall smooth?

Do the FFT and magnitude mapping off the main thread, render rows efficiently rather than rebuilding the whole image each frame, and bound the history to the visible height so memory stays flat. Map magnitude to color with a precomputed palette instead of recomputing it per pixel. A waterfall is GPU- and CPU-sensitive, so the smoothness comes from a tight pipeline and an efficient draw, not from doing more work per frame.

Can VP0 give me a free template for the radio UI?

Yes. VP0 is a free iOS design library where each screen has an AI-readable source page, so you copy a link and Claude Code or Cursor builds the radio interface, the tuning controls, the frequency readout, the waterfall panel frame, in SwiftUI. You implement the FFT pipeline and the Canvas render yourself. The design gives you the instrument-style UI to start from at no cost.