mpv

Медиаплеер на базе MPlayer с аппаратным ускорением и гибкими фильтрами.

Готовые примеры · man page

Флаги

Установить точку A цикла: при прохождении B плеер ищет к A; unset — цикл выключен.

Установить точку B цикла: при её прохождении плеер ищет к точке A.

Сколько раз выполнить A-B цикл, затем игнорировать точки (inf — навсегда, 0 — выключено).

Следовать любым ссылкам внутри открываемого файла (default: yes); отключайте для сканеров миниатюр.

Задать приоритетный список аудиодекодеров по их именам: первый подходящий по формату, далее следующие, '-' в конце подавляет остальных.

Выбрать уровень динамического сжатия AC-3 от 0 (нет) до 1 (полное); значения до 6 экспериментальные.

Запрашивать у декодера даунмикс каналов (default: no); число выходов задаёт --audio-channels, полезно для стереосистем.

Передать AVOptions декодеру libavcodec в виде списка ключ=значение (полный список — в мануале FFmpeg).

Число потоков декодирования аудио (поддержано лишь у некоторых lossless-кодеков); 0 — автодо 16, default: 1.

Запустить аудиодекодер в отдельном потоке с очередью кадров (default: no); почти бессмысленно, libavcodec уже многопоточен.

Максимальный приблизительный размер очереди аудиодекодера: при превышении декодирование останавливается (суффиксы KiB, MiB).

Максимальное число сэмплов в очереди аудиодекодера (превышение примерно на один кадр возможно).

Максимальное число секунд медиа в очереди аудиодекодера; 0 — без ограничения (превышение примерно на 2 кадра).

При сквозной передаче DTS использовать DTS-HD; устарело, применяйте --audio-spdif=dts-hd.

Задать список аудиофильтров для применения к аудиопотоку (--af-add, --af-pre, --af-clr правят существующий).

Выбрать аудиодорожку: auto — стандартная или лучшая, no — отключить звук (--audio — синоним).

Задать приоритетный список языков аудио IETF-тегами: первая совпавшая дорожка выбирается, больше подтегов — выше приоритет.

При --hdr-compute-peak разрешить откладывать обнаруженный пик на кадр ради производительности (default: no; только gpu-next).

Не читать и не ставить карту каналов ALSA-устройства, лишь запросить нужное число каналов и передавать аудио как есть; только для отладки.

Разрешить вывод неинтерлиеванных форматов (если их использует аудиодекодер); выключено из-за сломанных ALSA-плагинов.

(Android, --gpu-context=android) Задать размеры поверхности рендера; внедряющее приложение ставит их при повороте через surfaceChanged.

(Windows + ANGLE) Выбрать feature level пониже при D3D11: по умолчанию высший; OpenGL ES 3.0 требует 10_1 и выше.

(Windows + ANGLE) Использовать WARP при бэкенде D3D11 (default: auto — когда железо не тянет D3D11 feature level 9_3).

(Windows + ANGLE) Создавать swap chain встроенными EGL-функциями ANGLE (default: auto: свой для D3D11, встроенный для D3D9).

(Windows + ANGLE) Включить flip-model презентацию через разделение поверхностей с DWM (default: yes); no обесценивает --angle-swapchain-length.

(Windows + ANGLE) Принудительно задать конкретный рендерер ANGLE (default: auto); в основном для отладки.

Указать используемые драйверы аудиовывода (см. AUDIO OUTPUT DRIVERS).

Симулировать сломанный аудиодрайвер, неверно сообщающий задержку.

Симулировать сломанный аудиодрайвер, всегда прибавляющий фиксированную задержку устройства к позиции воспроизведения.

Симулируемая длина буфера в секундах для нулевого аудиовывода.

Неразделённый запятой список схем каналов, которые принимает этот AO: для теста выбора схемы каналов.

Принудительно задать формат аудиовывода, который принимает AO; без значения принимается любой.

Симулируемая задержка устройства (дополнительно к EOF).

Симулируемый размер чанка в сэмплах для нулевого аудиовывода.

Симулируемая скорость воспроизведения аудио множителем: реальное устройство чуть отклоняется от системных часов.

Не симулировать идеальное тайминговое аудио-устройство: декодирование идёт максимально быстро, без привязки к часам системы.

Расширения архивов для сопоставления в --autocreate-playlist и --directory-filter-types (список строк).

is an alias for --aid.

Сколько диапазонов ключевых кадров декодировать за раз при обратном ходе аудио (default: 10).

Число перекрывающихся диапазонов ключевых кадров для обратного декодирования аудио (default: auto).

Задать минимальный буфер аудиовывода в секундах (default: 0.2); только для тестов — меньше приводит к выпадениям звука.

Управлять выходными каналами звука: auto-safe (по умолчанию), auto или явные схемы расположений.

Имя приложения, которое плеер сообщает аудио-API: для другого профиля PulseAudio или своего имени в libmpv.

Задержка аудио в секундах: положительное задерживает звук, отрицательное — видео.

Использовать указанный аудиодемуксер для --audio-file; '+' перед именем пропускает часть проверок.

Использовать указанное аудиоустройство: имя вывода, '/', имя устройства; auto перебирает выводы с устройством по умолчанию.

Показывать ли обложки при воспроизведении аудио и с каким приоритетом: no, embedded-first или external-first.

Включить эксклюзивный вывод звука (wasapi, coreaudio, pipewire, audiounit): система остаётся заблокирована.

Список расширений аудиофайлов для сопоставления в --audio-file-auto, --autocreate-playlist и --directory-filter-types.

Если аудиоустройство не открылось, вести себя как при --ao=null вместо ошибки.

Синоним --audio-files-append в CLI и конфиге: каждое использование добавляет новую аудиодорожку.

Автозагрузка дополнительных аудиофайлов по имени видео: no, exact, fuzzy или all.

Как --sub-file-paths, но для автоматически загружаемых аудиофайлов (список путей).

Проигрывать аудио из внешнего файла во время просмотра видео (список путей).

Выбрать формат сэмплов на выходе из аудиофильтра в звуковую карту (значения — у фильтра format).

Включить нормализацию при даунмиксе окружения в стерео (default: no): выключено — клиппинг, включено — слишком тихо.

При скорости, отличной от обычной, автоматически вставлять аудиофильтр scaletempo2 (default: включено).

Частота среза resample-фильтра в диапазоне 0.0-1.0; по умолчанию зависит от длины фильтра.

Длина resample-фильтра относительно меньшей частоты дискретизации (default: 16).

Линейно интерполировать фильтры между полифазными записями (default: no).

Ограничить максимальный размер аудиокадров, фильтруемых за раз, в мс (default: 40), ускоряя реакцию на смену скорости; только для тестов.

Логарифм по 2 числа полифазных записей: 10 даёт 1024 (default: 10).

Максимальный объём буфера (в байтах) для обратного декодирования аудио; растите при overflow.

Выбрать выходную частоту дискретизации; при отличии от медиа вставляется внутренний swresample.

Устанавливать роль медиа на поддержанных аудио-серверах (video/audio-only); по умолчанию выключено из-за путаных громостей.

Список кодеков для сквозной передачи сжатого аудио по S/PDIF или HDMI: ac3, dts, dts-hd, eac3, truehd, dsd (через запятую).

Не останавливать аудио при поиске и паузе, заполняя дыры тишиной: обходит игнорирование первых байт некоторыми HDMI-ресиверами.

Передать AVOptions контексту SwrContext (AVAudioResampleContext) списком ключ=значение; документация — в FFmpeg.

Ждать указанные секунды после открытия аудиоустройства перед подачей реальных данных (полезно с --audio-stream-silence=yes).

Автоматически менять размер окна при изменении размера видео (по умолчанию yes); не влияет на --autofit и --geometry.

При открытии локального файла строить плейлист из родительской директории: no, filter (по --directory-filter-types) или same (та же категория).

Задать начальный размер окна максимум WxH без изменения соотношения сторон: пиксели или проценты от экрана.

Как --autofit, но задаёт максимальный размер окна: например 90%x80% уменьшает окно при большем видео.

Как --autofit, но задаёт минимальный размер окна (например 500x500), сохраняя соотношение сторон видео.

Автоматически загружать и выбирать внешние файлы (default: yes); no отключает --sub-auto, --audio-file-auto и --cover-art-auto, плюс автовыбор.

Постепенно подстраивать A/V синхронизацию по замерам аудиозадержки: 0 (по умолчанию) чисто по замерам, больше 1 — ближе к поведению без аудио.

(Windows) Стиль задника/рамки: auto, none, mica (default Windows 11), acrylic (матовое стекло) или mica-alt (перевёрнутый Mica).

Чем подмешивать фон под кадром с альфа-каналом: color (однотонный), tiles (шахматка, по умолчанию) или none (оставить альфа как есть).

Радиус размытия в пикселях для --border-background=blur.

Цвет частей окна mpv, не покрытых видео, в режиме --background=color; синтаксис как у --sub-color.

Первый цвет шахматного узора фона в режиме --background=tiles; синтаксис как у --sub-color.

Второй цвет шахматного узора фона в режиме --background=tiles; синтаксис как у --sub-color.

Размер плитки узора фона в режиме --background=tiles (default: 16).

Смешивать субтитры прямо с отмасштабированными кадрами до интерполяции и цветокоррекции (default: no): быстрее, но субтитры ограничены видимой частью видео.

Blu-ray содержат сцены с несколькими ракурсами: указать, какой угол использовать (default: 1).

Указать расположение Blu-ray: каталог со структурой Blu-ray; путь по умолчанию зависит от ОС.

Путь к базе ключей KEYDB.cfg, передаваемая libbluray для дешифровки AACS.

Не включать в список титулы Blu-ray короче этой длины в секундах (default: 0 — все); значения вроде 180 прячут меню-плейлисты.

Региональный код Blu-ray плеера (default: auto — остаётся дефолт libbluray, регион B).

Насколько строго соблюдать маски запретов операций диска: disabled, relaxed, strict или compliant (default: auto).

Играть видео с рамкой окна и украшениями; по умолчанию включено, отключается через --no-border.

То же, что --background, но только для области чёрных полос/рамки окна (только vo=gpu-next; default color).

Настроить яркость видеосигнала (default: 0); поддержано не всеми драйверами видеовывода.

Решить, использовать ли сетевой кэш (default: auto): включённый кэш делает данные искемыми, размер задаётся --cache-secs и --demuxer-max-bytes.

Писать данные пакетов во временный файл вместо памяти (имеет смысл только с --cache); метаданные всё равно в памяти.

Автоматически ставить плеер на паузу, когда кэш иссяк и декодирование застало, снимая её по мере наполнения (default: yes).

Входить в режим «буферизации» до старта воспроизведения, ожидая предзагрузку сети (default: no; длительность у --cache-pause-wait).

Сколько секунд кэш должен накопить перед возобновлением после «буферизации» (default: 1).

Сколько секунд аудио/видео предзагружать при активном кэше; переопределяет --demuxer-readahead-secs, если кэш включён и значение больше.

Эти опции настраивают чтение CD Audio в mpv.

Читать CD text; выключено по умолчанию, потому что почему-то рушит производительность CD-ROM приводов.

Указать CD-устройство для воспроизведения CDDA; путь по умолчанию зависит от ОС.

Принудительно задать минимальный overlap при верификации в секторах.

Уровень paranoia-проверки: 0 без проверок (по умолчанию), 1 только overlap, 2 полное исправление и верификация.

