From e02054502256d08cc0d26df6e2c360ad1740c981 Mon Sep 17 00:00:00 2001 From: kfrn Date: Wed, 1 Mar 2017 04:39:08 +1300 Subject: [PATCH] Tidy up: links, spacing, -> , -> --- index.html | 82 +++++++++++++++++++++++++++--------------------------- 1 file changed, 41 insertions(+), 41 deletions(-) diff --git a/index.html b/index.html index c242a3f..0ea094f 100644 --- a/index.html +++ b/index.html @@ -29,7 +29,7 @@

Each button displays helpful information about how to perform a wide variety of tasks using FFmpeg. To use this site, click on the task you would like to perform. A new window will open up with a sample command and a description of how that command works. You can copy this command and understand how the command works with a breakdown of each of the flags.

Tutorials

For FFmpeg basics, check out the program’s official website.

-

For instructions on how to install FFmpeg on Mac, Linux, and Windows, refer to Reto Kromer’s installation instructions.

+

For instructions on how to install FFmpeg on Mac, Linux, and Windows, refer to Reto Kromer’s installation instructions.

For Bash and command line basics, try the Command Line Crash Course. For a little more context presented in an ffmprovisr style, try explainshell.com!

License

Creative Commons License
This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License

@@ -364,7 +364,7 @@
ffmpeg
starts the command
-f image2
forces input or output file format. image2 specifies the image file demuxer.
-framerate 9
sets framerate to 9 frames per second
-
-pattern_type glob
tells ffmpeg that the following mapping should "interpret like a glob" (a "global command" function that relies on the * as a wildcard and finds everything that matches)
+
-pattern_type glob
tells ffmpeg that the following mapping should "interpret like a glob" (a "global command" function that relies on the * as a wildcard and finds everything that matches)
-i "input_image_*.jpg"
maps all files in the directory that start with input_image_, for example input_image_001.jpg, input_image_002.jpg, input_image_003.jpg... etc.
(The quotation marks are necessary for the above "glob" pattern!)
-vf scale=250x250
filter the video to scale it to 250x250; -vf is an alias for -filter:v
@@ -391,18 +391,18 @@
ffmpeg
starts the command
-i concat:input files
lists the input VOB files and directs ffmpeg to concatenate them. Each input file should be separated by a backslash and a pipe, like so:
-i concat:VTS_01_1.VOB\|VTS_01_2.VOB\|VTS_01_3.VOB
- The backslash is simply an escape character for the pipe (|).
+ The backslash is simply an escape character for the pipe (|).
-c:v libx264
sets the video codec as H.264
-c:a copy
audio remains as-is (no re-encode)
output_file.mp4
path and name of the output file
-

It’s also possible to adjust the quality of your output by setting the -crf and -preset values:

+

It’s also possible to adjust the quality of your output by setting the -crf and -preset values:

ffmpeg -i concat:input_file1\|input_file2\|input_file3 -c:v libx264 -crf 18 -preset veryslow -c:a copy output_file.mp4

-
-crf 18
sets the constant rate factor to a visually lossless value. Libx264 defaults to a crf of 23, considered medium quality; a smaller crf value produces a larger and higher quality video.
-
-preset veryslow
A slower preset will result in better compression and therefore a higher-quality file. The default is medium; slower presets are slow, slower, and veryslow.
+
-crf 18
sets the constant rate factor to a visually lossless value. Libx264 defaults to a crf of 23, considered medium quality; a smaller crf value produces a larger and higher quality video.
+
-preset veryslow
A slower preset will result in better compression and therefore a higher-quality file. The default is medium; slower presets are slow, slower, and veryslow.
-

Bear in mind that by default, libx264 will only encode a single video stream and a single audio stream, picking the ‘best’ of the options available. To preserve all video and audio streams, add -map parameters:

+

Bear in mind that by default, libx264 will only encode a single video stream and a single audio stream, picking the ‘best’ of the options available. To preserve all video and audio streams, add -map parameters:

