⚠️ VibeIQ is for raw IQ through the tunnel. On your own network you do not need it.
A VibeServer offers raw IQ two ways, and only one of them wants this app:
| What the client shows | What to do | |
|---|---|---|
Over the tunnel (a vibesdr.net address, or any receiver you reached over the internet)
| a six-character pairing code | Use VibeIQ. It carries the stream out of the tunnel and re-serves it as rtl_tcp on your machine. |
| On your own LAN | an address and port | Do not use VibeIQ. Point your SDR app straight at that address as an rtl_tcp source — it is a direct connection, nothing in the middle. |
The tunnel cannot carry an inbound rtl_tcp connection, which is the only reason this app exists. Locally there is nothing to bridge, and going through VibeIQ would only add a hop. The local path is also wider: up to 250 kHz direct on the LAN, 48 kHz through the tunnel (which still covers every digital voice and data mode).
VibeIQ takes the raw IQ of the channel your session is tuned to and serves it on your own machine as rtl_tcp on 127.0.0.1:1234, for SDR++, SDR#, GQRX, HDSDR, DSD-FME or anything else that speaks rtl_tcp. Tuning in that app moves the VibeServer session's dial; the web client keeps playing audio.
How to use it
- In the VibeSDR web client or app, open AUDIO and switch RAW IQ OUT on.
- If it shows a six-character code, run VibeIQ and enter it. If it shows an address and port, you are on the LAN — skip VibeIQ and point your SDR app there.
- Point your SDR app at
127.0.0.1:1234as an rtl_tcp source, at any sample rate it offers. VibeIQ converts the stream to the rate the app asks for.
Downloads
| Platform | File | |
|---|---|---|
| macOS (app) | VibeIQ-1.0.1-macOS-app.zip
| Universal. Signed, notarised and stapled — Gatekeeper lets it run. Drag to Applications. |
| macOS (command line) | VibeIQ-1.0.1-macos-universal.tar.gz
| Signed, not notarised (a loose binary cannot carry a ticket): xattr -d com.apple.quarantine ./vibeiq
|
| Windows x86-64 / arm64 | VibeIQ-1.0.1-windows-*.zip
| Two programs — see below. |
| Linux x86-64 / arm64 | VibeIQ-1.0.1-linux-*.tar.gz
| Static binary, plus a .desktop entry and icon. arm64 is the Raspberry Pi.
|
SHA256SUMS.txt lists the checksums.
The window, and the command line
The window is a small page the app serves to itself on the loopback — nothing is fetched from the network and it works offline. On macOS it appears in a real app window; on Windows and Linux it opens in the browser you already have, so nothing large is bundled.
- Double-click → the window. Type the code, and the stream starts.
vibeiq CODE→ pair and stream, no window.- Over SSH → it notices there is no screen to draw on and asks for the code on the terminal instead.
--guiforces the window anyway (forward the port it prints);--cliforces the terminal at a desk.
Windows ships two programs because it can only be one or the other: VibeIQ.exe is built without a console, so nothing black flashes up behind the browser when you double-click it — and a program without a console cannot print, so it cannot serve the command line. vibeiq-cli.exe is the one to run in cmd.
Changes since 1.0.0
- Over SSH it now asks for the pairing code on the terminal, instead of serving a page to a screen nobody is sitting at and appearing to hang.
- Windows: a proper double-click program with no console window, alongside the command-line one.
- Linux: a
.desktopentry and icon so it appears in the launcher; arm64 (Raspberry Pi) builds. - macOS: the app is signed, notarised and stapled.
Needs VibeServer 5.2.0 or later with Raw IQ out enabled by the receiver's owner. Source: tools/vibeiq in this repository. Licence as the repository.