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

Related tags

OpenInTerminal
Overview



English | OpenInTerminal 中文说明

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 and JetBrains(AppCode, CLion, GoLand, IntelliJ IDEA, PhpStorm, PyCharm, RubyMine, WebStorm).
Open in custom apps. ( ⚠️ Not all apps support.)
Support English, Chinese, French, Russian, Italian and Spanish.
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 中文说明

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

Issues
  • 重装后无法打开应用

    重装后无法打开应用

    我的系统是10.14.5,我之前卸载了brew。然后又重装了openinterminal-lite,用brew和手动安装都试过。点击图标后没有运行

    bug 
    opened by wyibo 25
  • Cannot be used in Finder

    Cannot be used in Finder

    What is the issue?

    Cannot be used in Finder

    How does one reproduce the issue?

    image 屏幕录制2020-06-29 10 56 16 2020-06-29 10_57_27

    I won't be able to use it even if I restart Finder. But the menu bar can be used.

    重启访达也不行,菜单栏的倒是可以使用。

    Debug information (Logs, OS, Hardware, Version, etc.)

    bug 
    opened by liuzhihang 19
  • use `open` to handle iTerm

    use `open` to handle iTerm

    Summarize this feature

    import Foundation
    
    final class iTermApp: Terminal {
        
        func open(_ path: String, _ newOption: NewOptionType, _ clear: ClearOptionType) throws {
            
            guard let url = URL(string: path) else {
                throw OITError.wrongUrl
            }
            
            let source = """
                tell application "iTerm"
                    open "\(url.path)"
                end tell
                """
            
            let script = NSAppleScript(source: source)!
            
            var error: NSDictionary?
            
            script.executeAndReturnError(&error)
            
            if error != nil {
                throw OITError.cannotAccessIterm
            }
        }
        
    }
    

    Why should this feature be included?

    remove ugly cd command

    Additional information

    drawback: new window or tab must be configure via iTerm

    enhancement 
    opened by pynixwang 16
  • iTerm2 打不开

    iTerm2 打不开

    iTerm2 打不开 自带终端可以正常使用 感谢作者

    opened by kbk01 14
  • Unable to launch this App 2.0.4

    Unable to launch this App 2.0.4

    What is the issue?

    Unable to launch after upgrade from 2.0.3 to 2.0.4 or reinstall after uninstall it

    How does one reproduce the issue?

    Just click the app after installed it.

    Screenshots

    None.

    Debug information (Logs, OS, Hardware, Version, etc.)

    macOS: 10.14.6 (18G87) Hardware: MacBook Pro (13-inch, 2018, Four Thunderbolt 3 Ports) App Version: 2.0.4

    bug 
    opened by Xwoder 13
  • 建议:添加到brew cask 源

    建议:添加到brew cask 源

    enhancement 
    opened by fashioncj 11
  • Signature Problem. Help wanted.

    Signature Problem. Help wanted.

    What is the issue?

    I don't have Apple Developer Account. I used to sign OpenInTerminal via Product -> Archive -> Distribute App -> Copy App with my free account. Then I upload OpenInTerminal.app to GitHub and Homebrew. But recently I signed version 2.1.0 app. It works on my mac, but it crashed on other mac. I don't know why. It seems like Apple has revoked my certificate. Any one can help me?

    How does one reproduce the issue?

    Screenshots

    Debug information (Logs, OS, Hardware, Version, etc.)

    Process:               OpenInTerminal [5004]
    Path:                  /private/var/folders/*/OpenInTerminal.app/Contents/MacOS/OpenInTerminal
    Identifier:            wang.jianing.OpenInTerminal
    Version:               ???
    Code Type:             X86-64 (Native)
    Parent Process:        ??? [1]
    Responsible:           OpenInTerminal [5004]
    User ID:               501
    
    Date/Time:             2019-10-16 16:22:11.946 +0800
    OS Version:            Mac OS X 10.14.6 (18G103)
    Report Version:        12
    Anonymous UUID:        721F6ACB-BB44-67A1-B37E-C4BBDA32D63C
    
    Sleep/Wake UUID:       18C49C29-E36B-4531-92CC-BEF1344B9AC1
    
    Time Awake Since Boot: 63000 seconds
    Time Since Wake:       250 seconds
    
    System Integrity Protection: enabled
    
    Notes:                 Translocated Process
    
    Crashed Thread:        0
    
    Exception Type:        EXC_CRASH (Code Signature Invalid)
    Exception Codes:       0x0000000000000000, 0x0000000000000000
    Exception Note:        EXC_CORPSE_NOTIFY
    
    Termination Reason:    Namespace CODESIGNING, Code 0x1
    
    kernel messages:
    
    VM Regions Near 0 (cr2):
    --> 
        __TEXT                 000000010a7dd000-000000010a7f2000 [   84K] r-x/r-x SM=COW  
    
    Thread 0 Crashed:
    0                                 	0x0000000112565000 _dyld_start + 0
    
    Thread 0 crashed with X86 Thread State (64-bit):
      rax: 0x0000000000000000  rbx: 0x0000000000000000  rcx: 0x0000000000000000  rdx: 0x0000000000000000
      rdi: 0x0000000000000000  rsi: 0x0000000000000000  rbp: 0x0000000000000000  rsp: 0x00007ffee5422ae0
       r8: 0x0000000000000000   r9: 0x0000000000000000  r10: 0x0000000000000000  r11: 0x0000000000000000
      r12: 0x0000000000000000  r13: 0x0000000000000000  r14: 0x0000000000000000  r15: 0x0000000000000000
      rip: 0x0000000112565000  rfl: 0x0000000000000200  cr2: 0x0000000000000000
      
    Logical CPU:     0
    Error Code:      0x00000000
    Trap Number:     0
    
    
    Binary Images:
           0x10a7dd000 -        0x10a7f1fff + (0) <2D4BB685-63BD-3D19-AA55-385BA98536DE> 
           0x112564000 -        0x1125ce70f + (655.1.1) <DFC3C4AF-6F97-3B34-B18D-7DCB23F2A83A> 
    
    External Modification Summary:
      Calls made by other processes targeting this process:
        task_for_pid: 0
        thread_create: 0
        thread_set_state: 0
      Calls made by this process:
        task_for_pid: 0
        thread_create: 0
        thread_set_state: 0
      Calls made by all processes on this machine:
        task_for_pid: 82504
        thread_create: 0
        thread_set_state: 0
    
    VM Region Summary:
    ReadOnly portion of Libraries: Total=716K resident=0K(0%) swapped_out_or_unallocated=716K(100%)
    Writable regions: Total=8400K written=0K(0%) resident=0K(0%) swapped_out=0K(0%) unallocated=8400K(100%)
     
                                    VIRTUAL   REGION 
    REGION TYPE                        SIZE    COUNT (non-coalesced) 
    ===========                     =======  ======= 
    STACK GUARD                       56.0M        1 
    Stack                             8192K        1 
    __DATA                             248K        3 
    __LINKEDIT                         204K        2 
    __TEXT                             512K        2 
    shared memory                        8K        2 
    ===========                     =======  ======= 
    TOTAL                             64.9M       11 
    
    help wanted 
    opened by Ji4n1ng 11
  • Feature request: Open in new tab

    Feature request: Open in new tab

    Hi, is it possible to open a new tab into an existing Terminal instead a new Terminal?

    opened by cristibaluta 8
  • [FR] Alacritty support

    [FR] Alacritty support

    Summarize this feature

    Alacritty (https://github.com/jwilm/alacritty) is a blazing fast terminal emulator app written in Rust, so my request is to support opening with that app in addition to Terminal, iTerm, and Hyper.

    Why should this feature be included?

    Alacritty is becoming more and more popular.

    Additional information

    N/A

    enhancement 
    opened by 4cm4k1 8
  • Can it be possible not launch at login

    Can it be possible not launch at login

    Summarize this feature

    I found an app in APP store ,and it is very similar to OpenInTerminal, and it dosn't need launch at login . So can it be possible not to launch at login ? BTW ,OpenInTerminal is an awesome APP !

    Why should this feature be included?

    not to launch at login

    Additional information

    enhancement 
    opened by L1cardo 8
  • Support for neovim

    Support for neovim

    Summarize this feature

    It would be great to have support for opening files in Neovim in Alacritty.

    Why should this feature be included?

    To support terminal neovim users

    Additional information

    There is an automator workflow here that demonstrates the workflow, but it does not work for Alacritty, as it does not support AppleScript. I discovered this extension supports Alacritty, so hopefully this feature can be implemented.

    enhancement 
    opened by burgessa23 0
  •  Feature request

    Feature request

    Thank you very much for providing this tool, it is very useful for me.However, I think there are some imperfections. I would like to put forward some suggestions. I hope you don't mind my unfathomable ideas.

    Summarize this feature

    I want to be able to launch more quickly through the toolbar icon, rather than clicking on the icon to appear a drop-down option at launch. Because there are only one or two features that my colleagues and I want to jump-start

    Why should this feature be included?

    Because there are only one or two features that most people want to jump-start.

    Additional information

    I think it can be done in two ways.

    • Split the drop-down options into individual ICONS
    • Set mouse shortcuts
      • Ctrl + Left Mouse: open terminal
      • Shift + Left Mouse: open editor
    enhancement 
    opened by YeomanYe 0
  • Support Android Studio

    Support Android Studio

    Summarize this feature

    open the current directory or file in Android Studio.

    Why should this feature be included?

    Android Studio is also Jetbrains app, I guess its easy to support just like others

    enhancement 
    opened by NamekMaster 0
  • Too much space in Finder's toolbar item

    Too much space in Finder's toolbar item

    What is the issue?

    There is too much space between the app's icon and the down-arrow in Finder's toolbar.

    How does one reproduce the issue?

    Use the app's toolbar item

    Screenshots

    Screen Shot 2021-03-25 at 6 18 20 PM

    Debug information (Logs, OS, Hardware, Version, etc.)

    OS: 11.2.3 Version: 2.3.3

    bug 
    opened by mohdfareed 0
  • Only apply shortcuts on specific windows

    Only apply shortcuts on specific windows

    Summarize this feature

    Only apply global shortcuts to specific windows (iterm, etc.)

    Why should this feature be included?

    I've bound Cmd + Shift + t to Open with default Terminal. This works great but when I'm on Chrome the shortcut Cmd + Shift + t that opens the last closed tab doesn't work anymore.

    Additional information

    Thank you for this great piece of software!

    enhancement 
    opened by devnoname120 2
  • Toggle hidden files

    Toggle hidden files

    Summarize this feature

    I use an Automator app to toggle the visibility of hidden files in Finder. It's based on this AppleScript:

    tell application "System Events"
    	tell process "Finder"
    		keystroke "." using {command down, shift down}
    	end tell
    end tell
    

    I can drag this app onto the Finder menu bar, but it would be nicer if it could be included in OpenInTerminal's drop down menu.

    I was able to add it as a custom menu option in OpenInTerminal. Unfortunately, when selecting it in the menu, it doesn't have any effect.

    Even better than being able to get that to work, would be a built-in option to show this entry in the drop menu without the need for an Automator app.

    Why should this feature be included?

    It would be handy to have an infrequently used function available from a drop down menu in the Finder toolbar.

    enhancement 
    opened by brechtm 0
  • OpenInTerminal-Lite 1.2.2 doesn't work if not in /Applications

    OpenInTerminal-Lite 1.2.2 doesn't work if not in /Applications

    I have all my small tools in /Applications/Tools/.../... to keep my /Applications reserved for main Applications

    Sadly 1.2.2 doesn't work if it is not located in /Applications It would be really nice if you could fix that

    bug 
    opened by indexofrefraction 2
  • Catalina全新安装,勾上应用到状态栏和上下文反而没生效

    Catalina全新安装,勾上应用到状态栏和上下文反而没生效

    What is the issue?

    Catalina全新安装,勾上应用到状态栏和上下文反而没生效,不勾反而Finder生效了。

    Screenshots

    Snipaste_2021-02-04_13-58-45

    Debug information (Logs, OS, Hardware, Version, etc.)

    bug 
    opened by hsingll 1
  • Sidebar icons for external volumes can change in certain situations

    Sidebar icons for external volumes can change in certain situations

    What is the issue?

    The icons on the left sidebar change from the stock images

    How does one reproduce the issue?

    Open the finder with the volumes mounted and you are in the default icon set, as shown Screenshot 2021-02-03 at 00 07 56

    Screenshots

    Then once you mount/unmount a volume manually (e.g. EFI partition) then the icons change to something else:

    Screenshot 2021-02-03 at 00 08 12

    Debug information (Logs, OS, Hardware, Version, etc.)

    Nothing actually, but I can provide them if required Catalina 10.15.7 19H114

    bug 
    opened by 1alessandro1 0
  • 能否添加一个配置选项,在Finder拓展中使用二级菜单

    能否添加一个配置选项,在Finder拓展中使用二级菜单

    Summarize this feature

    Why should this feature be included?

    像下图这样。 Snipaste_2021-01-29_17-04-49 上下文菜单可以没那么臃肿。

    Additional information

    enhancement 
    opened by hsingll 0
Releases(v1.2.3)
Owner
Jianing Wang
student, security research intern, developer.
Jianing Wang
🐢 Open terminal quickly from Finder

???????????? ???? ❤️ Support my app ❤️ Push Hero - pure Swift native macOS application to test push notifications PastePal - Pastboard, note and short

Khoa 893 Jul 24, 2021
Finder Toolbar app to open the current directory in the Terminal

cd to... Finder Toolbar app to open the current directory in the Terminal. It's written in objective-c, and uses the scripting bridge so it's fast. It

Jay Tuley 1.9k Jul 26, 2021
:open_file_folder: macOS Finder toolbar app to open current folder in Visual Studio Code

OpenInCode ?? Finder toolbar app to open current folder in Visual Studio Code Installation and usage: Download app for Light or Dark mode or using bre

Sertaç Özercan 768 Jul 24, 2021
Execute custom scripts from the MacOS context menu (CTRL+click) in Finder.

?? FiScript FiScript is an open source application for MacOS, released under the MIT License. FiScript lets you execute custom scripts on your files/f

Morten 391 Jul 29, 2021
Duplicate Finder is a MacOS Application that is written by Swift. It's a useful tool that would help you to find all duplicate files which have the same names in the specific folder.

Duplicate Finder Duplicate Finder is a MacOS Application that is written by Swift. It's a useful tool that would help you to find all duplicate files

Mr.Nixon 54 Jul 5, 2021
Clipboard manager with advanced features

CopyQ CopyQ is advanced clipboard manager with editing and scripting features. Downloads Web Site Documentation Mailing List Bug Reports Donate Script

Lukas Holecek 3.7k Aug 3, 2021
Clipboard extension app for macOS.

Clipy is a Clipboard extension app for macOS. Requirement: macOS 10.10 Yosemite or higher Distribution Site : https://clipy-app.com Development Enviro

Clipy Project 5.1k Jul 27, 2021
List of useful Quick Look plugins for developers

Quick Look plugins List of useful Quick Look plugins for developers Install Using Homebrew Run brew install <package> Install all brew install qlcolor

Sindre Sorhus 16k Jul 21, 2021