Vapoursynth RemoveSpotsMCX: Difference between revisions
New filter page (via create-page on MediaWiki MCP Server) |
Update to current Hybrid behaviour; code as <pre> (via update-page on MediaWiki MCP Server) |
||
| Line 26: | Line 26: | ||
== Example == | == Example == | ||
Default settings on a 10-bit YUV 4:2:0 source (machine with a discrete GPU): | Default settings on a 10-bit YUV 4:2:0 source (machine with a discrete GPU): | ||
< | <pre> | ||
# spot/dirt removal using RemoveSpotsMCX | # spot/dirt removal using RemoveSpotsMCX | ||
clip = artifacts.RemoveSpotsMCX(clip, tools={'mv': 'mvgpu', 'rg': 'zsmooth', 'removedirt': 'removedirt'}) | clip = artifacts.RemoveSpotsMCX(clip, tools={'mv': 'mvgpu', 'rg': 'zsmooth', 'removedirt': 'removedirt'}) | ||
</ | </pre> | ||
== How Hybrid calls it == | == How Hybrid calls it == | ||
Latest revision as of 09:52, 16 November 2026
RemoveSpotsMCX is the motion-compensated, multi-pass form of RemoveSpots: it removes dirt, spots and impulse noise that show up on one frame only. It cleans more and copes better with motion, but is much slower and can soften fine detail.
Filtering → Vapoursynth → Artifacts

What it does
For each frame a motion-compensated previous and next frame are built. The three frames are put in a row, RemoveSpots runs on this sequence several times, and only the source frames are kept. Besides film restoration and analog captures it can serve as a prefilter before temporal denoisers.
Settings
| Control | Parameter | Range / values | Hybrid default | Meaning |
|---|---|---|---|---|
| Limit | limit | 1 – 24 | 6 | Repair mode used to limit the cleaned result against the source. The modes are different clipping rules, not a strength scale. |
| Runs | runs | 1 – 10 | 3 | Number of RemoveSpots passes on the compensated sequence. |
| Tools: MV | – | mvgpu, mvutensils, mv | mvgpu with a discrete GPU, else mvutensils | Motion vector implementation. |
| Tools: RG | – | zsmooth, neo_smo | zsmooth | Clense/Repair implementation. |
| Tools: RemoveDirt | – | removedirt | removedirt | RemoveDirt plugin (scene change selection and motion detection). |
Example
Default settings on a 10-bit YUV 4:2:0 source (machine with a discrete GPU):
# spot/dirt removal using RemoveSpotsMCX
clip = artifacts.RemoveSpotsMCX(clip, tools={'mv': 'mvgpu', 'rg': 'zsmooth', 'removedirt': 'removedirt'})
How Hybrid calls it
- RemoveSpotsMCX works on 8-, 10-, 12- and 16-bit integer YUV; other formats are converted first.
- Limit and Runs are only written when they differ from the defaults, which equal the script's. Both are counts or mode numbers, so nothing is scaled. The Tools choice is always written.
- All planes are processed. The motion search uses fixed values (pel 2, block size 8, overlap 4, true motion).
- RemoveSpotsMCX also offers the common options (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick).
Background
The script
The function is a VapourSynth port of a script by Didée from the Doom9 forum. Its default Repair mode is 6 rather than RemoveSpots' 16, because the several passes and the motion compensation already clean a lot. It is meant for difficult sources where plain RemoveSpots is not enough.
Sources
- zsmooth README
- RemoveDirt plugin
- VapoursynthScriptsInHybrid (the script collection Hybrid uses)
- Hybrid's tooltips