CCExtractor is a tool that produces subtitles from TV use. Global accessibility (all users, all content, all countries) is the goal. With so many different formats, this is a constantly moving target, but we intend to keep up with all sources and formats.
The official repository (CCExtractor/ccextractor) is the most stable branch. It is (mainly) maintained by Carlos (cfsmp3).
CCExtractor has been invited to Code-in 2017! A second year of challenging tasks for students aged 13-17.
If you are a student fitting the age criteria, then you most likely are eligible to participate. Read more at the Google Code-in website.
Downloads for precompiled binaries and source code can be found on our website.
Extracting subtitles is relatively simple. Just run the following command:
ccextractor <input>
This will extract the subtitles.
More usage information can be found on our website:
You can also find the list of parameters and their brief description by running ccextractor without any arguments.
You may compile CCExtractor across all major platforms using CMakeLists.txt stored under ccextractor/src/ directory. Simply,
- Create and navigate to directory where you want to store built files
cd ccextractor/
mkdir build
cd build
- Generate makefile using cmake and then compile
cmake ../src/
make
You may also generate .sln files for Visual Studio and build using build tools, or open .sln files using Visual Studio.
cmake ../src/ -G "Visual Studio 14 2015"
cmake --build . --config Release --ccextractor
CCExtractor can also be compiled without cmake. System specific instructions are listed below :
Clone the latest repository from Github
git clone https://github.com/CCExtractor/ccextractor.git
- Make sure all the dependencies are met.
sudo apt-get install -y gcc
sudo apt-get install -y libcurl4-gnutls-dev
sudo apt-get install -y tesseract-ocr
sudo apt-get install -y tesseract-ocr-dev
sudo apt-get install -y libleptonica-dev
# Note: On Ubuntu Version 14.04 (Trusty) and earlier, you should build leptonica and tesseract from source
- Compiling
Using build script :
#Navigate to linux directory and call the build script
cd ccextractor/linux
./build
# test your build
./ccextractor
Standard linux compilation through Autoconf scripts :
sudo apt-get install autoconf #Dependency to generate configuration script
cd ccextractor/linux
./autogen.sh
./configure
make
# test your build
./ccextractor
- Make sure all the dependencies are met.
sudo yum install -y gcc
sudo yum install -y tesseract-devel # leptonica will be installed automatically
- Compiling
Using build script :
#Navigate to linux directory and call the build script
cd ccextractor/linux
./build
# test your build
./ccextractor
Standard linux compilation through Autoconf scripts :
sudo dnf install autoconf automake #Dependency to generate configuration script
cd ccextractor/linux
./autogen.sh
./configure
make
# test your build
./ccextractor
- Make sure all the dependencies are met. They can be installed via Homebrew as
brew install pkg-config
brew install autoconf automake libtool
brew install tesseract
brew install leptonica
Make sure tesseract and leptonica are detected by pkg-config, e.g.
pkg-config --exists --print-errors tesseract
pkg-config --exists --print-errors lept
- Compiling
Using build.command script :
cd ccextractor/mac
./build.command OCR
If you don't want the OCR capabilities, then you don't need to configure the tesseract and leptonica packages, and build it with just
cd ccextractor/mac
./build.command
Standard compilation through Autoconf scripts :
cd ccextractor/mac
./autogen.sh
./configure
make
Open the windows/ccextractor.sln file with Visual Studio (2015 at least), and build it. Configurations "(Debug|Release)-Full" includes dependent libraries which are used for OCR.
- Make sure all the dependencies are met.
- Compiling
cd ccextractor/linux
./autogen.sh
./configure --with-gui
make
# test your build
./ccextractorGUI
- Make sure all the dependencies are met. They can be installed via Homebrew as
brew install glfw
brew install glew
- Compiling
cd ccextractor/mac
./autogen.sh
./configure --with-gui
make
Open the windows/ccextractor.sln file with Visual Studio (2015 at least), and build it. Configurations "(Debug|Release)-Full" includes dependent libraries which are used for OCR.
building installation package (.pkg.tar.xz) or installing directly
cd ccextractor/package_creators
./arch.sh
building installation package (.rpm)
cd ccextractor/package_creators
./rpm.sh
By far the best way to get support is by opening an issue at our issue tracker.
When you create a new issue, please fill in the needed details in the provided template. That makes it easier for us to help you more efficiently.
You can also contact us by email or chat with the team in Slack.
You can contribute to the project by forking it, modifying the code, and making a pull request to the repository. We have some rules, outlined in the contributor's guide.
News about releases and modifications to the code can be found in the CHANGES.TXT file.
For more information visit the CCExtractor website: https://www.ccextractor.org