Something went wrong. Try again.
🎥 Command line media player
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151General usage=============
::
mpv infile --o=outfile [--of=outfileformat] [--ofopts=formatoptions] [--orawts] \ [(any other mpv options)] \ --ovc=outvideocodec [--ovcopts=outvideocodecoptions] \ --oac=outaudiocodec [--oacopts=outaudiocodecoptions]
Help for these options is provided if giving help as parameter, as in::
mpv --ovc=help
The suboptions of these generally are identical to ffmpeg's (as option parsingis simply delegated to ffmpeg). The option --ocopyts enables copying timestampsfrom 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 turnsoff discontinuity fixing.
Note that if neither --ofps nor --oautofps is specified, VFR encoding is assumedand the time base is 24000fps. --oautofps sets --ofps to a guessed fps numberfrom the input video. Note that not all codecs and not all formats support VFRencoding, and some which do have bugs when a target bitrate is specified - use--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.confsection::
[myencprofile] vf-add = scale=480:-2 ovc = libx264 ovcopts-add = preset=medium ovcopts-add = tune=fastdecode ovcopts-add = crf=23 ovcopts-add = maxrate=1500k ovcopts-add = bufsize=1000k ovcopts-add = rc_init_occupancy=900k ovcopts-add = refs=2 ovcopts-add = profile=baseline oac = aac oacopts-add = b=96k
It's also possible to define default encoding options by putting them intothe section named ``[encoding]``.
One can then encode using this profile using the command::
mpv infile --o=outfile.mp4 --profile=myencprofile
Some example profiles are provided in a fileetc/encoding-profiles.conf; as for this, see below.
Encoding examples=================
These are some examples of encoding targets this code has been used and testedfor.
Typical MPEG-4 Part 2 ("ASP", "DivX") encoding, AVI container::
mpv infile --o=outfile.avi \ --vf=fps=25 \ --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 or30000/1001 for NTSC)
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=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=b=128k
Typical VP8 encoding, WebM (restricted Matroska) container::
mpv infile -o outfile.mkv \ --of=webm \ --ovc=libvpx --ovcopts=qmin=6,b=1000000k \ --oac=libopus --oacopts=qscale=3
Device targets==============
As the options for various devices can get complex, profiles can be used.
An example profile file for encoding is provided inetc/encoding-profiles.conf in the source tree. mpv will read any filenamed ``encoding-profiles.conf`` in either the local or systemconfiguration directories.
Keep in mind that the default profile is the playback one. If you want to addoptions that apply only in encoding mode, put them into a ``[encoding]``section.
Refer to the top of that file for more comments - in a nutshell, the followingoptions 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)
You can encode using these with a command line like::
mpv infile --o=outfile.mp4 --profile=enc-to-bb-9000
Of course, you are free to override options set by these profiles by specifyingthem after the -profile option.
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 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)* 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)* Deinterlacing/Inverse Telecine with any of mpv's filters for that* Audio file converting: mpv --o=outfile.m4a infile.flac --no-video --oac=aac --oacopts=b=320k
What does not work yet======================
* 3-pass encoding (ensuring constant total size and bitrate constraints while having VBR audio; mencoder calls this "frameno")* Direct stream copy