Skip to content

Quick Setup Guide

Harry Munday edited this page Dec 8, 2025 · 24 revisions

Next Page Hardware Installation Guide

Previous Page Home

Sub-Page FAQ - Frequently Asked Questions

System Hardware Requirements

RF Capture solutions should be selected based off the tape formats or format you wish to capture

Recommended:

Desktop/Laptop/Server Platform

  • CPU: Ryzen 5000/7000 | Apple Arm M series | Intel i7 6th gen or newer
  • Graphics Card: Nvidia GPU 980ti or newer (For faster Teletext decoding)
  • Operating System: Linux (Ubuntu 22.04 or newer), Microsoft Windows 10 2009 (or Newer), Apple MacOS (MacOS 11 "Big Sur" or Newer)
  • Storage Capture: 2-8TB SSD or RAID Recommended
  • Storage Working: 8-20TB+ Recommended (WD/Seagate/HGST etc)

Minimum:

  • CPU: Intel 3rd gen (2010s era) / Ryzen 1000 Series (2016+ era)
  • Graphics Card: Integrated Graphics (only teletext decoding uses GPU processing)
  • Operating System: Linux (Mint/Ubuntu 22.04 or newer), Microsoft Windows 10 2009 (or Newer), Apple MacOS (MacOS 11 "Big Sur" or Newer)
  • Storage 500GB-2TB 7200 RPM HDD

Office PC with an Intel i7 or i5 quad-core CPU from 2008-Current day is more then enough powerful enough to capture, and will in most 2012 and newer chips will also be able to do real-time FLAC compression during capture thanks to multi-threading support as long as you have FLAC v1.5.0 or newer installed.

But decoding should not be expected to be faster than 2-3fps on very old hardware, 5fps and faster on higher end 2017 and newer hardware.

Higher Sample Rate = More Data = Slower Decoding

A 40msps file will take longer then a 20msps file or a 10msps HiFi file will do 1-3x real-time as it's much less range of data for decoders to look at and handle.

Tip

Used high-end hardware from 2017 or 2-4 years of current new generation of chips (CPUs) is always better than very old low end, modern low to middle end hardware or "low power" hardware options.

For non-Linux and just people who are new to CLI or Command Line Interfaces users we recommend Linux Mint Cinnamon over Ubuntu if your entirely unfamiliar with Linux with a simple setup guide.

The most flexible and cost-effective capture and decode setup will be with Linux on desktop hardware but initial capture can always be done though a in-expensive USB boot using the Linux Live Boot workflow with CX Cards.

MacOS is limited to the DdD/MISRC platform for capturing, Windows has its own driver/clockgen mod implementation.

Decode Software Suite

There is 2 ways to use the decode software suite, self-contained or built locally from source, each operating systems has its own steps and notes.

Tip

If making cold store archives you will want to bundle the source code and or self-contained binary's together with said archive.

Pick your capture hardware

Full format & device breakdown is on the Workflow Guide!

PCie 1x (1-2x slots) - Most Affordable

  • CX Card 1x - Ideal for single channel formats Video8/Hi8 & Betamax (HiFi only) NTSC.

  • Clockgen Mod - Ideal for VHS, Betamax, U-matic as it combines two CX Cards and a Audio ADC all 3 devices use shared clock source allowing for practical Video & HiFi or Linear audio synchronised capture as there is no hardware "drift".

USB 3.0 - More Expensive

  • DdD - DomesDay Duplicator (ideal for LaserDisc and Video8/Hi8 normal HiFi tapes)

  • MISRC - Multi Input Simultaneous Raw RF Capture, ideal for most multi-channel V1.5 & V2.5 has intergrated 4ch of audio capture.

Basic Command Line Interface "CLI" Guide

Universal Command List

A "directory" is simply a folder in the system, avoid spaces on files and folders otherwise you will have to "wrap/the/folder/path" like so with " for the applications to find the files this is done automatically on drag and drop for most Command Prompts or Terminals.

cd To enter into an directory.

cd .. To go back an directory.

./ Runs a script or application in a local directory. (Linux/Unix/Powershell)

CTRL + C Kills the current process in a terminal.

