aboutsummaryrefslogtreecommitdiffhomepage
path: root/DOCS/man/mpv.rst
Commit message (Collapse)AuthorAge
* man: mention stats in interactive controlGravatar Nicolas F2018-10-14
| | | | | | | Someone on IRC pointed out that the default stats bindings weren't documented in the interactive control section of the manual, so let's add them with a short mention and a reference to the STATS section of the manual.
* manpage: fixup mistaken show playlist/track-list shortcutsGravatar Daniel M. Capella2018-07-23
| | | | | This was mistaken in 496b13227b7f4b47a660bbf4e314f9a55b7e8867 and not noticed in review.
* manpage: mention that fd:// file descriptors may be modifiedGravatar wm42018-05-25
| | | | | For example, we call setmode() to switch a FD from text to binary mode on garbage OSes.
* config: replace config dir lua-settings/ with dir script-opts/Gravatar Avi Halachmi (:avih)2018-04-07
| | | | lua-settings/ is still supported, with deprecation warning.
* input: minor additions to default key bindingsGravatar wm42018-03-04
| | | | | | | | | This adds key bindings for some semi-popular features. It also tries to cleanup some old bindings. For example w/e for panscan is now changed to w/W. In all cases, the old bindings are still kept and work, though. Part of an ongoing attempt to cleanup the default key bindings. See #973 for some context.
* manpage: describe how to list/inspect/apply profilesGravatar wm42018-03-03
| | | | | This is all documented elsewhere in the manpage, but hard to find from here.
* options: add a builtin low-latency profileGravatar wm42018-03-03
| | | | | | | | | | Well I guess it doesn't help that much. Also add some stuff that might help to the manpage. The fundamental problem with some "live" sources (e.g. x11grab) is actually that the player gets behind initially, and never thinks it has to catch up. This is also why --untimed can help.
* stream_file: add mode for reading appended filesGravatar wm42018-02-21
| | | | | | | | | | | | | Do this because retrying reading on higher levels (like the demuxer) usually causes tons of problems. A hack like this is simpler and could allow to remove some of the higher level retry behavior. This works by trying to detect whether the file is appended. If we reach EOF, check if the file size changed compared to the initial value. If it did, it means the file was appended at least once, and we set the p->appending flag. If that flag is set, we simply retry reading more data every time we encounter EOF. The only way to do this is polling, and we poll for at most 10 times, after waiting for 200ms every time.
* manpage: remove mention of --vf=eqGravatar wm42018-02-13
| | | | This doesn't work anymore.
* input: add a keybinding to toggle hardware decodingGravatar wm42018-02-13
| | | | | We sure as hell won't enable hardware decoding by default, but we can make it more accessible with a key binding.
* options: add string list -toggle actionGravatar wm42018-01-25
|
* command: add a change-list commandGravatar wm42018-01-25
| | | | | | | | | | | | | Requested. See manpage additions. The main reason why this goes through the trouble to keep the action/operation parameter separate is so that we don't expose some option parser implementation details to the command (although that is a relatively weak reason), and also to make it more different from the "set" command, which can't support this type of option as it goes through the property layer. Fixes #5435.
* manpage: remove obsolete information on bd://Gravatar Ricardo Constantino2018-01-25
| | | | ISO files have been supported by bd:// for a while.
* stream_bluray: always show list of available titlesGravatar Ricardo Constantino2018-01-23
|
* options: add -add/-append actions to key/value listsGravatar wm42017-12-26
| | | | Requested.
* player: show demuxer cache buffered amount in bytes in the status lineGravatar wm42017-12-23
| | | | | | | | I don't want to add another field to display stream and demuxer cache separately, so just add them up. This strangely makes sense, since the forward buffered stream cache amount consists of data not read by the demuxer yet. (If the demuxer cache has buffered the full stream, the forward buffered stream cache amount is 0.)
* manpage: add some minor documenation fixesGravatar Leo Izen2017-12-04
| | | | | | - replace the incorrect reference to --opengl-shader - document a caveat when using --image-display-duration - add some documentation on --vf=lavfi=
* DOCS/mpv.rst: document bluray:// alias for bd://Gravatar Leo Izen2017-11-30
| | | | | | bluray:// is an alias for bd://, but this isn't actually documented anywhere. This should fix that.
* stats: add documentationGravatar Julian2017-10-09
| | | | stats.rst is heavily based on osc.rst
* vo_opengl: refactor into vo_gpuGravatar Niklas Haas2017-09-21
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This is done in several steps: 1. refactor MPGLContext -> struct ra_ctx 2. move GL-specific stuff in vo_opengl into opengl/context.c 3. generalize context creation to support other APIs, and add --gpu-api 4. rename all of the --opengl- options that are no longer opengl-specific 5. move all of the stuff from opengl/* that isn't GL-specific into gpu/ (note: opengl/gl_utils.h became opengl/utils.h) 6. rename vo_opengl to vo_gpu 7. to handle window screenshots, the short-term approach was to just add it to ra_swchain_fns. Long term (and for vulkan) this has to be moved to ra itself (and vo_gpu altered to compensate), but this was a stop-gap measure to prevent this commit from getting too big 8. move ra->fns->flush to ra_gl_ctx instead 9. some other minor changes that I've probably already forgotten Note: This is one half of a major refactor, the other half of which is provided by rossy's following commit. This commit enables support for all linux platforms, while his version enables support for all non-linux platforms. Note 2: vo_opengl_cb.c also re-uses ra_gl_ctx so it benefits from the --opengl- options like --opengl-early-flush, --opengl-finish etc. Should be a strict superset of the old functionality. Disclaimer: Since I have no way of compiling mpv on all platforms, some of these ports were done blindly. Specifically, the blind ports included context_mali_fbdev.c and context_rpi.c. Since they're both based on egl_helpers, the port should have gone smoothly without any major changes required. But if somebody complains about a compile error on those platforms (assuming anybody actually uses them), you know where to complain.
* man/mpv: document bd:// expected titles and title listGravatar Ricardo Constantino2017-08-11
|
* manpage: fix minor spelling mistake in mpv.rstGravatar James Cowgill2017-07-19
| | | | Found by https://lintian.debian.org/
* options: change everything againGravatar wm42017-07-02
| | | | Fucking bullshit.
* options: change path list options, and document list optionsGravatar wm42017-06-30
| | | | | | | | | | | | | | | | | | | | | | | The changes to path list options is basically getting rid of the need to pass multiple paths to a single option. Instead, you can use the option multiple times. The old behavior can be used by using the -set suffix with the option. Change some options to path lists. For example --script is now append by default, and if you use --script-set, you need to use ":"/";" as separator instead of ",". --sub-paths/--audio-file-paths is a deprecated alias now, and will break if the user tries to pass multiple paths to it. I'm assuming that if these are used, most users will pass only 1 path anyway. --opengl-shaders has more compatibility handling, since it's probably rather common that users pass multiple options to it. Also document all that in the manpage. I'll probably regret this later, as it somewhat increases the complexity of the option parser, rather than increasing it.
* input.conf: drop TV/DVB bindingsGravatar wm42017-06-27
| | | | Is anyone still using them? Well, I'm removing them anyway.
* manpage: Remove documentation to use 'I' to show filename on the OSDGravatar Leo Izen2017-06-21
| | | | | | A relic of mplayer had 'I' as the keybind to show the filename of the currently playing file on the OSD. mpv does not do this by default. This commit removes this incorrect information from the mpv manage.
* stream_file: option to close fd after use -> fdclose://Gravatar sfan52017-06-16
| | | | | fdclose://123 will instruct mpv to close the file descriptor when it is no longer needed (usually when playing finishes).
* js: add javascript scripting support using MuJSGravatar Avi Halachmi (:avih)2017-06-14
| | | | | | | | | | | | | | | Implements JS with almost identical API to the Lua support. Key differences from Lua: - The global mp, mp.msg and mp.utils are always available. - Instead of returning x, error, return x and expose mp.last_error(). - Timers are JS standard set/clear Timeout/Interval. - Supports CommonJS modules/require. - Added at mp.utils: getenv, read_file, write_file and few more. - Global print and dump (expand objects) functions. - mp.options currently not supported. See DOCS/man/javascript.rst for more details.
* manpage: Update 'u' keyboard shortcut docs to say 'sub-ass-override'Gravatar Leo Izen2017-06-13
| | | | | | | | | Sometime earlier, "sub-ass-style-override" was renamed to "sub-ass-override". The option's documentation was updated to support this, but not the documentation for the hotkey that toggles this option. This commit updates the keyboard shortcut documentation to fix that. Signed-off-by: wm4 <wm4@nowhere>
* man: document fonts.conf, subfont.ttf, and fonts subdirGravatar Zhuoyun Wei2017-05-02
| | | | | | | | | | | | | | | | | | | Update man page for fonts.conf and subfont.ttf. These are two undocumented features in mpv. They were only hardcoded into sub/ass_mp.c and could not be found anywhere else in the entire codebase. Git log reveals that fonts.conf was added in 2013 while subfont.ttf was brought in by a ancient patch of mplayer in 2002... These are two quite useful undocumented features when you do not want to mess up with global fonts.conf to include more fonts. Also document ~/.config/mpv/fonts/ directory and suggest using fonts.conf to include additional fonts. mpv reads all files in ~/.config/mpv/fonts/ directory into memory. If there are a lot of fonts in that directory, mpv would use a lot of memory. Using ~/.config/mpv/fonts.conf to include additional fonts is more memory-efficent.
* manpage: add empty line between protocol header/descriptionGravatar wm42017-03-25
| | | | Appears to give better formatting. (I'll never understand rst...)
* manpage: explain more about outstanding dvdnav bugsGravatar Frederick Eaton2017-03-25
|
* stream_lavf: add support for data URIsGravatar Ricardo Constantino2017-01-25
| | | | | | | Only FFmpeg supports them and they need to be in the format data:// like other protocols or prefixed with ffmpeg:// or lavf://. Closes #4058
* manpage: add "A/V sync" to make it findable with Ctrl+fGravatar octos2017-01-25
|
* manpage: add table of contents to the HTML versionGravatar Zhiming Wang2016-12-14
| | | | | | | | The reST contents directive is added to mpv.rst. In wscript_build.py, the --strip-elements-with-class=contents option is needed for the rst2man call in order to prevent the TOC from appearing in mpv.1.
* manpage: document current and legacy option syntax betterGravatar wm42016-12-12
| | | | | | | I thought it ewas already documented, but I'm not seeing it anywhere. Maybe it did exist, but was deleted. See #3899.
* manpage: remove mention of window alpha (OSX)Gravatar Akemi2016-12-08
| | | | | | | This is not implemented and i don't even know if it ever was. Also remove a trailing whitespace. Fixes #3866
* manpage: document ytdl://Gravatar wm42016-10-23
|
* options: rename subtitle optionsGravatar Dan Oscarsson2016-10-03
| | | | | | | | | | | Rename the text subtitle options from --sub-text- to --sub- and --ass- options to --sub-ass-. The intention is to common sub options to prefixed --sub- and special ASS option be seen as a special version of sub options. The OSD options that work like the --sub- options are still named --osd-. Man page updated including a short note about renamed --sub-text-* and --ass-* options to --sub-* and --sub-ass-*.
* player: allow opts in pseudo-gui set by the user to override user's defaultGravatar Ricardo Constantino2016-09-26
| | | | | | | | | | | | | | | | | | | | | This should still allow user-set default options to override built-in pseudo-gui while respecting user-set pseudo-gui options. Pros: - user option in default profile overrides built-in pseudo-gui's options Ex: screenshot-directory overrides built-in pseudo-gui's - user can "fix" pseudo-gui if some option like "force-window=no" is set in default by setting "force-window=yes" in [pseudo-gui] - `mpv --profile=pseudo-gui` will work as before Cons: - --show-profile=pseudo-gui won't display the built-in's options Original idea from wm4. Documentation edits mostly by wm4. Signed-off-by: wm4 <wm4@nowhere>
* player: do not let pseudo-gui override user config settingsGravatar wm42016-09-23
| | | | | | | | Seems like this confused users quite often. Instead of --profile=pseudo-gui, --player-operation-mode=pseudo-gui now has to be used to invoke pseudo GUI mode. The old way still works, and still behaves in the old way.
* DOCS: vo/ao auto profiles are deprecatedGravatar RiCON2016-09-17
| | | Leftovers from removal of references to ao/vo auto profiles.
* stream_cdda: remove weird option parsing stuffGravatar wm42016-09-09
| | | | | | | | | | Mostly untested. This is not compatible. It removes the URL fields for track range and cdrom speed (what did this even do). The device is not not to be prefixed with an additional "/" if it's put into the URL. I can't be bothered to keep these things compatible, just rip your damn CDs instead.
* manpage: remove more references to deprecated sub-option syntaxGravatar wm42016-09-07
| | | | Fixes #3497.
* DOCS: move libmpv stub to manpageGravatar wm42016-09-02
| | | | | | | And replace the sort-of duplicated explanations. (It's a bit funny to use weblinks to the generated web version of itself instead of proper RST links, but I think I don't care.)
* Use - as command-name separator everywhereGravatar Timotej Lazar2016-07-14
| | | | | | | Old-style commands using _ as separator (e.g. show_progress) were still used in some places, including documentation and configuration files. This commit updates all such instances to the new style (show-progress) so that commands are easier to find in the manual.
* docs: fix some typosGravatar Ben Boeckel2016-05-23
|
* manpage: document -- and some issues passing filenamesGravatar wm42016-05-10
|
* stream_memory: add hex:// protocolGravatar wm42016-04-20
| | | | Completely useless, expect for some special purposes.
* manpage: change underscore to hyphen in input commandGravatar Kevin Mitchell2016-04-03
| | | | fixes #3018