RepoMirrors
/
mpv
mirror of https://github.com/mpv-player/mpv
1
0
Fork 0
Code Issues Releases Wiki Activity
mpv/DOCS/man/en/changes.rst

232 lines
12 KiB
ReStructuredText
Raw Normal View History

manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
.. _changes:
CHANGES FROM OTHER VERSIONS OF MPLAYER
======================================
Rename to "mpv" This changes the name of this project to mpv. Most user-visible mentions of "MPlayer" and "mplayer" are changed to "mpv". The binary name and the default config file location are changed as well. The new default config file location is: ~/.mpv/ Remove etc/mplayer.desktop. Apparently this was for the MPlayer GUI, which has been removed from mplayer2 ages ago. We don't have a logo, and the MS Windows resource files sort-of require one, so leave etc/mplayer.ico/.xpm as-is. Remove the debian and rpm packaging scripts. These contained outdated dependencies and likely were more harmful than useful. (Patches which add working and well-tested packaging are welcome.)
2012-10-11 00:04:08 +00:00
**mpv** is based on mplayer2, which in turn is based on the original
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
MPlayer (also called mplayer, mplayer-svn, mplayer1). Many changes
have been made. Some changes are incompatible, or completely change how the
player behaves.
manpage: fix section headings
2013-07-07 18:37:47 +00:00
General Changes for MPlayer-svn to mplayer2
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
-------------------------------------------
* Removal of the internal GUI, MEncoder, OSD menu
* Better pause handling (don't unpause on a command)
* Better MKV support (such as ordered chapters)
* vo_vdpau improvements
* Precise seeking support
* No embedded copy of ffmpeg and other libraries
* Native OpenGL backend for OSX
* General OSX improvements
* Improvements in audio/video sync handling
* Cleaned up terminal output
* Gapless audio support (``--gapless-audio``)
* Improved responsiveness on user input
* Support for modifier keys (alt, shift, ctrl) in input.conf
* OSS4 volume control
* More correct color reproduction (color matrix generation)
* Use libass for subtitle rendering by default (better quality)
* Generally preferring ffmpeg/libav over internal demuxers and decoders
* Improvements when playing multiple files (``--fixed-vo``)
* Screenshot improvements (instant screenshots without 1-frame delay)
* Improved support for PulseAudio
* General code cleanups
* Many more changes
manpage: fix section headings
2013-07-07 18:37:47 +00:00
General Changes for mplayer2 to mpv
-----------------------------------
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
* Removal of lots of unneeded code to encourage developer activity (less
obscure scary zombie code that kills any desire for hacking the codebase)
* Removal of dust and dead bodies (code-wise), such as kernel drivers for
decades old hardware
* Removal of support for dead platforms
* Generally improved MS Windows support (dealing with unicode filenames,
manpage: cleanup Removing text about things that have been removed from the code long ago, other fixes.
2012-10-23 23:06:00 +00:00
improved ``--vo=direct3d``, improved window handling)
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
* Better OSD rendering (using libass). This has full unicode support, and
languages like Arabic should be better supported.
* Cleaned up terminal output (nicer status line, less useless noise)
* Support for playing URLs of popular streaming sites directly
Rename to "mpv" This changes the name of this project to mpv. Most user-visible mentions of "MPlayer" and "mplayer" are changed to "mpv". The binary name and the default config file location are changed as well. The new default config file location is: ~/.mpv/ Remove etc/mplayer.desktop. Apparently this was for the MPlayer GUI, which has been removed from mplayer2 ages ago. We don't have a logo, and the MS Windows resource files sort-of require one, so leave etc/mplayer.ico/.xpm as-is. Remove the debian and rpm packaging scripts. These contained outdated dependencies and likely were more harmful than useful. (Patches which add working and well-tested packaging are welcome.)
2012-10-11 00:04:08 +00:00
(e.g. ``mpv https://www.youtube.com/watch?v=...``)
manpage: cleanup Removing text about things that have been removed from the code long ago, other fixes.
2012-10-23 23:06:00 +00:00
* Improved OpenGL output (``--vo=opengl-hq``)
Rename to "mpv" This changes the name of this project to mpv. Most user-visible mentions of "MPlayer" and "mplayer" are changed to "mpv". The binary name and the default config file location are changed as well. The new default config file location is: ~/.mpv/ Remove etc/mplayer.desktop. Apparently this was for the MPlayer GUI, which has been removed from mplayer2 ages ago. We don't have a logo, and the MS Windows resource files sort-of require one, so leave etc/mplayer.ico/.xpm as-is. Remove the debian and rpm packaging scripts. These contained outdated dependencies and likely were more harmful than useful. (Patches which add working and well-tested packaging are welcome.)
2012-10-11 00:04:08 +00:00
* Make ``--softvol`` default (**mpv** is not a mixer control panel)
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
* Improved support for .cue files
manpage: cleanup Removing text about things that have been removed from the code long ago, other fixes.
2012-10-23 23:06:00 +00:00
* Screenshot improvements (can save screenshots as JPG or PNG, configurable
screenshot: minor simplification, prefer VF over VO Remove screenshot_force and associated logic. Always try to use the screenshot video filter before trying taking screenshots with the VO, which means that --vf=screenshot now takes the role of --vf=screenshot_force. (To make this clear, not adding a video filter is still the recommended way to take screenshots; we just change how VF screenshots are forced.) Preferring VO over VF and having --vf=screenshot_force used to make sense when not all VOs supported screenshots, and some VOs had somewhat broken screenshots (like vo_xv taking screenshots with OSD in it). But all these issues are fixed now, so just get rid of the cruft.
2013-01-30 00:17:33 +00:00
filenames, support for taking screenshots with or without subtitles - the
``screenshot`` video filter is not needed anymore, and should not be put
into the mpv config file)
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
* Removal of teletext support
manpage: cleanup Removing text about things that have been removed from the code long ago, other fixes.
2012-10-23 23:06:00 +00:00
* Replace image VOs (``--vo=jpeg`` etc.) with ``--vo=image``
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
* Do not lose settings when playing a new file in the same player instance
manpage: various fixes
2012-11-15 13:25:20 +00:00
* New location for config files, new name for the binary.
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
* Slave mode compatibility broken (see below)
manpage: various fixes
2012-11-15 13:25:20 +00:00
* Encoding functionality (replacement for mencoder, see ``DOCS/encoding.rst``)
* Remove ``--vo=gif89a``, ``--vo=md5sum``, ``--vo=yuv4mpeg``, as encoding can
handle these use cases. For yuv4mpeg, for example, use:
manpage: adjust y4m output example The additional flags are needed to get the muxer to write the source video frame rate (instead of a fallback) for 100% equivalence to the replaced MPlayer/mplayer2 y4m writer.
2013-06-12 15:23:47 +00:00
``mpv input.mkv -o output.y4m --no-audio --oautofps --oneverdrop``.
manpage: cleanup Removing text about things that have been removed from the code long ago, other fixes.
2012-10-23 23:06:00 +00:00
* Image subtitles (DVDs etc.) are rendered in color and use more correct
sub: add --sub-gray option to display image subs in grayscale MPlayer/mplayer2 still show DVD subtitles in gray. Depending on who you ask, this can be considered a bug or a feature. Include rendering in gray as explicit feature, so the user can decide what is better. This affects all indexed sub bitmaps entering the OSD rendering path. Currently, this means all image subs are affected by this option, but nothing else.
2012-11-25 22:32:35 +00:00
positioning (color can be disabled with ``--sub-gray``)
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
* General code cleanups
* Many more changes
manpage: fix section headings
2013-07-07 18:37:47 +00:00
Detailed Listing of User-visible Changes
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
----------------------------------------
This listing is about changed command line switches, slave commands, and similar
things. Completely removed features are not listed.
manpage: fix section headings
2013-07-07 18:37:47 +00:00
Command Line Switches
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
~~~~~~~~~~~~~~~~~~~~~
manpage: fix section headings
2013-07-07 18:37:47 +00:00
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
* There is a new command line syntax, which is generally preferred over the old
syntax. ``-optname optvalue`` becomes ``--optname=optvalue``.
The old syntax will not be removed in the near future. However, the new
syntax is mentioned in all documentation and so on, so it's a good thing to
know about this change.
(The new syntax was introduced in mplayer2.)
manpage: cleanup Removing text about things that have been removed from the code long ago, other fixes.
2012-10-23 23:06:00 +00:00
* In general, negating switches like ``-noopt`` now have to be written as
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
``-no-opt``, or better ``--no-opt``.
* Per-file options are not the default anymore. You can explicitly specify
file local options. See ``Usage`` section.
commands: replace --hardframedrop, change framedropping property Replace --hardframedrop with --framedrop=hard. Rename the framedrop property from "framedropping" to "framedrop" for the sake of making command line options have the same name as their corresponding property. Change the property to accept choice values instead of numeric values. Remove unused/forgotten auto_quality variable.
2012-09-17 06:38:19 +00:00
* Table of renamed/replaced switches:
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
=================================== ===================================
Old New
=================================== ===================================
ao_pcm: fix references to -novideo The option is -no-video. Remove the deprecated "fast" suboption, which did nothing and instructed the user to use "-novideo" instead. Fix a reference to -novideo in encoding.rst. Add a "generic" entry about -no-* to the list of renamed options. The change is already explicitly mentioned in the text above the table, but even if it's redundant, it makes it harder to overlook.
2012-11-30 16:32:46 +00:00
-no<opt> --no-<opt> (add a dash)
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
-nosound --no-audio
manpage: document -use-filename-title removal/replacement
2012-08-20 13:32:13 +00:00
-use-filename-title --title="${filename}"
options: change --loop option, and extend choice option type The --loop option takes slightly different parameters now. --loop=0 used to mean looping forever. Now it means looping is disabled (this is more logical: 2 means playing 2 more times, 1 means playing 1 more time, and 0 should mean playing not again). Now --loop=inf must be used to enable looping forever. Extend choice types to allow an optional range of integers as values. If CONF_RANGE is added to the flags of a m_option_type_choice option, m_option.min/max specify a range of allowed integer values. This can be used to remove "special" values from make integer range options. These special values are unintuitive, and sometimes expose mplayer internals to the user. The (internal) choice values can be freely mixed with the specified integer value range. If there are overlaps, the choice values are preferred for conversion to/from strings. Also make sure the extension to choice options works with properties. Add the ability to step choice properties downwards, instead of just upwards.
2012-09-05 00:17:13 +00:00
-loop 0 --loop=inf
commands: replace --hardframedrop, change framedropping property Replace --hardframedrop with --framedrop=hard. Rename the framedrop property from "framedropping" to "framedrop" for the sake of making command line options have the same name as their corresponding property. Change the property to accept choice values instead of numeric values. Remove unused/forgotten auto_quality variable.
2012-09-17 06:38:19 +00:00
-hardframedrop --framedrop=hard
commands: rename "osdlevel" option and property, make it a choice Rename both the option and property to "osd-level", which fits a bit better with the general naming scheme. Make it a choice instead of an integer range. I failed to come up with good names for the various levels, so leave them as-is. Remove the useless property handler for the "loop" property too.
2012-09-17 06:45:35 +00:00
-osdlevel --osd-level
commands: add more property-option bridge uses, rename some options Make more properties use the property-to-option bridge to reduce code size and to enforce consistency. Some options are renamed to the same as the properties (the property names are better in all cases). Do some other minor cleanups. One bigger issue was memory management of strings: M_PROPERTY_TO_STRING assumed the strings were statically allocated, and no dynamic allocations could be returned. Fix this in case the need for such properties arises in the future. Get rid of m_property_string_ro(), because it's not always clear that the "action" parameter is M_PROPERTY_SET and the string argument will be used.
2012-09-18 18:07:24 +00:00
-delay --audio-delay
-subdelay --sub-delay
-subpos --sub-pos
-forcedsubsonly --sub-forced-only
options: rename -ni to -avi-ni The -ni option does something with the AVI demuxer only. Also fix misleading error messages when the packet queue overflows (it suggests using -ni, which in the typical case of playing NI AVI files will not work, as demux_lavf is used by default).
2012-10-28 19:23:15 +00:00
-ni --avi-ni
manpage: -benchmark was renamed to -untimed
2012-10-28 19:24:52 +00:00
-benchmark --untimed (no stats)
options: rename --xineramascreen to --screen, remove magic values --xineramascreen=-2 becomes --screen=all --xineramascreen=-1 becomes --screen=current
2012-11-15 14:32:55 +00:00
-xineramascreen --screen (different values)
options: rename -ss and -endpos, allow relative times Rename the -ss option to -start, and -endpos to -length. Add a -end option. The -end option always specifies an absolute end time, as opposed to -endpos/-length. All these options (--start, --end, --length) now accept relative times. Percent positions (e.g. "--start=30%") are interpreted as fractions of the file duration. Negative times (e.g. "--start=-1:00) are interpreted relative to the end of the file. Chapters (e.g. "--start=#3") yield the chapter's time position. The chapter support might be able to replace --chapter completely, but for now I am not sure how well this works out with e.g. DVDs and BDs, and a separate --chapter option is useful interface-wise.
2012-11-15 17:49:17 +00:00
-ss --start
-endpos --length
options: rename --cursor-autohide, replace magic number values --cursor-autohide-delay=-2 becomes --cursor-autohide=always --cursor-autohide-delay=-1 becomes --cursor-autohide=no --cursor-autohide-delay=123 becomes --cursor-autohide=123
2012-11-15 17:59:41 +00:00
--cursor-autohide-delay --cursor-autohide
options: rename -sub-fuzziness to -autosub-match, change option values "--autosub-match" is close to "--autosub", and reflects what this option does slightly better. Replace the magic number option values with choices: --sub-fuzziness=0 becomes --autosub-match=exact --sub-fuzziness=1 becomes --autosub-match=fuzzy --sub-fuzziness=2 becomes --autosub-match=all
2012-11-15 18:08:21 +00:00
-sub-fuzziness --autosub-match
sub: add --sub-text-* options to unstyled text subtitles font Before this commit, the --osd-* options (like --osd-font-size etc.) configured both the OSD and subtitle font. Make them separate, and add --sub-text-* options (like --sub-text-size etc.). Now --osd-* affects the OSD font only, and --sub-text-* unstyled text subtitles only.
2013-01-04 15:10:17 +00:00
-subfont --sub-text-font
-font --osd-font
-subfont-* --sub-text-*, --osd-*
osd: make the OSD and sub font more customizable Make more aspects of the OSD font customizable. This also affects the font used for unstyled subtitles (such as SRT), or when using the --no-ass option. This adds back some customizability that was lost with commit 74e7a1 (osd: use libass for OSD rendering). Removed options: --ass-border-color --ass-color --font --subfont --subfont-text-scale Added options: --osd-color --osd-border --osd-back-color --osd-shadow-color --osd-font --osd-font-size --osd-border-size --osd-margin-x --osd-margin-y --osd-shadow-offset --osd-spacing --sub-scale The font size is now specified in pixels as it would be rendered on a window with a height of 720 pixels. OSD and subtitles are always scaled with the window height, so specifying or expecting an absolute font size doesn't make sense. Such scaled pixel units are used to specify font border etc. as well. (Note: the font size is directly passed to libass. How the fonts are actually rasterized is outside of our control, but in theory ASS font sizes map to "script" pixels and then are scaled to screen size.) The default settings should be about the same, with slight difference due to rounding to the new scales. The OSD and subtitle fonts are not separately configurable. It has limited use and would double the number of newly added options, which would be more confusing than helpful. It could be easily added later, should the need arise. Other small details that change: - ASS_Style.Encoding is not set to -1 for subs anymore (assuming subs use VSFilter direction in -no-ass mode too) - use a different WrapStyle for OSD - ASS forced styles are not applied to OSD
2012-11-17 19:56:45 +00:00
-subfont-text-scale --sub-scale
sub: reimplement -spugauss as --sub-gauss Apparently the -spugauss option was popular. The code originally implementing this is gone (scaler stuff in spudec.c). Reimplement it using libswscale to scale and blur image subtitles if the --sub-gauss option is set. The code does some rather lazy padding to allow the blur to spread pixels past the original image bounding box. (This problem exists with normal bilinear scaling too, but is barely noticable.) Technically, this doesn't just blur subtitles, but anything RGBA (or indexed) that enters the OSD rendering path. But only image subtitles produce these OSD formats currently, so no explicit check is done to prevent blurring in other cases.
2012-11-24 23:06:16 +00:00
-spugauss --sub-gauss
sub: remove vobsub reader in favor of ffmpeg vobsub demuxer ffmpeg recently added a demuxer that can read vobsubs (pairs of .sub and .idx files). Get rid of the internal vobsub reader, and use the ffmpeg demuxer instead. Sneak in an unrelated manpage change (autosub default).
2012-12-08 12:59:49 +00:00
-vobsub --sub (pass the .idx file)
options: move -ass-bottom-margin/-ass-top-margin options to vf_sub These options might be useful sometimes, but they are not that important, and work with vf_sub only. Make them vf_sub sub-options.
2012-12-12 22:35:01 +00:00
-ass-bottom-margin --vf=sub=bottom:top
video: different way to enable hardware decoding, add software fallback Deprecate the hardware specific video codec entries (like ffh264vdpau). Replace them with the --hwdec switch, which requests that a specific hardware decoding API should be used. The codecs.conf entries will be removed at a later time, but for now they are useful for testing and compatibility. Instead of --vc=ffh264vdpau, --hwdec=vdpau should be used. Add a fallback if hardware decoding fails. Most hardware decoders (including vdpau) support only a subset of h264, and having such a fallback is supposed to enable a better user experience.
2012-12-11 17:16:42 +00:00
-vc ffh264vdpau (etc.) --hwdec=vdpau
core: redo how codecs are mapped, remove codecs.conf Use codec names instead of FourCCs to identify codecs. Rewrite how codecs are selected and initialized. Now each decoder exports a list of decoders (and the codec it supports) via add_decoders(). The order matters, and the first decoder for a given decoder is preferred over the other decoders. E.g. all ad_mpg123 decoders are preferred over ad_lavc, because it comes first in the mpcodecs_ad_drivers array. Likewise, decoders within ad_lavc that are enumerated first by libavcodec (using av_codec_next()) are preferred. (This is actually critical to select h264 software decoding by default instead of vdpau. libavcodec and ffmpeg/avconv use the same method to select decoders by default, so we hope this is sane.) The codec names follow libavcodec's codec names as defined by AVCodecDescriptor.name (see libavcodec/codec_desc.c). Some decoders have names different from the canonical codec name. The AVCodecDescriptor API is relatively new, so we need a compatibility layer for older libavcodec versions for codec names that are referenced internally, and which are different from the decoder name. (Add a configure check for that, because checking versions is getting way too messy.) demux/codec_tags.c is generated from the former codecs.conf (minus "special" decoders like vdpau, and excluding the mappings that are the same as the mappings libavformat's exported RIFF tables). It contains all the mappings from FourCCs to codec name. This is needed for demux_mkv, demux_mpg, demux_avi and demux_asf. demux_lavf will set the codec as determined by libavformat, while the other demuxers have to do this on their own, using the mp_set_audio/video_codec_from_tag() functions. Note that the sh_audio/video->format members don't uniquely identify the codec anymore, and sh->codec takes over this role. Replace the --ac/--vc/--afm/--vfm with new --vd/--ad options, which provide cover the functionality of the removed switched. Note: there's no CODECS_FLAG_FLIP flag anymore. This means some obscure container/video combinations (e.g. the sample Film_200_zygo_pro.mov) are played flipped. ffplay/avplay doesn't handle this properly either, so we don't care and blame ffmeg/libav instead.
2013-02-09 14:15:19 +00:00
-ac spdifac3 --ad=spdif:ac3 (see --ad=help)
changes.rst: mention -afm hwac3 replacement
2013-03-30 19:19:38 +00:00
-afm hwac3 --ad=spdif:ac3,spdif:dts
manpage: document option syntax variations better
2013-02-03 15:40:02 +00:00
-x W, -y H --geometry=WxH + --no-keepaspect
-xy W --autofit=W
options: add option to prevent decoder audio downmixing Also rename --a52drc to --ad-lavc-ac3drc, and add --ad-lavc-o.
2013-03-31 02:24:53 +00:00
-a52drc level --ad-lavc-ac3drc=level
core: re-add -dumpstream as --stream-dump Apparently useful for dumping DVD. Could also be used to rip streams with libquvi and such, but for that there are better tools. Actually I doubt there aren't better tools to dump DVDs, but whatever, this was a feature request, so I don't need a good reason.
2013-05-11 20:40:46 +00:00
-dumpstream --stream-dump=<filename>
-capture --stream-capture=<filename>
x11: enable screensaver when paused, rename/change --stop-xscreensaver Use the recently introduced screensaver VOCTRLs to control the screensaver in the X11 backend. This means the behavior when paused changes: the old code always kept the screensaver disabled, but now the screensaver is reenabled on pausing. Rename the --stop-xscreensaver option to --stop-screensaver and make it more generic. Now it affects all backends that respond to the screensaver VOCTRLs.
2013-06-13 22:24:41 +00:00
-stop-xscreensaver --stop-screensaver
sub: add demux_libass wrapper, drop old hacks demux_libass.c allows us to make subtitle format detection part of the normal file loading process. libass has no probe function, but trying to load the start of a file (the first 4 KB) is good enough. Hope that libass can even handle random binary input gracefully without printing stupid log messages, and that the libass parser doesn't accept too many non-ASS files as input. This doesn't handle the -subcp option correctly yet. This will be fixed later.
2013-06-22 00:09:52 +00:00
-subfile --sub
options: rename -lavdopts to -vd-lavc, -lavfdopts to -demuxer-lavf Also change manpage so that top-level options are documented instead of suboptions. Suboptions still work, but might go away eventually.
2013-06-28 12:56:52 +00:00
-lavdopts ... --vd-lavc-...
-lavfdopts --demuxer-lavf-...
options: rename --rawvideo to --demuxer-rawvideo, same with --rawaudio
2013-06-28 13:13:43 +00:00
-rawaudio ... --demuxer-rawaudio-...
-rawvideo ... --demuxer-rawvideo-...
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
=================================== ===================================
manpage: document option syntax variations better
2013-02-03 15:40:02 +00:00
*NOTE*: ``-opt val`` becomes ``--opt=val``.
manpage: fix section headings
2013-07-07 18:37:47 +00:00
input.conf and Slave Commands
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
manpage: document input.conf related things This directly corresponds to DOCS/OUTDATED-tech/slave.txt. Changes from the recent commits are included too.
2012-09-27 01:20:12 +00:00
* Table of renamed input commands:
This lists only commands that are not always gracefully handled by the
internal legacy translation layer. If an input.conf contains any legacy
commands, they will be displayed with ``-v`` when it is loaded, and show
and the replacement commands.
Properties containing ``_`` to separate words use ``-`` instead.
+--------------------------------+----------------------------------------+
| Old | New |
+================================+========================================+
| pt_step 1 [0|1] | playlist_next [weak|force] |
| | (translation layer can't deal with |
| | whitespace) |
+--------------------------------+----------------------------------------+
| pt_step -1 [0|1] | playlist_prev [weak|force] (same) |
+--------------------------------+----------------------------------------+
| switch_ratio [<ratio>] | set aspect <ratio> |
| | set aspect 0 (to reset aspect) |
+--------------------------------+----------------------------------------+
| step_property_osd <prop> <step>| cycle <prop> <step> (wraps), |
| <dir> | add <prop> <step> (clamps). |
| | <dir> parameter unsupported. Use |
| | a negative step instead. |
+--------------------------------+----------------------------------------+
| step_property <prop> <step> | Prefix cycle or add with no-osd: |
options: drop --opt:subopt option names For all suboptions, "flat" options were available by separating the parent option and the sub option with ":", e.g. "--rawvideo:w=123". Drop this syntax and use "-" as separator. This means even suboptions are available as normal options now, e.g. "--rawvideo-w=123". The old syntax doesn't work anymore. Note that this is completely separate from actual suboptions. For example, "-rawvideo w=123:h=123" still works. (Not that this syntax is worth supporting, but it's needed anyway, for for other things like vf and vo suboptions.) As a consequence of this change, we also have to add new "no-" prefixed options for flag suboptions, so that "--no-input-default-bindings" works. ("--input-no-default-bindings" also works as a consequence of allowing "-input no-default-bindings" - they are handled by the same underlying option.) For --input, always use the full syntax in the manpage. There exist suboptions other than --input (like --tv, --rawvideo, etc.), but since they might be handled differently in the future, don't touch these yet. M_OPT_PREFIXED becomes the default, so remove it. As a minor unrelated cleanup, get rid of M_OPT_MERGE too and use the OPT_SUBSTRUCT() macro in some places. Unrelated: remove the duplicated --tv:buffersize option, fix a typo in changes.rst.
2013-02-21 21:10:21 +00:00
| <dir> | no-osd cycle <prop> <step> |
manpage: document input.conf related things This directly corresponds to DOCS/OUTDATED-tech/slave.txt. Changes from the recent commits are included too.
2012-09-27 01:20:12 +00:00
+--------------------------------+----------------------------------------+
| osd_show_property_text <text> | show_text <text> |
| | The property expansion format string |
| | syntax slightly changed. |
+--------------------------------+----------------------------------------+
| osd_show_text | Now does the same as |
command: replace some show_ commands with properties show_chapters, show_tracks, and show_playlist are killed and replaced with the properties chapter-list, track-list, and playlist. The code and the output of these stays the same, this is just moving a lot of code around and reducing the number of properties. The "old" commands will still be supported for a while (to avoid making everyone angry), so handle them with the legacy layer. Add something to suppress printing the legacy warnings for these commands.
2013-05-15 00:17:47 +00:00
| | osd_show_property_text. Use the raw |
| | prefix to disable property expansion. |
+--------------------------------+----------------------------------------+
| show_tracks | show_text ${track-list} |
+--------------------------------+----------------------------------------+
| show_chapters | show_text ${chapter-list} |
manpage: document input.conf related things This directly corresponds to DOCS/OUTDATED-tech/slave.txt. Changes from the recent commits are included too.
2012-09-27 01:20:12 +00:00
+--------------------------------+----------------------------------------+
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
Other
~~~~~
Rename to "mpv" This changes the name of this project to mpv. Most user-visible mentions of "MPlayer" and "mplayer" are changed to "mpv". The binary name and the default config file location are changed as well. The new default config file location is: ~/.mpv/ Remove etc/mplayer.desktop. Apparently this was for the MPlayer GUI, which has been removed from mplayer2 ages ago. We don't have a logo, and the MS Windows resource files sort-of require one, so leave etc/mplayer.ico/.xpm as-is. Remove the debian and rpm packaging scripts. These contained outdated dependencies and likely were more harmful than useful. (Patches which add working and well-tested packaging are welcome.)
2012-10-11 00:04:08 +00:00
* The playtree has been removed. **mpv**'s internal playlist is a simple and
manpage: various fixes
2012-11-15 13:25:20 +00:00
flat list now. This makes the code easier, and makes **mpv** usage less
confusing.
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
* Slave mode is broken. This mode is entirely insane in the ``old`` versions of
mplayer. A proper slave mode application needed tons of code and hacks to get
it right. The main problem is that slave mode is a bad and incomplete
interface, and to get around that, applications parsed output messages
manpage: cleanup Removing text about things that have been removed from the code long ago, other fixes.
2012-10-23 23:06:00 +00:00
intended for users. It's hard to know which messages exactly are parsed by
slave mode applications. This makes it virtually impossible to improve
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
terminal output intended for users without possibly breaking something.
Rename to "mpv" This changes the name of this project to mpv. Most user-visible mentions of "MPlayer" and "mplayer" are changed to "mpv". The binary name and the default config file location are changed as well. The new default config file location is: ~/.mpv/ Remove etc/mplayer.desktop. Apparently this was for the MPlayer GUI, which has been removed from mplayer2 ages ago. We don't have a logo, and the MS Windows resource files sort-of require one, so leave etc/mplayer.ico/.xpm as-is. Remove the debian and rpm packaging scripts. These contained outdated dependencies and likely were more harmful than useful. (Patches which add working and well-tested packaging are welcome.)
2012-10-11 00:04:08 +00:00
This is absolutely insane, and **mpv** will not try to keep slave mode
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
compatible. If you're a developer of a slave mode application, contact us,
and a new and better protocol can be developed.
manpage: fix section headings
2013-07-07 18:37:47 +00:00
Policy for Removed Features
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
---------------------------
Features are a good thing, because they make users happy. As such, it is
attempted to preserve useful features as far as possible. But if a feature is
manpage: cleanup Removing text about things that have been removed from the code long ago, other fixes.
2012-10-23 23:06:00 +00:00
likely to be not used by many, and causes problems otherwise, it will be
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
removed. Developers should not be burdened with fixing or cleaning up code that
has no actual use.
It's always possible to add back removed features. File a feature request if a
feature you relied on was removed, and you want it back. Though it might be
rejected in the worst case, it's much more likely that it will be either added
back, or that a better solution will be implemented.
manpage: fix section headings
2013-07-07 18:37:47 +00:00
Why this Fork?
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
--------------
* mplayer-svn wants to maintain old code, even if it's very bad code. It seems
mplayer2 was forked, because mplayer-svn developers refused to get rid of
all the cruft. The mplayer2 and mplayer-svn codebases also deviated enough to
make a reunification unlikely.
* mplayer2 development is slow, and it's hard to get in changes. Details
withheld as to not turn this into a rant.
* mplayer-svn rarely merged from mplayer2, and mplayer2 practically stopped
merging from mplayer-svn (not even code cleanups or new features are merged)
Rename to "mpv" This changes the name of this project to mpv. Most user-visible mentions of "MPlayer" and "mplayer" are changed to "mpv". The binary name and the default config file location are changed as well. The new default config file location is: ~/.mpv/ Remove etc/mplayer.desktop. Apparently this was for the MPlayer GUI, which has been removed from mplayer2 ages ago. We don't have a logo, and the MS Windows resource files sort-of require one, so leave etc/mplayer.ico/.xpm as-is. Remove the debian and rpm packaging scripts. These contained outdated dependencies and likely were more harmful than useful. (Patches which add working and well-tested packaging are welcome.)
2012-10-11 00:04:08 +00:00
* **mpv** intents to continuously merge from mplayer-svn and mplayer2, while
manpage: add initial documentation about changes Documents changes from mplayer-svn and mplayer2. Most of this should probably not be in the manpage, but on a website. But there is no website yet.
2012-08-07 20:24:29 +00:00
speeding up development. There is willingness for significant changes, even
if this means breaking compatibility.