Audio and Video Filters - iina/iina GitHub Wiki

You can add arbitrary video and audio filters in Video > Video filters and Audio > Audio Filters.

Please refer to mpv's documentation for filter format:

• https://mpv.io/manual/stable/#audio-filters
• https://mpv.io/manual/stable/#video-filters

Most filters in FFmpeg are available directly through mpv. Run mpv --af=help or mpv --vf=help to list them.

See mpv documentation for filter parameter syntax. If an mpv filter has multiple parameters, then in IINA they all go into the filter's "value" and are separated by :, just like they are on the command line. For example, you might call mpv with the scaletempo audio filter like this:

mpv --af=scaletempo=stride=8:overlap=1:search=10 some-file.mkv

To use that same audio filter in IINA, create a new audio filter with the name scaletempo and the value stride=8:overlap=1:search=10. In this example stride, overlap, and search are all parameters of the scaletempo filter. Here's a screenshot of that for reference:

NOTE to use one of the FFmpeg Filters choose Custom (FFmpeg) instead of Custom (mpv).

The above example is old, but still valid as far as how to add a filter. The scaletempo filter is still available, however the newer scaletempo2 filter is preferred:

scaletempo2[=option1:option2:...]

Scales audio tempo without altering pitch. The algorithm is ported from chromium and uses the Waveform Similarity Overlap-and-add (WSOLA) method. It seems to achieves higher audio quality than scaletempo, and rubberband R2 engine, or engine=faster.

Also note that normally you will not need to add a scaletempo2 audio filter because the mpv audio-pitch-correction option defaults to yes and causes this filter to be automatically inserted:

--audio-pitch-correction=<yes|no>

If this is enabled (default), playing with a speed different from normal automatically inserts the scaletempo2 audio filter.

Some features in IINA (crop, flip and audio EQ) are achieved using mpv filters. Those filters should have names begin with iina. You are not supposed to change them.

IINA enables hardware decoding by default. However, most video filter based features will not work properly in this situation.

• Clipping may clip the video from top left corner, instead of center.
• Flip and mirror will not work.

Some of them will be reflected in UI (ticks remain unchecked), but some won't. To use these features properly, disable hardware decoding in Preference > Codec.