-
Notifications
You must be signed in to change notification settings - Fork 93
MacOS Build
Previous Page Home
Next Page Workflow Guide
Decode Launcher Universal GUI - 2026
Self-Contained .app builds are published on the releases page: MacOS (Intel & Arm)
Open a Terminal or use Warp Terminal.
-
Open System Settings: Click on the Apple menu in the top-left corner of your screen and select “System Settings.”
-
Navigate to Privacy & Security: In the sidebar, click on “Privacy & Security.”
-
Keep System Settings Open: Ensure this window remains open throughout the process.
Open Terminal: Go to Applications > Utilities > Terminal.
Disable Gatekeeper: In the Terminal window, paste the following command and press Enter:
sudo spctl --master-disable
You will be prompted for a password, to run the command, this unlocks the "allow any" option for apps.
- Then open System Settings --> Privacy & Security
- At the bottom under "security" there will be a prompt to allow application from Anyware to run.
- Click allow when prompted after the first launch of the new
tbc-tools.apporvhs-decode.app
Open a terminal after moving the apps to your applications directory.
Run vhs-decode.app with vhs, ld, cvbs, hifi at the start i.g decode.app vhs calls the decoder you desire, commands are universal.
Run tbc-tools.app opening it will call ld-analyse, otherwise manually call tools via tbc-tools.app ld-chroma-decoder for example.
MacOS x86 & Arm is supported.
Warning
Only MacOS 11 "Big Sur" and newer is supported with native building and self-contained binaries.
Note
Brew is required to pull down the correct packages.
Tip
If your having installation problems or want automated installation assistance, use Agent mode with Warp terminal, If it manages to solve an installation issue please make an issue ticket, and post your entire start to finish process dialogue on the terminal so documentation can be updated.
Install Brew:
Open a Terminal and paste:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Install Dependencies:
brew install cmake pkg-config qt qwt ffmpeg fftw python pipx rust
Download vhs-decode repository
git clone https://github.com/oyvindln/vhs-decode.git vhs-decode
cd vhs-decode
Once cloned from git, run this to install the python part:
pipx ensurepath
pipx install . --python python3.12
Install TBC-Video-Export
pipx install tbc-video-export
(There is also self contained builds if install issues arise)
Then build ld-tools suite:
cmake -B build -DCMAKE_BUILD_TYPE=Release -DUSE_QT_VERSION=6 -DBUILD_PYTHON=false
cmake --build build -j8
cmake --install build
This should install the binaries in your bin folder, otherwise you can run them from the vhs-decode folder.
Builds for MacOS (Arm) can be found here.
Previous Page Home
Next Page Hardware Installation Guide
- FAQ - Frequently Asked Questions
- Diagram Breakdowns
- Visual-Comparisons
- VCR Reports / RF Tap Examples
- Download & Contribute Data
- Speed Testing
- Capture Setup Guide
- MISRC
- CX Cards & CXADC
- CX Cards - Clockgen Mod
- DdD - Domesday Duplicator
- RTL-SDR
- Hardware Installation Guide
- Finding RF Tap Locations
- Amplifier Setup Guide
- The Tap List Example VCR's
- Visual VBI Data Guide
- Closed Captioning
- Teletext
- WSS Wide - Screen Signalling
- VITC Timecode
- VITS Signals
- XDS Data (PBS)
- Video ID IEC 61880
- Auto Audio Align
- Vapoursynth TBC Median Stacking Guide
- Ruxpin-Decode & TV Teddy Tapes
- Tony's GNU Radio For Dummies Guide
- Tony's GNU Radio Scripts
- DomesDay Duplicator Utilities
- ld-decode Utilities