Quick X Folder Preview · Troubleshooting

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

Verified against macOS 26 Tahoe·Updated September 2026·8 min read
Quick answer: If Space does nothing at all when you select a file in Finder, no blue box, no preview, the cause is usually a keyboard tool that grabbed the bare spacebar before Finder could react to it. The two most common sources are a Karabiner-Elements or kanata rule that turns Space into a Hyper key with too generous a tap-hold timing window, and a BetterTouchTool setup that uses the spacebar as a modifier for Key Sequences. Quit the tool from its menu bar icon and test again immediately; if Quick Look comes back the moment the app closes, you have confirmed the cause and can scope a proper fix instead of disabling the tool for good.

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.

Faster confirmation
Quit Karabiner-Elements or BetterTouchTool directly from its menu bar icon (no need to edit any rule yet) and test Space again right away. If it starts working the instant the app closes, you've found your cause without touching a configuration file.

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 sometimes

BetterTouchTool: 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 files

Any 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 above

Find 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 own

Two 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 seeingLikely causeFix
Space does nothing at all on a selected fileA global tool with a bare-Space binding is eating the keypressQuit Karabiner-Elements or BetterTouchTool and retest immediately
Space works, but only after a short pauseA tap-hold timing window in Karabiner or kanata is too generousLower the tap-hold threshold, or exclude Finder from the rule
Space draws a blue selection box, not a previewFull Keyboard Access, a different bug entirelyTurn off Full Keyboard Access under Accessibility settings
Space fails only during trackpad gesturesA BetterTouchTool bug present before version 6.176Update BetterTouchTool to 6.176 or later
Space works fine in a guest accountConfirmed: a third-party app in your own account, not macOSWork through the causes above one at a time
Space still fails in a guest accountNot a remapping conflict, a genuine Quick Look problemSee 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.

Honest status
It ships now for macOS 13.0 (Ventura) or later, on Apple silicon or Intel: $4.99 once after a 14-day trial, no subscription. Unfold covers more file types (250+ versus our 13) if breadth matters more than anything else to you, and Looq and Unfold both have years of user reviews behind them that we don't have yet.

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

Why did Quick Look's space bar stop working after I installed Karabiner-Elements?
The usual cause is a "spacebar as Hyper key" complex modification, a popular tap-hold rule where tapping Space still types a space but holding it sends Control-Option-Command-Shift instead. If the tap-hold timing window is too generous, or you type the next key while Space is still physically down, Karabiner or kanata can read a normal Quick Look tap as the start of a hold and swallow it before Finder ever receives a keyDown event. Lowering the hold threshold, or excluding Finder from the rule entirely with a frontmost_application_unless condition, fixes it without giving up the Hyper key everywhere else.
Does BetterTouchTool actually intercept the space bar?
It can, but only if you told it to. BetterTouchTool ships an official technique for turning the spacebar into a modifier key for Key Sequences (holding Space, tapping a letter, releasing Space fires an action), and its own community documentation admits there is no built-in way to block just the spacebar from that behavior globally. If you set this up yourself, BetterTouchTool sees the keypress at the event-tap level before Finder does. Separately, a real bug in versions before 6.176 (fixed February 10, 2026) made the space key stop responding during drawing and mouse gestures, unrelated to any deliberate configuration.
Is this the same bug as the Full Keyboard Access spacebar issue?
No, and the symptoms are different. Full Keyboard Access reassigns Space to "activate the focused control," so pressing it draws a blue selection outline around the file. A remapping-tool conflict usually does nothing at all when you press Space on a selected file, because the keypress never reaches Finder as a normal key event. If you're seeing a blue box, turn off Full Keyboard Access instead; this guide won't help with that specific symptom.
Do Alfred or Raycast break Finder Quick Look?
Not in the way people often assume. Alfred previews a highlighted result with Shift (or Command-Y as an alternate), not Space, and only while Alfred's own window has focus. Raycast's File Search command does use Space to preview a result, but again only inside Raycast's own window; neither app runs a global hook on Finder's spacebar shortcut. If your Quick Look problem started after installing one of these, look at what else changed around the same time; a coincidence in timing isn't the same as a cause.
What is HotkeyClash and will it find this for me?
HotkeyClash is a free, open-source macOS menu bar utility that scans three sources for overlapping key combinations: the Accessibility API menu shortcuts of your currently running apps, Karabiner-Elements and skhd configuration files, and the macOS symbolic hotkeys plist for built-in shortcuts. It will catch a Karabiner rule or an app that exposes its shortcut as a real menu item. It will not see a BetterTouchTool trigger or an Alfred hotkey configured purely inside that app's own preferences, since those aren't exposed through the sources it reads. Treat it as a first check, not a complete answer.
How do I test whether it's actually a remapping tool and not Quick Look itself?
Create a temporary guest user account (System Settings > Users & Groups > Add Account, or enable Guest User) and log in there. Guest accounts start with none of your third-party apps or login items running. If Space previews a file normally in the guest account, Quick Look and macOS are fine, and something in your own account, almost always a keyboard tool, is the cause. If it still fails in the guest account, the problem is system-level and this guide is the wrong fix; see our full Quick Look troubleshooting guide instead.
Will quitting the app temporarily confirm the cause without deleting my config?
Yes, and it's faster than editing a configuration file. Quit Karabiner-Elements entirely (its menu bar icon > Quit Karabiner-Elements), or for BetterTouchTool, use its menu bar icon to Quit. Test Quick Look immediately after. If it starts working the moment the app closes, you've confirmed the cause without touching a single rule yet, and you can go back and scope the fix properly instead of guessing.

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