
dvdspanky readme
===========================================================


about
-----------------------------------------------------------
dvdspanky is a CLI front-end to transcode and mplex created
specifically for converting various types of video to DVD
MPEGs ready to be used in dvdauthor or similar. it is
designed for clean readable output while being simple,
automated and customisable. this program is written in C.


features
-----------------------------------------------------------
0.10.0
- output preview
- automatic fallback to mplayer decoding
0.9.1
0.9
- very consistent options no matter the input format
- clean output and progress
- destination file size option
- multi pass VBR or single pass CBR
- PAL/NTSC conversion
- transcode filters
- automatic border and croping
- automatic audio bit-rate rounding
- automatic aspect calculations
- automatic PAL/NTSC detection


requirements
-----------------------------------------------------------
- A POSIX compatible operating system such as GNU/Linux,
  *BSD etc.
- GCC (for gcc), GPL v2 licence
   http://gcc.gnu.org/
- mplayer, GPL v2 licence
   http://www.mplayerhq.hu/
- transcode, GPL v2 licence
   http://www.transcoding.org/
- mjpegtools (for mplex), GPL v2 licence
   http://mjpeg.sourceforge.net/


compile dependencies
-----------------------------------------------------------
- pcre library, PCRE licence (GPL/LGPL compatible)
   http://pcre.sourceforge.net


installation
-----------------------------------------------------------
./configure [ --prefix dir ]
make
su
make install
exit


tips
-----------------------------------------------------------
- NTSC/PAL conversion: (-F|--frameadjust):
    it is usually better to convert PAL<->NTSC from 24<->25
    FPS without frame-rate interpolation. the small speedup
    is not noticeable and far better than interpolation,
    and frame droping. to drop 30 FPS NTSC to 25 FPS PAL is
    when you make good use of the interpolation.
- preview:
    it is usually best to preview a video soon after you
    have started transcoding. eg. mplayer outfile.m2v.
    a preview option is coming soon.


software licence
-----------------------------------------------------------
the software is licenced under the GPL General Public
Licence version 2, the documentation is licenced under the
FDL Free Document Licence. see the COPYING file for the actual
licences.


copyleft
-----------------------------------------------------------
Copyright (c)  2007  Jeffrey Grembecki.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the section entitled "GNU
Free Documentation License".

