summaryrefslogtreecommitdiffstats
path: root/DOCS/man/options.rst
Commit message (Collapse)AuthorAgeFilesLines
* DOCS/man: more words about --teletext-pageMohammad AlSaleh2024-02-131-2/+11
| | | | Signed-off-by: Mohammad AlSaleh <CE.Mohammad.AlSaleh@gmail.com>
* sub: allow setting lavc txt_page special values via teletext_pageMohammad AlSaleh2024-02-131-2/+5
| | | | | | | | * Range of accepted values for teletext_page now include 0 and -1. * 0 means "subtitle" and -1 means "*". * Make 0 the default. Signed-off-by: Mohammad AlSaleh <CE.Mohammad.AlSaleh@gmail.com>
* player: add an auto option to deinterlaceDudemanguy2024-02-071-10/+9
| | | | | | | | | | 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.
* player: remove all rpi-specific codeDudemanguy2024-02-051-5/+0
| | | | | | | | | | | | | | | | | | | | | | vo_rpi and its related code has pretty much historically been a disaster in mpv. The build regularly gets broken and since nobody uses it, it takes months for anyone to notice. There was also that time where fullscreen was broken for about a year and a half. Also building in waf was entirely broken for about a couple of years or so due to mysterious reasons no one ever figured out (meson magically fixed it). Anyways, once again the build is broken due to rpi being forgotten about again, but instead of pretending to support this crap. Just drop it all. Nowadays, mmal hwdec is a relic since these devices are better off using the v4l2m2m ffmpeg fork instead which actually uses KMS properly. RPI 1 and 2 probably can't do this and will remain broken but oh well blame Broadcom for being special snowflakes and not using standard APIs (my rockpro worked out of the box; just saying). RPI 2 is nearly 10 years old anyways, so I think you can afford a new SBC by now. If we were nicer, there would be a deprecation period, but this is broken in the last major release anyway so too late. Closes #13402.
* x11_common: support --title-barnanahi2024-02-021-1/+1
| | | | | | | | | Some X11 window managers support controlling the title bar independently from other window decorations with _MOTIF_WM_HINTS. This allows hiding the title bar while keeping other decorations like the resizing borders. Let mpv respect the --title-bar option on X11 so --no-title-bar can hide the title bar only like on win32.
* vo_gpu_next: save cache to separate filesKacper Michajłow2024-01-311-6/+12
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Save the cache to separate files to avoid loading/saving a huge combined libplacebo.cache. This approach allows the saving of only new cache objects and avoids resaving the entire cache, especially even if only a tiny change was made. This commit improves the cold start time of mpv and avoids saving data when it's not necessary. Number of changes were made: - each cached object is saved in its own file - cache files are prefixed with the name of cached object - cache directory is cleaned on each uninit - the least recently used cache files are removed if cumulative cache size is above limit - files used in the recent 24 hours are not removed to allow changes to mpv.conf without worrying about the cache being removed during experimentation - shader cache size limit is set to 128 MiB - icc cache size limit is set to 1.5 GiB - cache objects are loaded/saved as needed This commit eliminates the runtime performance penalty associated with the size cache. While we continue to maintain the cache limit to prevent retaining stale objects, mpv now only loads a small subset of files that are currently required for playback, instead of loading all files.
* f_auto_filters: change fallback deinterlace to bwdifDudemanguy2024-01-211-1/+1
| | | | | | | I don't actually deinterlace ever but allegedly this is better than yadif, and there's no real reason to not have this be the fallback deinterlace when we're not using hw frames. Also change various mentions of yadif to bwdif. Ref #12835.
* sub: add `--sub-lavc-o` optionMohammad AlSaleh2024-01-211-0/+7
| | | | | | | We have `--vd-lavc-o` and `--ad-lavc-o`, but no equivalent option for subtitles. Signed-off-by: Mohammad AlSaleh <CE.Mohammad.AlSaleh@gmail.com>
* player: remove --term-remaining-playtime optionDudemanguy2024-01-201-4/+0
| | | | | This wasn't useful and didn't even really do what it said anyway. Closes #12167.
* DOCS/*: remove mentions of Libavllyyr2024-01-201-6/+6
|
* DOCS: reorder --volume-max documentation to where --volume isnanahi2024-01-201-4/+4
|
* DOCS: add documentation for --volume-gain optionsnanahi2024-01-201-0/+7
|
* player: add forced choice to subs-with-matching-audioDudemanguy2024-01-131-5/+7
| | | | | | | | | | fe875083b3d30b06ef77745f40570e8f63afec2 confused things a bit and made --no-subs-with-matching-audio actually mean what it says: no subtitles if the languages match. However, the option actually meant no non-forced subtitles not no subtitles at all. This isn't really intuitive so instead of changing the behavior back to the old way (we already have a release since then), add a third option "forced" which is equivalent to the old meaning of --no-subs-with-matching audio. Fixes #13151.
* vo_gpu_next: respect d3d11 swapchain output format preferencenanahi2024-01-061-0/+5
| | | | | | | | | | Currently, libplacebo always tries to reconfigure the d3d11 swapchain to a 10-bit output format because disable_10bit_sdr isn't set to true, even when an 8-bit format is explicitly requested via --d3d11-output-format. Fix this by passing the requested output format preference to libplacebo. Document that this option may be ignored.
* DOCS/options: note that --geometry doesn't fully work on waylandDudemanguy2024-01-041-0/+5
| | | | | Positioning windows won't work on wayland so note it here to hopefully avoid confusing users.
* DOCS/man: remove "Linux desktop issues" sectionnanahi2023-12-291-3/+5
| | | | | | | | | | | | | | | | | | | 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/man: use the correct directive type for "Warning" admonitionsnanahi2023-12-281-8/+8
| | | | | | | Some places in the manpage uses `.. admonition:: Warning` instead of the specific directive type `.. warning::` for warning admonitions. This causes the "Warning" text appearing in black color instead of red. Correct them here.
* win32: add support for --input-cursor-passthrough optionnanahi2023-12-281-1/+0
| | | | This completes the support for all supported desktop platforms.
* DOCS/options: fix documentation for --force-window window sizenanahi2023-12-281-1/+1
| | | | | | The value has been wrong since ca2b05c0fbc9a51472b1a5a94d016e977c6c87c3, and recent commit 8b4a995a9d7ee7b65a5d2c893d72844d551d9697 still didn't fix it.
* mac: add support for --input-cursor-passthrough optionder richter2023-12-251-1/+1
|
* DOCS/options: fix --image-display-duration's documentationGuido Cella2023-12-251-6/+6
| | | | | | - --image-display-duration does not hide the OSC. - Saying "Setting --image-display-duration" makes no sense because it is not a boolean and it cannot be unset.
* mac: add support for --auto-window-resize optionder richter2023-12-231-1/+0
| | | | Fixes #9325
* options: add --secondary-sub-ass-overridedyphire2023-12-181-0/+6
| | | | Default: strip. preserve the old behavior
* DOCS/options: fix documentation for replaygain-clipDudemanguy2023-12-161-2/+2
| | | | | | | f1c4d20e6577f32018e20efc4ab9da7d4e1ab4ac added this option, but the documentation is actually backwards. --replaygain-clip allows clipping. Having it disabled, the default, prevents it. Keep the behavior the same, but change the documentation to reflect reality. Closes #13111.
* mac: add support for drag-and-drop optionder richter2023-12-151-1/+0
|
* options: add --secondary-sub-poskarelrooted2023-12-131-2/+6
| | | | The default value is 0 (on the top of the screen)
* filter_sdh: add full width parentheses to the enclosures stringDudemanguy2023-12-081-3/+4
| | | | | Since these are technically parentheses, we'll treat them the same way as normal parenthesis. Fixes #11155.
* filter_sdh: add --sub-filter-sdh-enclosures optionDudemanguy2023-12-081-2/+14
| | | | | | | | | | | This filter is a bit complicated, but one of the essential parts of it is removing text enclosed by particular set of characters (e.g. text inbetween []). This was previously hardcoded to only take into account parenthesis and brackets, but people may want to filter more things so make this customizable. The option only takes "left hand characters" so the right pair is mapped internally if applicable. If not, then we just use the same character. Fixes #8268 since the unicode character in question can just be passed to this option.
* image_writer: default to lossless AVIF screenshotsKacper Michajłow2023-12-041-3/+3
| | | | | Also change the example to crf=23. crf=32 is pretty bad quality, don't give users bad usage ideas.
* image_writer: use common format selection for AVIF screenshotsKacper Michajłow2023-12-041-3/+2
| | | | --screenshot-avif-pixfmt no longer defaults to yuv420p.
* DOCS/options: clarify --spirv-compilersfan52023-11-271-3/+3
|
* options: add --osd-bar-border-sizeGuido Cella2023-11-271-0/+6
| | | | | Closes #1484. The default size is smaller than the previous --osd-border-size default value of 3 with the default --osd-bar-h.
* options: add secondary-sub-delayRipose2023-11-261-1/+4
| | | | | | | | | | | | | Add --secondary-sub-delay option and decouple --sub-delay from secondary subtitles. This produces desirable behavior in most cases as secondary and primary subtitles tracks tend to be timed independently of one another. This feature is implemented by turning the sub_delay field in mp_subtitle_opts into an array of 2 floats. From here the track index is either passed around or derived when sub_delay is needed. There are some cases in dec_sub.c where it is possible for dec_sub.order (equivalent to track index) to be -1. In these cases, sub_delay is inferred as 0.
* DOCS/options: remove the mention of cocoa and its removed backendder richter2023-11-251-8/+6
| | | | | | | | the cocoa backend was removed and all functionality is either available on all macOS backends or explicitly only with cocoa-cb. the manual should properly reflect that change. also remove the last mention of the old cocoa backend.
* vaapi: add support for vaapi-win32Kacper Michajłow2023-11-221-2/+5
| | | | | | | | | | | Only vaapi-copy variant as nothing can map D3D12 resources currently. And even if we would add resource sharing to D3D11 it would invoke copy at some point, so there is no point really. Maybe in the future when libplacebo get smarter about resource sharing on Windows, but practical advantages are really small. I've tested it with Vulkan <-> D3D11 sharing and GPU <-> GPU copy is still invoked. Better than CPU memcpy, something for the future.
* DOCS/options: admonish users for touching --3dlut-sizeNiklas Haas2023-11-201-2/+5
| | | | | | | | | | | | The "auto" logic is vastly better than setting a specific size. This option amounts to "allow users to shoot themselves in the foot" flag, given that the vast majority of ICC profiles in the wild are fine on 17x17x17 or even smaller 3DLUTs. Setting stupidly high --3dlut-size is the main source of ICC-related slow startup issues, and there is absolutely no conceivably benefit to going above the defaults except for pixel peeping and chasing tiny PSNR increments.
* DOCS/options: reword cache optionsNiklas Haas2023-11-201-11/+11
| | | | | | D3D11 is actually the main platform that suffers from slow shader compilation, typical Vulkan/GL drivers are either very fast to begin with, or already internally cache.
* DOCS: properly document --force-window-position for sdl vonanahi2023-11-181-1/+1
| | | | The behavior is also the case for SDL vo, so document it.
* DOCS/options: update watch-later-options docsKacper Michajłow2023-11-121-4/+8
|
* DOCS/options: osd-shadow is ignored with osd-back-colorGuido Cella2023-11-121-6/+5
| | | | The back color overrides the shadow, not the border.
* DOCS/option: discourage the use of video-latency-hacks a bit moreDudemanguy2023-11-081-1/+2
| | | | | Who knows why this exists but maybe it's possibly useful in some obscure case. Probably worth mentioning that it could break other options.
* vo_gpu_next: add --target-gamut optionNiklas Haas2023-11-081-0/+7
| | | | Fixes: https://github.com/mpv-player/mpv/issues/12777
* sub: add --sub-stretch-durations optionMohammad AlSaleh2023-11-071-0/+8
| | | | | | | | | Stretch a subtitle duration so it ends when the next one starts. Should help with subtitles which erroneously have zero durations. I found such a subrip substitles stream in the wild. Signed-off-by: Mohammad AlSaleh <CE.Mohammad.AlSaleh@gmail.com>
* wayland: improve wl_output guessing before mpv window is mappedDudemanguy2023-11-061-0/+7
| | | | | | | | | | | | | | | | | | | | There's some geometry-related things that mpv has to calculate before the window is actually mapped onto the screen in wayland. But there's no way to know which output the window will end up on before it happens, so it's possible to calculate it using the wrong values. mpv corrects itself later when the surface event happens, but making the initial guess work better can help in certain cases. find_output is the only thing that needs to be changed here. Its main purpose is to grab the right output based on user settings when we're trying to full screen and giving a fallback in case we don't have wl->current_output yet. The x11 code already does something similar, so we're basically just copying it. Allow user settings like --screen and --screen-name to influence the initial wl_output guess. Those options won't actually place the window on that specific screen since we can't do that in wayland, but if the user knows where the window will end up beforehand it makes sense to listen to the arguments they pass. If something goes wrong, then we just fallback to 0 like before.
* demux: make hysteresis-secs respect cache-secsNRK2023-10-301-6/+4
| | | | | | | | | | | | currently hysteresis-secs only works when the demuxer-max-bytes fills up. but it's possible for the cache-secs/demuxer-readahead-secs to be reached first. in those cases, hysteresis-secs doesn't work and keeps buffering non-stop. but the goal of this option was to save power by avoiding non-stop buffering so go ahead and make it respect cache-secs as well. additionally remove some redundant repetition from the docs.
* m_option: drop support for -del for list optionsDudemanguy2023-10-301-6/+6
| | | | | | 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: make --screenshot-directory/--watch-later-directory aliasesDudemanguy2023-10-301-0/+4
| | | | By popular demand I guess.
* ytdl_hook: add thumbnail optionChristoph Heinrich2023-10-301-0/+7
| | | | | Opening speed could be improved with the "async" prefix, but then the tracks would be out of order.
* various: remove trailing whitespaceGuido Cella2023-10-301-1/+1
|
* DOCS/options: clarify `no-config` is a command line flagllyyr2023-10-271-0/+1
| | | | This option does nothing when put inside config files.
* javascript: use --js-memory-report option instead of MPV_LEAK_REPORTDudemanguy2023-10-261-0/+6
| | | | | | | | The MPV_LEAK_REPORT environment variable was previously read in order to determine whether or not to enable memory reporting for javascript scripts. This is kind of weird and deviates from the norm of exposing an option to the user. So let's just add --js-memory-report and disable it by default instead.
* options: rename --play-dir to --play-directionDudemanguy2023-10-251-2/+2
| | | | | | --play-dir sounds like it has something to do with directories so change it. The play_dir variable is used a bunch everywhere internally so whatever just leave it alone instead of renaming that.
* options: rename --watch-later-directory to --watch-later-dirDudemanguy2023-10-251-1/+1
| | | | Same logic as the previous commit.
* options: rename --screenshot-directory to --screenshot-dirDudemanguy2023-10-251-1/+1
| | | | | Less characters is better? Other options use -dir for directory so consistency I guess.
* options: rename --sub-ass-force-style to --sub-ass-style-overridesDudemanguy2023-10-251-3/+3
| | | | | | | This option has exactly the same semantics are other mpv options that override a particular thing with something from the user. So instead of the "force-style" name, use "-overrides" which is more consistent. The plural form is used since it's a list option.
* options: rename --override-display-fps to --display-fps-overrideDudemanguy2023-10-251-2/+2
| | | | | | Other similar options are in the form of --foo-override not --override-foo. The display-fps one was backwards so flip it around the other way for consistency reasons.
* options: rename --fps to --container-fps-overrideDudemanguy2023-10-251-6/+6
| | | | | | 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.
* options: disable --allow-delayed-peak-detect by defaultKacper Michajłow2023-10-251-1/+1
| | | | | | Peak detection greatly increases HDR experience. Performance hit of non-delayed detection is not that significant and is in line with current default settings.
* stream_cdda: deprecate --cdda-toc-bias and always check for offsetsDudemanguy2023-10-191-5/+0
| | | | | | | | | | | | | | | | I started going through the blame but once I got to mplayer commits from 20 years ago, I stopped bothering. This obscure option has always been disabled by default, but there's zero reason, as far as I know, to not just enable it today. Some CDs (particularly very old ones) have the first sector shifted a bit and not starting exactly at 0. This makes the logic that tries to get all the chapters completely fail and thus you can't skip through tracks. However if you just enable this obscure option, it just works. For anything that starts exactly at 0, the calculated offset is just 0 anyway so it's a no-op and works exactly the same. So basically, there's literally no reason to not just always try to correct for the offset of the first sector by default. Fixes #8777.
* DOCS/options: remove obsolete noticeGuido Cella2023-10-171-4/+0
| | | | | This may have been true 10 years ago but now reset-on-next-file can definitely reset options that weren't explicitly set.
* vo_gpu/vo_gpu_next: add vulkan support for macOSder richter2023-10-141-0/+14
| | | | | | | | add support for vulkan through metal and a translation layer like MoltenVK. also add the possibility to use different render timing modes for testing. i still consider this experimental atm.
* DOCS/options: vdpau requires GLXGuido Cella2023-10-111-1/+2
| | | | | | | Only vpdau-copy works with EGL. 2d1d815cc7 already added this to manpage, and 1c8d2246bf removed it again, but that seems to be a mistake because I can only get vdpau to work with GLX, and another user also reported that only vdpau-copy was working for him with the default EGL.
* demux: change the default of metadata-codepage to autoDudemanguy2023-10-071-4/+3
| | | | | |