Subliminal
==========

Subliminal is an automatic subtitle extraction system.  It compares a raw video
with one into which subtitles have been encoded and tries to extract those
subtitles to facilitate soft-subbing.

Copyright (C) 2010, 2011  John Bytheway <jbytheway at that gmail place>

Note that the source tree is several megabytes (because of the video test
data).  Bear that in mind if downloading or cloning over a slow connection.

For building instructions see INSTALL.

Subliminal contains:

- boost
  Slightly tweaked version of the Boost.GIL numeric extension.
  (Note: you still need the rest of Boost; this extension is not distributed
  with it).

- ffmsxx
  A thin C++ wrapper round ffmpegsource.

- subliminal
  The program itself.

- score
  A very simple text-scoring program useful in postprocessing subliminal's
  output.

- test
  Some test data.

- doc
  User documentation.

Note that subliminal only extracts images which it believes to be the
subtitles.  If you need text subtitles you will need an OCR program too.  I
recommend tesseract <http://code.google.com/p/tesseract-ocr/>.


LICENSE
-------
This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program.  If not, see <http://www.gnu.org/licenses/>.