(Multiple Input Simultaneous RF Capture Graphical User Interface)
A universal cross platform GUI tool for interfacing with and visualizing monitoring and control of FM RF archival focused, capture device workflows.
- MISRC (v1.0-v1.5a / native v2.5)
- CXADC (single cards and Clockgen Mod with sound)
- HSDAOH
- FX3 (Generic tinkering firmware support)
- DdD (Domesday Duplicator)
- FX3ADC (100mhz MUSE capture device)
Downloads can be found on the releases page.
- Windows
- MacOS
- Linux
- Android (arm64 APK, very alpha)
x86 (AMD/Intel) and ARM64 (Apple M, Snapdragon, RockChip) are fully supported and intended for long-term support.
Building from source? See INSTALLATION.md.
DdD Setup
MISRC GUI supports both legacy DdD firmware and the protocol-v1 firmware family introduced in 3.1. They appear as separate device profiles in the device list.
Install Windows
For misrc_capture to be able to access the MS2130 or MS2131 capture device, you need to install a generic driver:
Firstly download Zadig
Force the installation of WinUSB (v6.1.7600.16385) or libusb-win32 (v1.2.6.0) driver on your MS2130/MS2131 adapter, on interface 0 leave interface 4 alone.
Interface 0 - USB Video
Interface 4 - HIDDevice
Linux CXADC/Clockgen Setup
Linux setup note (CXADC DC controls)
For CXADC DC up/down controls to work without root, the sysfs parameter files must be writable by the video group.
One-time fix for the current boot:
sudo chgrp video /sys/class/cxadc/cxadc*/device/parameters/*Verify:
ls -l /sys/class/cxadc/cxadc*/device/parameters/center_offsetExpected group is video (e.g. root video).
The MISRC GUI, the layout is a simplified command and control system, designed for a single 9-24” monitor both touch & non-touch compatible, with a two layer only rule of design meaning there is no more than one sub menu per button press or drop down selection.
The main GUI window from beginning from the top row
- Information button
- Metadata button
- Device selection box
- Device mode selection box
- Audio monitoring enable and disable
- Audio levels
- Timer and level stop control
- Record button
The record timer system is self fail proof, you cannot set a time lower than your current duration and instantly stop capture by accident, it will count the total timer with a discount of the current duration passed, and has to be armed with a manual button click.
- A/B Swap for older V1.5a users
- V4L2 Device discovery for Linux
- Core Pinning (Linux Only)
- Memory Budget (Allows you to limit/raise the buffers for higher stability on low end or high end systems)
The GUI is built with several layers of fallback and prevention measures to stop hardware issues on an OS level from interfering with your capture such as spillover if there is a slowdown in drive or encoding performance, the recommended amount of RAM ideally is 8GB DDR3 2400Mhz or better, of course on faster ARM64 chips this becomes less of a concern but production stations should have ideally no less then 16GB total.
Record button is clear when not in use.
Record button is RED when capturing is in use.
The record button will turn orange and state finalizing when a file is still being processed i.g adding timing header information or encoding from spill over or memory.
Audio monitoring has on/off and CH 1/2 or Ch 3/4 switching and level indicators in Green/Yellow/Red for visual loudness level.
Timer mode allows for HH:MM:SS timing to stop the capture, with an arm/disarm system but will append current duration to the total timer duration and will not allow you to accidentality stop your capture if you forgot to set the timer beforehand.
Level Autostop, this allows for you to set a overall % level alongside a timer to automatically stop captures when a tape is clearly reached its end and no active signal is being captured thus presenting a drastically lower level, users should be careful with this to prevent re-runs if tapes have spaced recordings.
- Auto File Naming
- Auto File Date Stamping
- Stop on dropout mode
- Base Name and Output
- A/B RF Capture On/Off
- FLAC/RAW PCM Encoding Control
- Bit-Depth Selection Control (for MISRC/HSDAOH, CXADC)
- FLAC Level & Threads Control
- Stereo/Mono/Quad channel record control for audio (You can select multiple options)
- Resampling Control for A/B (VHS config 20msps video 10msps hifi shown)
- Playback Input Files
There is a unified plugin system for deploying decoders.
Included currently are the following viewer modes.
- Stream Waveform (similar to an oscilloscope)
- FTT (visualizes peaks of signals carriers i.g video/hifi or your local FM radio)
- CVBS (Basic composite video decoder Luma B/W only currently)
Experimental support for Tape-Decode (A Rust re-write of vhs-decode) is also a working progress, this plugin hopes to allow for a quick is this working inspection and in the future potentially direct to file decoding however currently this does have massive limitation implications and performance cost implications, so it's not a high priority over the stability of the core feature of seeing there is something and getting it safely captured to file.
There is plans for a basic quality hi-fi audio decoder mode based off of the GNU radio script, allowing for directional test point finding and quick testing of sanity of if there is a HiFi FM signal present.
Statistics per channel will be available on the right hand side.
- Peak RF Level
- Clipping events observed + & - range
- Errors with feed
- Duration (HH.MM.SS)
- RAW Data Handled
- Encoded FLAC file size
- Compression Ratio (I.g 8.7x)
After a capture is finished these values will be persistent until a new capture starts or the application is closed.
Persistence config, once you have configured your settings a global configuration file will be saved and this will carry forward onto new versions or older test builds, this allows you to quickly change between builds to test things or to just instantaneously update to the latest version.
- Sync Status - confirms the current state of connectivity.
- XXX MSPS - shows your current rate of the hardware capture device I.g 40msps or 100msps
- Samples - xxxxGB gives you a rolling number of how many samples have been fed into the application during the current session.
- Frames - like samples shows you how many samples are in a frame counter.
- Missed - shows you how many frames of data have been missed.
- Errors - shows you how many hard dropout or encoder dropout errors there are.
- RF Buffer - shows the current level of the ring buffer for RF feeds.
- Audio Buffer - shows the current level of the ring buffer for audio feeds.
Understanding the waveform scale.
There are two visualization modes currently implemented.
- Level Bar (vertical colour indicator)
- Waveform Line
- Waveform Phosphor
On the zero line that is your DC offset position your signal should be level with this position to begin with irrespective of your gain level of the signal of input.
Ideal saturation range at 8-bit is typically within the plus +0.5 and -0.5 range of visualization, of course please do confirm with an oscilloscope and your recorded files before committing to long duration archival visualizations are of a decimated amount i.g (100/1000th samples) of data not an absolute of what is being captured to file.
Trigger modes like an oscilloscope can be done in the simple following.
Each channel can be triggered by any other channel by selecting the channel trigger mode.
Channels:
- Ch1 (RF)
- Ch2 (RF)
- Ch3 (MISRC Audio Ch3 or Clockgen Mod Mainboard Headswitching input)
Modes:
- Rising
- Falling
- Sync
- CVBS
There are plans to expand upon these to cover a full range of trigger modes you would typically see inside of an Siglent/Rigol oscilloscope.
The Text Icon opens the metadata tab for logging information about your capture.
MISRC GUI has a perpetual logging system, as record is pressed your exact system and record config is saved to your log file along with any metadata saved in the fields provided under the metadata window, and any configuration changes overall, this will also log any errors or buffering issues such as spillover usage to a temporary file, It will also confirm a file is properly encoded and saved so you know 100% the buffers were cleared correctly.
It is highly recommended to preserve these files alongside your captures, however unlike previous capture applications you're encoded FLAC files we'll have the correct duration on both the RF and standard audio files, and can have common metadata embedded into them. This allows for tools such as FLAC Chop to easily cut up or target or just remove dead space at the start and end of your capture sets.
This means no need for doing advanced math, simply just note the exact input and output timing positions you wish to make cuts and copy and paste across the different files of your capture sets, however you should also make a note inside of the log file if you do this to your files otherwise the information won't match up and maybe caught by future automated systems for disqualification.
MediaInfo Metadata Example:
Format : FLAC
Format/Info : Free Lossless Audio Codec
File size : 18.0 MiB
Duration : 6 min 55 s
Overall bit rate mode : Variable
Overall bit rate : 363 kb/s
DURATION_SECONDS : 415.838974
LENGTH : 415839
RF_TOTAL_SAMPLES : 4158389740
RF_SAMPLE_RATE : 10000000
RF_SAMPLE_RATE_KHZ : 10000
Log Example:
[2026-07-31 03:00:26] [INFO] MISRC capture log started (FLAC)
[2026-07-31 03:00:26] [INFO] computer_name: THE-RIPPER
[2026-07-31 03:00:26] [INFO] computer_model_name: unknown
[2026-07-31 03:00:26] [INFO] computer_cores: 32
[2026-07-31 03:00:26] [INFO] user_name: Harry
[2026-07-31 03:00:26] [INFO] operating_system_VERSION: Windows
[2026-07-31 03:00:26] [INFO] misrc_tools_version: dev-6d31f96
[2026-07-31 03:00:26] [INFO] datetime_start: 2026-07-31T03:00:26
[2026-07-31 03:00:26] [INFO] capture_log_path: C:\Users\Harry\Desktop/Test_Capture_2026.07.31_03.00.26_misrc_capture.log
[2026-07-31 03:00:26] [INFO] capture_base_name: Test_Capture
[2026-07-31 03:00:26] [INFO] output_path: C:\Users\Harry\Desktop
[2026-07-31 03:00:26] [INFO] capture_device_name: MS2130
[2026-07-31 03:00:26] [INFO] capture_device_type: hsdaoh
[2026-07-31 03:00:26] [INFO] capture_format: FLAC
[2026-07-31 03:00:26] [INFO] Capture channels: A=on B=on
[2026-07-31 03:00:26] [INFO] CVBS preview state: A=off B=off
[2026-07-31 03:00:26] [INFO] RF settings: bitsA=8 bitsB=8 resampleA=on(20000.0 kHz) resampleB=on(10000.0 kHz)
[2026-07-31 03:00:26] [INFO] Capture limits: capture_limit_seconds=0 record_limit_seconds=0 (record_timer_disarmed)
[2026-07-31 03:00:26] [INFO] Audio monitor: playback=off monitor_ch34=off misrc_mode=on
[2026-07-31 03:00:26] [INFO] MISRC V1.5/V2.5 A/B swap override: off
[2026-07-31 03:00:26] [INFO] Dropout handling: stop_on_dropout=off
[2026-07-31 03:00:26] [INFO] Ingest metadata project: (empty)
[2026-07-31 03:00:26] [INFO] Ingest metadata tape_id: (empty)
[2026-07-31 03:00:26] [INFO] Ingest metadata tape_format: (empty)
[2026-07-31 03:00:26] [INFO] Ingest metadata tape_size: (empty)
[2026-07-31 03:00:26] [INFO] Ingest metadata tape_speed: (empty)
[2026-07-31 03:00:26] [INFO] Ingest metadata tape_condition: (empty)
[2026-07-31 03:00:26] [INFO] Ingest metadata operator: (empty)
[2026-07-31 03:00:26] [INFO] Ingest metadata location: (empty)
[2026-07-31 03:00:26] [INFO] Ingest metadata notes: (empty)
[2026-07-31 03:00:26] [INFO] FLAC settings: level=8 verify=off threads=8
[2026-07-31 03:00:26] [INFO] FLAC affinity: enabled=off cpu_list=(none) support=unsupported
[2026-07-31 03:00:26] [INFO] FILE_PATH_A: C:\Users\Harry\Desktop/rfA_Test_Capture_2026.07.31_03.00.26_8-bit_20msps.flac
[2026-07-31 03:00:26] [INFO] FILE_PATH_B: C:\Users\Harry\Desktop/rfB_Test_Capture_2026.07.31_03.00.26_8-bit_10msps.flac
[2026-07-31 03:00:26] [INFO] Audio outputs: 4ch=off 2ch12=on 2ch34=off
[2026-07-31 03:00:26] [INFO] AUDIO_2CH_12_FILE_PATH: C:\Users\Harry\Desktop/Test_Capture_2026.07.31_03.00.26_Baseband_stereo_ch1_ch2.wav
[2026-07-31 03:00:32] [INFO] Recording stopped: duration=5.33s (00.00.05) rawA=394.00 MB (413138944 bytes) rawB=394.00 MB (413138944 bytes) waits=0 drops=0
[2026-07-31 03:00:32] [INFO] Capture time: 5.17s (00.00.05)
[2026-07-31 03:00:32] [INFO] Processing time: 0.16s (00.00.00)
[2026-07-31 03:00:32] [INFO] Output data: compressedA=9.31 MB (9763449 bytes) compressedB=9.15 MB (9599031 bytes)
[2026-07-31 03:00:32] [INFO] Compression ratio: total_raw=788.00 MB (826277888 bytes) total_compressed=18.47 MB (19362480 bytes) ratio=42.674x
[2026-07-31 03:00:32] [INFO] datetime_end: 2026-07-31T03:00:32
[2026-07-31 03:00:32] [INFO] Session complete
GUI flags
These flags open the GUI window (no capture args):
| Flag | Arg | Description |
|---|---|---|
--help / -h |
— | Print usage and exit |
--version |
— | Print version and exit |
--smoke-test |
— | Exit 0 if the binary loads OK (no window) |
--debug-view |
— | Verbose runtime logs |
--config |
<path> |
Load settings from <path> instead of the platform default |
--auto-connect |
— | Auto-trigger server/client connection (requires --config) |
--auto-connect requires --config <path> with a server (net_mode: 1) or client (net_mode: 2) config. Server mode auto-starts capture so RF data flows to clients; client mode auto-connects to the configured server. Without --config it exits with an error.
Headless CLI capture mode (full arg list)
The GUI binary doubles as the full misrc_capture CLI when any capture option is passed. GUI-only flags are processed first; any other arg routes into headless CLI capture mode (no window opens).
Run misrc_gui --help to see the full list with descriptions. Complete reference:
| Short | Long | Arg | Description |
|---|---|---|---|
-d |
--device |
[index] |
Input device index/name (default: 0) |
--devices / --device-list |
— | List available capture devices and exit | |
-n |
--count |
[samples] |
Number of samples to read (0 = infinite) |
-t |
--time |
[time] |
Capture duration: seconds, m:s or h:m:s (-n takes priority; assumes 40 MSPS) |
-w |
--overwrite |
— | Overwrite any files without asking |
-a |
--rf-adc-a |
[filename] |
RF ADC A output file (- for stdout) |
-b |
--rf-adc-b |
[filename] |
RF ADC B output file (- for stdout) |
-x |
--aux |
[filename] |
AUX output file (- for stdout) |
-r |
--raw |
[filename] |
Raw data output file (- for stdout) |
-p |
--pad |
— | Pad lower 4 bits of 16-bit output with 0 instead of upper 4 |
-L |
--level |
— | Display peak level of RF ADCs |
-A |
--suppress-clip-rf-a |
— | Suppress clipping messages for ADC A |
-B |
--suppress-clip-rf-b |
— | Suppress clipping messages for ADC B |
--8bit-a |
— | Reduce ADC A output from 12-bit to 8-bit (requires SoXR) | |
--8bit-b |
— | Reduce ADC B output from 12-bit to 8-bit (requires SoXR) | |
--resample-rf-a |
[kHz] |
Resample ADC A to given sample rate (requires SoXR) | |
--resample-rf-b |
[kHz] |
Resample ADC B to given sample rate (requires SoXR) | |
--resample-rf-quality-a |
[0-4] |
Resample quality ADC A (0=quick ... 4=very high, default: 3) | |
--resample-rf-quality-b |
[0-4] |
Resample quality ADC B (0=quick ... 4=very high, default: 3) | |
--resample-rf-gain-a |
[dB] |
Apply gain during resampling of ADC A (-72 to +72) | |
--resample-rf-gain-b |
[dB] |
Apply gain during resampling of ADC B (-72 to +72) | |
-f |
--rf-flac |
— | Compress RF ADC output as FLAC |
--rf-flac-12bit |
— | Set RF FLAC bit depth to 12 instead of 16 (legacy alias) | |
--rf-flac-bits |
[auto/12/16] |
Set the RF FLAC bit depth field | |
-l |
--rf-flac-level |
[0-8] |
RF FLAC compression level (0=lowest ... 8=highest, default: 1) |
-v |
--rf-flac-verification |
— | Enable verification of RF FLAC encoder output |
-c |
--rf-flac-threads |
[threads] |
Number of RF FLAC encoding threads per file (0 = auto; requires FLAC >= 1.4.0) |
--audio-4ch |
[filename] |
4-channel audio output file (- for stdout) |
|
--audio-2ch-12 |
[filename] |
Stereo audio output of inputs 1/2 (- for stdout) |
|
--audio-2ch-34 |
[filename] |
Stereo audio output of inputs 3/4 (- for stdout) |
|
--audio-1ch-1 |
[filename] |
Mono audio output of input 1 (- for stdout) |
|
--audio-1ch-2 |
[filename] |
Mono audio output of input 2 (- for stdout) |
|
--audio-1ch-3 |
[filename] |
Mono audio output of input 3 (- for stdout) |
|
--audio-1ch-4 |
[filename] |
Mono audio output of input 4 (- for stdout) |
SoXR resampling and FLAC compression options are only available when the binary is compiled with their respective libraries. Run misrc_gui --help to see which options are compiled in for your build.
Capture 2 hours of VHS from device 0, both channels, FLAC level 8, 8 threads, resampled to 20 MSPS (A) and 10 MSPS (B), with stereo audio:
misrc_gui -d 0 -t 2:00:00 -w -f -l 8 -c 8 -a capture_A.flac -b capture_B.flac --resample-rf-a 20000 --resample-rf-b 10000 --audio-2ch-12 baseband_audio_stereo.wav
Capture 30 minutes of Video8 from device 0, channel A only, raw 16-bit FLAC, peak level display, overwrite existing files:
misrc_gui -d 0 -t 30:00 -w -f -l 8 -c 8 -L -a video8_rf.flac --audio-2ch-12 baseband_stereo_audio.wav
Server/Client automated testing
Two GUI instances (server + client) can be launched with isolated configs and --auto-connect to test the full server/client chain without human intervention.
Create test configs:
mkdir -p /tmp/misrc-net-tests
cat > /tmp/misrc-net-tests/server_config.json <<'EOF'
{
"net_mode": 1,
"net_server_port": 8095,
"net_server_port_str": "8095",
"net_client_host": "",
"net_client_port": 8095,
"net_client_port_str": "8095"
}
EOF
cat > /tmp/misrc-net-tests/client_config.json <<'EOF'
{
"net_mode": 2,
"net_server_port": 8095,
"net_server_port_str": "8095",
"net_client_host": "127.0.0.1",
"net_client_port": 8095,
"net_client_port_str": "8095"
}
EOFLaunch both:
misrc_gui --config /tmp/misrc-net-tests/server_config.json --auto-connect &
sleep 3
misrc_gui --config /tmp/misrc-net-tests/client_config.json --auto-connect &Verify the chain:
# Server listening
ss -ltn | grep :8095
# Server /stats responds
curl -s http://127.0.0.1:8095/stats
# Client stderr shows connect + pump startup
grep -E "worker started|pump /rf|pump /baseband" /tmp/misrc-net-tests/client.stderr.logKill the client and verify the server detects the disconnect and stays alive:
kill <client_pid>
sleep 3
pgrep -af misrc_gui # server still alive, client gone
curl -s http://127.0.0.1:8095/stats # server still servingThe misrc_tools/test/cxadc_remote_capture_ci.sh script automates this full flow.
bash misrc_tools/test/cxadc_remote_capture_ci.sh ./build-local/misrc_gui 8095CI guard tests
Static guard checks (no hardware required):
python3 misrc_tools/test/ci_guard_tests.py --static-onlyCapture stability CI (requires a capture device or skips timed capture):
bash misrc_tools/test/capture_stability_ci.sh misrc_gui misrc_extract /tmp/ci-artifacts- December 2025 - Initial version presented by AlessandroAU (back and forth tinkering begins)
- February 2026 - First testing version released by Harry Munday
- April 4th 2026 - V1.0.0 Release (Basic HSDAOH support re-working by machcnz and vaguely stable)
- June 3rd 2026 - V1.0.7 Release first overall stable production release
- August 9th 2026 - Official public pushing for adoption and edge case bug finding!
- August 13th 2026 - Official release!
- August 24th 2026 - SDR Update (RTLSDR support + Waterfall/Spectro view modes)
- September 10th 2026 - CXADC refresh, Capture server/client/local modes integrated.
- September 22nd 2026 - CXADC rate/cycle modes, --auto-connect testing flag, FLAC level/threads warnings, clockgen audio cleanup.