Задать атомарный размер чтения с CD.

Никогда не принимать несовершенное восстановление данных.

Задать скорость вращения CD.

Прибавить value секторов (можно отрицательное) к значениям адресации дорожек.

Порог склейки почти соседних упорядоченных глав в миллисекундах (default: 100).

Расстояние в секундах от начала главы, внутри которого поиск назад уходит в предыдущую главу (default: 5.0).

Читать главы из этого файла, подменяя метаданные глав основного файла.

Приоритетный список бэкендов буфера обмена: непустой список включает нативную поддержку чтения и записи свойства clipboard.

Включить наблюдение буфера обмена, чтобы свойство clipboard сообщало об изменениях содержимого (default: no; только polling-реализации).

Использовать X11-бэкенд буфера обмена в подозрительных Wayland-средах (default: no): иногда позволяет работать через VO-бэкенд.

(macOS + cocoa-cb) Создавать 10-битный формат пикселей для контекста: вместо 8-битного Integer framebuffer запрашивается 16-битный half-float (default: yes).

(macOS) Задать цветовое пространство слоя для активации системной цветовой трансформации и EDR/HDR: auto (профиль ICC экрана), display-p3 и другие.

(macOS + cocoa-cb) Использовать программный рендерер Apple (default: auto — только когда обычный формат пикселей не создался).

Принудительно задать директорию конфигурации, игнорируя остальные и MPV_HOME.

Переопределить частоту кадров видео из контейнера: полезна при неверном или отсутствующем значении.

Настроить контраст видеосигнала (default: 0); поддержано не всеми драйверами видеовывода.

Поддерживать cookie при HTTP-запросах; по умолчанию выключено.

Читать HTTP cookie из файла в формате Netscape.

При значении выше 0.0 рисовать со скруглёнными углами, как с альфа-маской; 1.0 скругляет максимально (только --vo=gpu-next).

Расширять размер свёрточного фильтра при уменьшении: качество выше, производительность ниже (включено по умолчанию).

Автозагрузка внешних обложек по имени медиафайла: no, exact (по умолчанию), fuzzy или all; не грузится, если у видео уже есть дорожки.

Синоним --cover-art-files-append в CLI и конфиге: каждое использование добавляет новый файл обложки.

Использовать внешний файл как обложку при игре аудио: появляется в списке дорожек и подлежит автовыбору.

Имена файлов, загружаемые как обложки, по убыванию приоритета, в комбинации с расширениями из --image-exts (список строк).

Как --scale, но для интерполяции хроминантности; игнорируется без субдискретизации; если не задана — берётся из --scale.

Сила устранения рингинга для хроминантности от 0.0 до 1.0 (default 0.0; high-quality ставит 0.6).

Множитель ядра для хроминантности: меньше — резче, больше — размытее; 0 — предпочитаемый фильтром (рекомендуется 0.8-1.2).

То же для хроминантности: весовое смещение отрицательных коэффициентов, 1 зажимает диапазон в [0-1].

Параметр 1 фильтра для хроминантности: default — собственное значение фильтра (bicubic B и C, gaussian t).

Параметр 2 фильтра для хроминантности: default — собственное значение фильтра (bicubic B и C, gaussian t).

Радиус настраиваемого фильтра для хроминантности: число от 0.5 до 16.0 (default — предпочитаемый фильтром).

(Продвинутым пользователям) Оконная функция ядра для хроминантности; по умолчанию предпочитаемая фильтром.

Параметр оконной функции для хроминантности: default — собственное значение окна (kaiser, blackman, gaussian).

Выбрать GPU для декодирования при cuda/nvdec hwdec с OpenGL-бэкендом и для copy-вариантов.

Размер кольцевого буфера производителя на поток, отделяющего сетевой поток от потребителя (default: 4 MiB, минимум 32 KiB).

Таймаут соединения TCP/TLS в секундах (default: 30, диапазон 0-600); 0 — встроенный default libcurl.

Включить сетевой бэкенд на libcurl (default: yes); на известных старых версиях FFmpeg выключен из-за бага очистки вложенного IO.

Максимальная версия HTTP-протокола, которую libcurl вправе согласовать (default: auto — выбор libcurl).

Максимум HTTP-редиректов, которые пройдены до сообщения об ошибке (default: 16).

Разбивать iskeмую передачу на Range-запросы не больше этого размера (default: 0 — один открытый запрос); обходит троттлинг некоторых CDN.

Сколько раз искемая передача может прозрачно повторяться после восстановимой ошибки (default: 5); неискемые передачи не повторяются.

Автоматически скрывать курсор мыши спустя указанные миллисекунды (default: 1000; no — выключить, always — всегда скрыт).

Курсор всегда виден в оконном режиме, а в полноэкранном подчиняется --cursor-autohide.

Выбрать конкретный D3D11-адаптер для рендера: без значения берётся адаптер по умолчанию; альтернативы показываются именем help.

(Windows, --gpu-context=d3d11 и composition) Задать размер вывода для composition-режима: окна нет, размер задаёт внедряющее приложение.

Переключать swap chain D3D11 в состояние 'fullscreen' при полноэкранном видео («exclusive fullscreen», выключено по умолчанию).

Выбрать конкретный feature level при бэкенде D3D11: по умолчанию высший; понижение нужно главным образом для отладки.

Включить flip-model презентацию, избегающую лишнего копирования back buffer через разделение поверхностей с DWM (default: yes; откат на bitblt).

Цветовое пространство вывода D3D11: auto (по умолчанию) берёт пространство стола с swap chain; srgb и pq проверены, прочие вручную.

Формат вывода D3D11: auto (по умолчанию) выбирает rgba8 или rgb10_a2 по глубине рабочего стола; rgba16f и bgra8 вручную.

Режим вывода swapchain D3D11: composition (без окна, для WinUI), window (через DWM, он же auto); адрес — в display-swapchain.

Запланировать показ каждого кадра через указанное число интервалов VBlank: 1 — VSYNC включён (по умолчанию), 0 — выключен.

Использовать WARP (программный растеризатор Windows) с бэкендом D3D11 (default: auto — только когда нет аппаратных адаптеров D3D11).

Не копировать изображение из поверхности декодера в шейдерный ресурс при --gpu-api=d3d11, а сэмплировать напрямую: быстрее, но риски с паддингом.

Включить алгоритм дебандинга: значительно убирает видимые полосы, блочность и прочие артефакты квантования, едва размывая тончайшие детали.

Добавить дополнительный шум к картинке: заметно помогает скрыть оставшиеся артефакты квантования (default 32).

Число шагов дебандинга на сэмпл: каждый убирает чуть больше полос, но требует времени; свыше 4 практически бесполезно (default 1).

Начальный радиус дебандинга: растёт линейно по итерациям; больший радиус находит больше градиентов (default 16).

Порог отсечения фильтра дебандинга: большие значения резко усиливают эффект, но постепенно съедают детали (default 48).

Включить деинтерлейсинг (default: no): обычно вставляет фильтр bwdif или отдаёт дело VO; auto — по детекту ffmpeg.

Задать чередование полей при деинтерлейсинге: auto, tff (верхнее первым) или bff (нижнее первым).

Принудительно задать тип демуксера; '+' перед именем пропускает часть проверок (имя из --demuxer=help).

Сколько секунд демуксеру отступать назад за новыми пакетами при обратном воспроизведении (default: 60).

Директория для временных файлов кэша; без неё используется системный каталог (~/.cache/mpv). Сейчас только для --cache-on-disk.

Когда удалять файлы кэша: immediate (по умолчанию, гарантированно убирает их даже при падении), whendone или no.

Перед стартом чтения читать данные до конца файла или заполнения кэша демуксера, и только потом начинать воспроизведение.

Разрешить back buffer частично использовать forward buffer (default: yes); no раздельно ограничивает оба.

То же, что --demuxer-hysteresis-secs, но гистерезис в байтах прямого буфера: полезно при переменном или неизвестном битрейте (default: 0).

Гистерезис в секундах: сколько контента должно остаться в кэше после достижения лимита, прежде чем демуксер снова читает вперёд.

Разрешить выводить формат из HTTP MIME-типа (default: yes); отключайте, если HTTP-вещание загадочно ломается.

Максимальная длина в секундах для анализа свойств потока.

Размер буфера чтения потока для libavformat в байтах (default: 32768); меньше — ниже задержка.

Принудительно задать конкретный демуксер libavformat.

Отключить специфичные для форматов костыли libavformat при no; только для отладки и тестов.

Пытаться линеаризовать сбросы таймстампов в демуксируемых потоках (default: auto — включает для OGG-аудио, например веб-радио).

Передать AVOptions демуксеру libavformat списком ключ=значение (например fflags=+ignidx); некоторые конфликтуют с опциями mpv.

Зондировать ли информацию о потоках (default: auto); управляет вызовом avformat_find_stream_info(), ускоряя старт у безопасных форматов.

Минимально необходимый probe score libavformat (default: 26): меньше — быстрее старт, но менее надёжное определение формата.

Максимальный объём данных для зондирования на фазе определения (для MPEG-TS — число сканируемых TS-пакетов).

Передавать опции уровня FFmpeg рекурсивно открываемым соединениям (default: yes); влияет на --timeout и --demuxer-lavf-o.

Сколько прошлых данных демуксеру позволено сохранять (полезно только при включённом кэше); 0 строго запрещает back buffer.

Ограничить, сколько данных демуксер вправе буферизовать вперёд, останавливая чрезмерное чтение.

Режим совместимости для файлов, не полностью следующих спецификации Matroska (default: yes): применять crop до расчёта aspect.

Проверять время начала Matroska-файлов, читая таймстамп первого кластера (default: yes).

Искать к концу файла и брать таймстамп последнего видеопакета как длительность: совместимость только с Haali, медленно.

Сильнее стараться показывать встроенные мягкие субтитры при поиске: они часто появляются чуть раньше связанного видеокадра.

См. --demuxer-mkv-subtitle-preroll.

См. --demuxer-mkv-subtitle-preroll.

Число каналов или схема расположения при --demuxer=rawaudio (default: stereo).

Формат сэмплов для --demuxer=rawaudio (default: s16le); список — через --demuxer-rawaudio-format=help.

Частота дискретизации для --demuxer=rawaudio (default: 44 кГц).

Задать видеокодек вместо rawvideo при --demuxer=rawvideo; имена как в --vd, но декодеры не принимаются.

Цветовое пространство (fourcc) в hex или строкой для --demuxer=rawvideo (default: YV12).

Частота кадров в секунду для --demuxer=rawvideo (default: 25.0).

Размер изображения в пикселях по высоте при --demuxer=rawvideo (например 576 вместе с -w=720).

Цветовое пространство внутренним видеоформатом для --demuxer=rawvideo; список — через =help.

Размер кадра в байтах при использовании --demuxer=rawvideo.

Размер изображения в пикселях по ширине при --demuxer=rawvideo (например 720 вместе с -h=576).

Сколько секунд вперёд буферизует демуксер при включённом --demuxer-thread (default: 1); переопределяется --cache-secs.

Отладочная опция: может ли поиск пользоваться кэшем демуксера (default: auto — включается при --cache=yes).

Сколько секунд плеер ждёт остановки демуксера (default: 0.1) перед форсированным закрытием слоя потока.

Запускать демуксер в отдельном потоке с предзагрузкой пакетов (default: yes): ровнее играет, но добавляет накладные расходы.

