CCExtractor

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.

Carlos' version (mainstream) is the most stable branch.

Google Summer of Code 2017

CCExtractor has been invited to Summer of Code 2017! Another summer of coding fun.

If you are a student currently enrolled in university most likely you are eligible to participate. Read more at:

• Google Summer of Code official website
• CCExtractor's main GSoC page

Installation and Usage

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:

• Using the command line tool
• Using the Windows GUI

Compiling

Debian/Ubuntu

# make sure you have CCExtractor repository forked
# clone repository
sudo apt-get install -y git
git clone https://github.com/%USERNAME%/ccextractor.git # paste your github username

# installing dependencies
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 (Choose any one of 2 methods)
METHOD 1: If you don't want to obtain object files
cd ccextractor/linux
./build

METHOD 2: 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

Fedora

# make sure you have CCExtractor repository forked
# clone repository
sudo yum install -y git
git clone https://github.com/%USERNAME%/ccextractor.git # paste your github username

# installing dependencies
sudo yum install -y gcc
sudo yum install -y tesseract-devel # leptonica will be installed automatically

# compiling (Choose any one of the 3 methods)
METHOD 1: If you don't want to obtain object files
cd ccextractor/linux
./build

METHOD 2: 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

Arch Linux

# make sure you have CCExtractor repository forked
# clone repository
sudo pacman -S git
git clone https://github.com/%USERNAME%/ccextractor.git # paste your github username

# building installation package (.pkg.tar.xz) or installing directly
cd ccextractor/package_creators
./arch.sh

Redhat Package Manager (rpm) based Linux Distributions

# make sure you have CCExtractor repository forked
# clone repository
# install git via source
git clone https://github.com/%USERNAME%/ccextractor.git # paste your github username

# building installation package (.rpm)
cd ccextractor/package_creators
./rpm.sh

OSX

#PRE-REQUISITES:
#Installing required packages via Homebrew
brew install pkg-config
brew install autoconf automake libtool
brew install tesseract
brew install leptonica 
#After installing Make sure tesseract and leptonica are detected by pkg-config

METHOD 1: Using build.command script
cd ccextractor/mac
./build.command

METHOD 2: Using autoconf scripts
cd ccextractor/mac
./autogen.sh
./configure
make

Windows

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.

Support

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.

Contributing

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 & Other Information

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