VLC Fix Guide

VLC Black Screen in Fullscreen on macOS — Fixes

System-Specific Issues Last updated: Applies to: macOS 12+ · Intel & Apple Silicon · VLC 3.0.x

Fullscreen is where macOS VLC issues surface: the window works fine, but switching to fullscreen produces a black frame (audio still plays) or a window that never expands. The causes are macOS-specific — the native fullscreen Space system, the VideoToolbox output, and GPU driver quirks on Apple Silicon. This guide covers the fixes in the order that resolves the most cases.

Why does this happen?

  • VideoToolbox output glitches — the default macOS video output can fail to redraw when the window transitions to a fullscreen Space on some GPU/driver combos.
  • Fullscreen Space conflicts — macOS native fullscreen (green button) plus "Displays have separate Spaces" can leave VLC’s video layer behind.
  • Apple Silicon driver bugs — early M1/M2 driver generations had fullscreen redraw issues that later macOS updates fixed.
  • Corrupted preferences — a stale fullscreen/output setting from an older VLC version breaks the transition.
  • Hardware acceleration stalls — the GPU decoder hangs when the display mode changes, leaving the video plane black.

How to fix it

Fix 1Force the video output to OpenGL (or vice versa)

The classic macOS fullscreen fix

  1. Go to Tools > Preferences > Video > Output.

    Output options open.

  2. Set Output to "OpenGL video output" (or back to "VideoToolbox" if it was OpenGL).

    The output module changes.

  3. Save, restart VLC, and try fullscreen again.

    Fullscreen displays correctly.

NoteToggling the module breaks a stale rendering state — even if you end up switching back, the reset often fixes the transition.

Fix 2Use the non-native fullscreen mode

Bypasses macOS Space issues entirely

  1. Play the video and press Cmd+F (VLC’s own fullscreen) instead of the green traffic-light button.

    VLC enters its own fullscreen.

  2. If Cmd+F also fails, double-click the video area — this toggles "Always on top fullscreen" in some VLC versions.

    Fullscreen toggles.

  3. Disable the macOS preference System Settings > Desktop & Dock > "Displays have separate Spaces" if you use multiple monitors and see ghosting.

    Spaces behave predictably.

NoteCmd+F uses VLC’s window-level fullscreen, which does not create a new macOS Space — avoiding the transition bug.

Fix 3Disable hardware-accelerated decoding

Fixes black/green screen, pixelation and stuttering in most cases

  1. Open VLC and go to Tools > Preferences (or press Ctrl+P on Windows/Linux, Cmd+, on macOS).

    The Preferences window opens.

  2. Click the Input / Codecs tab on the left.

    Codec-related settings are shown.

  3. Find "Hardware-accelerated decoding" and set it to Disable.

    The dropdown now reads "Disable".

  4. Click Save, then fully restart VLC (close every VLC window, not just the video).

    VLC restarts with software decoding.

  5. Play the problematic file again.

    If the issue is gone, the GPU decoder was the culprit.

NoteA hung decoder during display-mode change is a common black-fullscreen cause on Apple Silicon.

Fix 4Update your graphics driver

Fixes black screen, green artifacts and crashes caused by driver bugs

  1. Press Win+X and open Device Manager (or System Settings > Display on macOS).

    The device list opens.

  2. Expand "Display adapters" and note your GPU model (NVIDIA, AMD or Intel).

    Your GPU is identified.

  3. Download the newest driver from the GPU vendor site (nvidia.com, amd.com or intel.com) — or use Windows Update.

    The driver package is ready.

  4. Install, restart your PC, then try VLC again.

    The system runs the new driver.

NoteOEM laptops sometimes block vendor drivers; in that case use the driver page from your laptop manufacturer instead.

Fix 5Reset VLC preferences to defaults

Clears corrupted settings that cause crashes, black screens and audio issues

  1. Close VLC completely.

    No VLC process is running.

  2. Open a command prompt (Win+R → cmd) or terminal.

    A command line is available.

  3. Run: vlc --reset-config (Windows/Linux) — on macOS delete ~/Library/Preferences/org.videolan.vlc instead.

    VLC preferences are restored to defaults.

  4. Launch VLC and re-apply only the settings you actually need.

    VLC starts with clean settings.

NoteThis erases all custom preferences (including shortcuts and skins). Export your config first under Tools > Preferences > All > Interface if you want a backup.

Fix 6Update VLC to the latest version

Applies official bug and security fixes (current stable: 3.0.23)

  1. In VLC, go to Help > Check for Updates.

    VLC compares your version with the latest.

  2. If an update exists, download it from the official page videolan.org.

    The new installer is downloaded.

  3. Install over your current version (settings are kept) and restart.

    VLC runs the new version.

NoteVLC 3.0.23 is the 24th update to the 3.0 branch and includes a large batch of demuxer and stability fixes — many "not playing" issues are already fixed there.

Advanced fixes

Fix 1Test in a fresh user account

Separates macOS-level settings from VLC settings

  1. Create a test account: System Settings > Users & Groups > Add Account.

    A clean account exists.

  2. Install VLC there (or copy the app) and test fullscreen.

    You see whether macOS-level settings are at fault.

  3. If it works in the test account, reset your main account’s VLC preferences and display settings.

    The cause is isolated to your main profile.

NoteThird-party display tools (BetterDisplay, DisplayLink) and accessibility apps that hook the window server are common fullscreen breakers — quit them while testing.

How to avoid it in the future

  • Prefer Cmd+F over the green button for media fullscreen.
  • Keep macOS fully updated — Apple Silicon display fixes arrive in system updates.
  • Quit window-manager utilities (BetterDisplay, Rectangle) if you see fullscreen glitches.
  • Keep VLC updated; fullscreen fixes ship with 3.0.x releases (current stable: 3.0.23).

Frequently asked questions

Why does fullscreen work in QuickTime but not VLC?
QuickTime uses Apple’s own video pipeline; VLC’s output modules interact with Spaces differently. The OpenGL/VideoToolbox toggle usually resolves it.
Black screen in fullscreen on M1/M2/M3/M4 Mac?
Update macOS first (Apple ships GPU driver fixes), then toggle the video output module. If it persists, disable hardware-accelerated decoding as a test.
The window goes fullscreen but the video stays small in the corner
That is a scaling bug in the output module — switch the video output (OpenGL ↔ VideoToolbox) and restart VLC.
Does an external monitor make it worse?
Yes, especially with "Displays have separate Spaces" enabled or a non-Retina external display. Disable separate Spaces or use mirroring as a test.

Summary

Force the video output to OpenGL (or vice versa) — The classic macOS fullscreen fix. If it does not help, work through the remaining fixes in order: each targets a different layer of the problem. Most users resolve this issue by fix 3 at the latest. Keep VLC updated (current stable: 3.0.23) and revisit this guide when a new VLC version ships.

Related guides

Edited by the VLC Fix Guide Tech Team — 10+ years of media software troubleshooting