My iTerm2 Configuration

A guide to my personal terminal setup with downloadable configuration files

aramb@localhost ~ $ echo "Welcome to my iTerm setup!"

Welcome to my iTerm setup!

aramb@localhost ~ $ _

About My Setup

I've customized my iTerm2 terminal for both functionality and aesthetics. This configuration features:

  • Custom color scheme that adapts to light/dark mode
  • Optimized key mappings for improved productivity
  • Configured for integration with modern tools
  • Visual bell and notification settings
  • Customized cursor and text rendering

On this page, you'll find my complete configuration files and step-by-step instructions for setting up your own terminal environment.

Configuration Features

Color Scheme

My color scheme uses different palettes for light and dark modes. The dark mode features a sleek dark background with vibrant, readable text colors, while light mode uses a crisp white background with dark text for better daytime readability.

Copied to clipboard!

Key Mappings

I've set up custom key bindings that make terminal navigation more efficient. Some notable mappings include:

  • ⌥← and ⌥→: Jump between words
  • ⌘↑ and ⌘↓: Scroll through output
  • ⌘⇧← and ⌘⇧→: Switch between tabs

Integration Features

The configuration includes built-in integration with:

  • Shell Integration for better history tracking and navigation
  • Smart selection for URLs, file paths, and IPs
  • Customized AI prompt configuration
  • SSH URL handling for seamless connections

Visual Preferences

My visual settings create a clean, distraction-free environment:

  • Slight background transparency with blur effect
  • Custom cursor style and blinking settings
  • Visual bell instead of sound notifications
  • Powerline-compatible font rendering
  • Subtle timestamp display in the terminal

Configuration Files

Download my iTerm2 configuration files to set up your own environment. Each file serves a specific purpose in the setup:

aramb-dev.json

Color scheme and profile settings in JSON format

Download

com.googlecode.iterm2.plist

Complete iTerm2 preferences file

Download

key-bindings.itermkeymap

Keyboard shortcuts configuration

Download

Installation Guide

Prerequisites

  1. Download and install iTerm2 if you haven't already
  2. Download the configuration files from the section above

Method 1: Import Color Preset

  1. Open iTerm2
  2. Go to iTerm2 > Preferences > Profiles > Colors
  3. Click on Color Presets... dropdown
  4. Select Import...
  5. Navigate to and select the downloaded aramb-dev.json file
  6. Click on Color Presets... again and select aramb-dev

Method 2: Import Key Bindings

  1. Open iTerm2
  2. Go to iTerm2 > Preferences > Keys > Key Bindings
  3. Click on Presets... dropdown
  4. Select Import...
  5. Navigate to and select the downloaded key-bindings.itermkeymap file

Method 3: Complete Configuration

  1. Quit iTerm2 completely
  2. Open Finder and press ⌘+Shift+G
  3. Enter ~/Library/Preferences/ and click Go
  4. Make a backup of your current com.googlecode.iterm2.plist file if it exists
  5. Copy the downloaded com.googlecode.iterm2.plist to this directory
  6. Restart iTerm2

Note: This method will replace your current iTerm2 settings. Make sure to back up your existing configuration first.

Advanced Configuration

Customizing the Profile

You can further personalize the profile by modifying:

  • Font type and size (I use Monaco 12pt)
  • Background transparency level (currently set to ~10%)
  • Terminal window style and dimensions
  • Status bar components and layout

Access these settings through iTerm2 > Preferences > Profiles after importing the configuration.

Shell Integration

My configuration includes iTerm2's shell integration features. To enable these fully:

  1. Open iTerm2
  2. Go to iTerm2 > Install Shell Integration
  3. Follow the on-screen instructions

This enables features like command history tracking, better navigation, and more.

AI Integration

My configuration includes a custom AI prompt configuration that works with Hack Club's AI terminal integration:

AI Prompt: Return commands suitable for copy/pasting into \(shell) on \(uname).
Do NOT include commentary NOR Markdown triple-backtick code blocks as your whole
response will be copied into my terminal automatically.

The script should do this: \(ai.prompt)

This configuration is designed to produce clean command outputs that can be directly executed.

Setting Examples

Profile & Terminal Settings

iTerm2 profile settings

Profile configuration with custom options

Key Features:

  • Monaco font at 12pt for optimal readability
  • 10% background transparency with blur
  • Cursor set to vertical bar with blink enabled
  • Terminal type: xterm-256color for best compatibility
  • Unicode normalization: NFC

Recommended settings:

Columns: 120

Rows: 36

Scrollback lines: 10000

Color Scheme Configuration

aramb@macbook ~ $ ls -la
total 112
drwxr-xr-x  15 aramb  staff    480 Feb 25 13:45 .
drwxr-xr-x   6 root   admin    192 Dec  9 09:12 ..
-rw-r--r--   1 aramb  staff   3520 Feb 25 13:45 .bashrc
-rw-r--r--   1 aramb  staff    157 Feb 25 13:38 .gitconfig
drwxr-xr-x  12 aramb  staff    384 Feb 25 13:30 Documents
drwxr-xr-x  15 aramb  staff    480 Feb 25 13:12 Projects
aramb@macbook ~ $ _

Dark mode terminal appearance

Color Palette:

Black: #000000
Red: #C91B00
Green: #00C200
Yellow: #C7C400
Blue: #0225C7
Purple: #CA30C7

Color configuration:

Both ANSI colors and bright versions are customized

Background opacity: 90%

Different color schemes for light/dark mode

Key Mapping Configuration

iTerm2 key mappings

Custom keyboard shortcuts configuration

Key Shortcut Examples:

Shortcut Action
⌥← Move cursor one word left
⌥→ Move cursor one word right
⌘↑ Scroll one page up
⌘↓ Scroll one page down
⌘⇧← Previous tab
⌘⇧→ Next tab

Shell Integration Features

aramb@macbook ~/Projects $ cd my-project

aramb@macbook ~/Projects/my-project $ git status

On branch main

Your branch is up to date with 'origin/main'.

nothing to commit, working tree clean

aramb@macbook ~/Projects/my-project $ _

Shell integration with command status indicators

Shell Integration Benefits:

  • Command status indicators (success/failure)
  • Jump to previous commands with ⌘↑/⌘↓
  • Command history tracking across sessions
  • Automatic directory tracking
  • Command timing information
  • Integrated with iTerm2's toolbelt features
  • Smart selection of file paths, URLs, and commands

Installation:

iTerm2 > Install Shell Integration

Questions or Feedback?

If you have any questions about my iTerm2 setup or suggestions for improvements, I'd love to hear from you!

Contact Me