XueshiQiao /AnyDrag
Modifier+drag to move any window smoothly on macOS, exactly like native speed
★ 300⑂ 21👁 2⑃ 23● 43▤ 45
300
stars
21
forks
2
watchers
23
prs
43
issues
45
releases
README
AnyDrag 按住修饰键,拖动窗口任意位置即可移动它——丝滑得宛如原生标题栏。 🇺🇸 English • 🇨🇳 中文 ⭐ 如果 AnyDrag 让你的窗口拖动更顺手,欢迎给个 Star —— 能帮更多人发现它。 ✨ 我做的更多应用 → xueshi.dev 按住修饰键,拖动窗口任意位置即可移动窗口,无需对准标题栏。 https://github.com/user-attachments/assets/82b18801-0f96-4e9d-b05a-ac7cdd18d490 为什么选择 AnyDrag? BetterTouchTool 等工具也有类似的修饰键+拖动功能,但它们通过 Accessibility API 移动窗口——这条间接路径要让每一帧都经过目标 app 的进程,延迟明显。 AnyDrag 采用不同的方案:在 window server 层面模拟原生标题栏拖动。窗口的移动方式和你亲手拖它真正的标题栏完全一致——没有逐帧 IPC,没有 Accessibility 往返,没有延迟。这份丝滑正是它存在的意义,macOS 上其他修饰键拖动工具都做不到。 ✨ 功能 下面所有内容都通过一个原生「系统设置」风格的窗口配置,无需手写任何配置文件。 🪟 核心手势 按住你的主修饰键(默认 Option),然后: | 手势 | 动作 | |------|------| | 修饰键 + 拖动 | 从窗口任意位置移动它——不限于标题栏 | | 修饰键 + 双击 | 最大化窗口;再次双击恢复原始大小 | | 修饰键 + 右键 | 打开窗口布局面板 | 三指拖移(可选,设置 → 窗口拖动):三指按在触控板上,在窗口任意处拖动即可移动窗口,完全不需要修饰键。它基于 macOS 自带的三指拖移,请先在 系统设置 → 辅助功能 → 指针控制 → 触控板选项 → 使用触控板进行拖移 → 三指拖移 中开启。三指拖动时按住左键缩放修饰键(默认 Shift,可在「窗口缩放」页设置)则改为从最近的窗口角缩放窗口。注意开启后,从窗口内开始的三指拖动会移动窗口,而不是选中文本。 🗂️ 窗口布局面板 修饰键 + 右键会弹出一个面板,快速排布窗口: - 移动与缩放 —— 吸附到半屏、四分之一屏或任意区域 - 填充与排列 —— 填满屏幕,或将多个窗口并排排列 - 全屏 —— 一键进入全屏 - 移动到显示器 —— 把窗口直接送到另一块显示器 ↔️ 窗口缩放 从最近的窗口角缩放窗口,无需对准角落那一小块拖拽区。默认开启的是右键拖动;可以在设置里换一种触发方式,或者关掉: - 右键拖动 —— 按住主修饰键并右键拖动。 - 左键拖动 —— 按住专门的「左键缩放修饰键」并左键拖动。 缩放过程中,活动角会有一个发光的角标(Corner Bracket)指示(可关闭以获得最佳性能)。 🖱️ 鼠标中键 → 按方向平铺 把鼠标中键动作设为「按方向平铺」,然后按住中键往某个边或角拖动即可吸附。 多显示器时,面板会按真实排列铺开所有屏幕,一个手势即可选「任意屏 × 任意区域」。停在别的屏幕那张卡片的中间格子上,窗口会原封不动地搬到那块屏幕——大小不变、位置不变,而不是被平铺;格子里画的小方块就是它落点的预览。当前这块屏幕卡片的中间格子仍然是取消。还有一个「仅拖动触发」模式,让普通的中键单击保持完全原生——只有真正移动光标后面板才出现。 ⌨️ 修饰键 选择你的主修饰键,或是组合键: - Option、Command、Control、Shift、fn - 像 Option + Command 这样的组合 - Hyper —— 按住 Caps Lock 作为触发键。它与姊妹应用 HyperCapslock 配合使用(开启其中的「按住 CapsLock 拖动窗口(AnyDrag)」)。 如果你在 macOS 中开启了「按住 ⌥ 键拖移窗口以平铺」,并且 AnyDrag 的修饰键不是 Option,那么也可以额外按住 Option 使用系统平铺。例如把 AnyDrag 设为 fn 后,可以直接用 fn + option + 拖动 从窗口任意区域触发原生拖动和平铺。 🛠️ 更多 - 排除应用 —— 列出那些让 AnyDrag 完全不介入的 app。 - 按应用微调 —— 必要时为特定 app 覆盖标题栏偏移量。 - 开机自启、菜单栏控制、浅色/深色跟随系统。 - 多语言界面 —— 英文 / 简体中文(跟随系统语言)。 - 自动更新 —— 内置 Sparkle。 - 隐私优先 —— 可选的匿名使用统计,不涉及 app 名称和窗口内容,并提供一个开关彻底关闭。 使用 1. 启动 AnyDrag —— 它会出现在菜单栏。 2. 按住 Option(默认)拖动任意窗口。 3. 按住修饰键双击窗口可最大化;再次双击恢复原大小。 4. 按住修饰键右键点击窗口,打开窗口布局面板。 5. 或把鼠标中键动作设为「按方向平铺」,然后按住中键往某个边/角拖动。 6. 点击菜单栏图标可以切换修饰键或开关 AnyDrag。 截图 安装 Homebrew bash brew install --cask anydrag 或者从 GitHub Releases 下载最新 .dmg,打开后将 AnyDrag 拖到应用程序文件夹。 应用已使用 Apple 开发者证书签名,并通过了 Apple 公证(Notarization),可以直接安装,不会出现安全警告。 权限 首次启动时 macOS 会请求辅助功能(Accessibility)权限——这是检测修饰键和移动窗口所必需的: 系统设置 → 隐私与安全性 → 辅助功能 它是如何工作的 一个 CGEventTap 运行在专属的高优先级线程上,只在修饰键被按住时拦截鼠标事件。AnyDrag 不是让 Accessibility API 逐帧移动窗口,而是把鼠标坐标改写到窗口的标题栏区域,让 window server 原生地完成这次拖动——和你抓住真正标题栏走的是同一条代码路径,没有任何逐帧 IPC。 这就是拖动手感原生的原因:没有中间层在搬运窗口,是 window server 在直接做这件事。 技术栈 - 原生 macOS —— AppKit 核心(引擎、菜单栏、覆盖层);设置窗口为 SwiftUI,通过 NSHostingController 承载。Swift 5.9,macOS 13+。 - CoreGraphics CGEventTap 拦截输入;用 window server 标题栏拖动模拟来移动窗口。 - Sparkle 实现自动更新。 - XcodeGen —— project.yml 是 Xcode 工程配置的唯一来源。 从源码构建 前置要求 - macOS 13+ - Xcode 16+ - XcodeGen(brew install xcodegen) 配置 bash git clone https://gith
Top issues
#21「功能需求」优化设置界面和快捷键设置3 comments · 2026-07-09#36Harden build.yml: pin third-party actions, narrow permissions, add concurrency1 comments · 2026-08-15#35build.yml: Sparkle framework version isn't reproducible (floating SPM range vs hardcoded 2.9.0)0 comments · 2026-08-15
Latest release
v26.11.129 v26.11.129 2026-11-17What's New in 26.11.129 More Apps — Settings has a new More Apps page that lists my other apps. Click Get and AnyDrag downloads the app, checks that it is signed by the same developer, puts it in your Applications folder and opens it. Each row also has a button that leads to the app's source on GitHub or to its App Store page. Easier to find — The More Apps by Author… item in the menu bar menu and the entry on the About page now open this page instead of the website. 26.11.129 更新内容 更多应用 — 设置里新增「更多应用」页面,列出我的其他应用。点「获取」,AnyDrag 会下载这个应用、确认它由同一位开发者签名、把它放进「应用程序」文件夹并打开。每一行还有一个按钮,可以打开这个应用在 G