oggcat(1) [debian man page]
OGGCAT(1) User Manuals OGGCAT(1) NAME
oggCat - concatenates two ogg video files (.ogv, .ogg or oga) SYNOPSIS
oggCat [options] outfile.ogv file1.ogv file2.ogv [ file3.ogv [...] ] DESCRIPTION
oggCat concatenates two or more ogg files. The parameters of the resulting ogg file is defined by the first file in the concatenation list. The parameters could be changed by some options, explained below. All subsequent files that does not match these video file parameters are automatically transcoded. A concatenation will fail in case that there are not enought streams available. This could happen e.g. if the first file consists of one audio and one video stream and the second file only carries a video stream. If there is more than one video or audio stream within the file, the first stream is used. OPTIONS
-s Sets the size of the video frame. The size is given as <width>x<height>. At default, the video frame size is the size of the first video stream. Example: -s 320x240 -d Sets the datarate in byte per seconds for the video encoder (theora). This meant to be a upper threshold. So the file may be smaller than assumed. If not set, the datarate of the first file is used. Example: -d 1024000 -D Sets the datarate in byte per seconds for the audio encoder (vorbis). If not set, the datarate of the first file is used. Example: -D 64000 -f Sets the frame rate of the video with numinator and demoninator and is the pictures per second. If only one number is given, the denominator is set to 1. If not set, the framerate of the first file is used. Example: -f 25:2 -F Sets the sample frequency (sample rate) of the audio data in Hertz. If the sample frequency does not match the one with the original file, resamling is invoked. Example: -F 32000 -c Adds comments to the video (theora) stream. Comments are given by a pair of type and value in the form 'type=value'. More than one comment can be concatenated with a semicolon. It is recommended to use apostrophes as the command line may use the semicolon as a seperator. Example: -c 'AUTHOR=yorn;DATE=03.07.09' -C Adds comments to the audio (vorbis) stream. Comments are given by a pair of type and value in the form 'type=value'. More than one comment can be concatenated with a semicolon. It is recommended to use apostrophes as the command line may use the semicolon as a seperator. Example: -C 'AUTHOR=yorn;DATE=03.07.09' -q Specifies the video quality for the newly created stream. Valid values can be chosen between 0 and 63 (best). Example: -q 63 -rv Force to reencode the video stream. This is sometimes neccessary, if the video stream match in video parameters, but not in the the- ora version. In that case, reencoding the video stream helps creating good results. -x Force to overwrite the output file, even if it exists. This is mainly helpful if the oggCat is server controlled. EXAMPLES
oggCat concatFile.ogv myfile1.ogv myfile2.ogv myfile3.ogv or oggCat -o concatFile.ogv myfile1.ogv myfile2.ogv myfile3.ogv This command creates a cancatenated file concatFile.ogv that consists of the three files myfile1.ogv myfile2.ogv myfile3.ogv oggCat -s320x240 -q63 concatFile.ogv myfile1.ogv myfile2.ogv myfile3.ogv This command connects the three files myfile[1-3].ogv to file concatFile.ogv with the size of 320x240 and best quality. AUTHOR
Joern Seger <yorn at gmx dot net> SEE ALSO
oggCut(1), oggJoin(1), oggSplit(1), oggTranscode(1), oggSlideshow(1), oggThumb(1), oggSilence(1) Linux JAN 2010 OGGCAT(1)
Check Out this Related Man Page
FFMPEG2THEORA(1) General Commands Manual FFMPEG2THEORA(1) NAME
ffmpeg2theora - command-line converter to create Ogg Theora and Ogg Vorbis files. SYNOPSIS
ffmpeg2theora [options] inputfile DESCRIPTION
This manual page documents briefly the ffmpeg2theora command. ffmpeg2theora is a program that converts any media file that ffmpeg can decode to Ogg Theora for video and Ogg Vorbis for audio. OPTIONS
To read from standard input, specify `-' as the input filename. These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below. General output options: -o, --output Specify the output filename. If no output filename is specified, output will be written to inputfile.ogv. To output to standard output, specify /dev/stdout as the output file. --no-skeleton Disables Ogg Skeleton metadata output. --seek-index Enables keyframe index in skeleton track. -s, --starttime Start encoding at this time (in seconds). -e, --endtime End encoding at this time (in seconds). -p, --preset Encode file with v2v preset. Right now, there is preview, pro and videobin. Run "ffmpeg2theora -p info" for more information. Video output options: -v, --videoquality [0 to 10] Set encoding quality for video (default: 6). use higher values for better quality -V, --videobitrate Set encoding bitrate for video (in kb/s). --soft-target Use a large reservoir and treat the rate as a soft target; rate control is less strict but resulting quality is usually higher/smoother overall. Soft target also allows an optional -v setting to specify a minimum allowed quality. --two-pass Compress input using two-pass rate control. This option requires that the input to the to the encoder is seekable and performs both passes automatically. --first-pass <filename> Perform first-pass of a two-pass rate controlled encoding, saving pass data to <filename> for a later second pass --second-pass <filename> Perform second-pass of a two-pass rate controlled encoding, reading first-pass data from <filename>. The first pass data must come from a first encoding pass using identical input video to work properly. --optimize Optimize output Theora video, using a full search for motion vectors instead of a hierarchical one. This can reduce video bitrate about 5%, but it is slower and therefore is disabled by default. --speedlevel encoding is faster with higher values the cost is quality and bandwidth 0: Slowest (best) 1: Enable early skip (default) 2: Disable motion compensation -x, --width Scale to given width (in pixels). -y, --height Scale to given height (in pixels). --aspect Define frame aspect ratio (e.g. 4:3, 16:9). --pixel-aspect Define pixel aspect ratio (e.g. 1:1, 4:3). -F, --framerate output framerate e.g 25:2 or 16 --croptop, --cropbottom, --cropleft, --cropright Crop input by given pixels before resizing. -K, --keyint [8 to 2147483647] Set keyframe interval (default: 64). -d, --buf-delay Buffer delay (in frames). Longer delays allow smoother rate adaptation and provide better overall quality, but require more client side buffering and add latency. The default value is the keyframe interval for one-pass encoding (or somewhat larger if --soft-tar- get is used) and infinite for two-pass encoding. (only works in bitrate mode) --no-upscaling only scale video or resample audio if input is bigger than provided parameter Video transfer options: --pp Video Postprocessing, denoise, deblock, deinterlacer use --pp help for a list of available filters. -C, --contrast [0.1 to 10.0] contrast correction (default: 1.0). Note: lower values make the video darker. -B, --brightness [-1.0 to 1.0] brightness correction (default: 0.0). Note: lower values make the video darker. -G, --gamma [0.1 to 10.0] gamma correction (default: 1.0). Note: lower values make the video darker. -P, --saturation [0.1 to 10.0] saturation correction (default: 1.0). Note: lower values make the video grey. Audio output options: -a, --audioquality [-2 to 10] Set encoding quality for audio (default: 1). use higher values for better quality -A, --audiobitrate [32 to 500] Set encoding bitrate for audio (in kb/s). -c, --channels Set number of output channels. -H, --samplerate Set output samplerate (in Hz). Input options: --noaudio Disable audio from input. --novideo Disable video from input. --deinterlace Force deinterlace. Otherwise only material marked as interlaced will be deinterlaced. --vhook you can use ffmpeg's vhook system, example: ffmpeg2theora --vhook '/path/watermark.so -f wm.gif' input.dv -f, --format Specify input format. --inputfps Override input fps. --audiostream id By default the first audio stream is selected, use this to select another audio stream. --videostream id By default the first video stream is selected, use this to select another audio stream. --sync Use A/V sync from input container. Since this does not work with all input format you have to manualy enable it if you have issues with A/V sync. Subtitles options: --subtitles Encode subtitles from the given file to a multiplexed Kate stream. The input file should be in SubRip (.srt) format, encoded in UTF-8, unless the --subtitles-encoding option is also given. --subtitles-encoding encoding Assumes the corresponding subtitles file is encoded in the given encoding. If ffmpeg2theora was built with iconv support, all encod- ings supported by iconv may be used. Otherwise, UTF-8 and ISO-8859-1 (aka latin1) are supported. The default is UTF-8. --subtitles-language language Sets the language of the corresponding subtitles stream. This will be set in the corresponding Kate stream so a video player may make this available to the user for language selection. Language is an ISO 639-1 or RFC 3066 ASCII string and is limited to 15 char- acters. --subtitles-category category Sets the category of the corresponding subtitles stream. This will be set in the corresponding Kate stream so a video player may make this available to the user for selection. The default category is "subtitles". Suggested other categories may include "tran- script", "commentary", "lyrics", etc. Category is an ASCII string and is limited to 15 characters --subtitles-ignore-non-utf8 When reading an UTF-8 subtitles text file, any invalid UTF-8 sequence will be ignored. This may be useful if there are stray sequences in an otherwise UTF-8 file. Note that, since those invalid sequences will be removed from the output, this option is not a substitute to converting a non UTF-8 file to UTF-8. --nosubtitles Disables subtitles from input. Note that subtitles explicitely loaded from external files will still be used. --subtitle-types Selects which subtitle types to include from the input file. Allowed types are: none, all, text, spu (spu being the image based subtitles found on DVD). By default, only text based subtitles will be included. Note that subtitles explicitely loaded from external files will still be used. Metadata options: --artist Name of artist (director). --title Title. --date Date. --location Location. --organization Name of organization (studio). --copyright Copyright. --license License. --contact Contact link. --nometadata disables metadata from input --no-oshash do not include oshash of source file(SOURCE_OSHASH) Keyframe indexing options: --index-interval <n> set minimum distance between indexed keyframes to <n> ms (default: 2000) --theora-index-reserve <n> reserve <n> bytes for theora keyframe index --vorbis-index-reserve <n> reserve <n> bytes for vorbis keyframe index --kate-index-reserve <n> reserve <n> bytes for kate keyframe index Other options: --nice n Set niceness to n. -h, --help Output a help message. --info Output json info about input file, use -o to save json to file. --frontend print status information in json, one json dict per line EXAMPLES
Encode Videos: ffmpeg2theora videoclip.avi (will write output to videoclip.ogv) cat something.dv | ffmpeg2theora -f dv -o output.ogv - Encode a series of images: ffmpeg2theora frame%06d.png -o output.ogv Live streaming from V4L Device: ffmpeg2theora /dev/video0 -f video4linux --inputfps 15 -x 160 -y 128 -o - | oggfwd icast2server 8000 password /theora.ogv (you might have to use video4linux2 depending on your hardware) Live encoding from a DV camcorder (needs a fast machine): dvgrab - | ffmpeg2theora -f dv -x 352 -y 288 -o output.ogv -0 Live encoding and streaming to icecast server: dvgrab --format raw - | ffmpeg2theora -f dv -x 160 -y 128 -o /dev/stdout - | oggfwd icast2server 8000 password /theora.ogv AUTHOR
ffmpeg2theora was written by jan gerber <j@v2v.cc>. This manual page was written by Hubert Chan <hubert@uhoreg.ca>, for the Debian project (but may be used by others). May 14, 2010 FFMPEG2THEORA(1)