NAME

       qmp3cut - extract and/or delete parts of a mp3 file

SYNOPSIS

       qmp3cut [option]... file

DESCRIPTION

       qmp3cut  allows  to  extract  and/or delete a fragment of a mp3 file. some parameters must be supplied in
       order to define the start/size/end cut points and what to do then: either the fragment must be copied  to
       another file or erased from the file (or both)

GENERAL OPTIONS

       -d, --delete
              deletes  the  fragment  from  the file. if option --output is used, deletion action is always done
              after fragment extraction.

       -h, --help
              show a brief help and exit.

       -o <outfile>, --output=<outfile>
              outfile is the file where the frames contained in the specified fragment will be copied.

       -v, --verbose
              verbose.

       -V, --version
              show version and exit.

CUT OPTIONS

       cut options are used to specify at which frame the fragment begins (options -b or -B), ends  (options  -e
       and  -E),  or  which  size  it  has  (option -s). at least, one cut option must be specified. neither the
       options -b and -B, and the options -e and -E can be used together; also, a begin, end and size option can
       be used at the same time.

       by default, the fragment begins at the first frame and ends at the last frame; there's no  default  value
       for size.

       all  the  values are treated as a frame number unless a format specifier is used. see the FORMATS section
       below for information. values must be positive integer.

       -b <begin>[<format>], --set-begin-from-eof=<begin>[<format>]
              begin specifies the first frame of the file that belongs to the cut counting from the end  of  the
              file.

       -B <begin>[<format>], --set-begin=<begin>[<format>]
              begin specifies the first frame of the file that belongs to the cut counting from the beginning of
              the file.

       -e <end>[<format>], --set-end-from-eof=<end>[<format>]
              end  specifies  the  last  frame  of the file that belongs to the cut counting from the end of the
              file.

       -E <end>[<format>], --set-end=<end>[<format>]
              end specifies the last frame of the file that belongs to the cut counting from  the  beginning  of
              the file.

       -s <size>[<format>], --set-size=<size>[<format>]
              size specifies the number of frames contained in the cut.

       -S <begin>-<end>, --slice <begin>-<end>
              slice  specifies  the  starting  and ending points of the cut as a timeslice, which is to say, two
              time specifications ([[h:]m:]s[.ms]) joined by a hyphen.

FORMATS

       cut options can have also an optional modifier. if this modifier is not used,  then  the  value  provided
       with the corresponding cut option will be interpreted as a number of frames. since most of the times will
       be difficult to specify a cut in terms of frames, the following modifiers are provided:

       j      value is interpreted as milliseconds.

       m      value is interpreted as minutes.

       s      value is interpreted as seconds.

       b      value is interpreted as bytes.

       k      value is interpreted as kbytes (1024 bytes).

       M      value is interpreted as megabytes (1024 kbytes).

       in either case, the values specified will be rounded to get an integer number of frames.

EXAMPLES

       here are some examples:

       to get the last ten seconds of a file:
              qmp3cut -b 10s -o outfile.mp3 infile.mp3

       two ways of getting the first minute of a file:
              qmp3cut -E 1m -o outfile.mp3 infile.mp3
              qmp3cut -s 1m -o outfile.mp3 infile.mp3

       three ways of getting the second quarter of a file:
              qmp3cut -S 15:0-30:0 -o outfile.mp3 infile.mp3
              qmp3cut -B 15m -E 30m -o outfile.mp3 infile.mp3
              qmp3cut -s 15m -E 30m -o outfile.mp3 infile.mp3
              qmp3cut -B 15m -s 15m -o outfile.mp3 infile.mp3

NOTES

       if neither the options --output nor --delete are specified, the program will do nothing.

BUGS

       usually,  the  mpg123 player (and any other app mp3-read capable) report messages in the way like "cannot
       rewind by XXX bytes" where XXX is a negative value on streams extracted with  qmp3cut.  this  is  due  to
       frame  dependency  (frame decoding depends sometimes of neighbourhood frames when bit reservoir technique
       is used at encoding time) and possibly will be corrected in a (near?) future.

       there's no support for variable bit rate (vbr) files.

       tests have been done only with mpeg version 1 layer iii streams, though it may (or not) work  with  other
       versions/layers.

AUTHOR

       dmanye@etse.urv.es
       http://www.etse.urv.es/~dmanye/quelcom/quelcom.html

SEE ALSO

       qmp3info(1), qmp3join(1), qmp3check(1), qmp3report(1)
       qwavinfo(1), qwavjoin(1), qwavcut(1), qwavsilence(1), qwavfade(1), qwavheaderdump(1)

quelcom 0.4.0                                     february 2001                                       qmp3cut(1)