Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/Ji4n1ng/OpenInTerminal

✨ Finder Toolbar app for macOS to open the current directory in Terminal, iTerm, Hyper or Alacritty.
https://github.com/Ji4n1ng/OpenInTerminal

Last synced: 28 days ago
JSON representation

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

Lists

README 

        


  



  

  

  

  




**OpenInTerminal**: English | [中文说明](./Resources/README-zh.md) | [Türkçe](./Resources/README-tr.md) | [OpenInTerminal Deutsch](./Resources/README-de.md)



**OpenInTerminal-Lite**: [English](./Resources/README-Lite.md) | [中文说明](./Resources/README-Lite-zh.md) | [Deutsch](./Resources/README-Lite-de.md)



## How to use 🚀



| Core Features | OpenInTerminal |

| --- | --- |

| Open X (e.g., folders or files) in Terminal or Editor | ![](https://user-images.githubusercontent.com/11001224/78589385-b797b880-7872-11ea-9062-c11a49461598.gif) | 

| Open the selected in X (e.g., Github Desktop) | ![](https://user-images.githubusercontent.com/11001224/104891620-28483580-59ac-11eb-9fb5-3e4dec7863cc.gif) |



### More features



| Features | OpenInTerminal | OpenInTerminal-Lite & OpenInEditor-Lite |

| --- | --- | --- |

| Support Terminal, [iTerm](https://www.iterm2.com/), [Hyper](https://github.com/zeit/hyper), [Alacritty](https://github.com/jwilm/alacritty), [kitty](https://sw.kovidgoyal.net/kitty/), [Warp](https://www.warp.dev), [WezTerm](https://wezfurlong.org/wezterm/index.html), [Tabby](https://tabby.sh). | ✅ | ✅ |

| Support TextEdit, Xcode, [Visual Studio Code](https://code.visualstudio.com/), [VSCode Insiders](https://code.visualstudio.com/insiders/), [Atom](https://atom.io/), [Sublime Text](https://www.sublimetext.com/), [VSCodium](https://github.com/VSCodium/vscodium), [BBEdit](https://www.barebones.com/products/bbedit/), [TextMate](https://macromates.com), [CotEditor](https://coteditor.com/), [MacVim](https://github.com/macvim-dev/macvim), [JetBrains](https://www.jetbrains.com/)(AppCode, CLion, GoLand, IntelliJ IDEA, PhpStorm, PyCharm, RubyMine, WebStorm, Android Studio, Fleet), [Typora](https://typora.io/), [Nova](https://nova.app/), [Cursor](https://cursor.sh/). | ✅ | ✅ |

| 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](./Resources/README-Lite.md) | [中文说明](./Resources/README-Lite-zh.md) | [Deutsch](./Resources/README-Lite-de.md)



## How to install 🖥



### 1. Download



#### a) Homebrew



```

brew install --cask openinterminal

```



#### b) Manual



1. Download from [release](https://github.com/Ji4n1ng/OpenInTerminal/releases).



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](https://github.com/sponsors/Ji4n1ng) 💖.



| PayPal | AliPay | WeChat Pay |

| --- | --- | --- |

| [paypal.me/ji4ning](https://www.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](https://github.com/sponsors/Ji4n1ng) and [contributors](https://github.com/Ji4n1ng/OpenInTerminal/graphs/contributors). Your work makes OpenInTerminal better.



### Reference projects



- [jbtule/cdto](https://github.com/jbtule/cdto)

- [es-kumagai/OpenTerminal](https://github.com/es-kumagai/OpenTerminal)

- [tingraldi/SwiftScripting](https://github.com/tingraldi/SwiftScripting)

- [onmyway133/FinderGo](https://github.com/onmyway133/FinderGo)

- [Caldis/Mos](https://github.com/Caldis/Mos/)