Anneau

A powerful, gesture-centric application switcher and quick launcher for macOS.

Features • Installation • Screenshots • Usage • Tech • Contributing • License • 中文

anneau_user_guide.1.mp4

Anneau is a native macOS app switcher that brings your running applications right to your cursor, enabling instant switching with keyboard shortcuts and intuitive gestures. Everything stays on-device and private.

Features

• Quick App Switching: Press ⌘~ (Command + ~) to instantly access your running apps
• Keyboard-First Navigation: Use Tab, arrow keys, or mouse to select apps
• Customizable Shortcuts: Define custom shortcuts for frequently used apps and actions
• Multiple Appearance Options: Choose from different card sizes to match your workflow
• Sound Effects: Optional audio feedback with multiple sound types (Pop, Tink, Glass, Hero, Funk)
• Mouse Mode: Enable mouse-based navigation with reverse knob control
• Launch at Login: Set Anneau to start automatically when you log in
• Privacy-Focused: All data stays on your device

Installation

Manual Download

Download the latest .dmg from Releases.

Homebrew (coming soon)

brew install --cask anneau

Build from Source

git clone https://github.com/helson-lin/Anneau.git
cd Anneau
open Anneau.xcodeproj

Build and run in Xcode (requires macOS 11.0+).

Install on macOS without a paid developer account

Because the app is not signed or notarized, Gatekeeper will warn. Follow these steps:

1. Download the latest .dmg from Releases.
2. Open the DMG and drag Anneau.app to Applications (or the Applications link in the DMG).
3. First launch (bypass Gatekeeper): in Applications, Control+Click (or right-click) Anneau -> Open, confirm the warning and click "Open". If blocked, go to System Settings -> Privacy & Security and click "Open Anyway", then open once more.
4. Permissions: grant Accessibility permission in System Settings -> Privacy & Security -> Accessibility so keyboard shortcuts work. The app will automatically prompt you to restart after granting permission for shortcuts to take effect.
5. Updates: for each new DMG, drag to Applications to replace. If Gatekeeper warns again, repeat step 3.
6. Remove quarantine if you see "file is damaged":

   sudo xattr -r -d com.apple.quarantine /Applications/Anneau.app

   then Control+Click -> Open once.
7. Uninstall: quit Anneau, delete Applications/Anneau.app. To erase all data:

   defaults delete com.helsonlin.anneau

Requirements

• macOS 11.0 (Big Sur) or later
• Accessibility permission for global keyboard shortcuts
• Approximately 10 MB of disk space

Screenshots

(Coming soon - add screenshots of your app here)

Usage

Basic Operations

• Open Switcher: Press ⌘~ (Command + ~) or your custom shortcut
• Navigate: Use Tab, arrow keys, or mouse to select apps
• Activate App: Press Enter or click to switch to the selected app
• Close Switcher: Release the shortcut key or press Escape

Customization

• Custom Shortcuts: Go to Settings → App Settings to define per-app shortcuts
• Appearance: Adjust card size in Settings → Appearance
• Sound Effects: Enable and choose sound type in Settings → Sound Effects
• Behavior: Configure mouse mode and navigation keys in Settings → Behavior
• Startup: Enable "Launch at Login" in Settings → Startup

Welcome Guide

On first launch, Anneau shows a welcome screen that guides you through:

1. Introduction to the app
2. Granting Accessibility permission with a quick link to system settings
3. Enabling launch at login

Tech Highlights

• Built with SwiftUI and AppKit for native macOS performance
• Global hotkey detection using Carbon Events and Accessibility APIs
• Custom keyboard shortcut recorder with modifier key support
• Efficient app enumeration using NSWorkspace
• Per-app shortcut management with persistent storage
• Multi-language support (English, Simplified Chinese, Traditional Chinese, Japanese, Korean, French, German, Russian, Norwegian, Danish, Esperanto)
• Automatic restart prompt after permission grant

Contributing

Issues and pull requests are welcome! Please:

