README Lite Zh

<a href="./README-Lite.md">English</a> | <a href="./README-Lite-zh.md">中文</a> | <a href="./README-Lite-de.md">Deutsch</a>

</div>

如何使用 🚀

1) 在终端（或编辑器）中打开当前目录

2) 在终端（或编辑器）中打开选择的文件夹或文件

3) 在自定义应用中打开 (例如, GitHub Desktop)

如何安装 🖥

Homebrew

运行以下命令

brew install --cask openinterminal-lite
# 或者
brew install --cask openineditor-lite

在 应用程序 文件夹中，按住 Cmd 键，然后将应用拖到访达工具栏中。

⚠️ 当您第一次运行应用程序时，macOS 将要求访问 访达 和 终端（或 iTerm）的权限。请给予应用程序权限。

手动安装

从 release 中下载。
将应用移动到 应用程序 文件夹。
按住 Cmd 键，然后将应用拖到访达工具栏中。

支持 ❤️

感谢你的支持！

PayPal	支付宝	微信
paypal.me/ji4ning

设置 🔨

1) 设置默认终端（或编辑器）

在第一次运行应用的时候，需要选择默认终端。

当设置了默认终端之后，选择框将不会再出现。如果想要重新设置默认终端，请在终端中输入以下命令。然后重新运行应用。

# 对于 OpenInTerminal-Lite:
defaults remove wang.jianing.app.OpenInTerminal-Lite LiteDefaultTerminal
# 对于 OpenInEditor-Lite:
defaults remove wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor

将下列应用设置为默认：

应用	命令
Alacritty	`defaults write wang.jianing.app.OpenInTerminal-Lite LiteDefaultTerminal Alacritty`
cmux	`defaults write wang.jianing.app.OpenInTerminal-Lite LiteDefaultTerminal cmux`
kitty	`defaults write wang.jianing.app.OpenInTerminal-Lite LiteDefaultTerminal kitty`
Ghostty	`defaults write wang.jianing.app.OpenInTerminal-Lite LiteDefaultTerminal ghostty`
TextEdit	`defaults write wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor TextEdit`
VSCodium	`defaults write wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor VSCodium`
BBEdit	`defaults write wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor BBEdit`
Visual Studio Code - Insiders	`defaults write wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor Visual\ Studio\ Code\ -\ Insiders`
TextMate	`defaults write wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor TextMate`
CotEditor	`defaults write wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor CotEditor`
MacVim	`defaults write wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor MacVim`
Typora	`defaults write wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor Typora`
Neovim	`defaults write wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor Neovim`
Nova	`defaults write wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor Nova`
Cursor	`defaults write wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor Cursor`
AppCode	`defaults write wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor AppCode`
CLion	`defaults write wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor CLion`
GoLand	`defaults write wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor GoLand`
IntelliJ IDEA	`defaults write wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor IntelliJ\ IDEA`
PhpStorm	`defaults write wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor PhpStorm`
PyCharm	`defaults write wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor PyCharm`
RubyMine	`defaults write wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor RubyMine`
WebStorm	`defaults write wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor WebStorm`
Android Studio	`defaults write wang.jianing.app.OpenInEditor-Lite LiteDefaultEditor Android\ Studio`

如果你想要使用自定义应用，那么你可以下面的命令。以 GitHub Desktop 为例。

defaults write wang.jianing.app.OpenInTerminal-Lite LiteDefaultTerminal GitHub\ Desktop

针对 Neovim 用户

如果您选择 Neovim 作为编辑器，应用将默认使用 Kitty 作为终端。要切换到其他终端（支持的选项包括 Alacritty、WezTerm 和 Kitty），请使用以下命令更新配置。根据您的安装调整 Neovim 路径（此示例为 /opt/homebrew/bin/nvim）：

defaults write wang.jianing.app.OpenInEditor-Lite NeovimCommand "open -na Alacritty --args -e /opt/homebrew/bin/nvim PATH"

其他终端配置：

// Kitty:
"open -na kitty --args /opt/homebrew/bin/nvim PATH"
// WezTerm:
"open -na wezterm --args start /opt/homebrew/bin/nvim PATH"
// Alacritty:
"open -na Alacritty --args -e /opt/homebrew/bin/nvim PATH"

针对 Kitty 用户

Kitty 的默认启动行为是为每个命令打开一个新实例，如下所示：

open -na kitty --args --single-instance --instance-group 1 --directory

如果您想自定义此行为，可以在终端中运行以下命令。请根据需要调整 open 命令：

defaults write wang.jianing.app.OpenInTerminal-Lite KittyCommand "open -na kitty --args --single-instance --instance-group 1 --directory"

2) 如果你正在使用深色模式 (Dark Mode)

macOS Tahoe 及更高版本

依次进入 系统设置 -> 外观 -> 图标与小组件样式，然后选择 自动。请注意，这会自动切换所有应用的图标。如果你只想切换 OpenInTerminal-Lite 的图标，请按照下面的步骤操作。

