Man Linux: Main Page and Category List

NAME

       mpgtx,  mpgsplit,  mpgcat, mpgjoin, mpginfo, mpgdemux - manipulate mpeg
       files

SYNOPSIS

       mpgtx command [ options ] file [ range | file ] ...

DESCRIPTION

       mpgtx can split and join MPEG files in various ways. Three  file  types
       are  currently  handled  (more  to  come): MPEG 1 Video files, MPEG 1/2
       Audio files (mp1, mp2, and mp3), MPEG 1 System files (audio  and  video
       files),  MPEG  2  Program  files (Experimental), MPEG 2 Transport files
       (demultiplex and info modes only).  mpgtx is a GOP (Group of  Pictures)
       based  editor.  This  means  that  mpgtx  cuts MPEG files on a Group Of
       Picture basis, not on a frame-by-frame basis. A typical GOP duration is
       about  0.5  sec  (approx.  15 frames), limiting the maximum accuracy of
       mpgtx.

COMMANDS

       -i     prints information about files,  such  as  duration,  dimention,
              bitrate, etc.

       -j     joins files (ranges may be specified, see the RANGES section).

       -s     splits  files  according to the specified ranges (see the RANGES
              section).

       -d     demultiplexes composite mpeg file.

       -T     manipulates ID3v1 tags from mp3 files (see tagmp3(1)).

       -h     prints a (not so) short help message.

       -v     prints version and exit.

       -#     where # is a number, splits the given files in # parts.

       --force
              enables joining of incompatible files  (some  players  are  very
              robust)

       --no-parachute
              prevents  mpgtx  to try to catch SIGSEGV signal. This is usefull
              for debugging.

       In addition, when invoked with the  names  mpgjoin,  mpgcat,  mpgsplit,
       mpgdemux,  tagmp3  or  mpginfo,  mpgtx will modify its behaviour in the
       following ways:
       mpginfo behaves as mpgtx -i
       mpgsplit behaves as mpgtx -s
       mpgjoin behaves as mpgtx -j
       mpgcat behaves as mpgtx -j -o -
       mpgdemux behaves as mpgtx -d
       tagmp3 behaves as mpgtx -T

OPTIONS

       -f     force overwriting of files, never ask.

       -Ax    Change aspect ratio of mpeg. Valid are  1,2,3,4  for  1:1,  4:3,
              16:9, 2.2:1

       -P     Keep junk or unusual headers in splits

       -X     Desperate  mode,  search  the  whole  movie for a valid PACK. In
              addition with Option -N no search infos will be displayed,  only
              end summary.

       -N     Suppress  progress  output to the console. Speeds up operation a
              little on most Systems and much on Macintosh OS9.
              Suppress time line check in mpginfo mode.

       -b NAME
              each output file will have the basename NAME

       -o FILE
              FILE will be used  as  the  output  file  (used  with  the  join
              command). if FILE is -, standard output will be used.

RANGES

       Each range must follow a filename or another range.  A range in an MPEG
       file can be specified using one of this three notations: Note  for  OSX
       Users: Ranges must be enclosed in single or double Quotes!

       [a-b]  from  value  a  inclusive to value b inclusive. If you want half
              opened ranges, you may want to use ]a-b], [a-b[ or ]a-b[.

       [n/ntot]
              the n th part out of ntot.  [1/4]  would  result  in  the  first
              quarter of the specified file.

       {a-b-...}
              with  a  ,  b , ...  in ascending order. Split specified file at
              given boundaries. {55M} therefore means from beginnig of file to
              55Megs and from 55Megs to the end of file.

VALID VALUES

       Values of ranges can be specified in seconds or as a byte offset.

       Time Format
              HH:MM:SS.SS where the HH: part can be omited

       Offset Format
              a number optionally followed by M for Megabytes k for kilobytes

       Omitted Values
              An  empty  value is valid and is equivalent to the corresponding
              file boundary:
              [-10M] are the first 10 Megabytes of the file.
              [1:10:04-] from 1 hour 10 minutes 4 seconds to the end of  file.

RETURN VALUE

       All programs return 0 upon successful completion and 1 on failure.

EXAMPLES

       mpgjoin movie1.mpg [-0:32] [45M-75M] movie2.mpg -o joined.mpg
              joined.mpg  will  contain  the  first  32  seconds of movie1.mpg
              followed by 30 Megs of movie1.mpg starting at 45  Megs  followed
              by the whole file movie2.mpg

       mpgtx -124 myfile.mpg -b output
              will  split myfile.mpg in 124 parts with names output-001.mpg to
              output-124.mpg

       mpgtx -i Wazzup.mp3
              will print infos about given file such as duration, bitrate, but
              also album, track, song name if this file has an ID3 tag.

       mpgcat myfile.mpg [2/2] | lpr
              will  redirect  the  second  half of myfile.mpg to your printer,
              emptying it from toner and paper and make you be fired  by  your
              boss... Use carefully.

BUGS

       Plenty of them :)
       GOP  (Group  of  Picture)  based:  well  this  is  not a bug but it’s a
       limitation. As explained in the DESCRIPTION section,  this  limits  the
       accuracy  of  mpgtx  on joins and splits to approximately 15 frames, or
       0.5 seconds.
       Some artifacts can be seen with bad MPEG players playing joined  files.
       These  players  don’t  take  into  account the broken link flag used to
       discard the first B frames they encounter. This is a bug in their  MPEG
       decoding engine, not mpgtx.

AUTHOR

       Laurent Alacoque <laureck@users.sourceforge.net> CopyLeft 2001.
       Modified by Chris Danis <danish@debian.org>, copyleft 2001.
       Philipp Biermann <philipp@biermann.org>, copyleft 2002.
       Erik Schanze <schanzi_@gmx.de>, copyleft 2004.
       Get  new  releases and information from, and send patches, bugs, girls,
       money etc. to:
       http://mpgtx.sourceforge.net/

THANKS

       for your attention. Have a good day.
       Godmar Back and Brent Phillips helped  me  to  tune  the  command  line
       interface.
       Volker Moell patiently teach me how to build rpms. Danke Volker.
       Jean  Fransisco  Sytem  (alias  Nicolas Schieli) helped me correct some
       nasty bugs.
       Thank you guys.