MacOS下Python OCR工具如何实现无焦点时的全局热键触发
全局热键实现方案
你当前基于rumps开发的macOS菜单栏OCR工具,rumps自带的菜单项快捷键仅在应用处于前台时生效,要实现任意应用下按下热键都能触发OCR流程,可按以下方案改造:
- 抽出原有OCR核心逻辑为独立通用函数,同时适配菜单点击、热键触发两种入口
- 使用
pynput库实现macOS级全局热键监听,该库和rumps的菜单栏主循环兼容性良好 - 将热键监听设为后台守护线程运行,避免阻塞rumps的事件循环
- 补充系统权限配置,否则全局热键无法被捕获
步骤1:安装依赖
pip install pynput
步骤2:改造后完整代码
#!/Library/Frameworks/Python.framework/Versions/3.9/bin/python3 import pytesseract from PIL import Image import os import rumps import pyperclip from pynput import keyboard import tempfile # 抽出OCR核心逻辑,供两种触发入口共用 def run_ocr(): # 使用临时路径替代桌面路径,避免残留文件 tmp_capture = os.path.join(tempfile.gettempdir(), 'ocr_capture.png') try: # 调用系统交互式截图 os.system(f'screencapture -i {tmp_capture}') # 用户按ESC取消截图时直接退出 if not os.path.exists(tmp_capture): return # OCR识别 img = Image.open(tmp_capture) text = pytesseract.image_to_string(img) # 复制到剪贴板 pyperclip.copy(text) # 弹出结果窗口 rumps.Window(message='OCR Capture', default_text=text, title='Text Copied').run() finally: # 无论成功/失败都清理临时截图文件 if os.path.exists(tmp_capture): os.remove(tmp_capture) # 保留原有菜单点击触发逻辑 @rumps.clicked('OCR (⌘⇧O)') def ocr_menu(sender): run_ocr() # -------------------------- 全局热键配置 -------------------------- # 自定义热键为 Cmd + Shift + O,可自行修改组合 HOTKEY_COMBO = '<cmd>+<shift>+o' def on_hotkey_trigger(): # 热键触发时调用OCR逻辑 run_ocr() # 初始化热键监听规则 hotkey = keyboard.HotKey( keyboard.HotKey.parse(HOTKEY_COMBO), on_hotkey_trigger ) # 按键事件处理回调 def for_canonical(callback): return lambda k: callback(listener.canonical(k)) # 开启后台守护线程运行热键监听,避免阻塞rumps主循环 listener = keyboard.Listener( on_press=for_canonical(hotkey.press), on_release=for_canonical(hotkey.release) ) listener.daemon = True listener.start() # ---------------------------------------------------------------- # 初始化菜单栏应用 app = rumps.App('OCR', menu=[ 'OCR (⌘⇧O)', None ]) app.run()
关键注意事项
- 系统权限配置:首次运行脚本时,需打开「系统设置 -> 隐私与安全性」,分别在「辅助功能」和「输入监控」列表中,勾选运行该脚本的载体(如Python解释器、后续打包生成的.app文件),否则全局热键无法被系统捕获
- 热键自定义:修改
HOTKEY_COMBO变量即可更换热键组合,推荐使用带修饰键的低冲突组合(如<cmd>+<alt>+o)避免和其他应用快捷键冲突 - 异常兼容:代码已加临时文件清理、用户取消截图的兼容逻辑,不会因异常残留文件或崩溃
内容的提问来源于stack exchange,提问作者Jerryhuhu25
相关产品推荐
相关产品推荐

