mirror of https://github.com/CCExtractor/ccextractor.git synced 2026-02-03 21:23:48 +00:00

Files

Kurma Ritish 0890e06d84 docs: add Windows WSL build instructions

2026-01-04 08:47:48 +00:00

1.9 KiB

Raw Permalink Blame History

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.

1.9 KiB Raw Permalink Blame History