- Find targeted fixes for common mpv playback problems.
- Browse video, audio, subtitle, streaming, and configuration guides.
- Identify the relevant mpv troubleshooting guide quickly.
- Video Playback and Performance
- Video Output, Hardware Decoding, and Image Quality
- Audio Output, Sync, and Track Selection
- Subtitle and Caption Problems
- Configuration, Profiles, and Command-Line Options
- Scripts, IPC, and Build Features
- Online Video, Streams, and Network Access
- Files, Playlists, Discs, and Playback Continuity
- Windows, Interface, and Application Behavior
Use this troubleshooting hub to find focused fixes for mpv playback, video, audio, subtitle, configuration, streaming, interface, and file-handling problems.
Start with free Canva bundles
Browse the freebies page to claim ready-to-use Canva bundles, then get 25% off your first premium bundle after you sign up.
Free to claim. Canva-ready. Instant access.
1. Video Playback and Performance
These guides cover lag, stuttering, freezes, resource usage, synchronization, and other video playback problems.
- mpv 4K Video Lagging
- mpv AV1 Video Stuttering
- mpv Dropped Frames and Stuttering
- mpv HEVC Video Stuttering
- mpv Video Freezes While Audio Continues
- mpv Fullscreen Freezes
- mpv High CPU Usage
- mpv High GPU Usage
- mpv Display Sync Not Working
- mpv Interpolation Not Working
- mpv Video Tearing
- mpv GLSL Shader Causes Lag
2. Video Output, Hardware Decoding, and Image Quality
Use these guides for rendering failures, hardware acceleration issues, incorrect colors, HDR problems, and display geometry.
- mpv Aspect Ratio Wrong
- mpv Black Screen While Audio Works
- mpv Colors Washed Out
- mpv D3D11VA Not Working
- mpv GPU API Selection Wrong
- mpv Green Screen Video
- mpv Hardware Decoding Not Working
- mpv HDR Too Dark
- mpv HDR Washed Out
- mpv hwdec Black Screen
- mpv NVDEC Not Working
- mpv OpenGL Output Not Working
- mpv Screenshot Wrong Colors
- mpv Screenshots Black
- mpv Shader Not Loading
- mpv Tone Mapping Looks Wrong
- mpv VAAPI hwdec Not Working
- mpv Video Output Driver Not Found
- mpv Video Rotated Wrong
- mpv VideoToolbox Not Working on macOS
- mpv Vulkan Output Not Working
3. Audio Output, Sync, and Track Selection
This section addresses missing sound, output devices, timing, channel layouts, volume behavior, and audio track selection.
- mpv Audio Channels Missing
- mpv Audio Crackling on Windows
- mpv Audio Delay
- mpv Audio Device Not Switching
- mpv Audio File Not Loading
- mpv Audio Out of Sync
- mpv Audio Output Initialization Failed
- mpv Audio Speed or Pitch Wrong
- mpv Bluetooth Audio Delay
- mpv External Audio Out of Sync
- mpv Language Auto Selection Wrong
- mpv Multiple Audio Tracks Not Switching
- mpv No Audio
- mpv PipeWire Audio Not Working
- mpv Playlist Audio Track Choice Not Remembered
- mpv PulseAudio Volume Behavior Changed
- mpv ReplayGain Not Working
- mpv Surround Sound Downmix Wrong
- mpv Tracks Not Auto Selected
- mpv Volume Normalization Not Working
- mpv Volume Too Low
- mpv WASAPI Exclusive No Sound
4. Subtitle and Caption Problems
Find fixes for missing, delayed, incorrectly styled, poorly positioned, or unavailable subtitles and captions.
- mpv ASS Subtitles Lagging Playback
- mpv ASS Subtitle Style Ignored
- mpv Captions Not Available for Online Video
- mpv Embedded Subtitles Not Selecting
- mpv External Subtitles Not Loading
- mpv Fontconfig Subtitle Font Missing
- mpv Forced Subtitles Not Playing
- mpv MKV Subtitles Not in Track Menu
- mpv PGS Subtitles Not Rendering
- mpv Secondary Subtitles Not Showing
- mpv Subtitle Seek Not Working
- mpv Subtitle Delay Keeps Resetting
- mpv Subtitle Download Script Not Working
- mpv Subtitle File Auto Detection Not Working
- mpv Subtitle Font Too Small
- mpv Subtitle Track Names Missing
- mpv Subtitles Have Garbled Encoding
- mpv Subtitles Have Black Boxes
- mpv Subtitles Not Showing
- mpv Subtitles Out of Sync
- mpv Subtitles Overlapping the OSD
- mpv Subtitles Too Low or High
5. Configuration, Profiles, and Command-Line Options
These guides focus on configuration discovery, syntax, profiles, command-line behavior, and input settings.
- mpv Auto Profile Not Triggering
- mpv Command-Line Option Ignored
- mpv Conditional Profile Error
- mpv Config File Ignored
- mpv Directory Config Not Loading
- mpv File-Specific Config Not Loading
- mpv input.conf Ignored
- mpv Keybindings Not Working
- mpv mpv.conf Syntax Error
- mpv no-config Disables Scripts
- mpv osc.conf Ignored
- mpv Portable Config Not Loading
- mpv Profile Not Applying
- mpv Windows Config Path Wrong
6. Scripts, IPC, and Build Features
Use this section for Lua scripts, script options, IPC communication, and features missing from an mpv build.
- mpv Install or Build Missing libass
- mpv Install or Build Missing Lua
- mpv IPC Server Not Working
- mpv JSON IPC Commands Failing
- mpv libarchive Support Missing
- mpv Lua Script Error
- mpv Script Not Loading
- mpv Script Options Ignored
- mpv ytdl Hook Script Not Loading
7. Online Video, Streams, and Network Access
These resources address buffering, proxies, authentication, yt-dlp integration, streaming sites, and online playlists.
- mpv Cache Settings Not Working
- mpv Cookies Not Working with yt-dlp
- mpv HLS Stream Buffering
- mpv HTTPS Proxy Not Working
- mpv Network Stream Stuttering
- mpv Streaming Site Login Not Working
- mpv Twitch Stream Not Playing
- mpv YouTube Playlist Not Playing
- mpv YouTube Quality Selection Not Working
- mpv YouTube URL Not Playing
- mpv yt-dlp Not Found
8. Files, Playlists, Discs, and Playback Continuity
Browse these fixes when mpv cannot open particular paths, archives, discs, playlists, or subsequent media files.
- mpv Autoplay Next File in Folder Not Working
- mpv Blu-ray Menu Not Working
- mpv DVD Menu Not Working
- mpv File Path with Spaces Not Playing
- mpv Filename Starting with a Dash Not Playing
- mpv M3U Playlist Not Loading
- mpv Playlist Next File Not Playing
- mpv RAR Archive Not Playing
- mpv Save Position on Quit Not Working
- mpv Watch History Not Saving
- mpv Watch Later Resume Not Working
9. Windows, Interface, and Application Behavior
This section covers launching mpv, console and window behavior, system integration, OSD controls, and application instances.
