Scroll Reverser:macOS设备独立滚动方向控制工具

Scroll Reverser:macOS设备独立滚动方向控制工具

【免费下载链接】Scroll-Reverser Per-device scrolling prefs on macOS. 【免费下载链接】Scroll-Reverser 项目地址: https://gitcode.com/gh_mirrors/sc/Scroll-Reverser

Scroll Reverser是一款专为macOS设计的免费开源工具,能够独立控制触控板和鼠标的滚动方向。通过精巧的事件处理机制,它解决了macOS系统默认将两种设备滚动方向绑定的设计缺陷,让用户可以根据个人习惯分别设置不同的滚动方向。

功能特性

Scroll Reverser提供以下核心功能:

  • 独立设备控制:分别为触控板和鼠标设置不同的滚动方向
  • 多点触控设备支持:兼容Magic Mouse等Apple多点触控设备
  • 实时事件监控:通过Quartz Event Services技术捕获和处理滚动事件
  • 调试功能:提供调试窗口查看实时事件日志
  • 开机自启动:支持开机自动运行,无需手动操作

安装方法

直接下载应用

最简单的方式是获取已编译的应用程序:

  1. 访问项目发布页面获取最新版本
  2. 将下载的应用拖入"应用程序"文件夹
  3. 首次运行时允许系统安全性设置中的权限请求

从源码构建

开发者可以通过以下步骤从源码构建:

git clone https://gitcode.com/gh_mirrors/sc/Scroll-Reverser
cd Scroll-Reverser
git submodule update --init

使用Xcode打开项目文件ScrollReverser.xcodeproj进行构建。首次构建会遇到签名错误,需在Xcode的"Signing & Capabilities"选项卡中,将原作者证书替换为你自己的Developer ID证书。

配置指南

基础设置

  1. 启动应用后,菜单栏会出现滚动方向图标
  2. 点击图标打开偏好设置面板
  3. 根据设备类型勾选对应选项:
    • 鼠标:勾选"Reverse Scroll Direction"
    • 触控板:取消勾选保持自然滚动

Scroll Reverser偏好设置界面

高级功能

  • 滚轮灵敏度调节:高级用户可调整"Scroll Step Size"控制滚轮灵敏度
  • 调试模式:按住Option(⌥)键点击菜单栏图标,可打开调试窗口查看实时事件日志
  • 开机自启:在偏好设置中勾选"Launch at Login"实现开机自动启动

技术原理

Scroll Reverser的核心功能通过MouseTap.m文件实现,它使用Quartz Event Services的事件监听机制:

  1. 安装事件监听器(event tap)访问系统事件流
  2. 通过分析手势事件判断输入设备类型(触控板或鼠标)
  3. 根据用户设置对滚动事件进行方向反转处理

事件监听器能够精准捕获滚动事件和手势事件,通过检测触控板上的手指数量来区分设备类型。当检测到两个或更多手指时,判断为触控板输入,否则为鼠标输入。

常见问题解决

权限问题

如果应用无法正常工作,请检查系统权限设置:

  • 进入"系统设置 > 安全性与隐私 > 辅助功能"
  • 确保Scroll Reverser已获得相应权限

事件捕获失败

如果滚动方向反转功能失效:

  • 重启Scroll Reverser应用
  • 检查是否有其他事件监听工具冲突
  • 通过调试窗口查看事件日志

更新提示

应用通过Sparkle.framework实现自动更新检查,建议保持最新版本以获得最佳兼容性。

版本历史

Scroll Reverser历经多个版本迭代,主要改进包括:

  • v1.7:全新偏好设置窗口,兼容Yosemite 10.10.2,增加AppleScript支持
  • v1.6:Retina显示支持,改进鼠标检测精度,自动更新检查功能
  • v1.4:独立水平和垂直滚动设置,支持Wacom数位板检测
  • v1.0:初始版本发布,基础滚动方向反转功能

项目结构

Scroll Reverser采用模块化设计,主要组件包括:

  • 事件处理核心:MouseTap.m实现事件捕获与方向反转逻辑
  • 用户界面:PrefsWindowController管理偏好设置窗口
  • 菜单栏控制:StatusItemController处理图标显示与交互
  • 权限管理:PermissionsManager处理系统权限请求

使用技巧

快速切换

右键或Control+点击菜单栏图标可以快速开启/关闭滚动方向反转功能。

睡眠唤醒处理

Scroll Reverser会在Mac从睡眠状态唤醒时自动重新启动,确保滚动功能持续正常工作。

多语言支持

应用支持多种语言界面,包括中文、英文、德文、法文、日文等,满足全球用户需求。

Scroll Reverser通过精巧的事件处理机制,完美解决了macOS系统滚动方向的设计缺陷。无论是习惯自然滚动的触控板用户,还是偏好传统滚动的鼠标用户,都能通过这款工具获得个性化的操作体验。

【免费下载链接】Scroll-Reverser Per-device scrolling prefs on macOS. 【免费下载链接】Scroll-Reverser 项目地址: https://gitcode.com/gh_mirrors/sc/Scroll-Reverser

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值