win32/smtc: add an option to skip fetching file thumbnails (GetThumbnailAsync)
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 55/100
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
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
- 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
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from mpv-player/mpv
-
meta:feature-request
Difficulty 2/5 1-3 hours Newbie friendliness 66/100
mpv-player/mpv#18855 · 2 comments ·
Maintainers usually reply within 1 day
-
meta:feature-request
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
mpv-player/mpv#18683 · 4 comments ·
Maintainers usually reply within 1 day
-
Subtitle delay value displays "-0ms"May be free again A pull request for this issue was closed without being merged. Openos:linux
Difficulty 2/5 1-3 hours Newbie friendliness 66/100
mpv-player/mpv#18649 · 1 comment ·
Maintainers usually reply within 1 day
-
meta:feature-request
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
mpv-player/mpv#18464 ·
Maintainers usually reply within 1 day
-
Keyboard shortcut next and previous secondary subtitle filePossibly taken @ravarnax claimed this 225 days ago. Openmeta:feature-request
Difficulty 2/5 1-3 hours Newbie friendliness 64/100
mpv-player/mpv#17693 · 5 comments · 1 reaction ·
Maintainers usually reply within 1 day
Similar issues
-
`sha256()` returns a wrong hash when libsql-ffi is built with gcc 11 or laterPossibly taken @colinhacks claimed this today. Open
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
tursodatabase/libsql#2333 ·
Maintainers usually reply within 11 days
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
OpenPrinting/cups#1826 ·
Maintainers usually reply within 1 day
-
Backport to 3.0 advertises a suffix that does not existPossibly taken A pull request linked to this issue is open or already merged. Open
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
389ds/389-ds-base#8152 ·
Maintainers usually reply within 2 days
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
RetroAchievements/rcheevos#580 · 1 comment ·
Maintainers usually reply within 5 days