Типы медиафайлов для фильтрации при открытии директорий и архивов (default: video,audio,image,archive,playlist).

При открытии директории раскрывать подкаталоги лениво, рекурсивно или вообще; auto — recursive с --shuffle, иначе lazy.

Запускать dvd:// или bd:// в интерактивное меню диска вместо автоплея самого длинного титула (default: no).

Задать FPS дисплея для режимов --video-sync=display-*, когда определённое значение неверно.

Список тегов, показываемых в терминале и статистике; значение с * сопоставляет по префиксу (список строк).

Алгоритм дизеринга (default: fruit): none, fruit или error-diffusion (нужны compute-шейдеры и много общей памяти, иначе откат).

Целевая глубина дизеринга N: no отключает, auto выбирает, 8 — 8 бит; рекомендуется явно ставить глубину дисплея.

Размер матрицы дизеринга (default: 6): действительный размер 2^N × 2^N, то есть 64x64; генерируется на старте.

Управлять встроенным поведением перетаскивания файлов: auto, replace, append, insert-next или no.

Как --scale, но применять эти фильтры при уменьшении.

Сила устранения рингинга при уменьшении от 0.0 до 1.0 (default 0.0; high-quality ставит 0.6).

Множитель ядра при уменьшении: меньше — резче, больше — размытее; 0 — предпочитаемый фильтром (рекомендуется 0.8-1.2).

То же при уменьшении: весовое смещение отрицательных коэффициентов, 1 зажимает диапазон в [0-1].

Параметр 1 фильтра при уменьшении: default — собственное значение фильтра (bicubic B и C, gaussian t).

Параметр 2 фильтра при уменьшении: default — собственное значение фильтра (bicubic B и C, gaussian t).

Радиус настраиваемого фильтра при уменьшении: число от 0.5 до 16.0 (default — предпочитаемый фильтром).

(Продвинутым пользователям) Оконная функция ядра при уменьшении; по умолчанию предпочитаемая фильтром.

При сквозной передаче DTS использовать DTS-HD; устарело, применяйте --audio-spdif=dts-hd.

Записывать сырые сэмплы статистики с таймстампами в указанный файл (для отладки).

Номер используемой DVB-карты от 0 до 15 (default: 0).

Смещение относительно изначально настроенного канала для переключения каналов (cycle в input.conf), не для конфига.

Читать список каналов из указанного файла; по умолчанию channels.conf.* в каталоге конфигурации mpv по типу карты.

Не фильтровать PID программ, лишь настроить частоту и передать демуксеру полный транспондер; выбор программ на фронтенде (default: no).

Программа, на которую настраиваться: обычно через URI dvb://ZDF HD; переключается записью свойства во время работы.

Максимум секунд ожидания настройки на частоту перед отказом (default: 30).

DVD содержат сцены с несколькими ракурсами: указать, какой угол использовать (default: 1).

Указать DVD-устройство или .iso-файл, либо каталог с скопированными с DVD файлами (например через vobcopy).

Региональный код DVD плеера (default: auto — заявляет регионы, разрешённые самим диском).

Ограничить скорость DVD в кБ/с (default: 0 — без изменений): меньшая скорость тише; 2700 кБ/с достаточно тихо и быстро.

Указать устройство или .iso-файл DVD-Audio для dvda://, либо каталог со скопированными с диска файлами.

Принудительно задать страницу неподвижного изображения при DVD-Audio вместо запланированной (default: -1).

Только Matroska: указать издание (набор глав), где 0 — первое; auto выбирает стандартное.

(Только EGL) Выбрать EGLConfig с указанным EGL_CONFIG_ID для поверхностей и контекстов (список при --msg-level=vo=trace).

Использовать шрифты, встроенные в Matroska и ASS-скрипты (default: yes), для рендера SSA/ASS.

Остановить воспроизведение в указанное время; для относительного отсчёта использовать --length.

Ядро распространения ошибки при --dither=error-diffusion: simple, sierra-lite (по умолчанию), floyd-steinberg или atkinson.

Синоним --external-files-append в CLI и конфиге: каждое использование добавляет новый внешний файл.

Загрузить файл и добавить все его дорожки: играть видео из одного файла и аудио из другого, включая --lavfi-complex.

Внутренний формат текстур FBO, влияющий на скорость и качество: rgb8, rgba16f, rgba16hf, rgb10_a2 и др. (default auto с откатами).

Игнорировать структуру программ контейнера (HLS, MPEG-TS) и показывать все дорожки плоским списком.

(X11 и macOS) Фокусировать и выносить окно на передний план по событиям: never, open (по умолчанию) или all.

Принудительно задать содержимое свойства media-title этим значением: удобно скриптам, не ломая --title пользователя.

Заставлять mpv рисовать кадры независимо от видимости окна; касается лишь X11, Wayland и macvk VO.

Изменить способ отрисовки OSD и текстовых субтитров некоторыми VO: только влияние на производительность.

Принудительно включить поиск, если плеер считает медиа неискемым (pipe, http без range): в кэше шансы высоки.

Создавать окно видеовывода даже без видео: выглядит как GUI-приложение; окно всегда 960x540.

Возвращать ли окно на исходную позицию после автоизменения размера из-за смены размера видео (default: no).

Пропускать показ некоторых кадров ради A/V-синхронизации: no, vo (по умолчанию) или decoder.

Проиграть только первые number видеокадров и выйти; 0 загружает файл и сразу выходит.

Воспроизведение в полноэкранном режиме.

На каком экране включать полноэкранный режим; current откатывается к значению --screen (на macOS all не работает).

Указать экран полноэкранного режима по имени экрана из видеобэкенда; игнорируется при явном --fs-screen.

Воспроизведение в полноэкранном режиме.

Настроить гамму видеосигнала (default: 0); поддержано не всеми драйверами видеовывода.

Автоматически корректировать гамму по условиям освещения (буст для ярких комнат); устарело, только macOS и --vo=gpu.

Дополнительный сырой коэффициент гаммы (default 1.0): умножается на прочие настройки гаммы (--gamma, свойства, привязки).

Алгоритм сжатия гамута под целевой дисплей после tone mapping: auto, clip, perceptual, relative и другие.

Пытаться играть подряд идущие аудиофайлы без пауз и разрывов на смене файла (default: weak).

Подвинуть начальную позицию или размер окна: W и H в пикселях (или % от экрана), x и y от левого верхнего угла экрана.

Добавить GLSL-hook: каждый use добавляет файл кастомного фрагментного шейдера во внутренний список.

Опции настраиваемых параметров шейдеров GLSL: shader/param=value для конкретного шейдера либо без префикса для всех (например PTS).

Задать список файлов GLSL-hook, перезаписывая внутренний список (опция списка путей).

Задать приоритетный список принимаемых графических API: auto (любой), opengl, vulkan (нужен --spirv-compiler) или d3d11.

Задать приоритетный список GPU-контекстов; auto (по умолчанию) выбирает по автопробе, help перечисляет собранные бэкенды.

Включить отладку GPU: для OpenGL вызывает glGetError() и просит debug-контекст, для Vulkan включает validation layers.

Крайне ограниченный режим, отключающий большинство расширенных возможностей (качественные скейлеры и свои шейдеры) для железа без FBO; auto включает сам.

Для диагностики interop-проблем hwdec: выбрать конкретный контекст interop или заблокировать бэкенды.

Хранить компилированные GLSL-шейдеры в кэш-каталоге (default: yes): ускоряет старт на D3D11, ANGLE, Vulkan и некоторых проприетарных драйверах.

Директория хранения кэша GPU-шейдеров; без неё используется системный каталог (~/.cache/mpv).

Продолжать работу, даже если обнаружен программный рендерер; работает для OpenGL/Vulkan бэкендов (для d3d11 — --d3d11-warp).

Увеличить исходные текстуры видео на это число пикселей по X: только отладка паддинга из hwdec interop; может быть удалено.

Увеличить исходные текстуры видео на это число пикселей по Y: только отладка паддинга из hwdec interop; может быть удалено.

Показать краткий список опций; с аргументом — только опции, содержащие эту строку в имени.

Вычислять HDR-пик и среднюю яркость покадрово вместо теговых метаданных: динамический tone mapping по сценам; нужны compute-шейдеры и SSBO (auto).

Включить восстановление контраста HDR после tone mapping: сила от 0.0 до 1.0 и выше, но переострение рискует (gpu-next).

Гладкость (default 3.5) низкочастотной фильтрации HDR-источника для получения информации о контрасте: 2.0 соответствует уменьшению вдвое.

Сила «плёночной» реакции при tone mapping (default 0.3): выше — высветленные сжатые света ценой насыщенности (только gpu-next).

Мягко обрезать значения источника выше пиковой яркости мастеринг-дисплея, когда метаданные достоверны; эффект угасает (default 1.0; gpu-next).

Скорость затухания алгоритма HDR-пика (default 20.0): больше — стабильнее значения, 0.0 отключает усреднение и даёт мерцание.

Какой процентиль гистограммы яркости считать истинным пиком сцены: 100 (по умолчанию) — самый яркий пиксель (только gpu-next).

Предполагаемая пиковая яркость мастеринг-дисплея для SDR в нитах: уровень диффузного белого SDR в HDR-контейнере (auto спрашивает систему, иначе 203).

Верхний порог в дБ разницы яркостей для признания смены сцены (default 3.0); иначе кадр остаётся слишком светлым или тёмным несколько секунд.

Нижний порог в дБ разницы яркостей, при котором она считается сменой сцены (default 1.0); нужен при --hdr-compute-peak.

Показать краткий список опций; с аргументом — только опции, содержащие эту строку (--h=scale).

Масштабировать размер окна коэффициентом DPI системы (default: no): при 200% окно удваивается.

Какие потоки HLS выбирать по умолчанию: no (первые найденные), min (низший битрейт) или max (по умолчанию); числом — потолок битрейта.

Когда использовать точный поиск вне ключевых кадров: no, yes (по умолчанию) или absolute.

Вычитать это время из отметки для демуксера, обходя неточные поиски некоторых форматов.

Разрешить декодеру сбрасывать кадры до цели при точном поиске: быстрее, но ломает фильтры, меняющие таймстампы.

Задать собственные HTTP-заголовки при доступе к HTTP-потоку списком строк вида 'Field1: value1'.

URL прокси HTTP/HTTPS: задавая его, игнорируется http_proxy (no_proxy остаётся в силе); молча игнорируется без http://.

Настроить оттенок видеосигнала (default: 0): даёт цветной негатив изображения; поддержано не всеми VO.

Задать API аппаратного декодирования видео, когда возможно; при недоступности mpv откатывается на программное.

Разрешить аппаратное декодирование только для списка кодеков (all — все); default h264,vc1,hevc,vp8,vp9,av1,prores,prores_raw,ffv1,dpx,apv.

Число дополнительных GPU-кадров, которые аппаратное декодирование должно выделить заранее (default: auto).

Задать внутренний формат пикселей аппаратного декодирования через --hwdec (default: no — формат реализации).

Откатиться на программное декодирование после N неудачных подряд кадров (default: 3; 1 — да).

Число потоков аппаратного декодирования в libavcodec (default: 4; 0 — по числу ядер CPU).

Размер генерируемого из ICC-профиля 3D LUT по каждой оси от 2 до 512; auto (по умолчанию) подбирает сам — менять не рекомендуется.