ffmpeg -i concat:input_file1\|input_file2 -map 0:v -map 0:a -c:v libx264 -c:a copy output_file.mp4

-map 0:v
encodes all video streams
@@ -424,7 +424,7 @@

Transcode to H.265/HEVC

ffmpeg -i input_file -c:v libx265 -pix_fmt yuv420p -c:a copy output_file

This command takes an input file and transcodes it to H.265/HEVC in an .mp4 wrapper, keeping the audio codec the same as in the original file.

-

Note: ffmpeg must be compiled with libx265, the library of the H.265 codec, for this script to work. (Add the flag --with-x265 if using brew install ffmpeg method).

+

Note: ffmpeg must be compiled with libx265, the library of the H.265 codec, for this script to work. (Add the flag --with-x265 if using brew install ffmpeg method).

ffmpeg
starts the command
-i input file
path, name and extension of the input file
@@ -434,7 +434,7 @@
output file
path, name and extension of the output file

The libx265 encoding library defaults to a ‘medium’ preset for compression quality and a CRF of 28. CRF stands for ‘constant rate factor’ and determines the quality and file size of the resulting H.265 video. The CRF scale ranges from 0 (best quality [lossless]; largest file size) to 51 (worst quality; smallest file size).

-

A CRF of 28 for H.265 can be considered a medium setting, corresponding to a CRF of 23 in encoding H.264, but should result in about half the file size.

+

A CRF of 28 for H.265 can be considered a medium setting, corresponding to a CRF of 23 in encoding H.264, but should result in about half the file size.

To create a higher quality file, you can add these presets:

ffmpeg -i input_file -c:v libx265 -pix_fmt yuv420p -preset veryslow -crf 18 -c:a copy output_file

@@ -455,7 +455,7 @@

Deinterlace a video

-

ffmpeg -i input_file -c:v libx264 -vf "yadif,format=yuv420p" output_file

+

ffmpeg -i input_file -c:v libx264 -vf "yadif,format=yuv420p" output_file

This command takes an interlaced input file and outputs a deinterlaced H.264 MP4.

ffmpeg
starts the command
@@ -464,17 +464,17 @@
-vf
video filtering will be used
"
start of filtergraph (see below)
yadif
deinterlacing filter (‘yet another deinterlacing filter’)
- By default, yadif will output one frame for each frame. Outputting one frame for each field (thereby doubling the frame rate) with yadif=1 may produce visually better results.
+ By default, yadif will output one frame for each frame. Outputting one frame for each field (thereby doubling the frame rate) with yadif=1 may produce visually better results.
,
separates filters
format=yuv420p
chroma subsampling set to 4:2:0
By default, libx264 will use a chroma subsampling scheme that is the closest match to that of the input. This can result in Y′CBCR 4:2:0, 4:2:2, or 4:4:4 chroma subsampling. QuickTime and most other non-FFmpeg based players can’t decode H.264 files that are not 4:2:0, therefore it's advisable to specify 4:2:0 chroma subsampling.
"
end of filtergraph
output file
path, name and extension of the output file
-

"yadif,format=yuv420p" is an ffmpeg filtergraph. Here the filtergraph is made up of one filter chain, which is itself made up of the two filters (separated by the comma).
+

"yadif,format=yuv420p" is an ffmpeg filtergraph. Here the filtergraph is made up of one filter chain, which is itself made up of the two filters (separated by the comma).
The enclosing quote marks are necessary when you use spaces within the filtergraph, e.g. -vf "yadif, format=yuv420p", and are included above as an example of good practice.

-

Note: ffmpeg includes several deinterlacers apart from yadif: bwdif, w3fdif, kerndeint, and nnedi.

-

For more H.264 encoding options, see the latter section of the encode H.264 command.

+

Note: ffmpeg includes several deinterlacers apart from yadif: bwdif, w3fdif, kerndeint, and nnedi.

