summaryrefslogtreecommitdiffstats
path: root/DOCS/man
Commit message (Collapse)AuthorAgeFilesLines
* mac: make display-names unique to allow specific selectionder richter19 hours1-5/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | the Screen property localizedName returns a none unique dynamic name that doesn't allow a specific selection of a Screen on every OS boot. the name consists of the vendor name and model name (eg DELL U2723QE). if the same model display is connected to the system several times, macOS starts to add numbers to the localizedName (eg DELL U2723QE (1)), that may not be associated to the same Screen on every OS boot or connecting the display. it also changes the name of the first connected display by adding that numeration. this makes it impossible specify the proper screen with the screen-name option every time. to circumvent this we remove the enumeration from the name and instead add the serial number to the display-names property. this makes the actual Screen unique and none dynamic. furthermore the selection of a screen by name will check for equality for the old localizedName, simple name without enumeration, serial number and the combined name with serial number. this makes it possible to select the screen by either of those names and identifiers, and keeps backwards compatibility with the old behaviour. Examples: localized name (System Settings name): DELL U2723QE, DELL U2723QE (1) simple name: DELL U2723QE serial number: 123456789 combined name: DELL U2723QE (123456789)
* DOCS/man: refer to "mp.options functions" for script config docsnanahi4 days3-18/+5
| | | | | | | | | | | Currently they refer to the OSC documentation. However, the "mp.options functions" already documents that, is more detailed, and does not contain false statements like "there may be no spaces around the ``=`` or anywhere else" (the primitive parser does not care about them, so starting a string option value with spaces is perfectly fine). Change them to refer to "mp.options functions" and remove the redundant section in the OSC documentation.
* ao_wasapi: add `--wasapi-exclusive-buffer` optionsunpenghao7 days1-0/+15
| | | | | | | | | | | This allows users to set buffer duration in exclusive mode. We have been using the default device period as the buffer size and it is robust enough in most cases. However, on some devices there are horrible glitches after a stream reset. Unfortunately, the issue is not consistently reproducible, but using a smaller buffer size (e.g., the minimum device period) seems to resolve the problem. Fixes #13715.
* player: always notify when writing window-scale optionDudemanguy7 days2-29/+7
| | | | | | As described in the previous commit, update_window_scale will always execute whenever window-scale is written even if the value doesn't change.
* stats.lua: add option to disable scale with video sizenanahi7 days1-0/+6
| | | | | This adds a new configuration option vidscale, which controls whether stats display is scaled with video, similar to the option for OSC.lua.
* stats.lua: add option to control plot border widthnanahi7 days1-0/+5
| | | | | This adds a new configuration option plot_bg_border_width, which controls the border width of plots.
* m_option: change confusing error messages for obj_settings_listnanahi7 days1-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/options: mention the new priority list usage of --gpu-contextnanahi7 days1-5/+7
| | | | The settings list conversion means a custom priority list can now be used.
* command: use property_time() for sub-start and sub-endrcombs7 days1-0/+10
| | | | This gives these properties the "time" type, which allows them to be pretty-printed as HH:MM:SS easily (but also still allows raw formatting using e.g. ${=sub-start}).
* player/command: add track-list/N/decoderKacper Michajłow8 days1-0/+3
|
* stats.lua: filter input bindings by typing themGuido Cella8 days1-0/+5
| | | | | | | | | This lets you press / in page 4 of the stats and type a keybinding or part of its command to filter it by using mp.input. This works badly without a VO because both stats.lua and console.lua use show-text and only one can be displayed at a time, but it's still better than not having the search available at all.
* sd_ass: add `sub-vsfilter-bidi-compat` to enable vsfilter bidi compatllyyr8 days1-0/+9
| | | | | | | | | | | | | | | | Enable ASS_FEATURE_{WHOLE_TEXT_LAYOUT, BIDI_BRACKETS} and auto base detection by default, and add an option to disable this if needed. This is strictly an improvement for webvtt files as they always use auto base detection. This _fixes_ right-to-left text rendering for webvtt files which correctly mark rtl/ltr. Webvtt files obtained from sources which sideload the RTL information through css also see an improvement due to the auto detection. Generally SRT files also want this, but some are also written to workaround VSFilter quirks. See also: https://github.com/mpv-player/mpv/pull/12985#issuecomment-1839565138
* DOCS: document --show-in-taskbar optionnanahi8 days1-0/+6
|
* stats.lua: inherit OSD stylesGuido Cella8 days1-6/+23
| | | | | | | | | | | | | | | Avoid having to configure both the OSD and the stats script opts when you change the OSD options, in particular avoid having to convert colors to BGR. Also document the shadow options. font_size, border_size and shadow offset defaults are kept because the same values look much bigger in the stats than in the corresponding OSD options. osd-back-color is now respected without extra checks until you explicitly set a shadow_color.
* DOCS/input: minor typo correctionsunpenghao8 days1-1/+1
|
* osc: add playlist_media_title optionsunpenghao8 days1-0/+7
| | | | | | Showing media titles in the playlist is pointless when sources are ill tagged and media titles contain only garbage. Being able to opt for file names at least gives us a choice in such cases.
* player/command: remove codec-info and use track-list directlyKacper Michajłow9 days1-40/+0
| | | | | | | | Turns out that adding more medatata like HDR10+ and Dolby Vision would produce a lot of duplication and it is better to centralize it around the track-list property. Fixes: e720159f72be2a816db849acb286f36a1ac4622b
* player/command: add video-codec-info and audio-codec-infoKacper Michajłow10 days1-8/+45
| | | | | | | | | | | Adds support for extracting codec profile. Old properties are redirected to new one and removed from docs. Likely will stay like that forever as there is no reason to remove them. As a effect of unification of properties between audio and video, video-codec will now print codec (format) descriptive name, not decoder long name as it were before. In practice this change fixes what docs says. If you really need decoder name, use the `track-list/N/decoder-desc`.
* DOCS/man/mpv: correct description of F8/F9 keybindsnanahi2024-04-101-4/+2
| | | | | Previous commit fixes showing the list in the terminal, so the mentions of it can be removed.
* mac/vulkan: add support for frame timing via presentation feedbackder richter2024-04-101-0/+1
|
* vo_tct: add --vo-tct-buffering optionKacper Michajłow2024-04-071-0/+19
|
* DOCS/man/vo: document vo_caca's hardcoded keybindsnanahi2024-04-071-0/+15
| | | | | | This was in mplayer's documentation, don't know why this got lost. "Fixes": 504e2336b7631fac55413d660adad5c734dac10a
* DOCS/man/options: mention the impact of --hwdec-codecs on startup timenanahi2024-04-071-1/+8
| | | | | | | | Probing for hwdec can be very slow: on my setup (Nvidia GPU without VP9 hwdec capability), this causes 2x hot cache startup time compared to explicitly disabling VP9 in this list (500 ms -> 1 000 ms). Also remove --vo=vdpau reference.
* DOCS/man: unify flag option descriptionsnanahi2024-04-075-96/+91
| | | | | | | | | | | 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 Tao2024-04-062-0/+60
|
* DOCS/options: document key autorepeat defaultsnanahi2024-03-291-6/+7
|
* ao_avfoundation: initial avfoundation ao supportMisaki Kasumi2024-03-291-1/+11
|
* DOCS: update for new --pulse-latency-hacks defaultssfan52024-03-251-5/+2
| | | | | I missed this. fixes: 8e3737ab633ba096fcf9f2da2391f84690bd1b4c
* options: add --input-commands optionDudemanguy2024-03-211-0/+15
| | | | | | | Basically a simple way to perform any command/property action from the command line. This takes the exact same syntax as input.conf but not including the key naturally. Potentially useful for weird properties that don't map well to options (like ao-volume). Fixes #12353.
* m_property: add `>` for fixed precision floating-point expansionKacper Michajłow2024-03-211-1/+7
| | | | | | | | | | | | | | This enhancement makes it easier to create constant width property expansions, useful for the `--term-status-msg`. Additionally, it changes to `%f` printing with manual zero trimming, which is easier to control than `%g`. With this method, we can directly specify precision, not just significant numbers. This approach also avoids overly high precision for values less than 1, which is not necessary for a generic floating-point print function. A new print helper function is added, which can be used with adjusted precision for specific cases where a different default is needed. This also unifies the code slightly.
* osc.lua: escape textGuido Cella2024-03-211-1/+1
| | | | | | | | | | | | | | | | | | | | Escape all messages in osc.lua, because other than the title they weren't being escaped at all. If for example you did mpv foo.mp4 '{\fs50}bar.mp4' and script-message osc-playlist, it would just render the second entry as bar.mp4 in big text. The title was escaped partially, now the escaping is complete because: - It escapes \. Backslashes at the end of the title are escaped instead of being stripped, and \n, \N and \h are now printed verbatim. In particular, "\\n" is no longer converted to space and is printed verbatim instead which is more correct. - Newlines ("\n", not the "\\n" escape sequence) are converted to spaces instead of rendering them and messing up the text positioning within the OSC. - Spaces at the start are preserved. Fixes #11209, fixes #11275.
* command: add escape-assGuido Cella2024-03-211-0/+12
| | | | | | | | | | | | | | | | | This adds a command to escape ASS tags to remove code duplication between sub/osd_libass.c, console.lua, osc.lua, stats.lua and any user script that calls mp.create_osd_overlay(). A command is used instead of scripting functions so that all clients can use this and not just use Lua and JS ones. osd_mangle_ass() also interprets osd-sym-cc and osd-ass-cc/{0,1}, but since they use invalid UTF-8 characters there is no risk of escape-ass users using them by accident, like with any OSD message. Always replacing \n with \\N in mangle_ass() even when it is not called by escape-ass doesn't seem to cause any issue, but I made it conditional anyway to avoid changing how all OSD messages are treated unnecessarily.
* player/command: add term-size/[w,h] propertyChristoph Heinrich2024-03-211-0/+13
| | | | | | There was no way for scripts to know the current size of the terminal, which is essintial if they want to provide a good user experience even without a window.
* stats.lua: truncate long lines for the terminalChristoph Heinrich2024-03-211-0/+12
| | | | | | | | | | | | | | | The terminal is assumed to be 80x24 in size, the new options `term_width_limit` and `term_height_limit` can be used to overwrite that. Lines longer then the terminal width cause problems with scrolling pages and need to be shortened. The algorithm used for shortening can deal with tabs and escape sequences, has rudimentary support for UTF-8 and runs in O(n). avih helped in the creation of the term_ellipsis() function and split() is also from him.
* DOCS: document the new way to handle interface changesDudemanguy2024-03-201-2/+1
| | | | | | | Manually editing interface-changes.rst is a giant maintenance pain that causes merge conflicts all the time. Stop doing that nonsense and instead have changes be written to files in DOCS/interface-changes. Also remove that one sentence in changes.rst because it's just not true.
* DOCS/options: improve wording of dither-depthllyyr2024-03-191-6/+6
|
* input.conf: add `b` to toggle debandingKacper Michajłow2024-03-191-0/+3
|
* vo_gpu_next: make `dither-depth=auto` mean 8 bpc for non-d3d11 SDRllyyr2024-03-191-2/+4
| | | | | | | Fixes the issue described in https://github.com/mpv-player/mpv/issues/11862 for SDR files for non-d3d11 gpu-api. We currently don't have a smarter way to get the real on-the-wire bpc for other APIs, so this is the best that can be done.
* DOCS/options: --x11-name sets the instance name, not the class'sGuido Cella2024-03-171-1/+1
|
* demux: add a format-name propertyDudemanguy2024-03-171-0/+5
| | | | | It can be useful to know the underlying format of any entry in the track list. Only applicable to the lavf demuxer.
* DOCS/options: clarify --autofit-larger effectnanahi2024-03-171-2/+2
| | | | | | Clarify that --autofit-larger sets the maximum size of the window. The original wording was not written with runtime change in mind, so the implication of "not changing size" is ambiguous.
* vo_drm: add support for YUYV formatsfan52024-03-161-6/+9
| | | | | | | | | | As the first aligned format this required a fix to reconfig(). Adding the other component-swapped formats in this group would be trivial but I checked the DRM database [1] and no driver exists that supports one of those but not YUYV and this is quite fringe as-is, so I opted not to. [1] <https://drmdb.emersion.fr/formats>
* options: remove --focus-on-open and add --focus-onder richter2024-03-101-3/+6
| | | | | | | | | replaces the old focus-on-open option with a more generic focus-on options that can be extended. adjust the only platform that uses that option. Fixes #8337
* vf_format: add hdr10plus sub-parameter to format video filterKacper Michajłow2024-03-091-0/+4
|
* csputils: add missing PL_COLOR_SYSTEM namesKacper Michajłow2024-03-091-4/+7
|
* vo: add video-target-params propertyKacper Michajłow2024-03-071-0/+5
|
* DOCS/man/input.rst: fix incorrect syntaxsavoury12024-03-061-10/+10
| | | | | | Some incorrect syntax is used in DOCS/man/input.rst with https://github.com/mpv-player/mpv/commit/c678033c1d60b48ae02fbbe4815869b9504a17f6 causing failure of PDF manual generation with rst2pdf. There are single rather than double back-ticks for insert-at and insert-at-play so this is fixed and a couple of typos are also corrected with this commit.
* options: add --deinterlace-field-parity option1nsane0002024-03-041-0/+11
| | | | | | | | Previously there was no way to specify the field order of interlaced videos when deinterlacing with inbuilt filters. Lavfi deinterlacers seemed to prefer top field order while inbuilt ones (vdpaupp, vavpp, d3d11vpp) seemed to prefer bottom field order. The default "auto" option should work exactly as before while specifying either "tff" or "bff" should force the specified field order
* DOCS/options: fix Vulkan typopsykose2024-03-021-1/+1
|
* command: add begin-vo-dragging commandnanahi2024-03-011-0/+7
| | | | | | This command initializes a vo dragging request for VOs that implement the new VOCTRL_BEGIN_DRAGGING voctrl. This allows scripts to begin vo dragging for any button press event.
* Revert "player: add ao-volume option, to set the system volume at startup"Dudemanguy2024-03-012-12/+6
| | | | | | | | Ended up being a bad idea. As a property, this inherently has more functionality and the tradeoff of being able to do --ao-volume wasn't worth it. This reverts commit 58ed620c064971535e60778612777750aa5e2f4d.
* DOCS/options: clarify --sub-blur and --osd-blur optionsnanahi2024-02-271-2/+4
| | | | | Clarify that these options only apply to the font borders, not to the texts themselves.
* vo_gpu_next: add --border-background optionDudemanguy2024-02-261-0/+4
| | | | | Allow for setting the border background independently from the background option.
* vo_gpu/vo_gpu_next: rework --alpha into --background optionDudemanguy2024-02-261-22/+18
| | | | | | | | | | | | | | | | | | | | | | | | | | The --alpha option currently covers two related but different concepts: whether or not to ignore the alpha component and possibly blending it with a background. Because of the way the option currently works, it is impossible to have a transparent window (which requires setting --alpha=yes) while blending it with the background at the same time. To solve this, let's rework it so it it superseded by the background option. --background controls what kind of background to set for the image if possible. It can be blended with the set background color, with tiles, or not blended at all (the last one is still broken on X11/mesa except for GLX, *sigh*). In this new paradigm, --alpha=no has no real purpose because you can simply set the background to color and whatever color you want for exactly the same effect. So the option is removed. Instead, the hint set by windowing backends (i.e. setting ra_ctx->opts.want_alpha) can by done with the --background option. As an aside, the colors in vo_gpu are currently bugged due to not pre-multiplying the alpha and it seems no one ever noticed. The next commit fixes that. vo_gpu_next support happens latter since it requires new things from libplacebo. Fixes #9615.
* player: rename --background to --background-colorDudemanguy2024-02-261-1/+1
| | | | | This better represents what it actually does. --background will be used for another, related option in the next commit.
* osd_libass: update the OSD bar's dent and border sizeGuido Cella2024-02-261-1/+1
| | | | | Make the OSD bar markers bigger so we can default to a smaller, better-looking border size, without sacrificing markers' visibility.
* DOCS/options: make --scale documentation more consistentdokur0chan2024-02-261-8/+9
| | | | | | | | | | | | Beef up the barebones description for the Mitchell filter and make it consistent with the other --scale examples. In addition to this, make some wording changes to make the language in the documentation a bit more unified. Before this change it was pretty obvious that multiple authors contributed to this part of the manual (at completely different timeframes), so the language was somewhat disjointed. The Mitchell description was also not very helpful.
* DOCS: move ALSA option documentation to ao.rstnanahi2024-02-262-51/+47
| | | | | | All other ao options are documented there so make ALSA the same. Also remove the (Linux only) wording since some systems (e.g. FreeBSD) provide compatibility layer for it.
* DOCS/options: clarify the impact of --audio-buffernanahi2024-02-261-1/+1
| | | | | | | | While making this larger do make audio filters react slower, it doesn't always make softvol react slower. This is because the softvol reaction speed is related to the ao buffer size which on many systems have an upper limit, typically much lower than 200 ms. In this case the softvol won't react slower. Change the wording to clarify this.
* DOCS/options: remove lavrresample referencenanahi2024-02-261-7/+2
| | | | | lavrresample is removed in c8b8fe9981c654c0539ca77056ed6451a3da7367. The replacement is the internal swresample filter.
* DOCS/options: remove --alsa-devicenanahi2024-02-261-3/+0
| | | | This option was removed in 809d160c1ec1c050d1877e66f93fcffc98fe4e83.
* DOCS/ao: update SDL ao version referencenanahi2024-02-261-2/+2
| | | | This hasn't been true since 1dcf511376545de7624863b76d7f30dc3bb44ac9.
* input/player: add loadfile/loadlist insert-at commandDavid Vaughan2024-02-261-5/+31
|
* input: add insert-next support for drag-and-dropDavid Vaughan2024-02-261-7/+8
| | | | | | | This commit adds a DND_INSERT_NEXT action option for drag-and-drop, allows for selecting it through the --drag-and-drop=insert-next option, and adds the necessary plumbing to make that happen when something is dragged onto the player.
* player: add loadlist insert-next commandsDavid Vaughan2024-02-261-0/+7
| |