Хранить и читать 3DLUT, созданные из ICC-профиля, в кэш-каталоге (default: yes): ускоряет загрузку, файлы несжатые и крупные.

Директория хранения ICC-кэша; без неё используется системный каталог (~/.cache/mpv).

Переопределить обнаруженный контраст целевого устройства значением (или inf — чистая gamma 2.4 для BT.1886); влияет только на BT.1886 контент.

ICC intent для цветовой трансформации при --icc-profile: 0 perceptual, 1 relative colorimetric (по умолчанию), 2 saturation, 3 absolute.

Загрузить ICC-профиль и применять его для трансформации видео RGB в вывод экрана; нужен собранный LittleCMS 2.

Автоматически выбрать ICC-профиль дисплея из системных настроек отображения (Windows: только ICC, WCS не поддержан).

Использовать значение яркости из ICC-профиля (только --vo=gpu-next).

Заставить mpv ждать без выхода, когда играть нечего; полезно в input-режиме.

Игнорировать путь (использовать только имя файла) в функции «смотреть позже» (выключено по умолчанию).

Если текущий файл — изображение, показывать его указанное число секунд (default: 5; inf — вечно).

Расширения изображений для сопоставления в --cover-art-auto, --autocreate-playlist и --directory-filter-types (список строк).

Указать собственный LUT-файл в формате Adobe .cube, применяемый к цветам при декодировании изображения (только --vo=gpu-next).

Как трактовать цвета LUT из --image-lut: auto (метаданные, иначе native), native до декодирования в RGB или normalized после, но до линеаризации.

Задать диффузный белый уровень битмапных субтитров в нитах для HDR: sdr, video, video-dynamic, video-static (default: 1000).

Подменить разрешение битмапных субтитров разрешением видео (default: no); помогает искать битые субтитры после транскодирования.

Указать конфиг-файл, который разбирается после стандартных.

Как искать в файле: default — использовать индекс или строить его, recreate — не читать существующий.

Подрезать или дополнять звук тишиной, чтобы он начинался с тем же таймстампом, что видео (включено по умолчанию).

Задержка в миллисекундах до начала автоповтора клавиши (default: 200; 0 — отключить).

Число повторений клавиши в секунду при автоповторе (default: 40).

Загружать встроенные привязки клавиш при инициализации (lib)mpv (default: yes); отключённые позже включить уже нельзя.

Включить встроенную обработку перетаскивания файлов (default: yes); на macOS затрагивает и Drop-иконку, и Finder.

Включить встроенное поведение перетаскивания окна мышью (default: yes); касается VO с командой begin-vo-dragging.

Перечислить все команды, которые можно привязать к клавишам.

Список команд mpv в синтаксисе input.conf без привязки клавиш: выполняются перед стартом аудио/видео или сразу в idle.

Указать файл конфигурации ввода вместо стандартного input.conf в каталоге mpv.

Разрешить mpv получать события указателя от драйвера видеовывода: нужно для OSC (default: yes).

Сказать оконной системе пропускать события указателя сквозь окно mpv: окна под ним получают их, будто mpv нет.

Включить привязки клавиш default-уровня («слабые»), которые input.conf может переопределить (default: yes).

Время в миллисекундах, чтобы распознать два нажатия подряд как двойной клик (default: 300).

Начинать встроенное перетаскивание окна, когда мышь с зажатой кнопкой вышла из мёртвой зоны в N пикселей (default: 3).

Включить или отключить поддержку SDL2 Gamepad; по умолчанию выключена.

(Wayland и Windows) Включить клавиатурный ввод через активный IME, связанный с VO (default: no).

Подключить одного IPC-клиента к данному файловому дескриптору: никаких сокетов, FD трактуется как принятое соединение accept().

Включить IPC и создать слушающий сокет по указанному пути (на Linux '@' — abstract socket, Windows — именованный канал).

Размер FIFO, буферизующего события клавиатуры (default: 7); малый теряет события, большой запаздывает при медленных командах.

Перечислить все клавиши, которые можно привязать к командам.

(macOS и Windows) Получать ли mpv медиа-клавиши вместо системы (default: yes, кроме libmpv).

Предобрабатывать события WHEEL_* так, чтобы диагональное вращение на тачпаде не порождало событий другого направления (default: yes).

(macOS и Windows) Считать правый Alt за Alt Gr для спецсимволов; иначе он обычная модификация Alt (включено по умолчанию).

Эмулировать движение мыши и нажатия из событий планшета (default: yes); только Wayland.

Режим теста ввода: показывать на OSD нажатые клавиши и привязанные команды вместо их выполнения.

Эмулировать движение мыши и нажатия кнопок из touch-событий при включённом мультитаче (default: yes).

Отключить весь клавиатурный ввод для VO, не умеющих правильно его диспетчеризировать: полезно при встраивании окна.

Устранить дрожание от несовпадения fps видео и частоты обновления дисплея (judder); требует --video-sync=display-*.

Сохранять результаты интерполяции предыдущих кадров при изменении параметров рендера: плавнее, но чуть больше задержка (default: on; только gpu-next).

Порог, ниже которого интерполяция по соотношению кадров отключается (default: 0.01): abs(disphz/vfps-1).

Разрешить обратный tone mapping (расширение динамического диапазона): SDR→HDR или сделать HDR ярче; не всеми кривыми поддержано (gpu-next).

Включить отчёт о памяти для JS-скриптов в оверлее статистики; требует включения до запуска mpv.

Не завершаться после конца файла, если следующего нет: ставить плеер на паузу; no — завершаться, yes — эквивалентно без аргументов.

При no вместо паузы на конце файла просто остановиться и продолжить играть при поиске назад (default: yes).

Задать «complex» граф libavfilter с несколькими входными аудио- и видеодорожками: метки aidN, vidN на входе, ao и vo на выходе.

Остановиться спустя указанное время от начала; вместе с --end стоп по достижению любой границы.

Передать сырые дополнительные опции бэкенду libplacebo (для --vo=gpu-next, нужна v6.309+): может перекрывать прочие опции; только отладка.

Масштабировать в линейном свете при уменьшении; нужен --fbo-format с точностью от 16 бит; на HDR не действует (включено по умолчанию).

Масштабировать в линейном свете при увеличении: требует 16-битный --fbo-format; обычно лучше включить --sigmoid-upscaling вместо этого.

Перечислить все доступные опции.

Перечислить все доступные свойства.

Перечислить все поддерживаемые протоколы.

Загрузить встроенный скрипт условных автопрофилей; auto грузит и сразу выгружает без таких профилей.