sudo su Admin permissions access or run/delete anything.

This is universal for Windows / MacOS / Liunx - The tools are CLI easyer to maintain then a GUI, easy to use remotely and very little changes to worry about once learned, please read the builds doc for your respective OS your going to operate decode on as formatting can slightly differ.

Tip

You can write out and or modify example commands and note them down in a txt or md file then simply copy, edit, paste when needed.

Quick Capture & Process Basics

Tip

Its recommend using the standardised naming guide so you and others know what your files are without guess work.

RF Capture--> FLAC Compress --> Archive

RF Capture --> Decode --> Inspect --> Export

DomesDayDuplicator "DdD" Setup

Fabricate --> Flash DE0 & FX3 boards --> Install USB Driver --> Open App & Capture

Note

Has sample drop issues on Windows for 99% reliability use MacOS or Linux install for initial captures.

If you have an DomesDayDuplicator you don't need to care about Linux past live install and having an exFat formatted HDD drive to move the data cross operating systems.

Decode workflow is 3-4 commands commands for the most part, for a plug and play setup today using a DdD + RTLSDR is fairly standard, but CX Cards with the Clockgen mod is more affordable and automatable.

GUI is simple for the DdD it tells you how long it runs just to make sure it's in 10-bit packed mode making an .lds raw file you then compress it to a .ldf 16-bit FLAC file.

Capture runtime limiting and capture time with storage space available is shown in the GUI application.

Software Control Options:

40 MHz 16-bit Signed Scaled Output is .raw (Recommended Mode To Use For HiFI Currently)

40 MHz 10-bit Packed Unsigned Output is .lds (Recommended Mode To Use)

Caution

10 Mhz 10-bit Packed Unsigned (4:1) is .cds not supported by toolchain do not use this option.

Compress Capture Down

(replace with the name you wish to use with your media capture)

Run ld-compress capture-name.lds in Linux/MacOS with your .lds file in the vhs-decode scripts directory or anyware if installed on path.

For Windows there is compression scrips with .bat files drag en drop to compress DdD or CX Card files.

CXADC (Stock 28mhz Card)

Note

Requires a hardware installation of Linux on a desktop or laptop with external PCIe 1x slot or bandwidth available.

Shutdown System --> Unplug --> Physically Install into PCIe slots --> Plug back in --> Power on. --> Install Driver --> Restart --> Use Driver.

CXADC Wiki for overview information path.

Driver install and use of CXADX is 100% covered in the readme for it.

Find VMUX --> Test Capture --> Decode Test Capture

./leveladj sets the gain level best to start the tape a few seconds in to set the gain then rewind and begin full capture, this can be ignored if amplifiers are employed in the capture chain as you can set gain to 0 and pretty much ignore it.

There is a GUI Alpha App that can make life easier.

Rule of thumb always sample higher then required if using a stock card 28msps 8-bit mode is the go to.

Caution

Do not use 35mhz 8-bit as it's just up-sampling data and wasting space.

Compress Capture Down

In technicality, you can down sample to 6-bits before any real world information loss occurs, but the ideal clock and sampling rate for CX Cards is 40mhz or 40msps 8-bit to make the most of the 10-bit ADC chip for initial captures, however for space-saving down sampling to 20msps 8-bit is a treading standard but has risks of causing issues for out of spec captures and SoX on windows can generate invalid data.

Fine Adjustments

With VCRs assuming no major issues you have 2 main controls physical tape guides and digital tracking IC control, now tracking is normally manipulable via a knob on a pro deck and channel up/down on consumer to prosumer deck front panels, or via remote if you have the remote, however, if its physical guides not aligned you will need to adjust them until the tape plays within spec.

A CRT TV or video monitor is generally recommended as you can view tapes directly without any need for any digital processing/stabilisation however this is a manual observation method and consumer CRTs with under scan modes are a recommended minimum as most consumer units have cropped edges/bottom head switch area of the video so Sony/JVC PVM/BVM style monitors with there horizontal/vertical shift and under scan modes are preferable, but any old later Sony Trinitron, for example will work fine for most peoples needs.

RF Tap points

