win32/smtc: add an option to skip fetching file thumbnails (GetThumbnailAsync)

Open
#18,756 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
55/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Active
Tech stack
c
Domain
desktop

Research direction

Read osdep/win32/smtc.cpp, especially update_thumbnail() around lines 187–260, to trace when GetThumbnailAsync runs and how existing media controls options are handled. Check the related option and property definitions and their tests or documentation before estimating the change. Done means the option prevents shell thumbnail fetching while the rest of SMTC controls continue working; the issue does not name a test or specify runtime property behavior.

Written by the indexing model from the issue text.

Description

meta:feature-request
Expected behavior of the wanted feature

Add an option that prevents SMTC from fetching a thumbnail from the Windows shell when the
currently playing file has no embedded cover art.

What happens today: on Windows, update_thumbnail() in osdep/win32/smtc.cpp (~lines 187-260)
calls StorageFile::GetThumbnailAsync(ThumbnailMode::SingleItem, 240) whenever metadata is
published and the file has no embedded cover. That call makes the Windows shell generate a
thumbnail for the file, which is real work inside explorer.exe.

Measured on Windows 10 21H2 (19044), mpv 0.41.0-920 (shinchiro 2026-08-08), plain MP3 without
an APIC frame, one fresh mpv process per playback:

  • explorer.exe GUI objects: +9 to +37 (GDI), +4 to +31 (USER), 0.60-0.66 s after the process
    starts, then back to baseline; the desktop icons visibly repaint.
  • Same audio but with an embedded cover (ID3v2.3 APIC injected into the file, audio untouched):
    0 objects, 0 repaints, 5 out of 5 runs.
    The attached log shows "Generating thumbnail for: ..." three times within 35 ms.

Why it matters: front-ends that spawn one mpv process per track (cue/layer players, radio
automation) trigger that shell work on every playback, and on Windows the desktop repaint is
visible to the operator. The only workaround today is --media-controls=no, which disables SMTC
completely and introduces an unrelated side effect: with SMTC off, the Windows shell keeps the
"busy" cursor for about 5 s for every new audio session (also measured, reproducible with plain
mpv.exe against a non-default endpoint, so that part is shell behaviour, not mpv's).

Proposal: add an option, e.g. --media-controls-thumbnail=no (or a sub-option of
--media-controls), that skips the GetThumbnailAsync call while keeping the rest of SMTC
(title/artist/transport controls) working.

Alternative behavior of the wanted feature

If adding an option is not wanted, simply do not request a thumbnail when the file has no
embedded cover art: the shell then generates a generic thumbnail of the file, which in the SMTC
media card is barely distinguishable from the default application icon (purely cosmetic loss).

Bonus: expose it as a runtime property (like the existing --media-controls toggle) so a
front-end can turn it on/off without restarting mpv.

Log File

Attached: mpv-smtc-thumbnail.log

Generated with:
mpv.exe --no-video --volume=0 --length=3
--msg-level=all=no,SystemMediaTransportControls=trace,cplayer=info
--log-file=mpv-smtc-thumbnail.log "file-without-cover.mp3"

Relevant lines:
[0.022][t][SystemMediaTransportControls] Generating thumbnail for:
[0.051][t][SystemMediaTransportControls] Generating thumbnail for:
[0.057][t][SystemMediaTransportControls] Generating thumbnail for:

Sample Files

mpv-smtc-thumbnail.log

Dominant language
C
Stars
38.2k
Forks
3.7k
Avg merge
1d 13h
Merged PRs (30d)
76

Getting set up

  • No Dockerfile or Docker Compose file
  • Has a pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from mpv-player/mpv

All issues in mpv-player/mpv

Similar issues

More C issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.