/OpenInTerminal

✨ Finder Toolbar app for macOS to open the current directory in Terminal, iTerm, Hyper or Alacritty.

Primary LanguageSwiftMIT LicenseMIT



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

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

How to use 🚀

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

More features

Features OpenInTerminal OpenInTerminal-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.

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

Backers & Sponsors

FAQ ❓

1. What is the difference between OpenInTerminal and OpenInTerminal-Lite?

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.

2. Oops, hit Don't Allow button by mistake.

No sweat! Just run the following command in your terminal, and it'll reset the permissions in System Preferences.


tccutil reset AppleEvents wang.jianing.app.OpenInTerminal
3. Special characters in the path.

Please do not use backslash \ and double quotes " in the path.

4. Open two Terminal windows on Mojave

This problem usually occurs when you first start Terminal. Try using ⌘W to close Terminal window, instead of using ⌘Q to quit Terminal.

5. OpenInTerminal's Finder extension doesn't work.

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 Option(⌥) key, right-click on Finder, and select Relaunch.

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.

6. OpenInTerminal doesn't work as I expected

OpenInTerminal works as the following order:

  • 1. Open the file or folder you selected.
  • 2. If nothing's selected, it opens the top Finder window.
  • 3. If there's no Finder window. it opens the desktop.
7. My custom app doesn't work.

If your custom application doesn't work with the following command, then it's not supported. For example, GitHub Desktop:

open -a GitHub\ Desktop ~/Desktop

Changes 🗒

show all

version 2.3.7

  • Support Korean
  • Support Warp
  • Support WezTerm
  • Support Tabby
  • Support Fleet
  • Support Nova
  • Support Cursor
  • Support Xcode
  • For kitty users: open in a signle instance instead of a new one

version 2.3.6

  • Support German
  • Search apps installed by JetBrains Toolbox
  • Support Android Studio

version 2.3.5

  • Support dragging to reorder custom menu
  • Support Turkish
  • Support Typora

version 2.3.4

  • Update icons in context menu

version 2.3.3

  • Fix: cannot open path with white space when using shortcut

version 2.3.2

  • Fix: cannot open path with white space

version 2.3.1

  • Fix: cannot open alacritty
  • Feat: add quit button in preferences

version 2.3.0

  • Open custom apps. (Not all apps support)
  • Show icon in context menu. (For stability, old Mac models are not recommended to display icons)

version 2.2.3

  • Support kitty
  • Open multi-selected files in editors

version 2.2.2

  • Support Italian and Spanish
  • Fix: does not show Terminal and TextEdit

version 2.2.1

  • Support JetBrains
  • Fix: check whether an application exists

version 2.2.0

  • Custom Finder menu options
  • Support Russian
  • Support PhpStorm
  • Fix: doesn't work when opening desktop in terminal

version 2.1.1

  • Signed the application with the developer account. Bundle ID has changed
  • Support Finder Extension Standalone Operation Mode
  • Support CotEditor and MacVim
  • User can hide context menu items
  • Finder context menu item's title will change to the current default terminal or editor

version 2.0.5

  • Fix: check application exist bug

version 2.0.4

  • Support TextMate
  • Fix: keyboard shortcut bug

version 2.0.3

  • Fix: Finder context menu icon supports dark mode

version 2.0.2

  • Support Visual Studio Code - Insiders
  • Support for hiding the status bar icon

version 2.0.1

  • Support BBEdit
  • Add icon in Finder context menu
  • Fix: check application folder under home directory

version 0.10.2

  • Fix: Finder context menu does not appear on other disks.

version 0.10.1

  • iTerm will not leave `cd xxx` in history.
  • You need to click the `window` button or the `tab` button of iTerm again in `Preferences`.

version 0.10.0

  • Support keyboard shortcuts.
  • Support VSCodium.

version 0.9.1

  • Support French.

version 0.9.0

  • OpenInTerminal has been released after several weeks of development. If you have suggestions or there are bugs, please feel free to open an issue.

version 0.4.1

  • Support Alacritty

version 0.4.0

  • You can set a default to open a new tab or window when using Terminal and Hyper.

version 0.3.0

  • Change name to OpenInTerminal-Lite (OpenInTerminal will come as a more powerful version in the future.)
  • Fix a bug that some special characters in the path would crash the program when opening Hyper.

version 0.2.0

  • Add terminal selector
  • Cancel running clear command when opening iTerm

version 0.1.1

  • Support Hyper
  • Give priority to creating a new tab when opening iTerm

version 0.1.0

  • First release

Special Thanks to ❤️

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

Reference projects