Skip to content

mz5210/RightClickTools

Repository files navigation

RightClickTools

RightClickTools 是一个 macOS Finder 右键菜单增强工具,可以把常用文件操作直接集成到 Finder 原生右键菜单中。

本项目基于 KylinWDS/RightClickTools 修改而来,并在原项目基础上做了权限处理、菜单配置、图标、设置页和文件创建等调整。

功能

  • 复制文件路径:复制当前选中文件或文件夹的完整路径。
  • 用 Sublime 打开:使用 Sublime Text 打开当前选中的文件或文件夹。
  • 在此打开终端:在当前 Finder 目录打开 Terminal。
  • 新建文件:在当前目录创建 TXT、Markdown、Word、Excel、PPT 文件。
  • 功能开关:点击应用图标或菜单栏图标打开设置页,可控制各项右键菜单功能是否显示。
  • 权限入口:在右键菜单中快速打开 macOS 权限设置。

当前修改点

  • 移除了原项目中的快捷键弹出菜单,改为应用图标和菜单栏图标打开统一设置页。
  • 增加功能列表设置页,可按功能开关控制 Finder 右键菜单显示项。
  • 增加应用图标和菜单栏图标。
  • 将部分需要访问文件系统或启动应用的动作交给主应用执行,降低 Finder Sync 扩展权限问题带来的失败率。
  • 修复创建 TXT、Markdown、Office 文件时的路径与权限问题。
  • 移除了“切换隐藏文件”功能。

安装

使用发布包

  1. 打开发布包中的 RightClickTools.app
  2. 将应用复制到 /Applications
  3. 启动 RightClickTools
  4. 打开系统设置,启用 Finder 扩展:
    • 系统设置 -> 隐私与安全性 -> 扩展 -> 访达
    • 勾选 RightClickExtension
  5. 如遇到权限提示,请允许 RightClickTools 访问相关文件夹、控制 Finder、Terminal 或 Sublime Text。

从源码编译

xcodebuild -project RightClickTools.xcodeproj \
  -scheme RightClickTools \
  -configuration Release \
  -derivedDataPath build \
  build

编译产物位于:

build/Build/Products/Release/RightClickTools.app

使用

  1. 启动 RightClickTools,菜单栏会出现应用图标。
  2. 点击菜单栏图标或应用图标可打开功能设置页。
  3. 在 Finder 中右键点击文件、文件夹或空白区域,使用对应的右键菜单功能。

权限说明

macOS 对 Finder Sync 扩展、文件访问和自动化控制有较严格限制。部分功能可能需要以下权限:

  • 完全磁盘访问权限:用于访问 Finder 中选中的文件或目录。
  • 自动化权限:用于控制 Finder、Terminal、Sublime Text。
  • Finder 扩展权限:用于显示 Finder 原生右键菜单。

如果右键菜单不显示或功能无响应,可以尝试:

killall Finder

然后重新打开 Finder 测试。

技术栈

  • Swift 5
  • SwiftUI
  • AppKit
  • FinderSync Extension
  • UserNotifications

系统要求

  • macOS 11.0 或更高版本
  • Xcode 15 或更高版本用于源码编译

致谢

感谢原项目 KylinWDS/RightClickTools 提供基础实现。

About

macOS Finder 右键菜单增强工具,基于 KylinWDS/RightClickTools 修改

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors