Skip to content

fix: use listenOnly event tap to prevent keyboard lag #25

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ZhaoChaoqun merged 2 commits into from
Apr 4, 2026
Merged

fix: use listenOnly event tap to prevent keyboard lag #25

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
7625ddc
fix: use listenOnly event tap to prevent system-wide keyboard lag
ZhaoChaoqun Apr 4, 2026
e77ce82
refactor: remove dead return-nil paths in listenOnly event tap
ZhaoChaoqun Apr 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 5 additions & 6 deletions Sources/KeyMonitor.swift
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -132,10 +132,14 @@ class KeyMonitor {
triggerConfig = .current
logger.info("触发键: \(self.triggerConfig.displayName, privacy: .public)")

// Use .listenOnly — we only observe the trigger key, never block/modify
// events. An active (.defaultTap) filter serialises every keystroke
// through our callback, which stalls typing system-wide whenever the
// main thread has any latency.
guard let tap = CGEvent.tapCreate(
tap: .cgSessionEventTap,
place: .headInsertEventTap,
options: .defaultTap,
options: .listenOnly,
eventsOfInterest: eventMask,
callback: { (proxy, type, event, refcon) -> Unmanaged<CGEvent>? in
guard let refcon = refcon else {
Expand Down Expand Up @@ -191,18 +195,13 @@ class KeyMonitor {
DispatchQueue.main.async {
Comment thread
claude[bot] marked this conversation as resolved.
self.onKeyRecorded?(config)
}
return nil // 吞掉录制的按键事件
}
return Unmanaged.passRetained(event)
}

// 正常触发键检测模式
if let pressed = triggerConfig.matches(type: type, event: event) {
handleTriggerState(pressed: pressed)
// 非修饰键需要吞掉事件，防止触发系统默认行为
if !triggerConfig.isModifierKey {
return nil
}
}

return Unmanaged.passRetained(event)
Expand Down
Loading