Загрузить встроенный скрипт ввода команд в консоли, по умолчанию клавиша ` (default: yes).

Загрузить встроенный скрипт обработки текстового ввода (default: yes).

Загрузить встроенный скрипт контекстного меню; по умолчанию yes там, где нет нативного меню.

Загрузить встроенный скрипт привязок для панорамирования видео и изображений (default: yes).

Если no, не загружать автоматически скрипты из директории scripts (default: yes).

Загрузить встроенный скрипт выбора из списков; его привязки начинаются с клавиши g (default: yes).

Загрузить встроенный скрипт показа информации о воспроизведении по клавише i (default: yes).

Загружать URL из плейлистов, считающихся небезопасными (default: no).

Открыть указанный путь для записи и писать туда логи, обрезая существующий файл.

Зациклить один файл N раз: то же, что --loop-file (inf — навсегда, no — выключено).

Зациклить один файл N раз: inf — навсегда, no — обычное воспроизведение (поиск вместо перезагрузки).

Прогнать плейлист N раз: inf — вечность, no — один раз, force — не пропускать битые записи.

Задать собственный LUT в формате Adobe .cube, применяемый к цветам как часть цветоконверсии (только --vo=gpu-next).

Как трактовать цвета LUT из --lut: auto (метаданные, иначе native), native в нелинейном свете, normalized в линейном или conversion целиком.

(macOS) Изменить политику активации приложения: accessory прячет иконку mpv в Dock (default: regular).

(macOS) Дописывать указанные пути в начало PATH приложения Bundle (по умолчанию /usr/bin:/bin:/usr/sbin:/sbin), чтобы скрипты находили бинарники.

(macOS) Отключить автоматическое переключение графики и принудительно использовать дискретный GPU (default: no).

(macOS) Длительность анимации изменения размера полноэкрана в мс (default чуть меньше системных 500 мс).

(macOS) Прямоугольник расчёта позиции и размера окна: visible учитывает меню-бар и Dock (по умолчанию), whole — игнорирует их.

(macOS) Включить стандартные сокращения меню-бара (default: yes): они всегда в приоритете и не доходят до input.conf и скриптов.

(macOS + macvk) Режим синхронизации рендера с частотой обновления дисплея: callback (по умолчанию), precise, system или feedback.

(macOS) Вид заголовочной полосы: auto по настройкам системы, aqua, darkAqua, vibrantLight или vibrantDark (неподдерживаемые — откат).

(macOS) Цвет заголовочной полосы (по умолчанию полностью прозрачный); зависит от appearance и material; синтаксис как у --sub-color.

(macOS) Материал заголовочной полосы: titlebar (по умолчанию), selection, menu, popover и т. п.; устаревшие не стоит использовать на 10.14+.

Максимальная коррекция A-V синхронизации на кадр в секундах.

(Windows) Включить интеграцию интерфейса управления медиа SystemMediaTransportControls (default: yes, кроме libmpv).

Делать вид, что все переданные файлы склеены в один большой (через EDL/timeline).

Кодировка различных входных метаданных (default: auto): как трактовать теги файлов, заголовки глав и т. п.

Частота кадров при декодировании из множества PNG или JPEG файлов через mf:// (default: 1).

Тип входных файлов для mf://: jpeg, png, tga или sgi; по умолчанию определяется по расширению.

Задать соотношение сторон монитора или ТВ экрана (4:3, 16:9 или числом); 0 отменяет прежнюю настройку; перекрывает --monitorpixelaspect.

Задать соотношение сторон одного пикселя монитора или ТВ (default: 1 — квадратные пиксели).

Включить цветной вывод консоли на терминалах (default: yes).

Управлять подробностью отдельно по каждому модулю (all меняет все): применяется слева направо, каждый пункт перекрывает предыдущий.

Дописывать имя модуля перед каждым сообщением в консоль.

Дописывать сведения о времени к каждому сообщению консоли: секунды от старта процесса, монотонные (CLOCK_MONOTONIC на разумных UNIX).

Задать стартовое состояние mute (default: no); см. также --volume.

(macOS) Использовать нативный полноэкранный механизм ОС (default: yes).

Использовать системные настройки повтора клавиш вместо --input-ar-delay и --input-ar-rate (default: no).

(Windows) Использовать нативные touch-события вместо эмулированных мышиных (default: no); нужно для мультитача.

Сетевой таймаут в секундах (default: 60); 0 — значения по умолчанию FFmpeg; игнорируется протоколами без таймаутов, ломает RTSP.

Не загружать ни системный, ни пользовательский конфиг (mpv.conf, input.conf, кэш, резюме).

Включить режим кодирования и задать имя выходного файла.

Задать выходной аудиокодек; полный список поддерживаемых — --oac=help.

Опции выходного аудиокодека libavcodec списком ключ=значение (например b=128000 для libmp3lame); --oacopts=help — список.

Копировать метаданные из входных файлов в выходные при кодировании (default: yes).

Задать выходной формат (переопределяя автоопределение по расширению из --o); список — --of=help.

Задать опции выходного формата libavformat (список ключ=значение; --ofopts=help — полный список).

(X11 и macOS) Показывать окно видео на всех виртуальных рабочих столах.

Держать окно плеера поверх других окон; на Windows в полноэкране даёт exclusive fullscreen мимо DWM.

(macOS) Уровень on-top окна: window (по умолчанию), system, desktop или целое число.

(Windows) Вызывать DwmFlush после swap буферов (default: auto — только когда композитор активен): ровнее интервалы кадров при высоком fps.

Вызывать glFlush() после рендера кадра до его показа (default: auto): лечит или порождает stuttering; на macOS всегда выключено.

Какие типы OpenGL-контекстов принимать: auto (все, по умолчанию), yes (только GLES) или no (только десктопный/core GL).

Вызывать glFinish() перед swap буферов (выключено): медленнее, но может помочь при пропуске кадров — зависит от драйвера OpenGL.

Включить использование PBO: на некоторых драйверах быстрее при огромных исходниках («4K»), на других медленнее.

Принудительно использовать прямоугольные текстуры (default: no): обычно преимуществ нет, аппаратное декодирование перекрывает флаг.

Интервал в отображаемых кадрах между двумя swap буферов: 1 — VSYNC включён (по умолчанию), 0 — выключен.

Вызывать glXWaitVideoSyncSGI после каждого swap буфера (выключено): может помочь или замедлить видеовывод; только X11/GLX.

Копировать входные pts в выходное видео без исправления разрывов (не поддержано некоторыми контейнерами вроде AVI); никогда не искать назад.

Поддержать упорядоченные главы Matroska: загружать сегменты из других файлов (default: yes).

Загрузить этот плейлист как список опорных файлов для упорядоченных глав вместо сканирования директории.

Метаданные, исключаемые из копирования во выходной файл (список строк, например comment,genre).

Загружать экранный контроллер OSC (default: yes).

К какому краю экрана выравнивать OSD по горизонтали (default: left).

Вертикальное положение OSD (default: top); подробности у --osd-align-x.

Цвет фона текста OSD (--osd-shadow-color — синоним); см. --sub-color.

Показывать полосу OSD (default: yes); полностью OSD отключается через --osd-level=0.

Позиция полосы OSD по горизонтали: -1 далеко влево, 0 центр, 1 далеко вправо; дробные значения допустимы.

Позиция полосы OSD по вертикали: -1 вверх, 0 центр, 1 вниз; дробные значения допустимы.

Высота полосы OSD в процентах от высоты экрана (default: 3.125).

Минимальный размер маркера на полосе OSD (default: 1.6).

Множитель размера маркеров полосы OSD относительно толщины её контура (default: 1.3).

Стиль маркеров полосы OSD: none (не рисовать), triangle (по умолчанию) или line.

Толщина контура полосы OSD в масштабированных пикселях (--osd-bar-border-size — синоним; default: 0.5).

Ширина полосы OSD в процентах от ширины экрана (default: 75; 50 — половина экрана).

Максимальный размер кэша битмапов в кэше libass для OSD в МБ; 0 — значение по умолчанию libass.

Фактор гауссова размытия границы шрифта OSD; 0 — без размытия (по умолчанию).

Оформлять текст OSD полужирным.

Стиль границы текста OSD; см. --sub-border-style.

Задать цвет, используемый для OSD; подробности у --sub-color.

Длительность сообщений OSD в миллисекундах (default: 1000).

Шрифт для OSD (default: sans-serif), например Bitstream Vera Sans или Comic Sans MS.

Поставщик шрифтов libass для OSD; значения как у --sub-font-provider (встроенные шрифты медиа OSD не использует).

Задать размер шрифта OSD в масштабированных пикселях при высоте окна 720 (default: 30).

Каталог шрифтов для OSD; подробности у --sub-fonts-dir (по умолчанию ~/.config/mpv/fonts).

Выводить времена OSD с долями секунд (миллисекундная точность): видно точный таймстамп видеокадра.

Максимальное число кэшированных глифов в кэше libass для OSD; 0 — значение по умолчанию libass.

Оформлять текст OSD курсивом.

Режим старта OSD: 0 полностью выключен (только субтитры), 1 по взаимодействию, 2 со временем, 3 с полным статусом.

Левый и правый отступ OSD в масштабированных пикселях: расстояние слева и точка переноса длинного текста (default: 16).

Верхний и нижний отступ OSD в масштабированных пикселях (default: 16).

Дополнительный вертикальный сдвиг поверх --osd-margin-y в масштабированных пикселях: для динамической правки скриптами (default: 0).

Показывать эту строку как сообщение OSD на уровне 1: видима по умолчанию, пока её ничто не перекрыло.

Как --osd-msg1, но для уровня OSD 2; пустая строка (по умолчанию) показывает время воспроизведения.

Как --osd-msg1, но для уровня OSD 3; пусто — время, длительность и прочее; используется show-progress и поиском.

Что показывать на OSD во время поиска (по умолчанию bar); настраивается префиксами osd- в input.conf.

Цвет контура шрифта OSD (--osd-border-color — синоним); см. --sub-color.

Толщина контура шрифта OSD в масштабированных пикселях; 0 отключает контур (default: 1.65).

Показывать сообщение на OSD при старте воспроизведения; свойства вроде ${filename} раскрываются.

Длительность показа --osd-playing-msg в мс; без значения держится столько, сколько --osd-duration.

Что показывать в плейлисте OSD: заголовок медиа, имя файла или оба (default: title; без media-title — только имя).

Задержка автоматической чистки событий из памяти libass для OSD; выключено по умолчанию (см. --sub-ass-prune-delay).

Множитель размера шрифта OSD, применяемый к значению --osd-font-size.

Масштабировать OSD размером окна (default: yes); выключено — все опции в реальных пикселях.

Цвет выбранного элемента в списках; см. --sub-color.

Цвет контура выбранного элемента в списках; см. --sub-color.

Смещение тени OSD в масштабированных пикселях; 0 отключает тень (default: 0).

Движок раскладки текста libass для OSD (default: complex); см. также --sub-shaper.

Горизонтальный интервал шрифта OSD и субтитров в масштабированных пикселях, добавляемый к кернингу (default: 0).

Кастомная строка статуса вместо стандартной; устарела взамен --osd-msg3 и игнорируется, если тот непустой.

Метаданные для включения в выходной файл списком ключ=значение: поддерживаемые ключи зависят от формата (MKV и FLAC почти произвольные).

Задать выходной видеокодек; полный список поддерживаемых — --ovc=help.

Опции выходного видеокодека libavcodec списком ключ=значение (например qscale=5 для mpeg4, crf=23 для libx264); --ovcopts=help — список.

Включить pan-and-scan: обрезание боков например 16:9 под 4:3 без чёрных полос; диапазон задаёт долю обрезки.

Запустить плеер в состоянии паузы.

Поднять или опустить тон аудио множителем без изменения скорости: автоматически вставляет scaletempo2.

Направление воспроизведения: forward (+) или backward (-) с обратным ходом времени.

Включить «псевдо-GUI режим», меняющий значения по умолчанию некоторых опций; предназначена самому mpv, его скриптам и .desktop.

Воспроизвести файлы согласно плейлисту: поддержанные форматы, иначе список имён построчно.

Расширения плейлистов для сопоставления в --autocreate-playlist и --directory-filter-types (список строк).

Наследовать опции отдельных файлов плейлиста его элементам при раскрытии (default: no).

Указать, с какого файла внутреннего плейлиста начинать воспроизведение (0 — первый, auto — по механизму резюме).

Предварительно открывать URL следующей записи плейлиста, когда текущая дочитана (default: no); не работает с youtube-dl и HLS.

(Windows) Приоритет процесса mpv: idle, belownormal, normal, abovenormal, high или realtime (realtime риск залипания системы).

Использовать указанные профили; --profile=help показывает список определённых.

Делать вывод консоли менее подробным: не показывать строку статуса AV: ...; полезно на медленных и битых терминалах.

Открывать все тома многотомного rar для полного списка файлов (default: no): быстрее открытие, но видны только записи первого тома.

Показывать ещё меньше сообщений и статуса, чем --quiet.

Переносить начало файла на 00:00:00 (по умолчанию yes); выключайте, если нужны реальные таймстампы.

Указать путь или URL реферера для HTTP-запросов.

(Windows) Зарегистрировать mpv как медиаплеер Windows: записи реестра для файлов и протоколов, автоплей для Blu-ray, DVD и CD-Audio.

При регистрации через --register задать пути, добавляемые в начало runtime PATH, чтобы mpv нашёл нужные DLL (список через ";").

Подстроить громкость по replaygain из метаданных: no, track или album с откатом на track.

Разрешить клиппинг при усилении (default: no); иначе mpv снижает гейн, чтобы избежать клиппинга.

Усиление в дБ, применяемое, когда тегов replaygain нет; другие replaygain-опции тогда не действуют.

Предусиление в дБ, применяемое к выбранному replaygain-усилению (default: 0).

Список опций, сбрасываемых к исходным значениям при переходе к следующему файлу (all — сбросить как можно больше).

Восстанавливать позицию воспроизведения из каталога watch_later (default: yes).

Восстанавливать позицию только если mtime файла не изменился с момента сохранения (default: no).

Транспорт RTSP при игре rtsp://-URL (default: tcp); lavf отдаёт решение libavformat.

Настроить насыщенность видеосигнала (default: 0): можно получить вывод в оттенках серого.

Всегда сохранять позицию воспроизведения при выходе и при замене плейлиста командой loadfile.

Сохранять список воспроизведённых файлов для выбора по g-h; может раскрывать приватные данные.

Функция фильтра при увеличении видео: bilinear, lanczos (по умолчанию для scale), ewa_lanczos и другие.

Сила устранения рингинга от 0.0 до 1.0 (default 0.0; профиль high-quality ставит 0.6); не влияет на bilinear и bicubic_fast.

Множитель ядра (blur factor): меньше — резче, больше — размытее; 0 использует предпочитаемый фильтром (рекомендуется 0.8-1.2).

Весовое смещение, домножаемое на отрицательные коэффициенты: 1 убирает их вовсе, ограничивая диапазон [0-1] и снижая рингинг.

Параметр 1 фильтра масштабирования: default — собственное значение фильтра; bicubic B и C, gaussian t, oversample порог.

Параметр 2 фильтра масштабирования: default — собственное значение фильтра; bicubic B и C, gaussian t, oversample порог.

Радиус настраиваемого фильтра: число от 0.5 до 16.0; по умолчанию предпочитаемый фильтром, реально может быть увеличен.

(Продвинутым пользователям) Выбрать собственную оконную функцию для ядра; список — --scale-window=help.

Параметр оконной функции из --scale-window: default — собственное значение окна (kaiser alpha 6.33, blackman alpha 0.16, gaussian t 1).

Отключать скейлер, когда изображение не масштабируется: вместо выбранного --scale используется bilinear (включено по умолчанию; --cscale не затрагивает).

Указать, на каком экране мультимониторной конфигурации показывать видео (на X11 не со всеми WM, на Wayland не работает).

Указать экран для видео по его имени из видеобэкенда; игнорируется, если --screen задан явно.

Указать AV1-энкодер libavcodec для кодирования AVIF-скриншотов (default: libaom-av1).

Опции libavcodec для выбранного энкодера AVIF (default usage=allintra,crf=0,cpu-used=8; гарантированно лишь для libaom-av1).

Задать формат пикселей для энкодера libavcodec; пусто (по умолчанию) — mpv подбирает близкий к исходному.

Хранить скриншоты в этой директории: присоединяется к имени из --screenshot-template, создаётся при первом скриншоте.

Задать тип файла для сохраняемых скриншотов: png, jpg (по умолчанию), webp, jxl или avif.

Записывать скриншоты с глубиной, близкой к исходному видео (default: yes); у PNG даёт 16 бит и огромный размер.

Уровень качества JPEG: выше — лучше (default: 90).

Писать JPEG с той же субдискретизацией хроминантности, что у видео (default: yes); иначе дефолт libjpeg.

Butteraugli distance для JPEG XL: ниже — лучше; 0.0 lossless, 1.0 примерно как JPEG q90, 0.1 «визуально без потерь» (default: 1.0).

Усилия сжатия JPEG XL: выше — обычно лучше сжатие, но больше CPU (default: 4).

Уровень сжатия PNG: выше — меньше файл и дольше запись, слишком высокий может перебивать воспроизведение (default: 7).

Фильтр перед сжатием PNG: 0 none, 1 sub, 2 up, 3 average, 4 Paeth, 5 mixed (по умолчанию, лучшее сжатие).

Использовать программный рендер скриншотов (default: no): yes берёт программный скейлер, no — текущий VO, но требует переинициализации.

Помечать скриншоты соответствующим цветовым пространством (default: yes); иначе конвертация в sRGB перед записью.

Шаблон имени файла скриншота без расширения с форматными спецификаторами (default: mpv-shot%n).

Уровень сжатия WebP: выше — сильнее сжатие и больше CPU, влияет и на качество lossy (default: 4).

Записывать WebP без потерь (default: no); тогда --screenshot-webp-quality игнорируется.

Уровень качества WebP: выше — лучше (default: 75).

Загрузить скрипт (Lua или JS) или C-плагин; несколько разделяются двоеточием.

Загрузить несколько скриптов (Lua, JS) или C-плагинов, разделённых путевым разделителем.

Продолжать работу, даже если обнаружен программный рендерер (SDL 2.0+ render VO).

Поручить SDL переключать видеорежим монитора при переходе в полноэкранный режим.

Поправить неоднозначные или рассогласованные SDR transfer functions: например контент, помеченный bt.709, обычно является захватом sRGB.

Выбрать вторичный поток субтитров: рисуется сверху экрана вместе с основными (битмапные могут налезать).

Управлять переопределениями стилей вторичных субтитров так же, как --sub-ass-override (default: strip).

Задержать вторичные субтитры на sec секунд; значение может быть отрицательным.

Задать позицию вторичных субтитров на экране, как --sub-pos но для них.

Множитель размера шрифта вторичных субтитров, как --sub-scale но для них (default: 1).

Отключить показ вторичных субтитров, оставив их выбор и декодирование.

Включить unsharp masking при значении, отличном от 0: положительные значения резче, отрицательные размывают (только --vo=gpu).

Показывать зависимые дорожки в списке (по умолчанию no): тайлы HEIF, слои IAMF, LCEVC.

(Windows и X11) Показывать mpv на панели задач (default: yes); no исключает его из Alt+Tab и списков.

Показать описание и содержимое профиля; без параметра — список всех профилей.

Воспроизводить файлы в случайном порядке, перемешивая плейлист при запуске и загрузке.

Показать субтитры потока с ID: auto — стандартные, no — отключить субтитры (--sub — синоним).

Центр сигмоидальной кривой для --sigmoid-upscaling: число от 0.0 до 1.0 (default 0.75).

Наклон сигмоидальной кривой для --sigmoid-upscaling: число от 1.0 до 20.0 (default 6.5).

При увеличении использовать сигмоидальную цветовую трансформацию против подчёркнутого рингинга (включено по умолчанию, заменяет --linear-upscaling).

Как --alang, но для субтитрных дорожек (список строк): например --slang=hu,en или --slang=pt-BR.

(Windows) Прилипать окна плеера к краям экрана.

Замедлить или ускорить воспроизведение в указанный раз (например 1.5).

Компилятор перевода GLSL в SPIR-V (важно для --gpu-api=d3d11 с --vo=gpu): auto (по умолчанию) или shaderc; опция устарела.

Пропускать sec секунд после каждого кадра; без --hr-seek прыжки по ключевым кадрам.

Искать к указанной позиции времени: формат [+|-][[hh:]mm:]ss[.ms], pp% — процент, #c — номер главы, none — сбросить.

Останавливать воспроизведение, если аудио или видео не инициализировались (default: no).

Выключать скринсейвер на старте и включать при выходе (default: yes; always — выключать совсем); нужен открытое окно.

Размер низкоуровневого байтового буфера потока между демуксером и I/O (default: 128KB); половина всегда зарезервирована для поиска назад.

Вместо воспроизведения прочитать байтовый поток файла и записать его в указанный файл, перезаписывая его.

Передать AVOptions потокам, открытым libavformat, списком ключ=значение; неизвестные опции молча игнорируются (видны при -v).

Писать прочитанные демуксером данные в указанный файл, всегда перезаписывая его; формат определяется расширением назначения.

Растягивать DVD-субтитры на анаморфном видео, чтобы шрифты выглядели нормально (выключено по умолчанию).

Растягивать DVD и прочие битмапные субтитры на весь экран, игнорируя поля видео; отображает некорректно.

is an alias for --sid.

Горизонтальное выравнивание текстовых субтитров: left, center (по умолчанию) или right; ASS только в режиме --sub-ass=no.

Вертикальное положение текстовых субтитров: top, center или bottom (по умолчанию); детали у --sub-align-x.

Родной рендер ASS-субтитров (default: yes); устарело взамен --sub-ass-override=strip; no вырезает все теги.

Размещать toptitles и ASS-субтитры в чёрных полосах, когда они доступны (default: no).

Применять выравнивание из --sub-justify к ASS-субтитрам, если --sub-ass-override не no (default: no).

Управлять применением пользовательских переопределений стилей: no, yes, scale (по умолчанию) или force.

Задержка автоматической чистки событий субтитров из памяти libass в секундах (-1 — выключено).

Как --sub-scale-with-window, но только для ASS-субтитров; может их сломать (default: no).

Переопределить отдельные параметры стиля или script info ASS списком ключ=значение (например FontName=Arial,Default.Bold=1).

Загрузить все SSA/ASS стили из файла и применять их для рендера текстовых субтитров.

Выбрать, какие сведения о видеопотоке передаются libass; кроме all это ломает совместимость с VSFilter.

Передать libass произвольное соотношение сторон вместо реального; ноль равен no, требует sub-ass-use-video-data.

Искажать цвета как (xy-)vsfilter (default: basic): историческая неосведомлённость VSFilter о цветовом пространстве.

Автозагрузка файлов субтитров по имени видео: no, exact (по умолчанию), fuzzy или all.

Расширения субтитров для сопоставления в --sub-auto и при перетаскивании файлов (список строк).

Цвет фона текста субтитров (--sub-shadow-color — синоним); см. --sub-color.

Максимальный размер кэша битмапов в кэше libass в МБ; 0 — значение по умолчанию libass.

Фактор гауссова размытия границы шрифта субтитров; 0 — без размытия (по умолчанию).

Оформлять текст субтитров полужирным.

Стиль границы субтитров: outline-and-shadow (контур плюс тень, BorderStyle=1) или opaque-box (непрозрачные коробки вокруг строк).

Отключить кэш субтитров через поиск: для битых mkv с дублирующимися полями ReadOrder (редко полезно).

Задать кодировку субтитров: uchardet определяет charset; auto (по умолчанию) включает автоопределение, без uchardet — utf-8.

Цвет нестилевых текстовых субтитров: r/g/b (или с /a альфой) компонентами 0.0-1.0; одно число — серый, gray/a задаёт альфу.

Создавать дорожку closed captions для каждого видеопотока сразу, чтобы её можно было выбрать с самого начала (default: no).

Задержать основные субтитры на sec секунд; значение может быть отрицательным.

Принудительно задать тип субтитрного демуксера для --sub-file (имя из --sub-demuxer=help).

Добавить файл субтитров к списку внешних; при однократном использовании отображается по умолчанию.

Дополнительные директории поиска субтитров по имени видео, разделённые ':' (';' в Windows); относительные — от каталога видео.

Добавить файл субтитров к списку внешних; --sid и --secondary-sid позволяют показывать два сразу.

То же, что --sub-filter-regex, но регулярными выражениями JavaScript; разделяет все его управляющие опции.

Список регулярных выражений для удаления совпавших строк текстовых субтитров (лучше --sub-filter-regex-append=<regex>).

Включать ли regex-фильтрацию субтитров вообще (default: yes); без списка regex эффекта нет.

Сначала конвертировать ASS-поле Text в plain-text, снимая теги и применяя директивы вроде \N (default: no).

Логировать отброшенные строки на уровне warning вместо verbose (default: no); удобно при отладке.

Фильтровать SDH-пометки для слабослышащих: убирать метки говорящего и текст в скобках заданных символов.

Пары символов, текст между которыми --sub-filter-sdh потенциально удаляет (список строк).

Более жёсткая SDH-фильтрация (при включённом --sub-filter-sdh): снимать метки и текст в скобках любого регистра (default: no).

Подстроить тайминги субтитров, убирая мелкие разрывы и наложения между ними.

Минимальная длительность в мс, ниже которой тайминг субтитра не правится (default: 400).

Порог в миллисекундах для правки таймингов: разрыв меньше него устраняется (default: 210).

Шрифт для субтитров, не задающих собственного (default: sans-serif); игнорируется для ASS, если не указан --sub-ass=no.

Бэкенд поставщика шрифтов libass: auto (fontconfig/CoreText/DirectWrite), fontconfig или none (отключает системные шрифты).

Задать размер шрифта субтитров в масштабированных пикселях при высоте окна 720 (default: 38).

Каталог шрифтов для mpv/libass: грузится в память перед использованием; без него по умолчанию используется каталог fonts.

Показывать только forced-события внутри потока субтитров; на текстовых субтитрах не покажет ничего (default: no).

Задать частоту кадров файла субтитров (по умолчанию fps видео); влияет только на текстовые субтитры.

Гаусово размытие битмапных субтитров (default: 0): украшает пиксельные DVD/Vobsubs, переключает на софт-скейл.

Максимальное число кэшированных глифов в кэше libass для потока субтитров; 0 — значение по умолчанию libass.

Конвертировать битмапные субтитры в оттенки серого: помогает жёлтым DVD/Vobsubs; к текстовым не применяется.

Задать диффузный белый уровень текстовых субтитров и OSD в нитах для HDR-вывода: auto или sdr (default: auto).

Тип хинтинга шрифта: none (по умолчанию), light, normal или native; может привести к съезду текста.

Оформлять текст субтитров курсивом.

Как выравнивать многострочные субтитры независимо от их позиции (default: auto — по --sub-align-x).

Передать AVOptions декодеру libavcodec для субтитров в виде списка ключ=значение.

Задать межстрочный интервал для рендера SSA/ASS.

Левый и правый отступ субтитров в масштабированных пикселях: расстояние слева и точка переноса справа (default: 19).

Верхний и нижний отступ нестилевых текстовых субтитров в масштабированных пикселях (default: 34).

Дополнительный вертикальный сдвиг поверх --sub-margin-y в масштабированных пикселях: для динамической правки скриптами (default: 0).

Цвет контура шрифта субтитров (--sub-border-color — синоним); см. --sub-color.

Толщина контура шрифта субтитров в масштабированных пикселях; 0 отключает контур (default: 1.65).

После последнего кадра продолжать обновлять субтитры по таймстампам аудио; иначе последний субтитр остаётся на экране.

Задать вертикальную позицию субтитров в % высоты экрана; 100 — исходная позиция с запасом снизу.

Множитель размера шрифта текстовых субтитров (default: 1); влияет и на ASS, аккуратнее.

Масштабировать субтитры размером окна (default: yes); выключите вместе с --sub-scale-with-window=no.

Применять --sub-scale также к типографике («знакам»), а не только к диалогам (default: no).

Делать размер шрифта субтитров относительным размеру окна (default: yes); иначе — относительно размера видео.

Смещение тени текста субтитров в масштабированных пикселях; 0 отключает тень (default: 0).

Движок раскладки текста libass: simple (Fribidi) или complex (HarfBuzz, по умолчанию).

Горизонтальный интервал шрифта субтитров в масштабированных пикселях, добавляемый к обычному кернингу (default: 0).

Умножить таймстампы событий субтитров на заданное значение: чинит скорость для покадровых форматов (только текстовые).

Растянуть длительность субтитра до начала следующего: спасает ошибочно нулевые длительности (только текст).

Размещать toptitles и текстовые субтитры в чёрных полосах, когда они доступны (default: yes).

Отключить показ субтитров, оставив их выбор и декодирование.

Поставить неявное bidi-определение ltr вместо auto ради соответствия ASS и отключить расширения libass (только plaintext).

Если ничего не подошло по языкам, выбирать полную дорожку субтитров; default — только помеченные как default.

При автовыборе предпочитать forced-дорожку субтитров при совпадении языка с аудио; always — только forced, no — никогда forced.

При автовыборе брать субтитры на языке ОС, если язык аудио другой (игнорируется при заданном --slang).

Выбирать субтитры даже тогда, когда язык аудио совпадает с предпочтительным языком субтитров (default: yes).

Разрешить до N одновременных кадров в работе, управляя задержкой кадра (default: 2; 1 — ждать показа каждого кадра).

Разрешить использование zimg, когда компонент явно это допускает (default: yes); иначе откат на libswscale и прочие --sws- опции.

Неизвестная функция libswscale (default: no): давать побитово одинаковый вывод на всех платформах, отключая оптимизации.

Гауссов фильтр размытия программного скейлера по хроминантности (chroma); см. --sws-scaler.

Горизонтальный сдвиг хроминантности программного скейлера; см. --sws-scaler.

Фильтр повышения резкости программного скейлера по хроминантности; см. --sws-scaler.

Вертикальный сдвиг хроминантности программного скейлера; см. --sws-scaler.

Разрешить ускоряющие, но ухудшающие качество оптимизации скейлера (default: no); выгодно VO drm и x11.

Гауссов фильтр размытия программного скейлера по яркости (luma); см. --sws-scaler.

Фильтр повышения резкости программного скейлера по яркости; см. --sws-scaler.

Алгоритм программного скейлера для --vf=scale и VO без аппаратного ускорения (default: bicubic; список =help).

Ставить метаданные выходного цветового пространства на swapchain (HDR passthrough и SDR): поддерживается Wayland, D3D11 и winvk, нужен gpu-next.

Какие метаданные использовать для --target-colorspace-hint: target (возможности дисплея) или source (метаданные контента); только gpu-next.

Строго соблюдать настроенное пространство swapchain с подсказкой (default: да); выключено — оно переопределяется из --target-*; только gpu-next.

Измеренный контраст дисплея вместе с --target-peak даёт чёрную точку для компенсации чёрной точки при HDR tone-mapping (auto, inf для OLED; только gpu-next).

Ограничить гамут вывода: именованный набор первооснов или 8 CIE xy значений Rx,Ry,Gx,Gy,Bx,By,Wx,Wy в диапазоне 0.0-1.0 (=help список).

Собственный LUT (.cube), применяемый к цветам перед показом на экране: подаётся нормализованный RGB после кодирования в целевое пространство (только gpu-next).

Измеренная пиковая яркость дисплея в кд/м² (нитах): ограничивает сигнал, при превышении вставляется tone mapping; параметризует обратный OOTF для HLG.

Первоосновы дисплея, под которые адаптируются цвета видео без ICC-управления: auto (по умолчанию), bt.601-525, bt.709, bt.2020 и другие.

Характеристики передачи (гамма) дисплея, под которые адаптируются цвета без ICC-управления: auto (кроме нетипичных), bt.1886, smpte-st-2084, hlg и другие.

(Windows) Включить или выключить отрисовку прогресса воспроизведения на панели задач (Windows 7+, включено).

Выбрать номер телетекст-страницы для декодирования: 1-999, 0 — все страницы субтитров (по умолчанию), -1 — все страницы.

Включить временной дизеринг: чередовать 8 паттернов по ориентации матрицы; на LCD даёт мерцание.

Как часто обновлять паттерн дизеринга при --temporal-dither: 1 (каждый кадр, по умолчанию), 2 — через кадр и т. д.

Показывать ли OSD-сообщения в консоли без видеовывода: auto (по умолчанию), no или force.

Печатать полосу прогресса под строкой статуса в терминале (выключено по умолчанию).

Настроить символы полосы терминального OSD пятью знаками: начало, пробел, индикатор, пробел, конец (default: [-+-]).

Напечатать строку после старта воспроизведения; свойства вроде ${filename} раскрываются.

Печатать кастомную строку вместо стандартной статусной во время воспроизведения; раскрывает свойства.

Задать заголовок терминала; раскрывает свойства.

Задать заголовок окна; используется для окна видео и, если возможно, для заголовка аудиопотока. Раскрывает свойства.

(Windows и X11) Показывать заголовочную полосу окна; --border имеет приоритет (по умолчанию включено).

Файл базы сертификатов центров доверия для TLS (молча не работает на старых версиях FFmpeg).

Файл с сертификатом, используемым в рукопожатии с пиром.

Файл с закрытым ключом для этого сертификата.

Проверять сертификаты пира при TLS вроде https:// (default: yes*); отключение открывает MITM-атаку, оправдано только точечно.

Алгоритм tone-mapping на целевой дисплей (HDR→SDR и сжатие гамута): auto, clip, mobius, spline, st2094-40 и другие.

Линейная экспозиция или усиление, применяемое линейной кривой (default 1.0; только gpu-next).

Насколько сильно коленная точка адаптируется к средней яркости сцены источника относительно цели в PQ: 1.0 полная адаптация, 0.0 выключена (default 0.4; gpu-next).

Запасная коленная точка, когда метаданных средней яркости сцены нет; должна лежать между minimum и maximum (default 0.4; gpu-next).

Максимальная коленная точка как доля диапазона PQ-яркости, ограничивающая автоподбор сверху (default 0.8; только gpu-next).

Минимальная коленная точка как доля диапазона PQ-яркости, ограничивающая автоподбор снизу (default 0.1; только gpu-next).

Смещение коленной точки для bt.2390: спецификация ITU-R даёт 0.5, libplacebo использует 1.0 (default 1.0; только gpu-next).

Коленная точка для наследуемых кривых mobius и gamma, работающих в линейном свете (default 0.3; только gpu-next).

Верхний предел, насколько tone-mapping вправе поднять среднюю яркость пересветом: 1.0 без буста, 2.0 — вдвое (только --vo=gpu).

Параметр tone-mapping: default — собственное значение алгоритма; clip множитель перед клиппингом, mobius точка перехода.

Коэффициент локального контраста reinhard на пике дисплея: 0.5 делает референсный белый примерно вдвое темнее точки клиппинга (default 0.5; gpu-next).

Поправка наклона сплайн-кривой вместе с --tone-mapping-slope-tuning (default 0.2; только gpu-next).

Как подстраивать наклон сплайн-кривой по разнице пиков источника и цели: сохранять наклон ближе к 1.0 при малой разнице (default 1.5; gpu-next).

Контраст сплайн-кривой: выше — круче кривая и середние тона, ниже — светлые участки (выше 1.0 контраст превосходит источник; default 0.5; gpu-next).

Показать (PQ-PQ) график активной tone-mapping LUT для отладки: жёлтый — усиление, синий — снижение яркости (только gpu-next).

Включить автовыбор дорожек (по умолчанию yes); без него дорожки не выбираются и плеер ждёт.

Линеаризовать sRGB чистой степенью 2.2 вместо стандартной кусочной функции: auto (по умолчанию, с поправками платформы) или включение; только gpu-next.

Фильтр интерполяции временной оси (кадров) при включённом --interpolation; separable-свёртки, default oversample.

Сила устранения рингинга временного фильтра от 0.0 до 1.0 (default 0.0; high-quality ставит 0.6).

Множитель ядра временного фильтра: меньше — резче, больше — размытее; 0 — предпочитаемый фильтром (рекомендуется 0.8-1.2).

Весовое смещение отрицательных коэффициентов временного фильтра: 1 убирает их вовсе, зажимая диапазон [0-1] и снижая рингинг вокруг движущихся краёв.

Параметр 1 временного фильтра: default — собственное значение фильтра (bicubic B и C, gaussian t).

Параметр 2 временного фильтра: default — собственное значение фильтра (bicubic B и C, gaussian t).

Радиус настраиваемого временного фильтра: число от 0.5 до 16.0 (default — предпочитаемый фильтром).

(Продвинутым пользователям) Оконная функция ядра временного фильтра; по умолчанию предпочитаемая фильтром.

Параметр оконной функции временного фильтра: default — собственное значение окна (kaiser, blackman, gaussian).

(Windows) Отменить регистрацию mpv как медиаплеера, убрав все изменения из --register (сам бинарник mpv не удаляется).

Не спать при выдаче видеокадров: полезно для бенчмарков вместе с --audio=no.

Загружать встроенный ICC-профиль из медиафайлов вроде PNG (default: yes); работает лишь с --icc-profile(-auto) и LittleCMS 2.

Искать файл-специфичный конфиг рядом с самим воспроизводимым файлом.

Использовать указанную строку как user agent для HTTP-вещания.

Выбрать DRM-устройство для vaapi-copy (по умолчанию /dev/dri/renderD128); в Windows — имя адаптера.

Задать приоритетный список видеодекодеров по семейству и имени (--vd=help — полный список).

Применять обрезку кодека на стадии декодера (включено по умолчанию), иначе ею занимается VO.

Считать, что видео закодировано старым багнутым x264 (build 150 или ранее); помогает при 4:4:4 без версии в битстриме.

Использовать только bit-exact алгоритмы на всех шагах декодирования (для тестов кодеков).

Проверять профиль аппаратного декодера (default: yes); no — безусловно брать высший профиль, рискуя битым выводом.

Включить direct rendering (default: auto): декодирование прямо в GPU-память; gpu требует OpenGL 4.4+ или Vulkan.

(MPEG-1/2 и H.264) Включить не соответствующие спецификации ускорения: упрощённые IDCT и motion compensation.

Включить применение film grain на GPU: auto, gpu или cpu; ускоряет декодирование и снижает число копий кадров.

Задать режим пропуска кадров, используемый с --framedrop (значения — как у skiploopfilter).

Передать AVOptions декодеру libavcodec списком ключ=значение (например --vd-lavc-o=debug=pict); полный список — в мануале FFmpeg.

Показывать даже битые и повреждённые кадры (default: no).

Пропускать декодирование кадров целиком: большое ускорение, но рваное движение и артефакты.

(MPEG-1/2/4) Пропустить шаг IDCT: сильно ухудшает качество (значения skip — как у skiploopfilter).

(H.264, HEVC) Пропускать loop filter (deblocking) при декодировании: большой выигрыш в скорости при малой потере качества.

Число потоков декодирования; 0 — автоопределение по ядрам машины вплоть до 16 (по умолчанию 0).

Запустить видеодекодер в отдельном потоке с очередью кадров (default: no); почти бессмысленно, libavcodec уже многопоточен.

Максимальный приблизительный размер очереди видеодекодера: при превышении декодирование останавливается (суффиксы KiB, MiB).

Максимальное число кадров в очереди видеодекодера (превышение примерно на один кадр возможно).

Максимальное число секунд медиа в очереди видеодекодера; 0 — без ограничения (превышение примерно на 2 кадра).

Напечатать строку версии и выйти.

Задать список видеофильтров для применения к видеопотоку (--vf-add, --vf-pre, --vf-clr правят существующий).

Добавить фильтр, данный аргументами, в конец списка фильтров (несколько сразу всё ещё можно, но устарело).

Добавить фильтр, данный аргументами, в конец списка фильтров.

Полностью очистить список видеофильтров.

Добавить указанные фильтры в начало списка фильтров (несколько сразу всё ещё можно, но устарело).

Удалить фильтр из списка: по полному виду как он был добавлен или по метке через @; метка имеет приоритет при сравнении.

Добавить указанный фильтр, если его ещё нет, или убрать, если он уже есть; сравнение как у --vf-remove.

Выбрать видеодорожку: auto — стандартная, no — отключить видео (--video — синоним).

is an alias for --vid.

Выровнять видимую часть видео по X: -1 — левый край, 0 — центр (по умолчанию), 1 — правый.

Выровнять видимую часть видео по Y: -1 — верх, 0 — центр (по умолчанию), 1 — низ.

Задать способ определения соотношения сторон: container (строго из контейнера) или bitstream (из битстрима).

Переопределить соотношение сторон видео при неверных или отсутствующих данных: no (метод из --video-aspect-method), 0, -1 или число.

Сколько диапазонов ключевых кадров декодировать за раз при обратном ходе видео (default: 1).

Число перекрывающихся диапазонов ключевых кадров для обратного декодирования видео (default: auto).

Обрезать видео размером w×h со смещением x,y до анаморфного растягивания; работает с hwdec.

Расширения видеофайлов для сопоставления в --autocreate-playlist и --directory-filter-types (список строк).

Включить приёмы, снижающие задержку видео на 1-2 кадра; ломает интерполяцию и прочие опции (default: no).

Включить рендер OSD на окон видео (default: yes); полезно, когда предпочтительнее OSD в терминале.

Задать уровни RGB при конверсии YUV→RGB: limited (studio) или full, чтобы не ломать чёрный и белый.

Сместить прямоугольник видео по X на долю от размера отмасштабированного видео (например -0.1).

Сместить прямоугольник видео по Y на долю от размера отмасштабированного видео (например -0.1).

Вести себя так, будто --video-align-x и --video-align-y равны 0, когда видео становится меньше окна (default: no).

Максимальный объём буфера (в байтах) для обратного декодирования видео; растите при overflow.

Повернуть видео по часовой на указанные градусы; no — никогда не поворачивать даже при метаданных.

Умножить отображаемый размер видео по X на заданное значение (default: 1.0).

Умножить отображаемый размер видео по Y на заданное значение (default: 1.0).

Как плеер синхронизирует аудио и видео: display-resample и прочие display-* режимы под частоту обновления дисплея.

Максимальное дополнительное отличие скорости в процентах, применяемое к аудио при --video-sync=display-*, когда расхождение A/V велико (default 0.125).

Максимальный множитель, при котором FPS видео подгоняется к FPS дисплея (default 5): 1 заставляет целочисленное кратное.

Максимальное отличие скорости в процентах для --video-sync=display-* (default 1); вне диапазона display sync отключается.

За сколько до целевого времени показа рендерить кадр (default 0.050): VO ждёт блокирующе и потом swap'ит кадр.

Отключить масштабирование видео: полосы сверху или обрезка, downscale-big — подгонка под окно.

Изменить коэффициент отображения видео на величину в логарифме по 2 (1 — вдвое больше, -2 — вчетверо меньше).

Как --alang и --slang, но для видеодорожек; список строк.

Указать бэкенд видеовывода (см. VIDEO OUTPUT DRIVERS).

Обычно размеры текстур выровнены до 16; с этой опцией текстура видео имеет ровно размер самого видео (отладочная).

Всегда ресайзить backbuffer до размера окна; отладочная опция, может быть удалена или ломаться.

Всегда принуждать текстуры к степени двойки, даже когда устройство поддерживает non-power-of-2 размеры.

Использовать D3DSWAPEFFECT_DISCARD, что может быть быстрее (а может и медленнее: очистка каждый кадр).

(Windows) MMCSS-профиль для потока видеорендера (default: Playback).

(Устарело, см. vdpaupp.) Временные деинтерлейсеры работают и по яркости, и по хроминантности (по умолчанию); no-chroma-deint быстрее.

(Устарело.) Пытаться определить активный композитный WM и отключать коррекцию тайминга, поскольку VDPAU под ним врёт о времени кадров.

Никогда не принимать RGBA-вход: mpv вставит фильтр конверсии в YUV перед VO; полезно для YUV-only возможностей (эквалайзер, деинтерлейс).

(Устарело, см. vdpaupp.) Пытаться применить обратный телекин; требует адаптивного по движению временного деинтерлейсинга.

Задать стартовую громкость: 0 — тишина, 100 без изменения; отрицательные считаются нулём (внутренний микшер).

Задать усиление громкости в дБ поверх прочих настроек громкости.

Задать верх границы диапазона усиления в дБ (по умолчанию 12 дБ).

Задать нижнюю границу диапазона усиления в дБ (по умолчанию -96 дБ).

Задать максимальное усиление в процентах (default: 130 — примерно вдвое выше обычного уровня).

Использовать асинхронные compute-очереди Vulkan: вне очереди планировать compute вместе с графикой; выгодно не на всех GPU.

Использовать асинхронные transfer-очереди Vulkan для загрузки текстур и blit параллельно рендеру (включено по умолчанию, относительно безопасно).

Имя или UUID Vulkan-устройства для рендера и презентации; список — --vulkan-device=help; без него первое перечисленное.

Индекс дисплея на выбранном Vulkan-устройстве для презентации в контексте displayvk; список — =help.

Индекс режима дисплея выбранного Vulkan-дисплея для контекста displayvk; список — =help; без него первый перечисленный.

Индекс плоскости на выбранном Vulkan-устройстве для презентации в контексте displayvk; список — =help.

Число VkQueue для рендера (default: 1): теоретически больше даёт параллелизм кадров при --swapchain-depth > 1, но может замедлить.

Режим презентации swapchain Vulkan (как --opengl-swapinterval): auto, fifo, fifo-relaxed, mailbox или immediate.

Путь хранения истории просмотра (default: state/watch_history.jsonl): по JSON-объекту на строку с полями time, path, title.

Задать директорию для временных файлов «смотреть позже» (по умолчанию watch_later в state-каталоге).

Список опций, сохраняемых в файлах «смотреть позже» при их изменении и восстанавливаемых в следующий раз.

Задать client app id для Wayland-методов видеовывода (default: mpv).

Подписаться ли на configure bounds от композитора, ограничивающий начальный размер окна (default: auto — игнорируется при autofit/geometry).

Посылать композитору подсказку content-type: auto (по умолчанию) переключается между photo, video и none по эвристикам.

Размер кромки в пикселях (default: 16) для запуска клиентского изменения размера мышью или планшетом; только без серверных украшений.

Размер кромки в пикселях (default: 32) для запуска клиентского изменения размера touch-событиями; только без серверных украшений.

Использовать ли внутренний vsync mpv для Wayland-вывода (default: auto: выключается при поддержке fifo и presentation time v2 на Vulkan).

Использовать протокол presentation time Wayland для более точного показа кадров, если композитор поддерживает (default: yes; нужен --video-sync=display-...).

Задать имя сессии Wayland для восстановления окна (default: не задано); пустое значение отключает управление сессией.

Присоединиться к существующему окну по его ID: видео масштабируется под него с чёрными полосами при другом aspect.

(Windows) Поведение окна при захвате экрана: default, excludefromcapture (полностью исключено из записи экрана) или monitor (затемнение окна).

(Windows) Предпочтение скругления углов окна: default, donotround, round или roundsmall.

Перемещать окно кликом по нему с движением мыши (default: yes).

Развернуть окно видео на весь экран или вернуть прежний размер, если VO поддерживает; замечания как у --window-minimized.

Минимизировать или развернуть окно видео, если текущий VO это поддерживает; состояние может не отслеживаться.

Изменить размер окна видео во столько раз (или долей) от размера видео; применяется раньше --autofit (например 0.5).

Дописывать имя файла комментарием в конфиг watch later; может раскрывать приватные данные.

Просить композитор анредиректить окно mpv через _NET_WM_BYPASS_COMPOSITOR: fs-only (по умолчанию), no, never или yes.

Задать имя экземпляра окна для X11-методов видеовывода.

(X11) Управлять использованием функций протокола NetWM: auto, yes (форсировать) или no.

Использовать статистику презентации из расширения X11 present (default: auto); важно для --video-sync=display-...

Ставить ли заголовок окна, когда mpv встроен на X11 (default: no).

Включить hook-скрипт youtube-dl: играть видео по URL со многих стриминговых сайтов (нужен свежий youtube-dl; default: yes).

Строка выбора формата, передаваемая youtube-dl напрямую (по умолчанию bestvideo*+bestaudio/best).

Передать произвольные опции youtube-dl парой ключ=значение; опции без аргумента обязаны содержать '='; прокси тоже здесь.

Задать дизеринг zimg (default: random).

Разрешить оптимизации zimg, ускоряющие работу но снижающие качество (default: yes): например упрощение гамма-преобразований.

Используемый zimg-скейлер по яркости (default: lanczos).

То же, что --zimg-scaler, но для интерполяции хроминантности (default: bilinear).

То же, что --zimg-scaler-param-a и --zimg-scaler-param-b, но для хроминантности.

То же, что --zimg-scaler-param-a и --zimg-scaler-param-b, но для хроминантности.

Параметр a скейлера zimg: default — собственное значение; для lanczos число taps, для bicubic параметр b.

Параметр b скейлера zimg: default — собственное значение; для lanczos число taps, для bicubic параметр c.

Максимальное число потоков масштабирования (default: auto — логические ядра машины); 1 отключает многопоточность.

Напечатать строку версии и выйти.

Простой способ добавить один элемент в список опций без необходимости экранирования.

Повышать уровень подробности вывода на один уровень за каждое -v в командной строке.

mpv

Построчное объяснение

mpv (command)
Медиаплеер на базе MPlayer с аппаратным ускорением и гибкими фильтрами.

История