summaryrefslogtreecommitdiffstats
path: root/DOCS/man/en/options.rst
Commit message (Collapse)AuthorAgeFilesLines
* DOCS: remove en/ sub-directorywm42014-06-201-2789/+0
| | | | | This additional sub-directory doesn't serve any purpose anymore. Get rid of it.
* manpage: remove bogus significant whitespacewm42014-06-181-1/+1
| | | | Made the first line formatted differently.
* options: allow adding multiple files with --audio-filewm42014-06-181-2/+3
| | | | At least 1 person expected that this works this way.
* sub: add --sub-scale-with-window optionwm42014-06-141-0/+8
| | | | Implements the feature requested in #839 and #186.
* options: turn --idx, --forceidx into --indexwm42014-06-131-14/+7
| | | | | | | | | | | | Also clarify the semantics. It seems --idx didn't do anything. Possibly it used to change how the now removed legacy demuxers like demux_avi used to behave. Or maybe it was accidental. --forceidx basically becomes --index=force. It's possible that new index modes will be added in the future, so I'm keeping it extensible, instead of e.g. creating --force-index.
* input: make option struct localwm42014-06-111-11/+11
| | | | | | | | | Similar to previous commits. This also renames --doubleclick-time to --input-doubleclick-time, and --key-fifo-size to --input-key-fifo-size. We could keep the old names, but these options are very obscure, and renaming them seems better for consistency.
* options: remove global variables for swscale options; rename themwm42014-06-111-30/+19
| | | | | | Additionally to removing the global variables, this makes the options more uniform. --ssf-... becomes --sws-..., and --sws becomes --sws- scaler. For --sws-scaler, use choices instead of magic integer values.
* stream_dvb: remove global option variableswm42014-06-111-12/+11
|
* stream_cdda: remove global option variableswm42014-06-111-28/+23
|
* stream_pvr: remove global option variableswm42014-06-111-36/+35
|
* tv: remove global option variableswm42014-06-111-136/+128
| | | | | | Pretty much nothing changes, but using -tv-scan with suboptions doesn't work anymore (instead of "-tv-scan x" it's "-tv scan-x" now). Flat options ("-tv-scan-x") stay compatible.
* audio: add a "weak" gapless mode, and make it defaultwm42014-06-091-16/+27
| | | | | | | | | | | | | | Basically, this allows gapless playback with similar files (including the ordered chapter case), while still being robust in general. The implementation is quite simplistic on purpose, in order to avoid all the weird corner cases that can occur when creating the filter chain. The consequence is that it might do not-gapless playback in more cases when needed, but if that bothers you, you still can use the normal gapless mode. Just using "--gapless-audio" or "--gapless-audio=yes" selects the old mode.
* manpage: document new --sub-file semanticswm42014-06-081-3/+11
| | | | This was forgotten in the previous commit.
* sub: remove old style override optionwm42014-06-051-6/+1
| | | | Didn't work too well.
* sub: add --ass-style-override=force optionwm42014-06-051-3/+10
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | (The old "force" choice of that option is renamed to "force-default".) This allows overriding native ASS script subtitle styles with the style provided by the --sub-text-* options (like --sub-text-font etc.). This is disabled by default, and needs to be explicitly enabled with the --ass-style-override=force option and input property. This uses in fact exactly the same options (--sub-text-*) and semantics as the ones used to configure unstyled text subtitles. It's recommended to combine this with this in the mpv config file: ass-force-style="ScaledBorderAndShadow=1" # work around dumb libass behavior Also, adding a key binding to toggle this behavior should be added, because overriding can easily break: L cycle ass-style-override This would cycle override behavior on Shift+L and allows quickly disabling/enabling style overrides. Note: ASS should be considered a vector format rather than a subtitle format. There is no easy or reliable way to determine whether the style of a given subtitle event can be changed without destroying visuals or not. This patch relies on a simple heuristic, which often works and often breaks.
* player: write file name to the watch later config fileAlessandro Ghedini2014-06-011-0/+9
| | | | | | | | | This simply writes the file name as a comment to the top of the watch later config file. It can be useful to the user for determining whether a watch later config file can be manually removed (e.g. in case the corresponding media file has been deleted) or not.
* video: add --video-rotate option for controlling auto-rotationwm42014-05-241-0/+7
|
* stream: kill start_pos, remove --sb optionwm42014-05-241-4/+0
| | | | | | | | | | | | | | | | | | | | stream.start_pos was needed for optical media only, and (apparently) not for very good reasons. Just get rid of it. For stream_dvd, we don't need to do anything. Byte seeking was already removed from it earlier. For stream_cdda and stream_vcd, emulate the start_pos by offsetting the stream pos as seen by the rest of mpv. The bits in discnav.c and loadfile.c were for dealing with the code seeking back to the start in demux.c. Handle this differently by assuming the demuxer is always initialized with the stream at start position, and instead seek back if initializing the demuxer fails. Remove the --sb option, which worked by modifying stream.start_pos. If someone really wants this option, it could be added back by creating a "slice" stream (actually ffmpeg already has such a thing).
* manpage: update references to renamed optionsAlessandro Ghedini2014-05-231-2/+2
|
* input: allow disabling window dragging with --no-window-draggingwm42014-05-201-0/+3
| | | | Requested in github issue #608.
* cache: redo options and default settingswm42014-05-201-15/+16
| | | | | | | | | | | | Some options change from percentages to number of kilobytes; there are no cache options using percentages anymore. Raise the default values. The cache is now 25000 kilobytes, although if your connection is slow enough, the maximum is probably never reached. (Although all the memory will still be used as seekback-cache.) Remove the separate --audio-file-cache option, and use the cache default settings for it.
* x11: implement --fs-screen properly, separate old code pathwm42014-05-171-4/+2
| | | | | | | Try to get the "new" code path (using NetWM/EWMH) free of hacks done for the sake of old WMs or the no-WM case. Implement --fs-screen using _NET_WM_FULLSCREEN_MONITORS.
* x11: replace--[x11-]fstype option with --x11-netwmwm42014-05-161-38/+12
| | | | | Simplifies the code a lot. You can still use --x11-netwm=no to disable NetWM for whatever reasons.
* manpage: update --playlist entrywm42014-05-111-5/+10
|
* man: tweak --sub-codepage for concisionKevin Mitchell2014-05-091-20/+18
| | | | | | | The many "boxes" in this entry were causing rst2pdf to fail because it couldn't figure out where to break the page. Make the boxes smaller by removing semi-redundant examples. Also try and make surrounding text a little shorter by rewording.
* options: add --hr-seek-framedrop optionwm42014-05-071-0/+9
| | | | | | | | This allows disabling of decoder framedrop during hr-seek. It's basically another useless option, but it will help exploring whether this framedropping really makes seeking faster, or whether disabling it helps with precise seeking (especially frame backstepping).
* options: merge ---sub-auto-match with --sub-autowm42014-05-041-9/+6
| | | | There's no reason why these should be separate.
* manpage: improve --input-cursor descriptionwm42014-05-041-2/+2
|
* options: remove deprecated --identifyMartin Herkt2014-05-041-15/+9
| | | | | | | Also remove MSGL_SMODE and friends. Note: The indent in options.rst was added to work around a bug in ReportLab that causes the PDF manual build to fail.
* options: remove obsolete --fsmode-dontuseMartin Herkt2014-05-041-4/+0
|
* options: rename device-specific optionsMartin Herkt2014-05-041-2/+2
| | | | | --dvdangle → --dvd-angle --tvscan → --tv-scan
* options: rename msg-related optionsMartin Herkt2014-05-041-18/+21
| | | | | | | | | --msgcolor → --msg-color --msglevel → --msg-level --msgmodule → --msg-module --msgtime → --msg-time (also document this one) --playing-msg → --term-playing-msg --status-msg → --term-status-msg
* options: rename video-related options/propertiesMartin Herkt2014-05-041-30/+30
| | | | | | | | | | | Renamed options: --aspect → --video-aspect --fstype → --x11-fstype --native-fs → --fs-missioncontrol --name → --x11-name Renamed properties: aspect → video-aspect
* options: rename audio-related options/propertiesMartin Herkt2014-05-041-48/+49
| | | | | | | | | | | | | Renamed options: --audiofile → --audio-file --audiofile-cache → --audio-file-cache --channels → --audio-channels --format → --audio-format --srate → --audio-samplerate Renamed properties: samplerate → audio-samplerate channels → audio-channels
* options: rename subtitle-related optionsMartin Herkt2014-05-041-47/+46
| | | | | | | | | --ass → --sub-ass --autosub → --sub-auto --autosub-match → --sub-auto-match --sub → --sub-file --subcp → --sub-codepage --subfps → --sub-fps
* options: rename input-related optionsMartin Herkt2014-05-041-50/+50
| | | | | | | | | | | --ar → --input-appleremote --consolecontrols → --input-terminal --media-keys → --input-media-keys --joystick → --input-joystick --lirc → --input-lirc --lircconf → --input-lirc-conf --mouse-movements → --input-cursor --right-alt-gr → --input-right-alt-gr
* manpage: improve --osd-level descriptionwm42014-04-251-4/+4
|
* player: add a --loop-file optionwm42014-04-171-0/+6
| | | | Unlike --loop, loops a file instead of the playlist.
* player: add a --dump-stats optionwm42014-04-171-0/+8
| | | | | | | | | | | | | | | | | | | | | | | This collects statistics and other things. The option dumps raw data into a file. A script to visualize this data is included too. Litter some of the player code with calls that generate these statistics. In general, this will be helpful to debug timing dependent issues, such as A/V sync problems. Normally, one could argue that this is the task of a real profiler, but then we'd have a hard time to include extra information like audio/video PTS differences. We could also just hardcode all statistics collection and processing in the player code, but then we'd end up with something like mplayer's status line, which was cluttered and required a centralized approach (i.e. getting the data to the status line; so it was all in mplayer.c). Some players can visualize such statistics on OSD, but that sounds even more complicated. So the approach added with this commit sounds sensible. The stats-conv.py script is rather primitive at the moment and its output is semi-ugly. It uses matplotlib, so it could probably be extended to do a lot, so it's not a dead-end.
* Remove radio://wm42014-04-131-55/+0
| | | | | It was disabled by default, works only for analogue radio, and I bet nobody uses it.
* manpage: --ad-spdif-dtshd=yes works nowwm42014-04-081-1/+2
| | | | | It was fixed a while ago. There are still some issues, as pointed out in the manpage addition.
* vd_lavc: by default, do not show corrupt frameswm42014-04-081-1/+1
| | | | This flips the default value. Use --vd-lavc-show-all=yes to revert.
* manpage: remove misleading description for --ontopStefano Pigozzi2014-03-291-2/+1
| | | | | Pretty much all the VOs and backends support this, so there is no point in listing only X11 and corevideo support.
* manpage: clarify what to pass to --hwdec-codecs optionwm42014-03-201-1/+3
|
* options.rst: correct broken URLDiogo Franco2014-03-111-1/+1
|
* audio: make --channels option always force the output layoutwm42014-03-101-11/+14
| | | | | | Use the --channels value directly on the AO, instead of doing it only in the --channels=stereo (default) case and if the decoder output is not stereo.
* sd_ass: add a very simple and evil way to override ASS subtitle styleswm42014-03-011-5/+10
| | | | | | --ass-style-override=force now attempts to override the 'Default' style. May or may not work. In some situations it will work, but also mess up seemingly unrelated things like signs typeset with ASS.
* lua: add option to disable auto-loading of lua scriptswm42014-02-281-0/+4
|
* config: add a --config-dir option to force config directorywm42014-02-251-0/+11
| | | | Useful for slave-mode like uses, and not as radical as --no-config.
* manpage: fix yadif example in one casewm42014-02-231-1/+1
|
* options: make --no-config block all auto-loaded configuration fileswm42014-02-141-4/+2
| | | | | | | | | | | | Until now, the --no-config was explicitly checked in multiple places to suppress loading of config files. Add such a check to the config path code itself, and refuse to resolve _any_ configuration file locations if the option is set. osc.lua needs a small fixup, because it didn't handle the situation when no path was returned. There may some of such cases in the C code too, but I didn't find any on a quick look.
* manpage: document --aspect special valueswm42014-02-111-0/+7
| | | | | | | Use of these is "discouraged", but they're there to select these special cases with the "aspect" property. They really should use some sort of choice option type, but since it would be some work to make these work with float values, the simple and dumb alternative was picked.
* options: add --no-terminal switchwm42014-02-101-0/+7
| | | | | Mostly useful for internal reasons. This code will be enabled by default if mpv is started via the client API.
* quvi: disable subtitle fetching by defaultwm42014-01-311-4/+6
| | | | This is slow and unreliable, basically unusable.
* options: alternative way to specify color optionswm42014-01-311-10/+22
| | | | | | | | | | | | | | | | Try to make it more intuitive by not requiring hex values. The new way uses float values in the range 0.0-1.0, separated by '/' (':' was suggested, but that wouldn't allow color options in sub-options). Example: --osd-color=1.0/0.0/0.0/0.75 Using the range 0.0-1.0 has the advantage that it could be easily extended to colors beyond 8 bit. Details see manpage. Suggestions for alternative syntax or value ranges are welcome, but be quick with it.
* lua: add a --lua-opts option, which can be queried by scriptswm42014-01-161-0/+5
| | | | | | | The values set by this new option can be queried by Lua scripts using the mp.getopt() function. The function takes a string parameter, and returns the value of the first key that matches. If no key matches, nil is returned.
* player: add --term-osd-bar, which shows a status bar on the terminalwm42014-01-151-0/+12
| | | | | Feature request from github issue #451. Disabled by default, will probably stay this way.
* manpage: document --term-osd=forcewm42014-01-131-1/+3
| | | | | Apparently this was forgotten when it was first added, or maybe it's an arrifact from the rst conversion.
* player: redo terminal OSD and status line handlingwm42014-01-131-5/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The terminal OSD code includes the handling of the terminal status line, showing player OSD messages on the terminal, and showing subtitles on terminal (the latter two only if there is no video window, or if terminal OSD is forced). This didn't handle some corner cases correctly. For example, showing an OSD message on the terminal always cleared the previous line, even if the line was an important message (or even just the command prompt, if most other messages were silenced). Attempt to handle this correctly by keeping track of how many lines the terminal OSD currently consists of. Since there could be race conditions with other messages being printed, implement this in msg.c. Now msg.c expects that MSGL_STATUS messages rewrite the status line, so the caller is forced to use a single mp_msg() call to set the status line. Instead of littering print_status() all over the place, update the status only once per playloop iteration in update_osd_msg(). In audio- only mode, the status line might now be a little bit off, but it's perhaps ok. Print the status line only if it has changed, or if another message was printed. This might help with extremely slow terminals, although in audio+video mode, it'll still be updated very often (A-V sync display changes on every frame). Instead of hardcoding the terminal sequences, use terminfo/termcap to get the sequences. Remove the --term-osd-esc option, which allowed to override the hardcoded escapes - it's useless now. The fallback for terminals with no escape sequences for moving the cursor and clearing a line is removed. This somewhat breaks status line display on these terminals, including the MS Windows console: instead of querying the terminal size and clearing the line manually by padding the output with spaces, the line is simply not cleared. I don't expect this to be a problem on UNIX, and on MS Windows we could emulate escape sequences. Note that terminal OSD (other than the status line) was broken anyway on these terminals. In osd.c, the function get_term_width() is not used anymore, so remove it. To remind us that the MS Windows console apparently adds a line break when writint the last column, adjust screen_width in terminal- win.c accordingly.
* options: remove --screenw and --screenhwm42014-01-111-8/+0
| | | | | | | | | Doesn't make any sense anymore. X11 (which was mentioned in the manpage) autodetects it, and everything else ignored the option values. Since for incomprehensible reasons the backends and vo.c still need to exchange information about the screensize using the option fields, they're not removed yet.
* options: don't reset pause mode when switching to next filewm42014-01-091-3/+3
| | | | | | This basically reverts the default as set by commit 812798c5. This seems to be a matter of taste, but personally I think keeping the pause setting is better.
* screenshot: add format specifiers to get file directory pathwm42014-01-081-0/+6
| | | | | Useful if you want to put the screenshot into the same directory as the file that is being played.
* manpage: mention how to get a list of codecs for use with --hwdec-codecswm42014-01-071-0/+3
|
* Fix audio delay inversionMartin Herkt2014-01-061-2/+2
|
* quvi: add option to not fetch subtitlesAndre D2014-01-051-0/+7
| | | | Signed-off-by: wm4 <wm4@nowhere>
* manpage: mention --pauseMartin Herkt2014-01-031-0/+3
|
* manpage: clarifications about bitmap subtitles and --s