macOS Tahoe 之前

我在 release 中提供了几个图标。

a) 手动更换图标

您可以右键单击该应用程序并选择 显示简介，然后拖动图标以覆盖默认图标。

b) 使用动态图标（macOS Big Sur 及更高版本，推荐）

动态图标无需任何额外工具即可自动适配浅色与深色模式。它们位于 Resources/dynamic-icons/。

只需按照上面的方法，手动应用一次你所选择的图标即可。

图标会随系统外观自动切换——无需 Hammerspoon。

c) 利用 Hammerspoon 自动更换图标

此方法适用于 macOS Catalina 及更早版本，或当你更倾向于使用独立的浅色/深色图标文件时。

通过下载最新版本并将其拖动到 /Applications 文件夹中，或使用 Homebrew 安装 Hammerspoon:

brew install --cask hammerspoon

安装 fileicon 程序，以编程的方式更改图标:

brew install fileicon

创建 ~/.hammerspoon/Icons 文件夹，并将图标放在此处
创建 ~/.hammerspoon/init.lua 文件（如果该文件不存在），并添加以下代码：

lua

local function setOpenInEditorLiteIcon(dark)
  -- 如果安装到其他路径，请替换下面的路径
  local appPath = "/Applications/OpenInEditor-Lite.app"
  -- 根据你想使用的图标(editor, atom, sublime, vscode)来更改下面的类型
  local iconType = "editor"
  local iconsFolder = hs.fs.currentDir() .. "/Icons"
  local theme = dark and "dark" or "light"
  hs.execute('fileicon set "' .. appPath .. '" "' .. iconsFolder .. "/icon_" .. iconType .. "_" .. theme .. '.icns"', true)
end

local function setOpenInTerminalLiteIcon(dark)
  -- 如果安装到其他路径，请替换下面的路径
  local appPath = "/Applications/OpenInTerminal-Lite.app"
  -- 根据你想使用的图标(terminal, iterm, hyper)来更改下面的类型
  local iconType = "terminal"
  local iconsFolder = hs.fs.currentDir() .. "/Icons"
  local theme = dark and "dark" or "light"
  hs.execute('fileicon set "' .. appPath .. '" "' .. iconsFolder .. "/icon_" .. iconType .. "_" .. theme .. '.icns"', true)
end

local function updateIcons()
  darkMode = (hs.settings.get("AppleInterfaceStyle") == "Dark")
  setOpenInEditorLiteIcon(darkMode)
  setOpenInTerminalLiteIcon(darkMode)
end

updateIcons()
hs.settings.watchKey("dark_mode", "AppleInterfaceStyle", function()
  updateIcons()
end)

现在可以重新加载配置文件（或重新启动 Hammerspoon），就完成了！从亮模式切换为暗模式时，图标应自动更新，反之亦然。不要忘记勾选 "登录时启动 Hammerspoon" 选项。

3) 使用 iTerm 时，打开新的标签页或者窗口

当你在使用 iTerm 时，你可以设置默认打开一个新的标签或者窗口。默认是打开新的窗口。

# 打开新的标签
defaults write com.googlecode.iterm2 OpenFileInNewWindows -bool false
# 打开新的窗口
defaults write com.googlecode.iterm2 OpenFileInNewWindows -bool true

常见问题 ❓

<details><summary>1. 我不小心点了不授权的按钮</summary> <p>你可以运行以下命令。这会重置系统设置里的权限。</p> <pre><code># 对于 OpenInTerminal-Lite: tccutil reset AppleEvents wang.jianing.app.OpenInTerminal-Lite # 对于 OpenInEditor-Lite: tccutil reset AppleEvents wang.jianing.app.OpenInEditor-Lite </code></pre> </details> <details><summary>2. 路径里的特殊字符</summary> <p>请不要在路径中使用反斜线 <code>\</code> 和双引号 <code>"</code>。</p> </details> <details><summary>3. 为什么不能根据深色模式自动切换图标</summary> <p>对于 <code>OpenInTerminal-Lite</code> 来说，访达工具栏里的图标是应用图标，而不是访达扩展图标。目前没有 API 可以实时切换应用图标。</p> <p>在 macOS Big Sur 及更高版本上，你可以使用 <code>Resources/dynamic-icons/</code> 中的<strong>动态图标</strong>——单个 <code>.icns</code> 文件同时包含两种外观，并会随系统自动切换。参见上文 2b 小节。</p> <p>在更旧的 macOS 上，感谢 @MatteoCarnelos 的贡献(#126)，你可以使用 Hammerspoon 来自动切换图标。参见上文 2c 小节。</p> </details> <details><summary>4. 我的自定义应用不工作</summary> <p>如果你的自定义应用不能通过运行以下命令正常运行，那么该应用不支持通过 OpenInTerminal 打开。例如，GitHub Desktop:</p> <code>open -a GitHub\ Desktop ~/Desktop</code> </details>

特别感谢 ❤️

所有贡献者和支持者！