Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

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: about 2 months ago
JSON representation

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

Host: GitHub
URL: https://github.com/Ji4n1ng/OpenInTerminal
Owner: Ji4n1ng
License: mit
Created: 2019-04-11T13:23:23.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2024-05-11T10:00:07.000Z (7 months ago)
Last Synced: 2024-10-16T05:41:03.765Z (about 2 months ago)
Language: Swift
Homepage:
Size: 27.9 MB
Stars: 5,910
Watchers: 35
Forks: 233
Open Issues: 36
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

awesome-github-star - OpenInTerminal
awesome-list - OpenInTerminal
awesome-opensource-macOS - OpenInTerminal
awesome-personal - OpenInTerminal - Open Terminal/VS Code/CotEditor in Current Directory (Desktop & Web Applications / macOS Specific )
open-source-mac-os-apps - OpenInTerminal - Finder Toolbar app for macOS to open the current directory in Terminal, iTerm, Hyper or Alacritty. ![swift_icon] (Applications / Finder)
open-source-mac-os-apps - OpenInTerminal - Finder Toolbar app for macOS to open the current directory in Terminal, iTerm, Hyper or Alacritty. ![swift_icon] (Applications / Terminal)
awesome-swift-macos-apps - OpenInTerminal - Finder Toolbar app for macOS to open the current directory in Terminal, iTerm, Hyper or Alacritty. (Terminal / Text)
awesome-swift-macos-apps - OpenInTerminal - Finder Toolbar app for macOS to open the current directory in Terminal, iTerm, Hyper or Alacritty. (Terminal / Text)

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/)