+

For more H.264 encoding options, see the latter section of the encode H.264 command.

Example

Before and after deinterlacing:

@@ -501,25 +501,25 @@
ffmpeg
starts the command
-i input file
path, name and extension of the input file
-c:v libx264
tells ffmpeg to encode the video stream as H.264
-
-vf colormatrix=src:dst
the video filter colormatrix will be applied, with the given source and destination colourspaces.
- Accepted values include bt601 (Rec.601), smpte170m (Rec.601, 525-line/NTSC version), bt470bg (Rec.601, 625-line/PAL version), bt709 (Rec.709), and bt2020 (Rec.2020).
+
-vf colormatrix=src:dst
the video filter colormatrix will be applied, with the given source and destination colourspaces.
+ Accepted values include bt601 (Rec.601), smpte170m (Rec.601, 525-line/NTSC version), bt470bg (Rec.601, 625-line/PAL version), bt709 (Rec.709), and bt2020 (Rec.2020).
For example, to convert from Rec.601 to Rec.709, you would use -vf colormatrix=bt601:bt709.
output file
path, name and extension of the output file
-

Note: Converting between colourspaces with ffmpeg can be done via either the colormatrix or colorspace filters, with colorspace allowing finer control (individual setting of colourspace, transfer characteristics, primaries, range, pixel format, etc). See this entry on the ffmpeg wiki, and the ffmpeg documentation for colormatrix and colorspace.

+

Note: Converting between colourspaces with ffmpeg can be done via either the colormatrix or colorspace filters, with colorspace allowing finer control (individual setting of colourspace, transfer characteristics, primaries, range, pixel format, etc). See this entry on the ffmpeg wiki, and the ffmpeg documentation for colormatrix and colorspace.

Convert colourspace and embed colourspace metadata

-

ffmpeg -i input_file -c:v libx264 -vf colormatrix=src:dst -color_primaries val -color_trc val -colorspace val output_file

+

ffmpeg -i input_file -c:v libx264 -vf colormatrix=src:dst -color_primaries val -color_trc val -colorspace val output_file

ffmpeg
starts the command
-i input file
path, name and extension of the input file
-c:v libx264
encode video as H.264
-
-vf colormatrix=src:dst
the video filter colormatrix will be applied, with the given source and destination colourspaces.
-
-color_primaries val
tags video with the given colour primaries.
+
-vf colormatrix=src:dst
the video filter colormatrix will be applied, with the given source and destination colourspaces.
+
-color_primaries val
tags video with the given colour primaries.
Accepted values include smpte170m (Rec.601, 525-line/NTSC version), bt470bg (Rec.601, 625-line/PAL version), bt709 (Rec.709), and bt2020 (Rec.2020). -
-color_trc val
tags video with the given transfer characteristics (gamma).
+
-color_trc val
tags video with the given transfer characteristics (gamma).
Accepted values include smpte170m (Rec.601, 525-line/NTSC version), gamma28 (Rec.601, 625-line/PAL version)1, bt709 (Rec.709), bt2020_10 (Rec.2020 10-bit), and bt2020_12 (Rec.2020 12-bit).
-
-colorspace val
tags video as being in the given colourspace.
+
-colorspace val
tags video as being in the given colourspace.
Accepted values include smpte170m (Rec.601, 525-line/NTSC version), bt470bg (Rec.601, 625-line/PAL version), bt709 (Rec.709), bt2020_cl (Rec.2020 constant luminance), and bt2020_ncl (Rec.2020 non-constant luminance).
output file
path, name and extension of the output file
@@ -534,8 +534,8 @@ MediaInfo screenshots of colourspace metadata

⚠ Using this command it is possible to add Rec.709 tags to a file that is actually Rec.601 (etc), so apply with caution!

These commands are relevant for H.264 and H.265 videos, encoded with libx264 and libx265 respectively.

-

