summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorhooke007 <hooke007@qq.com>2022-05-16 22:49:13 +0100
committerLeo Izen <leo.izen@gmail.com>2022-07-07 21:12:57 -0400
commit6858fc7d800a23bf0cc0b87bf7178358a2a51cb2 (patch)
treef7bd886de70275caea202ee0556c5ac0e2b3db1f
parent80e29d1851334935a77eb66cf570f7126f9ddf05 (diff)
downloadmpv-6858fc7d800a23bf0cc0b87bf7178358a2a51cb2.tar.bz2
mpv-6858fc7d800a23bf0cc0b87bf7178358a2a51cb2.tar.xz
DOCS/encoding: remove the legacy option syntax
-rw-r--r--DOCS/encoding.rst74
1 files changed, 37 insertions, 37 deletions
diff --git a/DOCS/encoding.rst b/DOCS/encoding.rst
index ee46cec770..9c6c067589 100644
--- a/DOCS/encoding.rst
+++ b/DOCS/encoding.rst
@@ -3,26 +3,26 @@ General usage
::
- mpv infile -o outfile [-of outfileformat] [-ofopts formatoptions] [-orawts] \
+ mpv infile --o=outfile [--of=outfileformat] [--ofopts=formatoptions] [--orawts] \
[(any other mpv options)] \
- -ovc outvideocodec [-ovcopts outvideocodecoptions] \
- -oac outaudiocodec [-oacopts outaudiocodecoptions]
+ --ovc=outvideocodec [--ovcopts=outvideocodecoptions] \
+ --oac=outaudiocodec [--oacopts=outaudiocodecoptions]
Help for these options is provided if giving help as parameter, as in::
- mpv -ovc help
+ mpv --ovc=help
The suboptions of these generally are identical to ffmpeg's (as option parsing
-is simply delegated to ffmpeg). The option -ocopyts enables copying timestamps
+is simply delegated to ffmpeg). The option --ocopyts enables copying timestamps
from the source as-is, instead of fixing them to match audio playback time
-(note: this doesn't work with all output container formats); -orawts even turns
+(note: this doesn't work with all output container formats); --orawts even turns
off discontinuity fixing.
-Note that if neither -ofps nor -oautofps is specified, VFR encoding is assumed
-and the time base is 24000fps. -oautofps sets -ofps to a guessed fps number
+Note that if neither --ofps nor --oautofps is specified, VFR encoding is assumed
+and the time base is 24000fps. --oautofps sets --ofps to a guessed fps number
from the input video. Note that not all codecs and not all formats support VFR
encoding, and some which do have bugs when a target bitrate is specified - use
--ofps or -oautofps to force CFR encoding in these cases.
+--ofps or --oautofps to force CFR encoding in these cases.
Of course, the options can be stored in a profile, like this .config/mpv/mpv.conf
section::
@@ -48,7 +48,7 @@ to encoding. This is not the case anymore.)
One can then encode using this profile using the command::
- mpv infile -o outfile.mp4 -profile myencprofile
+ mpv infile --o=outfile.mp4 --profile=myencprofile
Some example profiles are provided in a file
etc/encoding-profiles.conf; as for this, see below.
@@ -62,10 +62,10 @@ for.
Typical MPEG-4 Part 2 ("ASP", "DivX") encoding, AVI container::
- mpv infile -o outfile.avi \
+ mpv infile --o=outfile.avi \
--vf=fps=25 \
- -ovc mpeg4 -ovcopts qscale=4 \
- -oac libmp3lame -oacopts ab=128k
+ --ovc=mpeg4 --ovcopts=qscale=4 \
+ --oac=libmp3lame --oacopts=b=128k
Note: AVI does not support variable frame rate, so the fps filter must be used.
The frame rate should ideally match the input (25 for PAL, 24000/1001 or
@@ -73,22 +73,22 @@ The frame rate should ideally match the input (25 for PAL, 24000/1001 or
Typical MPEG-4 Part 10 ("AVC", "H.264") encoding, Matroska (MKV) container::
- mpv infile -o outfile.mkv \
- -ovc libx264 -ovcopts preset=medium,crf=23,profile=baseline \
- -oac libvorbis -oacopts qscale=3
+ mpv infile --o=outfile.mkv \
+ --ovc=libx264 --ovcopts=preset=medium,crf=23,profile=baseline \
+ --oac=libopus --oacopts=qscale=3
Typical MPEG-4 Part 10 ("AVC", "H.264") encoding, MPEG-4 (MP4) container::
- mpv infile -o outfile.mp4 \
- -ovc libx264 -ovcopts preset=medium,crf=23,profile=baseline \
- -oac aac -oacopts ab=128k
+ mpv infile --o=outfile.mp4 \
+ --ovc=libx264 --ovcopts=preset=medium,crf=23,profile=baseline \
+ --oac=aac --oacopts=b=128k
Typical VP8 encoding, WebM (restricted Matroska) container::
mpv infile -o outfile.mkv \
- -of webm \
- -ovc libvpx -ovcopts qmin=6,b=1000000k \
- -oac libvorbis -oacopts qscale=3
+ --of=webm \
+ --ovc=libvpx --ovcopts=qmin=6,b=1000000k \
+ --oac=libopus --oacopts=qscale=3
Device targets
@@ -111,18 +111,18 @@ section.
Refer to the top of that file for more comments - in a nutshell, the following
options are added by it::
- -profile enc-to-dvdpal DVD-Video PAL, use dvdauthor -v pal+4:3 -a ac3+en
- -profile enc-to-dvdntsc DVD-Video NTSC, use dvdauthor -v ntsc+4:3 -a ac3+en
- -profile enc-to-bb-9000 MP4 for Blackberry Bold 9000
- -profile enc-to-nok-6300 3GP for Nokia 6300
- -profile enc-to-psp MP4 for PlayStation Portable
- -profile enc-to-iphone MP4 for iPhone
- -profile enc-to-iphone-4 MP4 for iPhone 4 (double res)
- -profile enc-to-iphone-5 MP4 for iPhone 5 (even larger res)
+ --profile=enc-to-dvdpal # DVD-Video PAL, use dvdauthor -v pal+4:3 -a ac3+en
+ --profile=enc-to-dvdntsc # DVD-Video NTSC, use dvdauthor -v ntsc+4:3 -a ac3+en
+ --profile=enc-to-bb-9000 # MP4 for Blackberry Bold 9000
+ --profile=enc-to-nok-6300 # 3GP for Nokia 6300
+ --profile=enc-to-psp # MP4 for PlayStation Portable
+ --profile=enc-to-iphone # MP4 for iPhone
+ --profile=enc-to-iphone-4 # MP4 for iPhone 4 (double res)
+ --profile=enc-to-iphone-5 # MP4 for iPhone 5 (even larger res)
You can encode using these with a command line like::
- mpv infile -o outfile.mp4 -profile enc-to-bb-9000
+ mpv infile --o=outfile.mp4 --profile=enc-to-bb-9000
Of course, you are free to override options set by these profiles by specifying
them after the -profile option.
@@ -133,19 +133,19 @@ What works
* Encoding at variable frame rate (default)
* Encoding at constant frame rate using --vf=fps=RATE
-* 2-pass encoding (specify flags=+pass1 in the first pass's -ovcopts, specify
+* 2-pass encoding (specify flags=+pass1 in the first pass's --ovcopts, specify
flags=+pass2 in the second pass)
* Hardcoding subtitles using vobsub, ass or srt subtitle rendering (just
configure mpv for the subtitles as usual)
-* Hardcoding any other mpv OSD (e.g. time codes, using -osdlevel 3 and -vf
- expand=::::1)
+* Hardcoding any other mpv OSD (e.g. time codes, using --osdlevel=3 and
+ --vf=expand=::::1)
* Encoding directly from a DVD, network stream, webcam, or any other source
mpv supports
* Using x264 presets/tunings/profiles (by using profile=, tune=, preset= in the
- -ovcopts)
+ --ovcopts)
* Deinterlacing/Inverse Telecine with any of mpv's filters for that
-* Audio file converting: mpv -o outfile.mp3 infile.flac -no-video -oac
- libmp3lame -oacopts ab=320k
+* Audio file converting: mpv --o=outfile.m4a infile.flac --no-video
+ --oac=aac --oacopts=b=320k
What does not work yet
======================