3.1 qwavcut

qwavcut extracts and/or deletes parts of a wav file

3.1.1 synopsis

‘qwavcut option… file’

3.1.2 description

qwavcut allows to extract and/or delete a fragment of a wav 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)

3.1.3 general options

‘-d’

‘--delete’

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

‘-h’

‘--help’

show a brief help and exit.

‘-o outfile’

‘--output=outfile’

outfile is the name of the file where all the samples in the given fragment will be copied.

‘-V’

‘--version’

show version and exit.

3.1.4 cut options

cut options are used to specify where the fragment begins and ends. there are two ways to do it: with time slices (easier) and with cut points (more complex but also more powerful). cut options are mandatory (which way is used is matter of your choice).

if time slices are used, cut points options are automatically ignored.

3.1.4.1 cut with time slices

there is only one option:

‘-S timeslice’

‘--slice timeslice’

timeslice (see specifying time) specifies, in terms of time, where the cut begins and ends.

3.1.4.2 cut with cut points

there are several options with cut points. cut points are used to specify at which sample the fragment begins (--begin and --Begin), ends (--end and --End), or which size it has (--size). at least, one cut option must be specified (non specified options take its default values). neither the options --begin and --Begin, and the options --end and --End can be used together; also, a begin, end and size option cannot be used at the same time.

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

‘-b cutpoint’

‘--set-begin-from-eof=cutpoint’

cutpoint (see cut points) specifies the first sample of the file that belongs to the cut counting from the end of the file.

‘-B cutpoint’

‘--set-begin=cutpoint’

cutpoint (see cut points) specifies the first sample of the file that belongs to the cut counting from the beginning of the file.

‘-e cutpoint’

‘--set-end-from-eof=cutpoint’

cutpoint (see cut points) specifies the last sample of the file that belongs to the cut counting from the end of the file.

‘-E cutpoint’

‘--set-end=cutpoint’

cutpoint (see cut points) specifies the last sample of the file that belongs to the cut counting from the beginning of the file.

‘-s cutpoint’

‘--size=cutpoint’

cutpoint (see cut points) specifies the number of samples contained in the cut.

3.1.5 examples

1. to get the last ten seconds of a file

   qwavcut -b 10s -o outfile.wav infile.wav
   

2. four different ways to get the first minute of a file:

   qwavcut -S -1:0 -o outfile.wav infile.wav
   qwavcut -S -60 -o outfile.wav infile.wav
   qwavcut -E 1m -o outfile.wav infile.wav
   qwavcut -s 1m -o outfile.wav infile.wav
   

3. four ways of getting the second quarter of a file:

   qwavcut -S 15:0-30:0 -o outfile.wav infile.wav
   qwavcut -B 15m -E 30m -o outfile.wav infile.wav
   qwavcut -s 15m -E 30m -o outfile.wav infile.wav
   qwavcut -B 15m -s 15m -o outfile.wav infile.wav