Note: If you wish to embed colourspace metadata without changing to another colourspace, omit -vf colormatrix=src:dst. However, since it is libx264/libx265 that writes the metadata, it's not possible to add these tags without reencoding the video stream.

-

For all possible values for -color_primaries, -color_trc, and -colorspace, see the ffmpeg documentation on codec options.

+

Note: If you wish to embed colourspace metadata without changing to another colourspace, omit -vf colormatrix=src:dst. However, since it is libx264/libx265 that writes the metadata, it's not possible to add these tags without reencoding the video stream.

+

For all possible values for -color_primaries, -color_trc, and -colorspace, see the ffmpeg documentation on codec options.

1. Out of step with the regular pattern, -color-trc doesn't accept bt470bg; it is instead here referred to directly as gamma.
In the Rec.601 standard, 525-line/NTSC and 625-line/PAL video have assumed gammas of 2.2 and 2.8 respectively. ↩

@@ -1017,13 +1017,13 @@
for file in *.MXF
starts the loop, and states what the input files will be. Here, the ffmpeg command within the loop will be applied to all files with an extension of .MXF.
The word ‘file’ is an arbitrary variable which will represent each .MXF file in turn as it is looped over.
do ffmpeg -i "$file"
carry out the following ffmpeg command for each input file.
- Per Bash syntax, within the command the variable is referred to by “$file”. The dollar sign is used to reference the variable ‘file’, and the enclosing quotation marks prevents reinterpretation of any special characters that may occur within the filename, ensuring that the original filename is retained.
+ Per Bash syntax, within the command the variable is referred to by “$file”. The dollar sign is used to reference the variable ‘file’, and the enclosing quotation marks prevents reinterpretation of any special characters that may occur within the filename, ensuring that the original filename is retained.
-map 0
retain all streams
-c copy
enable stream copy (no re-encode)
"${file%.MXF}.mov";
retaining the original file name, set the output file wrapper as .mov
done
complete; all items have been processed.
-

Note: the shell script (.sh file) and all .MXF files to be processed must be contained within the same directory, and the script must be run from that directory.
+

Note: the shell script (.sh file) and all .MXF files to be processed must be contained within the same directory, and the script must be run from that directory.
Execute the .sh file with the command sh Rewrap-MXF.sh.

Modify the script as needed to perform different transcodes, or to use with ffprobe. :)

The basic pattern will look similar to this:
@@ -1043,8 +1043,8 @@

Create PowerShell script to batch process with ffmpeg

-

As of Windows 10, it is possible to run Bash via Bash on Ubuntu on Windows, allowing you to use bash scripting. To enable Bash on Windows, see these instructions.

-

On Windows, the primary native command line programme is PowerShell. PowerShell scripts are plain text files saved with a .ps1 extension. This entry explains how they work with the example of a PowerShell script named “rewrap-mp4.ps1”, which rewraps .mp4 files in a given directory to .mkv files.

+

As of Windows 10, it is possible to run Bash via Bash on Ubuntu on Windows, allowing you to use bash scripting. To enable Bash on Windows, see these instructions.

+

On Windows, the primary native command line programme is PowerShell. PowerShell scripts are plain text files saved with a .ps1 extension. This entry explains how they work with the example of a PowerShell script named “rewrap-mp4.ps1”, which rewraps .mp4 files in a given directory to .mkv files.

“rewrap-mp4.ps1” contains the following text:

