/OpenInTerminal

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

Primary LanguageSwiftMIT LicenseMIT



English | OpenInTerminal 中文说明

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

HELP WANTED! Recently I have a signature problem with the version 2.1.0. Please see #61. Thanks a lot!

How to use 🚀

Features OpenInTerminal OpenInTerminal-Lite & OpenInEditor-Lite
Open current directory in Terminal (or Editor)
Open selected folder or file in Terminal (or Editor)
Copy path of the selected file or Finder window to Clipboard ❌ Not Supported

More features

Features OpenInTerminal OpenInTerminal-Lite & OpenInEditor-Lite
Support Terminal, iTerm, Hyper and Alacritty. ✅ ✅
Support Visual Studio Code, VSCode Insiders, Atom, Sublime Text, VSCodium, BBEdit and TextMate. ✅ ✅
Set to open a new tab or window. ✅ ✅
Support English, Chinese and French. ✅ ✅
GUI preferences ✅ ❌
Support keyboard shortcuts. ✅ ❌
Support Dark Mode. ✅ ❌
No need to run in the background ❌ ✅

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 or editor and don't want to keep the application in the background, then you can use OpenInTerminal-Lite.

For me, I prefer the Lite version, 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 中文说明

How to install 🖥

1. Download

a) Homebrew (current version: 2.0.5)

brew cask install openinterminal

b) Manual (latest version: 2.0.5)

  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.

3. Set OpenInTerminal to launch at login

Just check the Launch OpenInTerminal at login button in Preferences.

Because the Finder Extension does not work when the main app is not running, it is very recommended to set OpenInTerminal to launch at login.

Todo 👨‍💻

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

The upcoming festures 🎉

🎉 OpenInTerminal finally supports Finder Extersion Standalone Operation Mode in version 2.1.0. It is not necessary to run OpenInTerminal in the background.

  • Finder Extension Standalone Operation Mode.
  • Finder context menu title will change to the current default terminal / editor.
  • Open iTerm with split pane.

Support ❤️

Hello, I am Ji4n1ng. I am a student and OpenInTerminal is an open source project I maintain in my spare time. It is free and open source.

Recently because of strange bugs, signed OpenInTerminal(new version 2.1.0) cannot run on other computers. I don't know why. I will be very grateful that you can support me in purchasing an Apple Developer account ($99 is not a small number for students, it is close to my three-week living expenses.).

Or someone can help me solve this problem. Please see #61. Thanks a lot!

PayPal AliPay WeChat Pay
paypal.me/ji4n1ng AliPay WeChatPay

FAQ ❓

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

OpenInTerminal currently has a normal version and a lite version. If you only need to open the terminal and don't need to keep the application in the background, then you can use the Lite version. If you like more powerful features, then choose the normal version.

2. Finder Extension doesn't work

Please check if there is an OpenInTerminal(main app) icon in the status bar. The Finder Extension will always be in the toolbar. But if the main app is not open, it will not work. It is recommended to set OpenInTerminal to launch at login in Preferences.

3. 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
4. Special characters in the path.

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

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

Changes 🗒

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
old version

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 ❤️

Contributors

Translators

Reference projects