README

<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, Hyper, Alacritty, kitty, Warp, WezTerm, Tabby, Ghostty, cmux.	✅	✅
Support TextEdit, Xcode, Visual Studio Code, VSCode Insiders, Atom, Sublime Text, VSCodium, BBEdit, TextMate, CotEditor, MacVim, JetBrains(AppCode, CLion, GoLand, IntelliJ IDEA, PhpStorm, PyCharm, RubyMine, WebStorm, Android Studio, Fleet), Typora, Nova, Cursor, notepad--, neovim.	✅	✅
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 | 中文 | Deutsch

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 document for how to install and trust unsigned apps.

brew install --cask openinterminal

Or manually download it from release.

Configuration and FAQ ⚙️

Please check the Configuration 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 💖.

PayPal	AliPay	WeChat Pay
paypal.me/ji4ning

Changes 🗒

<details><summary>show all</summary> version 2.3.9 <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> version 2.3.8 <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> version 2.3.7 <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> version 2.3.6 <ul> <li>Support German</li> <li>Search apps installed by JetBrains Toolbox</li> <li>Support Android Studio</li> </ul> version 2.3.5 <ul> <li>Support dragging to reorder custom menu</li> <li>Support Turkish</li> <li>Support Typora</li> </ul> version 2.3.4 <ul> <li>Update icons in context menu</li> </ul> version 2.3.3 <ul> <li>Fix: cannot open path with white space when using shortcut</li> </ul> version 2.3.2 <ul> <li>Fix: cannot open path with white space</li> </ul> version 2.3.1 <ul> <li>Fix: cannot open alacritty</li> <li>Feat: add quit button in preferences</li> </ul> version 2.3.0 <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> version 2.2.3 <ul> <li>Support kitty</li> <li>Open multi-selected files in editors</li> </ul> version 2.2.2 <ul> <li>Support Italian and Spanish</li> <li>Fix: does not show Terminal and TextEdit</li> </ul> version 2.2.1 <ul> <li>Support JetBrains</li> <li>Fix: check whether an application exists</li> </ul> version 2.2.0 <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> version 2.1.1 <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> version 2.0.5 <ul> <li>Fix: check application exist bug</li> </ul> version 2.0.4 <ul> <li>Support TextMate</li> <li>Fix: keyboard shortcut bug</li> </ul> version 2.0.3 <ul> <li>Fix: Finder context menu icon supports dark mode</li> </ul> version 2.0.2 <ul> <li>Support Visual Studio Code - Insiders</li> <li>Support for hiding the status bar icon</li> </ul> version 2.0.1 <ul> <li>Support BBEdit</li> <li>Add icon in Finder context menu</li> <li>Fix: check application folder under home directory</li> </ul> version 0.10.2 <ul> <li>Fix: Finder context menu does not appear on other disks.</li> </ul> version 0.10.1 <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> version 0.10.0 <ul> <li>Support keyboard shortcuts.</li> <li>Support VSCodium.</li> </ul> version 0.9.1 <ul> <li>Support French.</li> </ul> version 0.9.0 <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> version 0.4.1 <ul> <li>Support <code>Alacritty</code></li> </ul> version 0.4.0 <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> version 0.3.0 <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> version 0.2.0 <ul> <li>Add terminal selector</li> <li>Cancel running <code>clear</code> command when opening iTerm</li> </ul> version 0.1.1 <ul> <li>Support <code>Hyper</code></li> <li>Give priority to creating a new tab when opening iTerm</li> </ul> version 0.1.0 <ul> <li>First release</li> </ul> </details>

Special Thanks to ❤️

Thanks to all backers and contributors. Your work makes OpenInTerminal better.

Thanks to Sonar and Paul Gerste for the security audit and responsible disclosure.