Skip to content

MacOS Build

Harry Munday edited this page Mar 13, 2026 · 15 revisions

MacOS Builds

Previous Page Home

Next Page Workflow Guide

Decode Launcher Universal GUI - 2026

Download & Usage

Self-Contained .app builds are published on the releases page: MacOS (Intel & Arm)

Allow MacOS to install non-signed apps

Open a Terminal or use Warp Terminal.

  1. Open System Settings: Click on the Apple menu in the top-left corner of your screen and select “System Settings.”

  2. Navigate to Privacy & Security: In the sidebar, click on “Privacy & Security.”

  3. 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.

  1. Then open System Settings --> Privacy & Security
  2. At the bottom under "security" there will be a prompt to allow application from Anyware to run.
  3. Click allow when prompted after the first launch of the new tbc-tools.app or vhs-decode.app

Use Decode & Tools via CLI

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.

Manually Building

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.

Notes

DD86 Discord

DomesDay Duplicator (DdD)

Builds for MacOS (Arm) can be found here.

Page End

Previous Page Home

Next Page Hardware Installation Guide

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