Why Quick Look's Space Bar Stops Working After Karabiner or BetterTouchTool
Not Full Keyboard Access, not a corrupted cache. If you remapped your spacebar or built a global keyboard shortcut around it, here is what is actually happening and the specific fix for each tool.
By Ram Velmurugan · Founder & Lead Developer, 1dot.ai
Editorial note: 1dot.ai makes Quick X Folder Preview, a Quick Look extension mentioned near the end of this guide that also relies on the same space bar shortcut. It ships today at $4.99 one-time after a 14-day trial and plays no role in the causes or fixes below. Every tool behavior, version number, and community report cited here was checked live in September 2026 against each project's own site, documentation, or forum; sources are listed near the bottom.
A Different Bug From the One Most Guides Cover
Most "Quick Look not working" guides, including our own, walk through Full Keyboard Access reassigning the space bar, a stuck quicklookd process, or a corrupted preview cache. Those are real and common. But they all assume nothing outside Quick Look itself is touching the space bar, and if you customize your keyboard with Karabiner-Elements, kanata, BetterTouchTool, skhd, or Hammerspoon, that assumption stops holding.
The tell is in what actually happens when you press Space. Full Keyboard Access draws a visible blue selection outline around the file, a clear (if confusing) reaction. A remapping conflict usually produces no reaction whatsoever, because the keypress gets consumed before Finder's Quick Look handler ever receives it. If you're seeing the blue box, you want our main Quick Look troubleshooting guide instead, since the fix there is a single settings toggle, not a keyboard-tool audit.
Confirm It Really Is a Remap
Before touching any configuration, spend thirty seconds ruling the rest of macOS out. Log into a temporary guest account (System Settings > Users & Groups, or enable Guest User) where none of your third-party apps or login items are running, select a file in Finder, and press Space. If a normal preview opens there, Quick Look and macOS itself are fine, and the cause lives in your own account, almost always one specific app.
The Actual Causes, and Fixes
Karabiner-Elements or Kanata: Spacebar-as-Hyper-Key Timing
This is the most common cause among people who customize their keyboard, and it's usually self-inflicted by a rule the person set up on purpose and forgot about. A popular complex modification turns the spacebar into a dual-function key: tap it and you get a normal space, hold it and it sends Control-Option-Command-Shift, the Hyper key, to your whole system. One widely shared write-up of this setup uses kanata, a tool that runs on Karabiner's driver, with the rule spelled out as a 200-millisecond tap-hold window.
The problem shows up when that window is too generous, or when you press the next key before fully releasing Space, which happens constantly in normal typing rhythm. A Karabiner-Elements GitHub discussion on the same technique for a different purpose, a spacebar-driven shift key, found exactly this: one contributor wrote that they were "simply hitting the next key so quickly that spacebar is still being depressed," concluding "there's nothing that can be done in Karabiner" for that specific overlap. When it happens over a file you meant to preview, the tap gets read as the start of a hold, Quick Look never sees a keyDown at all, and nothing happens.
Two fixes work without giving up the Hyper key everywhere else. First, tighten the tap-hold threshold in your rule's JSON (the to_if_alone and to_if_held_down timing values) so a fast, deliberate tap registers reliably as a tap. Second, and more reliably, exclude Finder from the rule entirely with a frontmost_application_unless condition targeting Finder's bundle identifier, com.apple.finder, so the spacebar behaves normally the moment Finder is the active app and only becomes Hyper elsewhere.
"conditions": [{ "type": "frontmost_application_unless", "bundle_identifiers": ["^com\\.apple\\.finder$"] }]
Add that block to the manipulator handling your spacebar rule, reload the configuration, and test with a file selected in Finder.
Fixes: Space does nothing, or works only sometimesBetterTouchTool: Spacebar as a Modifier
BetterTouchTool documents its own technique for making the spacebar act like a modifier key: hold Space, tap a letter, release Space, and BTT fires whatever action you assigned, the same pattern as "Command plus a letter" but built around the space bar instead. It works because BTT operates as a low-level event tap that sees keyboard input before the system delivers it to the focused app, which is exactly what lets it intercept a bare Space press meant for Finder's Quick Look.
The tool's own user community has documented the limitation directly: one detailed configuration guide on BetterTouchTool's official forum states plainly, "I have not found a way to block only the Spacebar with BTT," recommending a keyboard-response-speed workaround instead of a clean exclusion. Separately, and unrelated to any deliberate setup, BetterTouchTool shipped a real bug in versions before 6.176 (fixed February 10, 2026) where the space key "sometimes stopped working" specifically during drawing and mouse gesture recognition. If you're on an older build, updating BetterTouchTool alone may be the entire fix.
If you built the spacebar-as-modifier setup on purpose and want to keep it everywhere except Finder, BetterTouchTool's own documentation describes app-specific overrides: add Finder to the app sidebar, then either disable the global spacebar trigger for that app so it falls back to the default behavior, assign the action "Use Apple Default or Do Nothing" while Finder is frontmost, or scope it with a Conditional Activation Group. Any of the three stops BTT from eating the keypress specifically inside Finder.
Fixes: Space does nothing on some or all filesAny Other Global Hotkey Tool Bound to Bare Space
Karabiner-Elements and BetterTouchTool are the two most common culprits because they both explicitly support remapping or capturing the bare spacebar with no modifier attached, which most macOS apps intentionally avoid registering as a global hotkey precisely because it collides with things like Quick Look. If you use skhd (a lighter, config-file-only hotkey daemon popular alongside tiling window managers like yabai) or Hammerspoon with a Lua script that binds a bare space event, the same conflict applies for the same reason: whichever process taps the keyboard event stream first wins, and Finder's own Quick Look handler runs later in that chain.
The fix is the same shape regardless of which tool is responsible: find the rule or script binding a bare Space with no modifier, and either remove it, add a Finder-specific exclusion if the tool supports one, or change the trigger to require a modifier key (Option-Space instead of Space alone) so it stops overlapping with Finder's own shortcut entirely.
Fixes: narrows down tools not covered aboveFind It Without Guessing: HotkeyClash
HotkeyClash is a free, open-source (GPL-2.0) macOS menu bar utility built specifically to answer "what else is using this key combination." It scans three sources: the Accessibility API menu-bar shortcuts of every app currently running, Karabiner-Elements and skhd configuration files directly, and the macOS symbolic hotkeys property list that stores built-in system shortcuts like Mission Control and Spotlight. It requires macOS 14 or later, needs no account or internet connection, and collects no telemetry.
It's a genuinely useful first check, with one honest limitation: it reads Karabiner and skhd configuration files directly, so a spacebar rule built there shows up clearly. It cannot see inside BetterTouchTool's or Alfred's own private preferences unless that binding is also exposed as a normal app menu shortcut, which a spacebar trigger usually isn't. Treat a clean HotkeyClash scan as ruling out Karabiner and skhd specifically, not as clearing every possible tool.
Diagnostic, not a fix on its ownTwo Apps That Get Blamed but Usually Aren't
Alfred and Raycast come up constantly in forum threads about broken Quick Look, mostly because people installed one of them around the same time the problem started and assumed a connection. Neither app runs a global hook on Finder's space bar. Alfred previews a highlighted result with Shift by default (Command-Y works too), and only while Alfred's own window has focus. Raycast's File Search command does reuse Space to preview a result, deliberately mirroring Finder's own convention, but again only inside Raycast's own window, not as a system-wide grab.
If your Quick Look problem genuinely started after installing one of these, look at what else you set up around the same time. A new launcher app is a common moment to also start experimenting with Karabiner or BetterTouchTool, and it's easy to blame the app you can see instead of the one running quietly in the background.
Symptom → Likely Cause → Fix
Use this as a shortcut straight to your exact symptom.
| What you're seeing | Likely cause | Fix |
|---|---|---|
| Space does nothing at all on a selected file | A global tool with a bare-Space binding is eating the keypress | Quit Karabiner-Elements or BetterTouchTool and retest immediately |
| Space works, but only after a short pause | A tap-hold timing window in Karabiner or kanata is too generous | Lower the tap-hold threshold, or exclude Finder from the rule |
| Space draws a blue selection box, not a preview | Full Keyboard Access, a different bug entirely | Turn off Full Keyboard Access under Accessibility settings |
| Space fails only during trackpad gestures | A BetterTouchTool bug present before version 6.176 | Update BetterTouchTool to 6.176 or later |
| Space works fine in a guest account | Confirmed: a third-party app in your own account, not macOS | Work through the causes above one at a time |
| Space still fails in a guest account | Not a remapping conflict, a genuine Quick Look problem | See our full Quick Look troubleshooting guide instead |
Where Quick X Folder Preview Fits In
Quick X Folder Preview adds 13 Quick Look extensions, folders, archives, source code, Markdown, Jupyter notebooks, and more, all triggered by the same Space key this guide is about. That means every cause above affects it exactly the same way Full Keyboard Access or a stuck cache would: fix the underlying keyboard conflict and both standard Quick Look and Quick X Folder Preview's extensions start working again together, since they share one shortcut, not two separate ones to debug.
Sources & Further Reading
Spacebar-as-Hyper-key setup and its typing-overlap limits: Vishnu Gopal, Using Space for Hyper Key Shortcuts on macOS, Karabiner-Elements GitHub Discussion #4135, hold-spacebar as a central shift key.
Karabiner-Elements per-app exclusion conditions: official documentation, frontmost_application_if / frontmost_application_unless.
BetterTouchTool spacebar-as-modifier setup and its stated limitation: BetterTouchTool Community, Spacebar can act like Command-Key. App-specific trigger scoping: official documentation, Global and App Specific Triggers. Space-key gesture bug fixed in 6.176: BetterTouchTool release notes.
HotkeyClash, free conflict scanner for running apps, Karabiner/skhd, and system shortcuts: hotkeyclash.com.
Alfred's Quick Look shortcut (Shift, or Command-Y): Alfred Help, Previews and QuickLook. Raycast File Search's own Space-to-preview: Raycast Manual, File Search.
If your symptom is a blue selection box instead of nothing, see our main Quick Look troubleshooting guide for the Full Keyboard Access fix and the rest of the system-level causes.
Frequently Asked Questions
The Bottom Line
A space bar that does nothing at all, not even the Full Keyboard Access blue box, points somewhere outside Quick Look itself. Quit Karabiner-Elements or BetterTouchTool first and test immediately; that one step identifies the cause in under a minute for most people reading this. From there, the fix is never "stop customizing your keyboard," it's scoping the specific rule so it leaves Finder alone while still working everywhere else you built it for.
Looking for more Mac productivity guides? Read our main Quick Look troubleshooting guide, our full guide to previewing files on Mac without opening them, browse every 1dot.ai guide, or check Quick X Folder Preview's product page for pricing and the full extension list.
Fixed the Conflict? See What Else Space Can Preview
Quick X Folder Preview adds 13 Quick Look extensions to the same space bar shortcut: folders, archives, code, Markdown, and more. Free for 14 days, then $4.99 once for a lifetime license.
Try It FreeRead More Guides