• Check existing issues before creating new ones
• Keep PRs focused on a single feature or fix
• Include clear descriptions and, if possible, screenshots
• Follow the existing code style

License

Note: This project is a fork and modification of Orbit by Yuze Pan (潘禹泽).

This project is open source under the GPL-3.0 License. See LICENSE for details.

In short:

• Free for personal and commercial use
• You may study, modify, and distribute the code
• Derivative works must use the same license
• No warranty provided

For questions, contact: helsonlin@163.com

---

中文说明

Anneau 是一款原生的 macOS 应用切换器，通过键盘快捷键和直观手势快速访问运行中的应用。 所有数据都在本地处理，保护您的隐私。

功能特点

• 快速应用切换: 按 ⌘~ (Command + ~) 即可快速访问运行中的应用
• 键盘优先导航: 使用 Tab/方向键或鼠标选择应用
• 自定义快捷键: 为常用应用和操作定义专属快捷键
• 多种外观选项: 选择不同的卡片大小以匹配您的工作流
• 音效反馈: 可选音效反馈，支持多种音效类型 (Pop、Tink、Glass、Hero、Funk)
• 鼠标模式: 启用基于鼠标的导航和反方向旋钮控制
• 开机自启动: 设置 Anneau 在登录时自动启动
• 注重隐私: 所有数据保存在本地设备

安装方式

手动下载

从 Releases 下载最新 .dmg。

Homebrew (即将推出)

brew install --cask anneau

从源码构建

git clone https://github.com/helson-lin/Anneau.git
cd Anneau
open Anneau.xcodeproj

在 Xcode 中构建运行（需要 macOS 13.0+）。

没有开发者账号时的安装方法

由于应用未签名/未公证，Gatekeeper 会提示风险，可按以下步骤操作:

1. 从 Releases 下载最新 .dmg。

2. 打开 DMG，将 Anneau.app 拖入 Applications。

3. 首次运行: 在 Applications 中 Control+Click (或右键) Anneau -> 打开，确认警告并点击"打开"。 如仍被拦截，进入系统设置 -> 隐私与安全性，点击"仍要打开"，然后再次打开。

4. 权限: 在系统设置 -> 隐私与安全性 -> 辅助功能中授予权限，以启用键盘快捷键。 授权后应用会提示您重启。

5. 更新: 下载新 DMG 后拖入 Applications 覆盖即可，如再次提示按步骤 3 处理。

6. 若提示 "文件已损坏"，可移除隔离属性:

   sudo xattr -r -d com.apple.quarantine /Applications/Anneau.app

   然后 Control+Click -> 打开一次。

7. 卸载: 退出 Anneau，删除 Applications/Anneau.app。如需清除数据:

   defaults delete com.helsonlin.anneau

运行要求

• macOS 11.0 更高版本
• 需要授予辅助功能权限以启用全局键盘快捷键
• 约需 10 MB 磁盘空间

使用方式

基本操作

• 打开切换器: 按 ⌘~ (Command + ~) 或您的自定义快捷键
• 导航: 使用 Tab、方向键或者鼠标选择应用
• 激活应用: 按 Enter 或点击以切换到选定的应用
• 关闭切换器: 松开快捷键或按 Escape

自定义设置

• 自定义快捷键: 进入设置 → 应用设置，为每个应用定义快捷键
• 外观: 在设置 → 外观中调整卡片大小
• 音效: 在设置 → 音效中启用并选择音效类型
• 行为: 在设置 → 行为中配置鼠标模式和导航键
• 启动: 在设置 → 启动中启用"开机自动启动"

欢迎引导

首次启动时，Anneau 会显示欢迎界面，引导您完成:

1. 应用介绍
2. 授予辅助功能权限（提供快速跳转到系统设置的链接）
3. 启用开机自启动

许可证

注意本项目是基于Oribt修改而来。 作者： Made by Yuze Pan (潘禹泽)

本项目采用 GPL-3.0 许可证 开源 - 详见 LICENSE。

如有问题，请联系: helsonlin@163.com

Made with ❤️ by Helson Lin