win32/smtc: add an option to skip fetching file thumbnails (GetThumbnailAsync)
Los mantenedores suelen responder en 1 día
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 4/5
- Tiempo estimado
- 3-5 días
- Aptitud para principiantes
- 55/100
Línea de trabajo
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.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
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
- Lenguaje dominante
- C
- Estrellas
- 38.2k
- Forks
- 3.7k
- Merge medio
- 1 d 13 h
- PR fusionados (30 d)
- 76
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Tiene una plantilla de pull request
- Sin guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de mpv-player/mpv
-
meta:feature-request
Dificultad 2/5 1-3 horas Aptitud para principiantes 66/100
mpv-player/mpv#18855 · 2 comentarios ·
Los mantenedores suelen responder en 1 día
-
meta:feature-request
Dificultad 2/5 1-3 horas Aptitud para principiantes 70/100
mpv-player/mpv#18683 · 4 comentarios ·
Los mantenedores suelen responder en 1 día
-
Subtitle delay value displays "-0ms"Quizá libre de nuevo Un pull request para esta issue se cerró sin fusionarse. Abiertoos:linux
Dificultad 2/5 1-3 horas Aptitud para principiantes 66/100
mpv-player/mpv#18649 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
meta:feature-request
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
mpv-player/mpv#18464 ·
Los mantenedores suelen responder en 1 día
-
Keyboard shortcut next and previous secondary subtitle filePosiblemente ocupada @ravarnax la tomó hace 225 días. Abiertometa:feature-request
Dificultad 2/5 1-3 horas Aptitud para principiantes 64/100
mpv-player/mpv#17693 · 5 comentarios · 1 reacción ·
Los mantenedores suelen responder en 1 día
Todos los issues de mpv-player/mpv
Issues similares
-
bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 84/100
Los mantenedores suelen responder en 1 día
-
enhancement
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
ChupathingyCE/chupathingyce#1550 ·
Los mantenedores suelen responder en 1 día
-
[BUG] SWAPDB sends no invalidation to CLIENT TRACKING clientsPosiblemente ocupada Un pull request vinculado a esta issue está abierto o ya se fusionó. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 83/100
redis/redis#16302 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
slice
Dificultad 2/5 1-3 horas Aptitud para principiantes 73/100
Life-Framework/Life-Framework#3878 ·
Los mantenedores suelen responder en 1 día
-
`sha256()` returns a wrong hash when libsql-ffi is built with gcc 11 or laterPosiblemente ocupada @colinhacks la tomó hoy. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
tursodatabase/libsql#2333 ·
Los mantenedores suelen responder en 11 días