On most VCRs you have test points next to each other or by the conventional video outputs, if you're going to modify your consumer/prosumer VCR its worth installing a couple more BNC's and cables to signal points such as head switching, for SCART only decks this is an opportunity to add CVBS in/out etc.

When the term "tap point" is used think signal output connection point, a cable soldered at a test point or signal path point using a cable like RG316 or RG178 to a mechanically secure bulkhead, or to a jig boards for camcorders.

Important

The centre wire is signal and the outer wrapping wire is ground coax is much loved as it provides basic RF shielding and is not only cheap but universally available worldwide. RED = Pos/+/Signal/Live & BLACK = Neg/-/Ground/Return

Test points normally will be called the following:

RF Y, RF C, RF Y+C, PB, V RF, V ENV, ENV, ENVELOPE, VIDEO ENVE, VIDEO ENVELOPE - Video RF

RF-Out, A-RF, HIFI RF - Audio RF

A.Out - Linear Baseband

Important

Don't forget about Ground - There is normally always a common ground point nearby or ground shield that can be soldered to as a ground all RF needs a return path proper grounding matters!

RF & Reference Capture Setup

Note

With a 10uf capacitor in-line de-coupling the test point, you should be able to capture RF and conventional normal baseband i.e CVBS or S-Video output at the same time with virtually no affect on RF or standard video output.

Having a conventional capture and viewing for reference is very useful to understand the state of a tape and possible errors like tracking, audio sync and damaged segments.

  • CRT or Digital TV with S-Video/CVBS/SCART
  • DMR-ES10 / ES15 or equivalent signal passthrough stabiliser. (if no remote press eject then external link up/down on DMR units)
  • EasyCrap/BlackMagic SDI or GV2-USB (or even CVBS to HDMI to HDMI to USB)

You can have a complete reference capture setup for around 50USD or less globally if you look around properly.

Storage Solutions!

Allocate 500GB to 2TB of storage 100MB/s Write Speed Safe Minimum.

For affordable local storage:

Western Digital (WD) make EasyStores/Elements lines

Seagate makes Desktop/Backup lines

These are great mass storage drives, however, do not use the included USB caddy and you may need a simple Molex to SATA power adapter due to power pinning standards used on the drives to use on desktops, USB caddies are not preferred for mass storage nor is keeping it some ware it can be physically knocked common sense and keeping critical equipment off USB is hand in hand as USB bus data is a shared system ware as SATA to SATA is direct and unaffected, however, if using USB don't use the included adapter as that makes the drive crippled in terms of being able to use it in a desktop it after the fact without copying or deleting all the data off.

There is a "shucking" community around these drives due to the low cost per gigabyte new 14TB+ units should be server-grade drives as some 8TB drives are now lower grade on the WD side.

Creating Archives and Preservation

Media Archive Guide & LTO Tape Guide

Currently, we only have M-Disk & DataLifePlus as a solid archive format widely on the market using the standard Blu-Ray format

25GB SL, 50GB DL, 100GB TL & 128GB Sony

These discs are not affected by humidity/thermal shifts/radiation and magnetic forces if stored in a crush-proof environment these disks will last better then factory stamped non-dye disks decades if not up-to "1000" years when the polycarbonate plastics start de-bond.

Once written all modern DVD/BluRay readers/writers & players support the UDF data format, which can be read on PC/Mac/Linux/Android and even IOS with some select Blu-Ray readers that have file system translation modes.

Amazon US / Amazon UK has a constant supply.

Cloud Services

Backblase Personal Backup Plan *7USD/m

For testing or interesting signals & issues you encounter feel free to store them on the Telegram Group.

Please be sure to read and use the Submission Guidelines Naming System this ensures sanity of knowing what files are what format.

Reference Diagrams

Diagrams Visuals Page

Note! open the image in another tab or download it to view full scale in case of viewing issues.

Page End

Next Page Hardware Installation Guide

Previous Page Home

Home

Starting & Contributing

Software Installation

Capture Hardware

Hardware Installation

Software Usage

VBI Data Extraction & Decoding

Tools & Scripts

Guides

Technical

Other Decoders

Support & Community

Clone this wiki locally