$inputfiles = ls *.mp4
 foreach ($file in $inputfiles) {
@@ -1059,13 +1059,13 @@ foreach ($file in $inputfiles) {
             
{
Opens the code block.

             
$output = [io.path]::ChangeExtension($file, '.mkv')
Sets up the output file: it will be located in the current folder and keep the same filename, but will have an .mkv extension instead of .mp4.

             
ffmpeg -i $file
Carry out the following ffmpeg command for each input file.

-            Note: To call ffmpeg here as just ‘ffmpeg’ (rather than entering the full path to ffmpeg.exe), you must make sure that it’s correctly configured. See this article, especially the section ‘Add to Path’.

+            Note: To call ffmpeg here as just ‘ffmpeg’ (rather than entering the full path to ffmpeg.exe), you must make sure that it’s correctly configured. See this article, especially the section ‘Add to Path’.
             
-map 0
retain all streams

             
-c copy
enable stream copy (no re-encode)

             
$output
The output file is set to the value of the $output variable declared above: i.e., the current file name with an .mkv extension.

             
}
Closes the code block.

           
-          
Note: the PowerShell script (.ps1 file) and all .mp4 files to be rewrapped must be contained within the same directory, and the script must be run from that directory.

+          
Note: the PowerShell script (.ps1 file) and all .mp4 files to be rewrapped must be contained within the same directory, and the script must be run from that directory.

           
Execute the .ps1 file by typing .\rewrap-mp4.ps1 in PowerShell.

           
Modify the script as needed to perform different transcodes, or to use with ffprobe. :)

           

@@ -1160,7 +1160,7 @@ foreach ($file in $inputfiles) {
           

             
ffmpeg
starts the command

             
-i input_file
path, name and extension of the input file

-            
-filter:v idet
This calls the  idet (detect video interlacing type) filter.

+            
-filter:v idet
This calls the  idet (detect video interlacing type) filter.

             
-f null
Video is decoded with the null muxer. This allows video decoding without creating an output file.

             
-
FFmpeg syntax requires a specified output, and - is just a place holder. No file is actually created. 

           

@@ -1179,7 +1179,7 @@ foreach ($file in $inputfiles) {
         

           
Creates a QCTools report

           
ffprobe -f lavfi -i "movie=input_file:s=v+a[in0][in1],[in0]signalstats=stat=tout+vrep+brng,cropdetect=reset=1:round=1,idet=half_life=1,split[a][b];[a]field=top[a1];[b]field=bottom,split[b1][b2];[a1][b1]psnr[c1];[c1][b2]ssim[out0];[in1]ebur128=metadata=1,astats=metadata=1:reset=1:length=0.4[out1]" -show_frames -show_versions -of xml=x=1:q=1 -noprivate | gzip > input_file.qctools.xml.gz

-          
This will create an XML report for use in QCTools for a video file with one video track and one audio track. See also the QCTools documentation.

+          
This will create an XML report for use in QCTools for a video file with one video track and one audio track. See also the QCTools documentation.

           

             
ffprobe
starts the command

             
-f lavfi
tells ffprobe to use the Libavfilter input virtual device [more]

@@ -1209,7 +1209,7 @@ foreach ($file in $inputfiles) {
         

           
Creates a QCTools report

           
ffprobe -f lavfi -i "movie=input_file,signalstats=stat=tout+vrep+brng,cropdetect=reset=1:round=1,idet=half_life=1,split[a][b];[a]field=top[a1];[b]field=bottom,split[b1][b2];[a1][b1]psnr[c1];[c1][b2]ssim" -show_frames -show_versions -of xml=x=1:q=1 -noprivate | gzip > input_file.qctools.xml.gz

-          
This will create an XML report for use in QCTools for a video file with one video track and NO audio track. See also the QCTools documentation.

+          
This will create an XML report for use in QCTools for a video file with one video track and NO audio track. See also the QCTools documentation.

           

             
ffprobe
starts the command

             
-f lavfi
tells ffprobe to use the Libavfilter input virtual device [more]

@@ -1293,7 +1293,7 @@ foreach ($file in $inputfiles) {
             
ffmpeg
starts the command

             
-f lavfi
tells ffmpeg to use the libavfilter input virtual device

             
-i testsrc=size=720x576:rate=25
asks for the testsrc filter pattern as input. Adjusting the size and rate options allow you to choose a specific frame size and framerate. 

-              The different test patterns that can be generated are listed here.

+              The different test patterns that can be generated are listed here.
             
-c:v v210
transcodes video from rawvideo to 10-bit Uncompressed YUV 4:2:2. Alter this setting to set your desired codec.

             
-t 10
specifies recording time of 10 seconds

             
output_file
path, name and extension of the output file. Try different file extensions such as mkv, mov, mp4, or avi.

@@ -1363,19 +1363,19 @@ foreach ($file in $inputfiles) {
           

             
ffmpeg
starts the command

             
-f concat
forces ffmpeg to concatenate the files and to keep the same file format

-            
-i mylist.txt
path, name and extension of the input file. Per the ffmpeg documentation, it is preferable to specify relative rather than absolute file paths, as allowing absolute file paths may pose a security risk.

+            
-i mylist.txt
path, name and extension of the input file. Per the ffmpeg documentation, it is preferable to specify relative rather than absolute file paths, as allowing absolute file paths may pose a security risk.

             This text file contains the list of files to be concatenated and should be formatted as follows:
             
file './first_file.ext'
 file './second_file.ext'
 . . .
 file './last_file.ext'

-In the above, file is simply the word "file". Straight apostrophes ('like this') rather than curved quotation marks (‘like this’) must be used to enclose the file paths.

+In the above, file is simply the word "file". Straight apostrophes ('like this') rather than curved quotation marks (‘like this’) must be used to enclose the file paths.

 Note: If specifying absolute file paths in the .txt file, add -safe 0 before the input file.

 e.g.: ffmpeg -f concat -safe 0 -i mylist.txt -c copy output_file

             
-c copy
use stream copy mode to re-mux instead of re-encode

             
output_file
path, name and extension of the output file

           

-          
For more information, see the ffmpeg wiki page on concatenating files.

+          
For more information, see the ffmpeg wiki page on concatenating files.

           

         

       

@@ -1578,7 +1578,7 @@ e.g.: ffmpeg -f concat -safe 0 -i mylist.txt -c copy output_fileffmpeg
starts the command

             
-i input_video_file
path, name and extension of the input video file

             
-i input_image_file
path, name and extension of the image file

-            
-filter_complex overlay=main_w-overlay_w-5:5
This calls the overlay filter and sets x and y coordinates for the position of the watermark on the video. Instead of hardcoding specific x and y coordinates, main_w-overlay_w-5:5 uses relative coordinates to place the watermark in the upper right hand corner, based on the width of your input files. Please see the ffmpeg documentation for more examples.

+            
-filter_complex overlay=main_w-overlay_w-5:5
This calls the overlay filter and sets x and y coordinates for the position of the watermark on the video. Instead of hardcoding specific x and y coordinates, main_w-overlay_w-5:5 uses relative coordinates to place the watermark in the upper right hand corner, based on the width of your input files. Please see the ffmpeg documentation for more examples.

             
output_file
path, name and extension of the output file

           
           

@@ -1724,9 +1724,9 @@ e.g.: ffmpeg -f concat -safe 0 -i mylist.txt -c copy output_fileAdding other stream properties.
           
Other properties may be clarified in a similar way. Replace -aspect and its value with other properties such as shown in the options below. Note that setting color values in QuickTime requires that -movflags write_colr is set.

           

-            
-color_primary VALUE -movflags write_colr
Set a new color_primary value. The vocabulary for values is at ffmpeg.

-            
-color_trc VALUE -movflags write_colr
Set a new color_transfer value. The vocabulary for values is at ffmpeg.

-            
-field_order VALUE
Set interlacement values. The vocabulary for values is at ffmpeg.

+            
-color_primary VALUE -movflags write_colr
Set a new color_primary value. The vocabulary for values is at ffmpeg.

+            
-color_trc VALUE -movflags write_colr
Set a new color_transfer value. The vocabulary for values is at ffmpeg.

+            
-field_order VALUE
Set interlacement values. The vocabulary for values is at ffmpeg.