summaryrefslogtreecommitdiffstats
path: root/DOCS/man/mpv.rst
Commit message (Collapse)AuthorAgeFilesLines
* m_option: change confusing error messages for obj_settings_listnanahi32 hours1-13/+14
| | | | | | | | | This option type is not used only by filter options: they're already used by --ao, --vo, and --gpu-context. Replace the mentions of "filter" to "item" instead, and changes some languages to improve clarity. Also change the documentation on "Filter options" to describe what it really is, and fix a typo.
* DOCS/man/mpv: correct description of F8/F9 keybindsnanahi9 days1-4/+2
| | | | | Previous commit fixes showing the list in the terminal, so the mentions of it can be removed.
* DOCS/man: unify flag option descriptionsnanahi12 days1-2/+2
| | | | | | | | | | | In many places, flags options have duplicate descriptions like --break-player and --no-break-player. This is redundant since the equivalence of this syntax to --break-player=<yes|no> is already documented, and the =<yes|no> syntax is more in line with the syntax of other option types. This replaces all usage of --no-foobar with --foobar=no, and use --foobar=<yes|no> when possible.
* vo: add win32 context menu supportShuanglei Tao14 days1-0/+15
|
* input.conf: add `b` to toggle debandingKacper Michajłow2024-03-191-0/+3
|
* DOCS/man: document Ctrl+WHEEL_UP/WHEEL_DOWN keybindsnanahi2024-02-211-2/+4
| | | | Also remove the existing redundant wordings.
* DOCS/mpv: update ancient profiles config examplellyyr2024-02-201-11/+13
| | | | | Hopefully actually useful now. Also updates big-cache to not be smaller than the current default.
* player: add an auto option to deinterlaceDudemanguy2024-02-071-1/+1
| | | | | | | | | | Deinterlacing required that the user set it on/off themselves, but we actually have handy flags for detecting if a frame is interlaced. So it's pretty simple to make an auto option using that. Unfortunately, life is not quite that simple and there are known cases of false positives from the ffmpeg flags so we can't make auto the default value. However, it still may have some utility for some people, and the detection could potentially be improved upon later. Closes #10358.
* DOCS/mpv: document how mf:// URLs are formedGuido Cella2024-02-021-1/+12
|
* DOCS/*: remove mentions of Libavllyyr2024-01-201-4/+4
|
* DOCS/mpv: the playback position is not remembered after poweroffGuido Cella2024-01-131-4/+4
| | | | | | | | | | | This doesn't actually work on either Windows or Linux with --terminal. With --no-terminal or --no-input-terminal the SIGTERM handler is never registered, so it definitely can't work. Just remove the note about signals because it would be complicated to explain that they don't terminate abruptly only with --terminal and only if that signal has a handler, and it wouldn't be of interest to most users.
* DOCS/man: remove "Linux desktop issues" sectionnanahi2023-12-291-21/+0
| | | | | | | | | | | | | | | | | | | This section has no reason to exist anymore because: - No "desktop issues" sections exist for other platforms, and all other Linux-specific issues are represented as notes for options. This section only addressed one specific issue. - This section was shortened significantly with commit 2c46ae8ea3d9ae32b52eae9092f0517d69dcedbc, so there is no need for this to be a separate section anymore. - This section was shortened again with commit d5e681e95df759a4df8608cc773931e3f97c9460, when the original rationale behind this section became outdated because GNOME has implemented the idle inhibit protocol. The historical info is moved to the documentation of --stop-screensaver.
* DOCS/mpv: quotes in mpv.conf don't escape backslashGuido Cella2023-11-271-2/+3
| | | | | I don't know why I thought they did in 7798881360, but single quotes disable escape sequences only in input.conf commands.
* DOCS/options: update watch-later-options docsKacper Michajłow2023-11-121-1/+1
|
* DOCS/mpv: consistent formatting of keybindingsChristoph Heinrich2023-11-071-12/+12
|
* m_option: drop support for -del for list optionsDudemanguy2023-10-301-2/+0
| | | | | | 5f74ed58286a1339412554932f31844ec1b64280 deprecated this many years ago. The utility is questionable at best given that -remove exists and is more natural to use. Free up some code and drop it.
* options: rename --fps to --container-fps-overrideDudemanguy2023-10-251-1/+2
| | | | | | This better reflects what it actually does. As a bonus, script writers won't be misled into thinking that fps displays the actual video or display fps.
* DOCS/mpv: fix typos in List OptionsGuido Cella2023-10-171-5/+3
|
* DOCS/mpv: update mpv.conf's documentationGuido Cella2023-10-061-17/+21
|
* DOCS/mpv: update the wheel bindingsGuido Cella2023-09-271-2/+2
| | | | Update the docs to the new bindings set by 981a9372ff.
* input.conf: make `u` toggle between force and yesllyyr2023-09-251-3/+3
| | | | | | | | There was a discrepancy in what the keybind was advertised to do in the manual, and what the comment in input.conf described it to be doing. It makes very little sense to add a keybind that changes the default and doesn't allow you to get back to the default. This keybind is much more useful if it toggles between yes/force instead of no/force.
* DOCS/man: remove outdated note about gnome and idle-inhibitDudemanguy2023-09-241-3/+0
| | | | They support it now.
* DOCS: update notes about new profilesKacper Michajłow2023-09-201-1/+1
|
* DOCS/mpv: document ZOOMIN & ZOOMOUT multimedia keysJames Cuzella2023-08-231-0/+2
| | | | | | | Document default key mappings for ZoomIn & ZoomOut: ZOOMIN add video-zoom 0.1 ZOOMOUT add video-zoom -0.1
* path-win: move state directory to %LOCALAPPDATA%Kacper Michajłow2023-07-291-0/+2
| | | | %LOCALAPPDATA% is where the local application state belongs.
* path-win: add subdirectory for cacheKacper Michajłow2023-07-291-1/+1
| | | | To not polute %LOCALAPPDATA%/mpv as it may be used for other things too.
* player: set default cache dir on macOSm154k12023-07-151-0/+8
| | | | Use ~/Library/Caches/io.mpv for caches instead of ~~home.
* DOCS/mpv: clarify the location of cache/state filesDudemanguy2023-07-151-7/+31
|
* DOCS/mpv: add an example for applying profiles to certain pathsGuido Cella2023-06-071-0/+8
| | | | | | | It is worth adding this example because it has been asked multiple times in the issue tracker and the IRC channel. string.find() is used because it's 20 times faster than string.match().
* player: use XDG_CACHE_HOME by defaultDudemanguy2023-05-091-0/+2
| | | | | | | | | | | | This adds cache as a possible path for mpv to internally pick (~/.cache/mpv for non-darwin unix-like systems, the usual config directory for everyone else). For gpu shader cache and icc cache, controlling whether or not to write such files is done with the new --gpu-shader-cache and --icc-cache options respectively. Additionally, --cache-on-disk no longer requires explicitly setting the --cache-dir option. The old options, --cache-dir, --gpu-shader-cache-dir, and --icc-cache-dir simply set an override for the directory to save cache files. If unset, then the cache is saved in XDG_CACHE_HOME.
* player: use XDG_STATE_HOME for watch_laterDudemanguy2023-05-091-1/+3
| | | | | | | | | | | | | | | | | | A pain point for some users is the fact that watch_later is stored in the ~/.config directory when it's really not configuration data. Roughly 2 years ago, XDG_STATE_DIR was added to the XDG Base Directory Specification[0] and its description, user-specific state data, actually perfectly matches what watch_later data is for. Let's go ahead and use this directory as the default for watch_later. This change only affects non-darwin unix-like systems (i.e. Linux, BSDs, etc.). The directory doesn't move for anyone else. Internally, quite a few things change with regards to the path selection. If the platform in question does not have a statedir concept, then the path selection will simply return "home" instead (old behavior). Fixes #9147. [0]: https://gitlab.freedesktop.org/xdg/xdg-specs/-/commit/4f2884e16db35f2962d9b64312917c81be5cb54b
* auto_profiles.lua: apply profiles when conditions are truthyGuido Cella2023-04-051-9/+10
| | | | | | | | | | | | Instead of erroring when values returned by profile-cond expressions aren't booleans, apply the relative profiles as long as the return values are truthy. This allows shortening conditions like profile-cond=path:match('foo') ~= nil to profile-cond=path:match('foo')
* sub: add --sub-fonts-dir and --osd-fonts-dir optionsFrédéric Brière2023-03-011-5/+2
| | | | | | | | These options make it possible to specify the directory that will be passed to ass_set_fonts_dir(), akin to VLC's `--ssa-fontsdir` and FFmpeg's `fontsdir`. Fixes #8338
* DOCS: document E to cycle through EditionsLeo Izen2022-10-241-0/+3
| | | | | | Pushing E (aka Shift+e) cycles through Editions for containers that support editions, such as Matroska, although this feature was not documented before this commit.
* DOCS/mpv: remove spaces at EOL, ensure 80 colsAvi Halachmi (:avih)2022-08-291-4/+5
| | | | These are fixes for the previous commit.
* DOCS/mpv: added COMMAND INTERFACE refs to INTERACTIVE CONTROLenly12022-08-291-3/+5
| | | | Added COMMAND INTERFACE references to make it easier for new users.
* man: remove unhelpful languageMia Herkt2022-08-071-28/+8
| | | | | | | | Whether or not the GNOME project has a tendency to make life difficult for anyone outside their ecosystem, the user manual is no place for childish rants such as this. Keep it to what is relevant for users.
* DOCS/{mpv,options}: document the watch later functionalityGuido Cella2022-04-211-1/+29
| | | | | | | | | | This adds a section to the documentation to explain how resuming playback works, and in particular it explains how it affects which playlist entry mpv starts playing from, since this feature was only implied in the --playlist-start documentation. It also groups the documentation of the watch later options together to make them easier to find.
* DOCS/mpv: improve vf=rotate examplesGuido Cella2022-02-071-5/+5
| | | | | | | | | | | We have a few examples with vf=rotate=90, but libavfilter's rotate accepts radians - not degrees, so a value of 90 is valid but misleading because it's not 90 degrees. Change the value of 90 at those examples. Also replace "vf-add=hflip" with "vf add hflip", since that example lists commands, not options, to run.
* DOCS: clarify what the ~~/ path meanssfan52021-11-011-6/+11
| | | | As it turns out the manual was very wrong about this.
* DOCS: fix manual compiling warningsgaroto2021-07-281-1/+1
| | | | | | | | | | This fix the warnings shown below when compiling the manual for any of its three common formats: ``` DOCS/man/mpv.rst:46: (ERROR/3) Unknown target name: "--input-test". DOCS/man/stats.rst:183: (ERROR/3) Unknown target name: "--input-test". ```
* DOCS/mpv.rst: fix quotingAvi Halachmi (:avih)2021-07-281-1/+1
| | | | | | In rst, double-backtick starts a code string only if it's followed by a non-space char, otherwise it's taken literally, hence, `` x2.0`` was taken literally rather than code string.
* DOCS/mpv.rst: add cross references to --input-test and statsAvi Halachmi (:avih)2021-07-191-0/+3
|
* manpage: DEL key: clarify it refers to the oscGuido Cella2021-07-121-1/+1
|
* DOCS: mpv.rst: minor escaping clarificationsAvi Halachmi (:avih)2021-04-231-1/+4
| | | | Fixes #8767
* manpage: rename OS X references to macOSLeo Izen2021-01-031-8/+8
| | | | | | | | Apple has decided that Mac OS X is now named macOS for the time being. For consistency, it makes sense to use the same name for the operating system in all places where it occurs. This commit renames OS X to macOS in the documentation in places where it was otherwise still using the old name.
* manpage: clarify profile-cond requires underscoresGuido Cella2020-12-061-3/+5
| | | | | | | While this says that _ is replaced with -, it doesn't say that you HAVE to use _. This isn't obvious and I didn't understand why my profile conditions with - weren't working at first. Seeing as the person who reproted #8324 ran into this as well, this may be worth clarifying.
* path: do not use old_home for win32 exe dirwm42020-11-161-0/+2
| | | | | | | | | | | | | | | | | | | | | | | | Apparently mpv supports loading config files from the same directory as the mpv.exe. This is a fallback of some sort. It used the old_home mechanism. I want to add a warning if old_home exists, but that would always show the warning on win32. Obviously we don't want that. Add a separate exe_dir entry to deal with that. Untested, but probably works. Mistakenly reverted as part of the default configuration directory location switch-back in aa18a8e1cde663caeabd93af7d57a745c1a76af6. Separation of the mpv executable directory from old_path is a good change now that we warn about the old_config directory also existing. Fixes #8232 Fixes #8244 Fixes #8262
* input.conf: add default keybindings for sub-scalesoredake2020-10-271-0/+3
|
* manpage: Document behaviour of *nix configuration directoriesPhilip Langdale2020-10-161-6/+22
| | | | | | | The original documentation here is unclear, so let's describe the behaviour we actually have. Inspired by wm4's updated docs but obviously not identical because we're not changing any of the behaviours.
* Revert "path: switch back to using non-XDG config dir by default"Philip Langdale2020-10-161-41/+23
| | | | This reverts commit 269f0e743e5634691f0c9d5b1b8a4bb68eedbbd0.
* Revert "path: do not use old_home for win32 exe dir"Philip Langdale2020-10-161-2/+0
| | | | This reverts commit c3694f0acb7f71daac7606fafbadcb7b500ca35e.
* Revert "manpage: reference standard for configuration file location"Philip Langdale2020-10-161-5/+0
| | | | This reverts commit 67b4a96e4592a6bf95a86ebcc8f6c5e951fe327d.
* manpage: reference standard for configuration file locationwm42020-10-091-0/+5
|
* stream_slice: interpret `end` as offset if it starts with '+'Mohammad AlSaleh2020-09-171-0/+7
| | | | | | | | Example: slice://1g-2g@file.ts (1 to 2) slice://1g-+2g@file.ts (1 to 3) Signed-off-by: Mohammad AlSaleh <CE.Mohammad.AlSaleh@gmail.com>
* manpage: fix typoGuido Cella2020-09-061-4/+4
| | | | | Change 'already by defined' to 'already defined' and reformat the paragaph.
* options: do not accept ":" as separator anymore in key/value listswm42020-08-221-0/+7
| | | | | | | | | | | | | | | | | | Accepting ":" in addition to "," seems confusing and dumb. It only causing problems when you want to pass a value that contains ":". Remove support for ":", it is now treated like any other normal character. This affects all options that are listed as "Key/value list" in the option list. It's possible that this breaks for someone who happened to use ":" as separator. But this was undocumented, and never recommended. Originally, the option treated many other characters in a special way, but this was changed in commit a3d561f950e74fe. I'm, not sure why ":" was explicitly included. Maybe because -the absurd -vf/--af syntax uses ":" as list separator. But "," was always recommended and used in examples for key/value options. Fixes: #8021 (if you consider it a bug)
* stream: Implement slice:// for reading slices of streamsMohammad AlSaleh2020-08-191-0/+21
| | | | | | | | | | | | | | | | Add support for reading a byte range from a stream via the `slice://` protocol. Syntax is `slice://start[-end]@URL` where end is a maximum (read until end or eof). Size suffixes support in `m_option` is reused so they can be used with start/end. This can be very useful with e.g. large MPEGTS streams with corruption or time-stamp jumps or other issues in them. Signed-off-by: Mohammad AlSaleh <CE.Mohammad.AlSaleh@gmail.com>
* auto_profiles: unapply conditional profiles if declaredwm42020-08-071-15/+27
| | | | | | Uses the mechanism introduced in the previous commit. The hope was to make auto-profiles easier to use, and to get rid of the need for manually created inverse profiles. Not sure if the end result is useful.
* options: add some way to more or less "unapply" profileswm42020-08-071-0/+66
| | | | | | | | | | | | | | | | | | | | | | | | Make it possible to restore from profiles by backing up the option values before profile application. This is sort of like unapplying a profile. Since there might be multiple ways to do this, a profile needs to explicitly provide the "profile-restore" option, which specifies how exactly this should be done. This is a big mess. There is not natural way to do this. Profile application is "destructive" and simply changes the values of the options. Maybe one could argue that the option system should have hierarchical "overlays" of profiles instead, where unset options will use the value of the lower profiles. Options set interactively by the user would be the top profile. Default values would be in the lowest profile. You could unapply a profile by simply removing it from this overlay stack. But uh, let's not, so here's something stupid. It reuses some code used for file local options to reduce code size. At least the overlay idea would still be possible in theory, and could be added as another profile-restore mode. This is used by the following commit.
* auto_profiles: add this scriptwm42020-08-051-5/+126
| | | | | | | | | | | | | | | | | | | | | This is taken from a somewhat older proof-of-concept script. The basic idea, and most of the implementation, is still the same. The way the profiles are actually defined changed. I still feel bad about this being a Lua script, and running user expressions as Lua code in a vaguely defined environment, but I guess as far as balance of effort/maintenance/results goes, this is fine. It's a bit bloated (the Lua scripting state is at least 150KB or so in total), so in order to enable this by default, I decided it should unload itself by default if no auto-profiles are used. (And currently, it does not actually rescan the profile list if a new config file is loaded some time later, so the script would do nothing anyway if no auto profiles were defined.) This still requires defining inverse profiles for "unapplying" a profile. Also this is still somewhat racy. Both will probably be alleviated to some degree in the future.
* x11: remove terrible xdg-screensaver hackwm42020-07-081-0/+44
| | | | | | | | | | | | | | I'm tired of dealing with this frequent spawning of xdg-screensaver when debugging and what not. xdg-screensaver was never a serious tool anyway, it's more like some self-deprecating joke by FDO folks. This will affect X11 on GNOME and other DEs. I'm singling out GNOME though, because they are the ones actively sabotaging any sane technical solutions and community cooperation. I have been accused of taking it out on innocent GNOME users, while none of this will reach GNOME developers. Of course that is not the intention.
* path: do not use old_home for win32 exe dirwm42020-06-251-0/+2
| | | | | | | | | | | | | Apparently mpv supports loading config files from the same directory as the mpv.exe. This is a fallback of some sort. It used the old_home mechanism. I want to add a warning if old_home exists, but that would always show the warning on win32. Obviously we don't want that. Add a separate exe_dir entry to deal with that. Untested, but probably works.
* path: switch back to using non-XDG config dir by defaultwm42020-06-251-23/+41
| | | | | | | | | | | | | | | | | | | | | XDG is stupid, so change back to the standard behavior. Unfortunately, most users will now have the XDG one, so we will still need to load this. (This is exactly the same problem as when XDG support was introduced, just the other way around). This should not affect any normal users. Hopefully I tested this well enough; my intention is not to torment miserable XDG fans; they can keep using their config dir if they want it. This changes behavior in two c