Master iTerm2: Turn Your Mac Terminal into a Floating, Hotkey‑Activated Power Tool

For engineers who spend a lot of time in a terminal, iTerm2 on macOS can be turned into a powerful, floating terminal that appears at the top of the screen and can be toggled with a hotkey.

01 Floating Window

Create a new profile named HotKey Window via Preferences → Profiles. In Preferences → Profiles → Window → Window Appearance enable Full‑Width Top of Screen , Current Space and Screen Width Cursor to make the window span the full width and stay in the current workspace.

Background Transparency & Blur

Set transparency and blur in Preferences → Profiles → Window → Window Appearance.

Window Style Configuration

Adjust settings under

Preferences → Profiles → Window → Settings for New Windows

to control window style.

HotKey Setup

In Preferences → Profiles → Keys → HotKey Window enable A hotkey opens a dedicated window with this profile and configure the desired hotkey (e.g., F12). For MacBooks without a Touch Bar, set the function keys to act as standard keys in System Preferences → Keyboard. For Touch Bar models, use a combination such as Fn+F12.

Cursor Shape

Change the cursor shape under Preferences → Profiles → Text to a more readable style.

Custom Logo

Set a custom logo in Preferences → Profiles → General to personalize new terminal windows.

Custom Tab Title

Disable Applications in terminal may change the title and enable Profile Name while disabling Job Name so each tab shows the profile name.

Color Scheme

Download schemes from iterm2colorschemes.com , import them via

Preferences → Profiles → Colors → Color Presets → Import

, and select a preferred theme (e.g., Ubuntu).

Unified Tab Color

Set the overall theme to Minimal in Appearance → General to apply the chosen color scheme to tab bars.

Hide Dock Icon & Startup Window

Enable Exclude from Dock and … in Appearance → General to prevent iTerm2 from showing a default window or Dock icon on launch.

Shell Integration

Install shell integration via the menu iTerm2 → Install Shell Integration or run:

# If your default shell is bash, replace zsh with bash
curl -L https://iterm2.com/misc/install_shell_integration.sh | zsh

This adds markers, command history, current directory, and host information to the prompt. The blue triangle indicator shows integration is active; it can be disabled in

Preferences → Profiles → Terminal → Shell Integration → Show mark indicators

.

Useful iTerm2 Tools

imgcat filename          # display image inline
imgls                    # list directory with thumbnails
it2api                   # manipulate iTerm2 from CLI
it2check                 # check if terminal is iTerm2
it2copy [filename]       # copy to pasteboard
it2dl filename           # download file to Downloads folder
it2setcolor …           # change colors or load preset
it2setkeylabel …        # modify Touch Bar key labels
it2ul                    # upload a file
it2universion            # set Unicode version

Clipboard History

Press Command + Shift + H to open the clipboard history panel, which supports fuzzy search. Enable persistent storage in Preferences → General.

Smart Selection

Double‑click selects a word, triple‑click selects a line, and quadruple‑click performs smart selection (URLs, emails, quoted strings, etc.) configurable via the iTerm2 documentation.

Command‑Key Tricks

Drag selected text while holding ⌘.

Click a URL to open it in the default browser.

Click a file to open it with its default application.

Click a folder to reveal it in Finder.

Hold ⌘ + Option for rectangular selection (similar to Vim’s Ctrl‑V).

Copy Text to Clipboard

pbcopy < text.md

Open Current Directory in Finder

open .

The tutorial covers the iTerm2 configuration and optimization; the next part will discuss remote server connection settings.