Skip to content

[Fix] [IMPROVEMENT] Fix CMake across all platform and clean compiling documentation. #761

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
cfsmp3 merged 2 commits into from
Jul 25, 2017
Merged

[Fix] [IMPROVEMENT] Fix CMake across all platform and clean compiling documentation. #761

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
da0893f
Fix CMakeLists for MacOS and Linux.
saurabhshri Jul 25, 2017
333fb6e
Cleanly format the compiling documentation and cmake instructions.
saurabhshri Jul 25, 2017
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
226 changes: 146 additions & 80 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@

![logo](https://avatars3.githubusercontent.com/u/7253637?v=3&s=100)

# CCExtractor
Expand Down Expand Up @@ -29,108 +30,173 @@ More usage information can be found on our website:
- [Using the command line tool](https://www.ccextractor.org/doku.php?id=public:general:command_line_usage)
- [Using the Windows GUI](https://www.ccextractor.org/doku.php?id=public:general:win_gui_usage)

You can also find the list of parameters and their brief description by running `ccextractor` without any arguments.

## Compiling

You may compile CCExtractor across all major platforms using `CMakeLists.txt` stored under `ccextractor/src/` directory. Simply,

1. Create and navigate to directory where you want to store built files

```
cd ccextractor/src/
mkdir build
cd build
```

2. 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
```

### 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

1. 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
```

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
2. Compiling

*Using build script :*

# test your build
./ccextractor
```
#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
```

### 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

1. Make sure all the dependencies are met.

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

# test your build
./ccextractor
2. Compiling

### 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
*Using build script :*

# building installation package (.pkg.tar.xz) or installing directly
cd ccextractor/package_creators
./arch.sh
```
#Navigate to linux directory and call the build script

cd ccextractor/linux
./build

# test your build
./ccextractor
```

### 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
*Standard linux compilation through Autoconf scripts :*

# building installation package (.rpm)
cd ccextractor/package_creators
./rpm.sh
```
sudo dnf install autoconf automake #Dependency to generate configuration script
cd ccextractor/linux
./autogen.sh
./configure
make

# test your build
./ccextractor
```

### 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

1. 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

2. Compiling

*Using build.command script :*

```
cd ccextractor/mac
./build.command
```

METHOD 2: Using autoconf scripts
cd ccextractor/mac
./autogen.sh
./configure
make
*Standard compilation through 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.

## Building Installation Packages

### Arch Linux

*building installation package (.pkg.tar.xz) or installing directly*

cd ccextractor/package_creators
./arch.sh

### Redhat Package Manager (rpm) based Linux Distributions

*building installation package (.rpm)*

cd ccextractor/package_creators
./rpm.sh

## Support

By far the best way to get support is by opening an issue at our [issue tracker](https://github.com/CCExtractor/ccextractor/issues).
Expand Down
13 changes: 7 additions & 6 deletions src/CMakeLists.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ option (WITH_SHARING "Build with sharing and translation support" OFF)

# Version number
set (CCEXTRACTOR_VERSION_MAJOR 0)
set (CCEXTRACTOR_VERSION_MINOR 85)
set (CCEXTRACTOR_VERSION_MINOR 85b)

# configure a header file to pass some of the CMake settings
# to the source code
Expand Down Expand Up @@ -36,13 +36,12 @@ if(WIN32)
aux_source_directory ("${PROJECT_SOURCE_DIR}/win_iconv/" SOURCEFILE)
aux_source_directory ("${PROJECT_SOURCE_DIR}/libpng/" SOURCEFILE)
set (EXTRA_LIBS ${EXTRA_LIBS} -lws2_32 -lwinmm)
else (WIN32)
# Adding some platform specific library path
link_directories (/opt/local/lib)
link_directories (/usr/local/lib)
endif(WIN32)


# Adding some platform specific library path
link_directories (/opt/local/lib)
link_directories (/usr/local/lib)

set (CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -O0 -Wall -g -std=gnu99 -Wno-write-strings -D_FILE_OFFSET_BITS=64")
add_subdirectory (lib_ccx)

Expand Down Expand Up @@ -73,6 +72,8 @@ else(PKG_CONFIG_FOUND)
aux_source_directory ("${PROJECT_SOURCE_DIR}/zlib/" SOURCEFILE)
endif (PKG_CONFIG_FOUND)

set (EXTRA_LIBS ${EXTRA_LIBS} -lz)

########################################################
# Build using FFmpeg libraries
########################################################
Expand Down