/OpenInTerminal

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

Primary LanguageSwiftMIT LicenseMIT



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

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

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 and kitty. ✅ ✅
Support TextEdit, Visual Studio Code, VSCode Insiders, Atom, Sublime Text, VSCodium, BBEdit, TextMate, CotEditor, MacVim, JetBrains(AppCode, CLion, GoLand, IntelliJ IDEA, PhpStorm, PyCharm, RubyMine, WebStorm), and Typora. ✅ ✅
Open in custom apps. (⚠️ Not all apps support.) ✅ ✅
Support English, Chinese, French, Russian, Italian, Spanish and Turkish ✅ ✅
GUI preferences ✅ ❌
Support keyboard shortcuts. ✅ ❌

OpenInTerminal and OpenInTerminal-Lite (OpenInEditor-Lite) 👀

Which one to choose? Both of these apps are my children. If you like more powerful features and GUI preferences, then you can use OpenInTerminal. If you just need to open terminal faster and more stably, then you can use OpenInTerminal-Lite.

For me, I prefer OpenInTerminal-Lite which only needs to click once to complete the function (and the other needs to click twice 😂) and it is more lightweight.

For OpenInTerminal-Lite users:

Please check the document: OpenInTerminal-Lite English | OpenInTerminal-Lite 中文说明 | OpenInTerminal-Lite Türkçe

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.

Todo 👨‍💻

If you have a good idea, feel welcome to open a new issue.

Support ❤️

Thank you for your support!

PayPal AliPay WeChat Pay
paypal.me/ji4ning

FAQ ❓

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

OpenInTerminal currently has a normal version and a lite version. If you like more powerful features and GUI preferences, then you can use OpenInTerminal. If you just need to open terminal faster and more stably, then you can use OpenInTerminal-Lite.

2. I accidentally clicked on the Don't Allow button.

You can run the following command in the terminal. This will reset the permissions in the 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 Terminal is first started. So you can use ⌘W to close Terminal window instead of using ⌘Q to quit Terminal.

5. OpenInTerminal Finder extension doesn't work.

Currently Finder extension is completely dependent on AppleScript in order to run independently. So it is hard to guarantee its stability. When you find that Finder extension doesn't work properly, you need to hold down the Option(⌥) key, right-click on Finder, and select Relaunch.

If your Mac model is a bit old like mine, I suggest you cancel the icon in the context menu in Preferences. If it still crashes frequently, it is recommended to use OpenInTerminal-Lite.

6. OpenInTerminal doesn't work as I expected

OpenInTerminal will open terminal or editor as the following order:

  • 1. Open the file or folder that you selected.
  • 2. Open the top Finder window.
  • 3. Neither. Then open the desktop.

For example, if you select a file in the bottom Finder window and you want to open the above Finder window in terminal, this will not work as you expected according to the above order.

Q: I right-click on the desktop but no terminal or editor appears. But actions in status bar menu work.

A: Try to select a file(folder) or open a Finder window. Because when you right-click on the desktop and nothing is selected, system does not provide program with the path of selected files. Under this situation, the program does not work.
Currently they(Fidner extension and actions in status bar menu) do not work as the same way. Finder extension is completely dependent on AppleScript in order to run independently, while status bar icon works as before. So they have different behaviors. This problem will be improved in the future.

7. The implementation mechanism of OpenInTerminal and why there are two versions.

There are two ways to achieve "open in terminal".

  • 1. ScriptingBridge. It's faster and more stable than the second one, although the differences are small. OpenInTerminal-Lite and actions of OpenInTerminal in status bar menu are based on this way. Its disadvantage is that applications which use ScriptingBridge to access user's directory infomation or something else cannot be sandboxed.
  • 2. AppleScript. Finder extension of OpenInTerminal is completely dependent on AppleScript in order to run independently. The first way cannot be applied to Finder extension because it is required to be sandboxed.

Some people want OpenInTerminal to be fast and stable(the lite version), while others want OpenInTerminal to be powerful and easier to configure(the normal version). Some people hope that OpenInTerminal can automatically adapt to dark mode(the normal version), while others just want to open the terminal with one click(the lite version).

When one version can no longer meet these needs, OpenInTerminal was split into a normal version and a lite version a few months ago.

(BTW, I know there are apps that are sandboxed and can achieve the same effect as OpenInTerminal. But I don't know how it implements this. If anyone knows it and is willing to talk to me, that would be great. I'm very happy to make OpenInTerminal more perfect so that one version is enough.😀)

8. My custom app doesn't work.

If your custom application cannot work by running the following command, then the application cannot be supported. For example, GitHub Desktop:

open -a GitHub\ Desktop ~/Desktop

Changes 🗒

show all

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 contributors. Your work makes OpenInTerminal better.

Contributors

Translators

Reference projects