Home

Awesome

<p align="center"> <img width="80%" src="https://user-images.githubusercontent.com/11001224/104892170-d18f2b80-59ac-11eb-96b1-0293acfde4e5.png"><br/><br/> <a href="https://github.com/Ji4n1ng/OpenInTerminal/releases/tag/v2.3.6"><img src="https://img.shields.io/badge/Version-2.3.6-blue.svg"></a> <a href="https://github.com/Ji4n1ng/OpenInTerminal/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green.svg"></a> <img src="https://img.shields.io/badge/Made With-Swift-red.svg"> <a href="https://travis-ci.org/Ji4n1ng/OpenInTerminal"><img src="https://img.shields.io/travis/Ji4n1ng/OpenInTerminal.svg"></a> </p>

OpenInTerminal: English | 中文说明 | Türkçe | OpenInTerminal Deutsch

OpenInTerminal-Lite: English | 中文说明 | Deutsch

How to use 🚀

Core FeaturesOpenInTerminal
Open X (e.g., folders or files) in Terminal or Editor
Open the selected in X (e.g., Github Desktop)

More features

FeaturesOpenInTerminalOpenInTerminal-Lite & OpenInEditor-Lite
Support Terminal, iTerm, Hyper, Alacritty, kitty, Warp, WezTerm, Tabby.
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.
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 and OpenInEditor-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: English | 中文说明 | Deutsch

How to install 🖥

1. Download

a) Homebrew

brew install --cask openinterminal

b) Manual

  1. Download from release.

  2. Move the app into /Applications.

⚠️ macOS will ask your permissions to access Finder and other applications when you run the app for the first time. Please give OpenInTerminal the permissions.

2. Check Finder Extension permission

Open the OpenInTerminal app. Go to System Preferences -> Extensions -> Finder Extensions, check the permission button as below.

<div> <img src="https://user-images.githubusercontent.com/11001224/78590336-448f4180-7874-11ea-827c-ad3a7bffca5e.png" width="400px"> </div>

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 💖.

PayPalAliPayWeChat Pay
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>

FAQ ❓

<details><summary>1. What is the difference between OpenInTerminal and OpenInTerminal-Lite?</summary><br> <p>OpenInTerminal's got two flavors: the regular and the lite. If you're into fancy features and GUI preferences, stick with the standard OpenInTerminal. But if you just wanna open terminal in a quick and stably way, OpenInTerminal-Lite is your friend.</p> </details> <details><summary>2. Oops, hit <code>Don't Allow</code> button by mistake.</summary><br> <p>No sweat! Just run the following command in your terminal, and it'll reset the permissions in System Preferences.</p> <br><code>tccutil reset AppleEvents wang.jianing.app.OpenInTerminal</code><br> </details> <details><summary>3. Special characters in the <code>path</code>.</summary><br> <p>Please do not use backslash <code>\</code> and double quotes <code>"</code> in the path.</p> </details> <details><summary>4. Open two Terminal windows on Mojave</summary><br> <p>This problem usually occurs when you first start Terminal. Try using <code>⌘W</code> to close Terminal window, instead of using <code>⌘Q</code> to quit Terminal.</p> </details> <details><summary>5. OpenInTerminal's Finder extension doesn't work.</summary><br> <p>The Finder extension relies on AppleScript. So it's hard to guarantee its stability. When the extension doesn't work properly, try this: hold down the <code>Option(⌥)</code> key, right-click on Finder, and select <code>Relaunch</code>.</p> <p>Got an older Mac like me? Maybe cancel showing the icon in the context menu in Preferences. If it still crashes frequently, consider switching to OpenInTerminal-Lite.</p> </details> <details><summary>6. OpenInTerminal doesn't work as I expected</summary><br> <p>OpenInTerminal works as the following order:</p> <ul> <li>1. Open the file or folder you selected.</li> <li>2. If nothing's selected, it opens the top Finder window.</li> <li>3. If there's no Finder window. it opens the desktop.</li> </ul> </details> <details><summary>7. My custom app doesn't work.</summary><br> <p>If your custom application doesn't work with the following command, then it's not supported. For example, GitHub Desktop:</p> <code>open -a GitHub\ Desktop ~/Desktop</code> </details>

Changes 🗒

<details><summary>show all</summary><br> <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 and contributors. Your work makes OpenInTerminal better.

Reference projects