discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens
Ji4n1ng/OpenInTerminal · source
Snapshot 0 · 2026-11-04T12:47:25Z · Swift · MIT
Content fingerprint
a2fbef78f0a115d54fa2217e53c4d702902c210bda72660898b2646cfd73b307GitHub description at capture
✨ Finder Toolbar app for macOS to open the current directory in Terminal, iTerm, Hyper or Alacritty.
README at capture
<div align="center"> <img width="80%" src="https://github.com/user-attachments/assets/43667e33-d02d-4a0e-8ca9-fd1cf411b24a"><br/><br/> <a href="./README.md">English</a> | <a href="./Resources/README-zh.md">中文</a> | <a href="./Resources/README-tr.md">Türkçe</a> | <a href="./Resources/README-de.md">Deutsch</a> </div> ## How to use 🚀 | Core Features | OpenInTerminal | | --- | --- | | Open items (e.g., folders or files) in Terminal or Editor. |  | | Open the selected item in your preferred apps (e.g., Github Desktop, Fork). |  | ### More features | Features | OpenInTerminal | OpenInTerminal-Lite & OpenInEditor-Lite | | --- | --- | --- | | Support Terminal, [iTerm](https://www.iterm2.com/), [Hyper](https://github.com/zeit/hyper), [Alacritty](https://github.com/jwilm/alacritty), [kitty](https://sw.kovidgoyal.net/kitty/), [Warp](https://www.warp.dev), [WezTerm](https://wezfurlong.org/wezterm/index.html), [Tabby](https://tabby.sh), [Ghostty](https://ghostty.org/), [cmux](https://github.com/manaflow-ai/cmux). | ✅ | ✅ | | Support TextEdit, Xcode, [Visual Studio Code](https://code.visualstudio.com/), [VSCode Insiders](https://code.visualstudio.com/insiders/), [Atom](https://atom.io/), [Sublime Text](https://www.sublimetext.com/), [VSCodium](https://github.com/VSCodium/vscodium), [BBEdit](https://www.barebones.com/products/bbedit/), [TextMate](https://macromates.com), [CotEditor](https://coteditor.com/), [MacVim](https://github.com/macvim-dev/macvim), [JetBrains](https://www.jetbrains.com/)(AppCode, CLion, GoLand, IntelliJ IDEA, PhpStorm, PyCharm, RubyMine, WebStorm, Android Studio, Fleet), [Typora](https://typora.io/), [Nova](https://nova.app/), [Cursor](https://cursor.sh/), [notepad--](https://github.com/cxasm/notepad--), [neovim](https://neovim.io/). | ✅ | ✅ | | Open in custom apps. (⚠️ Not all apps support.) | ✅ | ✅ | | Support English, Chinese, French, Russian, Italian, Spanish, Turkish, German and Korean | ✅ | ✅ | | GUI preferences | ✅ | ❌ | | Support keyboard shortcuts. | ✅ | ❌ | ## OpenInTerminal vs OpenInTerminal-Lite 👀 Wondering which one to choose? If you're all about fancy features and GUI settings, go for `OpenInTerminal`. But if you just want to open your terminal quickly and without fuss, `OpenInTerminal-Lite` is your buddy. I personally prefer `OpenInTerminal-Lite`. Why? It's a one-click wonder (while the other makes you click twice 😂) and it's more lightweight. Check **OpenInTerminal-Lite** Docs: [English](./Resources/README-Lite.md) | [中文](./Resources/README-Lite-zh.md) | [Deutsch](./Resources/README-Lite-de.md) ## Installation 🖥 > ⚠️ **Important:** Signed builds are no longer provided for **OpenInTerminal**, **OpenInTerminal-Lite**, or **OpenInEditor-Lite**. Before using these apps, please either trust the unsigned binaries or sign them yourself. See the [Configuration](./Resources/README-Config.md) document for how to install and trust unsigned apps. ``` brew install --cask openinterminal ``` Or manually download it from [release](https://github.com/Ji4n1ng/OpenInTerminal/releases). ## Configuration and FAQ ⚙️ Please check the [Configuration](./Resources/README-Config.md) document. Note: If you're on macOS 15 and above then you must follow the instructions in this document to make the context menu items appear. ## Support ❤️ Open-source projects cannot live long without your help. If you like OpenInTerminal, please consider supporting this project by becoming a sponsor. Your user icon or company logo shows up on the README with a link to your home page. Become a sponsor through [GitHub Sponsors](https://github.com/sponsors/Ji4n1ng) 💖. | PayPal | AliPay | WeChat Pay | | --- | --- | --- | | [paypal.me/ji4ning](https://www.paypal.me/ji4ning) | <img src="./Resources/Support-Alipay.jpg" width="50%"> | <img src="./Resources/Support-WeChatPay.jpg" width="50%"> | <!-- ### Backers & Sponsors --> <!----> <!-- <a href="https://github.com/wcoder"><img src="https://avatars.githubusercontent.com/u/766193?v=4" width="10%" style="border-radius:10px;" /></a> --> ## Changes 🗒 <details><summary>show all</summary><br> <p><strong>version 2.3.9</strong></p> <ul> <li>Security: Fixed an AppleScript/command injection vulnerability that allowed arbitrary command execution via a crafted folder name when opening it in a non-default terminal or an editor. Thanks to Paul Gerste (<a href="https://www.sonarsource.com">Sonar</a>) for the responsible disclosure.</li> <li>Added support for Zed, Emacs, Kakoune, GitKraken, and cmux.</li> <li>Added an option to limit global keyboard shortcuts to Finder-only shortcuts. (#251, #243)</li> <li>Introduced a new default app icon with automatic light/dark mode support.</li> <li>Added an option to display the Finder context menu items in a submenu.</li> <li>Fixed the Finder extension icon being rendered as a template icon.</li> <li>Improved startup responsiveness by fetching installed applications on a background thread.</li> <li>Fixed the keyboard shortcut overlapping the "Open in ..." title in the status bar menu.</li> </ul> <p><strong>version 2.3.8</strong></p> <ul> <li>Support "open in neovim" for Alacritty, WezTerm, and kitty users.</li> <li>Customize open command for kitty users</li> <li>Copy path with escaping</li> <li>Support fork, notepad--, Ghostty</li> <li>Support nix installed applications</li> </ul> <p><strong>version 2.3.7</strong></p> <ul> <li>Support Korean</li> <li>Support Warp</li> <li>Support WezTerm</li> <li>Support Tabby</li> <li>Support Fleet</li> <li>Support Nova</li> <li>Support Cursor</li> <li>Support Xcode</li> <li>For kitty users: open in a signle instance instead of a new one</li> </ul> <p><strong>version 2.3.6</strong></p> <ul> <li>Support German</li> <li>Search apps installed by JetBrains Toolbox</li> <li>Support Android Studio</li> </ul> <p><strong>version 2.3.5</strong></p> <ul> <li>Support dragging to reorder custom menu</li> <li>Support Turkish</li> <li>Support Typora</li> </ul> <p><strong>version 2.3.4</strong></p> <ul> <li>Update icons in context menu</li> </ul> <p><strong>version 2.3.3</strong></p> <ul> <li>Fix: cannot open path with white space when using shortcut</li> </ul> <p><strong>version 2.3.2</strong></p> <ul> <li>Fix: cannot open path with white space</li> </ul> <p><strong>version 2.3.1</strong></p> <ul> <li>Fix: cannot open alacritty</li> <li>Feat: add quit button in preferences</li> </ul> <p><strong>version 2.3.0</strong></p> <ul> <li>Open custom apps. (Not all apps support)</li> <li>Show icon in context menu. (For stability, old Mac models are not recommended to display icons)</li> </ul> <p><strong>version 2.2.3</strong></p> <ul> <li>Support kitty</li> <li>Open multi-selected files in editors</li> </ul> <p><strong>version 2.2.2</strong></p> <ul> <li>Support Italian and Spanish</li> <li>Fix: does not show Terminal and TextEdit</li> </ul> <p><strong>version 2.2.1</strong></p> <ul> <li>Support JetBrains</li> <li>Fix: check whether an application exists</li> </ul> <p><strong>version 2.2.0</strong></p> <ul> <li>Custom Finder menu options</li> <li>Support Russian</li> <li>Support PhpStorm</li> <li>Fix: doesn't work when opening desktop in terminal</li> </ul> <p><strong>version 2.1.1</strong></p> <ul> <li>Signed the application with the developer account. Bundle ID has changed</li> <li>Support Finder Extension Standalone Operation Mode</li> <li>Support CotEditor and MacVim</li> <li>User can hide context menu items</li> <li>Finder context menu item's title will change to the current default terminal or editor</li> </ul> <p><strong>version 2.0.5</strong></p> <ul> <li>Fix: check application exist bug</li> </ul> <p><strong>version 2.0.4</strong></p> <ul> <li>Support TextMate</li> <li>Fix: keyboard shortcut bug</li> </ul> <p><strong>version 2.0.3</strong></p> <ul> <li>Fix: Finder context menu icon supports dark mode</li> </ul> <p><strong>version 2.0.2</strong></p> <ul> <li>Support Visual Studio Code - Insiders</li> <li>Support for hiding the status bar icon</li> </ul> <p><strong>version 2.0.1</strong></p> <ul> <li>Support BBEdit</li> <li>Add icon in Finder context menu</li> <li>Fix: check application folder under home directory</li> </ul> <p><strong>version 0.10.2</strong></p> <ul> <li>Fix: Finder context menu does not appear on other disks.</li> </ul> <p><strong>version 0.10.1</strong></p> <ul> <li>iTerm will not leave `cd xxx` in history.</li> <li>You need to click the `window` button or the `tab` button of iTerm again in `Preferences`.</li> </ul> <p><strong>version 0.10.0</strong></p> <ul> <li>Support keyboard shortcuts.</li> <li>Support VSCodium.</li> </ul> <p><strong>version 0.9.1</strong></p> <ul> <li>Support French.</li> </ul> <p><strong>version 0.9.0</strong></p> <ul> <li>OpenInTerminal has been released after several weeks of development. If you have suggestions or there are bugs, please feel free to open an issue.</li> </ul> <p><strong>version 0.4.1</strong></p> <ul> <li>Support <code>Alacritty</code></li> </ul> <p><strong>version 0.4.0</strong></p> <ul> <li>You can set a default to open a new tab or window when using <code>Terminal</code> and <code>Hyper</code>.</li> </ul> <p><strong>version 0.3.0</strong></p> <ul> <li>Change name to <code>OpenInTerminal-Lite</code> (<code>OpenInTerminal</code> will come as a more powerful version in the future.)</li> <li>Fix a bug that some special characters in the path would crash the program when opening Hyper.</li> </ul> <p><strong>version 0.2.0</strong></p> <ul> <li>Add terminal selector</li> <li>Cancel running <code>clear</code> command when opening iTerm</li> </ul> <p><strong>version 0.1.1</strong></p> <ul> <li>Support <code>Hyper</code></li> <li>Give priority to creating a new tab when opening iTerm</li> </ul> <p><strong>version 0.1.0</strong></p> <ul> <li>First release</li> </ul> <br> </details> ## Special Thanks to ❤️ Thanks to all [backers](https://github.com/sponsors/Ji4n1ng) and [contributors](https://github.com/Ji4n1ng/OpenInTerminal/graphs/contributors). Your work makes OpenInTerminal better. ### Reference projects - [jbtule/cdto](https://github.com/jbtule/cdto) - [es-kumagai/OpenTerminal](https://github.com/es-kumagai/OpenTerminal) - [tingraldi/SwiftScripting](https://github.com/tingraldi/SwiftScripting) - [onmyway133/FinderGo](https://github.com/onmyway133/FinderGo) - [Caldis/Mos](https://github.com/Caldis/Mos/)