Skip to content

build-wsl.md

Latest commit

 

History

History
137 lines (88 loc) · 1.87 KB

build-wsl.md

File metadata and controls

137 lines (88 loc) · 1.87 KB

Building CCExtractor on Windows using WSL

This guide explains how to build CCExtractor on Windows using WSL (Ubuntu). It is based on a fresh setup and includes all required dependencies and common build issues encountered during compilation.

Prerequisites

  • Windows 10 or Windows 11
  • WSL enabled
  • Ubuntu installed via Microsoft Store

Install WSL and Ubuntu

From PowerShell (run as Administrator):

wsl --install -d Ubuntu

Restart the system if prompted, then launch Ubuntu from the Start menu.

Update system packages

sudo apt update

Install basic build tools

sudo apt install -y build-essential git pkg-config

Install Rust (required)

CCExtractor includes Rust components, so Rust and Cargo are required.

curl https://sh.rustup.rs -sSf | sh
source ~/.cargo/env

Verify installation:

cargo --version
rustc --version

Install required libraries

sudo apt install -y \
  libclang-dev clang \
  libtesseract-dev tesseract-ocr \
  libgpac-dev

Clone the repository

git clone https://github.com/CCExtractor/ccextractor.git
cd ccextractor

Build CCExtractor

cd linux
./build

After a successful build, verify by running:

./ccextractor

You should see the help/usage output.

Common build issues

cargo: command not found

source ~/.cargo/env

Unable to find libclang

sudo apt install libclang-dev clang

gpac/isomedia.h: No such file or directory

sudo apt install libgpac-dev

please install tesseract development library

sudo apt install libtesseract-dev tesseract-ocr

Notes

  • Compiler warnings during the build process are expected and do not indicate failure.
  • This guide was tested on Ubuntu (WSL) running on Windows 11.