README-Lite.md

English | 中文说明

How to use 🚀

1) Open current directory from toolbar

2) Open selected folder or file from Toolbar

3) Set default terminal

You are asked to set the default terminal to open after first launch.

The selection box will not appear after you have set the default terminal. If you want to reset the default terminal, please enter the following command in the terminal. Then just run the application again.

For version 0.3.0 and above:

defaults remove wang.jianing.OpenInTerminal-Lite OIT_TerminalBundleIdentifier

For version 0.2.0:

defaults remove wang.jianing.OpenInTerminal OIT_TerminalBundleIdentifier

Set Alacritty as the default terminal:

defaults write wang.jianing.OpenInTerminal-Lite OIT_TerminalBundleIdentifier io.alacritty

4) Open in a new Tab or Window

When you are using Terminal and iTerm, you can set a default to open a new tab or window. The default is to open a new window.

For Terminal:

# Open a new Tab
defaults write wang.jianing.OpenInTerminal-Lite OIT_TerminalNewOption "tab"
# Open a new Window
defaults write wang.jianing.OpenInTerminal-Lite OIT_TerminalNewOption "window"

For iTerm:

# Open a new Tab
defaults write wang.jianing.OpenInTerminal-Lite OIT_iTermNewOption "tab"
# Open a new Window
defaults write wang.jianing.OpenInTerminal-Lite OIT_iTermNewOption "window"

For Hyper users, it is more recommended to open a new tab.

For Alacritty users, it is only supported to open a new window now.

How to install 🖥

Manual (latest version: 0.4.1)

1. Download from release.
2. Move the app into /Applications.
3. Hold down the Cmd key and drag the app into Finder Toolbar.
4. Done.

Homebrew (latest version 0.4.1)

1. Run the following command

   brew cask install openinterminal-lite
   

2. In /Applications folder, hold down the Cmd key and drag the app into Finder Toolbar.

3. Done

⚠️ macOS will ask your permissions to access Finder and Terminal (iTerm or Hyper) when you run the app for the first time. Please give the application permissions.

If you are using Dark Mode

I provided several icons along with the app in the release. You can right click on the app and select Get Info. Drag the icon to cover the default icon.

FAQ ❓

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

2. Special characters in the path.

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

Changes 🗒

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.

old version

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

• Camji55

Reference projects

• jbtule/cdto
• es-kumagai/OpenTerminal
• tingraldi/SwiftScripting