The README in the main GitHub repository will always be kept up-to-date for current builds and basic user guide help.

Linux Compatibility Doc

Self Contained Binary's: Linux x86

To give the AppImage permissions open terminal in the directory and use:

chmod +x decode.AppImage tbc-tools.AppImage 

Open a terminal and use the following commands :

Workflow assumes you have the decoder/tools/export in the same folder and at least FFmpeg installed systemwide this normally should be under User/Home/decode.

Run ./decode.AppImage with vhs, ld, cvbs, hifi at the start.

Example: ./decode.AppImage vhs calls vhs-decode, commands are universal.

Run ./tbc-tools.AppImage like any normal GUI app to open ld-analyse, the ld-xxxx tools are used just like Linux via CLI but within the decode folder.

Run ./tbc-video-export --appimage tbc-tools.AppImage for 100% self contained use (requires FFmpeg installed system wide)

This is the workflow to manually build the decoders and toolchain.

The vhs-decode repository also has hifi-decode, cvbs-decode & ld-decode included.

sudo apt install clang python3-setuptools python3-numpy python3-scipy python3-matplotlib git qt5-default libqwt-qt5-dev libfftw3-dev python3-tk python3-numba libavformat-dev libavcodec-dev libavutil-dev ffmpeg openssl pv python3-distutils make cython3 cmake pipx

For Ubuntu 22.04 that is:

sudo apt install clang python3-setuptools python3-numpy python3-scipy python3-matplotlib git qt5-qmake qtbase5-dev libqwt-qt5-dev libfftw3-dev python3-tk python3-numba libavformat-dev libavcodec-dev libavutil-dev ffmpeg openssl pv python3-distutils pkg-config make cython3 cmake pipx

Set up pipx

pipx ensurepath

(Alternatively, a python virtual environment can be used instead of using pipx)

Install TBC-Video-Export

pipx install tbc-video-export

(There is also self contained builds if install issues arise)

Optional dependencies for GPU (Nvidia Cards) FLAC compression support:

sudo apt install make ocl-icd-opencl-dev mono-runtime

Also Requires FlaLDF Download & Install via .deb for Linux.

When installing from source, if you want the gui you have hifi_gui and hifi_gui_qt6

QT5

pipx install vhs_decode[hifi_gui]

QT6

pipx install vhs_decode[hifi_gui_qt6]

Download VHS-Decode:

git clone https://github.com/oyvindln/vhs-decode.git vhs-decode

Install VHS-Decode:

cd vhs-decode

Build and install vhs-decode via pipx

pipx install .[hifi_gui]

Compile and Install ld-tools suite: (Required)

mkdir build2
cd build2
cmake .. -DCMAKE_BUILD_TYPE=Release -DUSE_QT_VERSION=5
make -j4
sudo make install

Go back to the main directory with

cd .. 

To update the decoders and tools do git pull while inside of the vhs-decode directory, and repeat the above build & compile steps.

Binary versions, there is no automatic updates simply check back on the releases page from time to time.

Older builds may have use for testing or understanding, deprecated or older revisions of functions.

Between 2021-2024 there was 2 notable turning points in the building process.

Pre-Pipx switchover

Pre-Cmake switchover

Previous Page Home