You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Update COMPILATION.md with FFmpeg version configuration details
- Added overview section explaining platform-specific FFmpeg defaults
- Updated Linux build instructions with FFmpeg version override examples
- Updated macOS build instructions with hardsubx and FFmpeg options
- Updated Windows build instructions with FFmpeg 7 default note
- Added CMake instructions for FFmpeg version configuration
- Documented FFMPEG_VERSION environment variable usage across all platforms
### Hardsubx (Burned-in Subtitles) and FFmpeg Versions
14
+
15
+
CCExtractor's hardsubx feature extracts burned-in subtitles from videos using OCR. It requires FFmpeg libraries. The build system automatically selects appropriate FFmpeg versions for each platform:
16
+
17
+
-**Linux**: FFmpeg 6.x (default)
18
+
-**Windows**: FFmpeg 7.x (default)
19
+
-**macOS**: FFmpeg 8.x (default)
20
+
21
+
You can override the default by setting the `FFMPEG_VERSION` environment variable to `ffmpeg6`, `ffmpeg7`, or `ffmpeg8` before building. This flexibility ensures compatibility with different FFmpeg installations across platforms.
22
+
13
23
## Docker
14
24
You can now use docker image to build latest source of CCExtractor without any environmental hustle. Follow these [instructions](https://github.com/CCExtractor/ccextractor/tree/master/docker/README.md) for building docker image & usage of it.
15
25
@@ -62,12 +72,22 @@ cd ccextractor/linux
62
72
# compile with debug info
63
73
./build -debug # same as ./builddebug
64
74
65
-
# compile with hardsubx
66
-
[Optional] You need to set these environment variables correctly according to your machine,
67
-
FFMPEG_INCLUDE_DIR=/usr/include
68
-
FFMPEG_PKG_CONFIG_PATH=/usr/lib/pkgconfig
75
+
# compile with hardsubx (burned-in subtitle extraction)
76
+
# Hardsubx requires FFmpeg libraries. Different FFmpeg versions are used by default:
77
+
# - Linux: FFmpeg 6.x (automatic)
78
+
# - Windows: FFmpeg 7.x (automatic)
79
+
# - macOS: FFmpeg 8.x (automatic)
80
+
81
+
./build -hardsubx # uses platform-specific FFmpeg version
69
82
70
-
./build -hardsubx # same as ./build_hardsubx
83
+
# To override the default FFmpeg version, set FFMPEG_VERSION:
84
+
FFMPEG_VERSION=ffmpeg8 ./build -hardsubx # force FFmpeg 8 on any platform
85
+
FFMPEG_VERSION=ffmpeg6 ./build -hardsubx # force FFmpeg 6 on any platform
86
+
FFMPEG_VERSION=ffmpeg7 ./build -hardsubx # force FFmpeg 7 on any platform
87
+
88
+
# [Optional] For custom FFmpeg installations, set these environment variables:
89
+
FFMPEG_INCLUDE_DIR=/usr/include
90
+
FFMPEG_PKG_CONFIG_PATH=/usr/lib/pkgconfig
71
91
72
92
# compile in debug mode without rust
73
93
./build -debug -without-rust
@@ -113,9 +133,15 @@ sudo make install
113
133
114
134
`cmake` also accepts the options:
115
135
`-DWITH_OCR=ON` to enable OCR
116
-
`-DWITH_HARDSUBX=ON` to enable burned-in subtitles
136
+
`-DWITH_HARDSUBX=ON` to enable burned-in subtitles (requires FFmpeg)
117
137
118
-
([OPTIONAL] For hardsubx, you also need to set these environment variables correctly according to your machine)
0 commit comments