CUTOGGVORBIS(1)

NAME
cutoggvorbis - a fast and leightweight Ogg/Vorbis editor

SYNOPSIS
cutoggvorbis [-i <file>] [-O <file>] [-a <startpoint>] [-b <endpoint>] [-f <timetable>] [-o <output_prefix>] [-I <file>] [-d 2] -q

DESCRIPTION
Cutoggvorbis is a small and fast command line Ogg/Vorbis editor. It lets you select sections of an Ogg/Vorbis interactively or via a timetable and save them to separate files without quality loss. It uses ogg123 for playback and even works with files bigger than 2GB.

OPTIONS

-i <file>
    input file to edit

-O <file>
    forced output filename

-o <output_prefix>
    prefix of generated output filename
    (e.g. <output_prefix>0001.ogg, <output_prefix>0002.ogg, ...)

-a <mm:ss.xx>
    starting position of selection to write to new file

-b <mm:ss.xx>
    end position of selection to write to new file

-f <timetable_file>
    use a timetable to extract several sequences from a given file.
    The timetable must have the following format:
    "<start_position> <end_position>" e.g.:
    0:01 1:00
    11:15 19:33
    01:01.34 02:39.78
    1:0 -0:05
    Negative values mean distance from the end of file. Note that the options [-a] and [-b] override a given timetable.

-q quiet mode
    Switch on quiet mode, cutoggvorbis won't make any sound, useful for debugging and commands using a pipe like: "echo 7a9bsq | cutoggvorbis -i file.ogg"

-d 2
    use the second soundcard (/dev/dsp1)

KEYBOARD CONTROL
rewind with the following keys [1/2/3/4/5]
move forward with the following keys [6/7/8/9/0]
[0] means 10mins forward, [9] is 1min forward, [8] is 10secs forward, [7] is 1sec forward and [6] is 1/10sec forward. Keys [1] to [5] go symmetrically back (so [1] means 10mins back). For highest precision [,] goes back one page and [.] goes one page forward. After any of these keys you will hear the sound at this position for one second. When you are at the starting position of your part of interest, press the key [a]. When you are at the last position of your part of interest, press the key [b] (What you hear after [b] will then be the last second inside the new file). By pressing [s] the resulting file will be written to result0001.ogg. If it already exists, cutoggvorbis will increase the number to result0002.ogg, result0003.ogg and so on. Please note that cutoggvorbis only accepts one inputfile, so using wildcards like [?] or [*] in filenames will result in editing only the first file that matches.

EXAMPLES
1) The resulting files will be written to blah0001.ogg, blah0002.ogg, blah0003.ogg and so on:
    cutoggvorbis -i file.ogg -o blah 2) If you only want to cut a file once and you know the times for start and the end, you type:
    cutoggvorbis -i file.ogg -a 0:37 -b 1:25 and cutoggvorbis will write the passage of file.ogg starting at 0:37 and ending at 1:25 to blah01.ogg 3) If you want to cut a file more often, you need to create a file which contains a timetable and type (Please read README.timetable for details):
    cutoggvorbis -i file.ogg -f name_of_the_timetablefile 4) Only print info about the file:
    cutoggvorbis -I file.ogg

ABOUT
cutoggvorbis was written by Jochen Puchalla <mail at puchalla-online dot de>
this manpage was mainly written by Marc O. Gloor <mgloor at fhzh dot ch>