iterm2/README.md

   1 ---
   2 title: iTerm2
   3 homepage: https://iterm2.com/
   4 tagline: |
   5   iTerm2: a terminal emulator for macOS that does amazing things.
   6 ---
   7
   8 ## Cheat Sheet
   9
  10 > The only bad thing about iTerm2 is that it's so seamless and intuitive that
  11 > you quickly forget why you started using it - it just fades into the
  12 > background.
  13
  14 iTerm2 supports a lot of nifty features, including:
  15
  16 - Excellent [themes](https://iterm2colorschemes.com/)
  17 - Hold ⌘ to make links clickable
  18 - Per-user & per-host sessions
  19 - Lots of
  20   [fun little utilities](https://www.iterm2.com/documentation-utilities.html)
  21 - Better tmux / screen support
  22 - GPU-accelerated
  23
  24 **Important**: Unlike most packages, iTerm2 will be installed to
  25 `~/Applications`.
  26
  27 ### How to make the best of iTerm2
  28
  29 Open Preferences with <kbd>Cmd ⌘</kbd> + <kbd>,</kbd>
  30
  31 ```md
  32 - Appearance
  33   - Tabs
  34     - Preserve window size when tab bars shows or hides
  35 - Profiles
  36   - General
  37     - Command
  38       - Custom Shell (see the Fish Cheat Sheet: <https://webinstall.dev/fish>)
  39     - Colors
  40       - Color Presets... (see theme recommendations below)
  41     - Text
  42       - Font (see the Nerd Fonts Cheat Sheet: <https://webinstall.dev/nerdfont>)
  43       - Anti-Aliased
  44   - Terminal
  45     - Notifications
  46     - Check Silence bell
  47     - Uncheck Flash visual bell
  48   - Advanced
  49     - Automatic Profile Switch (see notes below)
  50 - Advanced
  51   - (this is where you can reset prompts)
  52 ```
  53
  54 ### How to set up profile switching
  55
  56 I suggest using different profiles:
  57
  58 - Default (no matching hosts)
  59 - Local (matching my local `hostname`)
  60 - Remote (matching `app@` for VPSes and cloud environments)
  61 - Prod (matching specific `app@hostname`s for production systems)
  62 - Root (matching `root@`)
  63
  64 You need to "Install Shell Integration" on each host for profile switching to
  65 work.
  66
  67 !["Install iTerm2 Shell Integrations"](https://i.imgur.com/PRuQViC.png)
  68
  69 !["Enable iTerm2 Profile Switching"](https://i.imgur.com/syRmikE.png)
  70
  71 ### Which themes are the best?
  72
  73 There are [216+ color schemes](https://iterm2colorschemes.com/).
  74
  75 Here's my shortlist. I chose them because they are easy on the eyes and
  76 distinct.
  77
  78 Two-finger click "Save Link As" (or similar) to download.
  79
  80 - <a href="/packages/iterm2/schemes/Tomorrow%20Night.itermcolors" download>Tomorrow
  81   Night</a>
  82   ![](https://raw.githubusercontent.com/mbadolato/iTerm2-Color-Schemes/master/screenshots/tomorrow_night.png)
  83 - <a href="/packages/iterm2/schemes/Firewatch.itermcolors" download>Firewatch</a>
  84   ![](https://raw.githubusercontent.com/mbadolato/iTerm2-Color-Schemes/master/screenshots/firewatch.png)
  85 - <a href="/packages/iterm2/schemes/Dracula.itermcolors" download>Dracula</a>
  86   ![](https://raw.githubusercontent.com/mbadolato/iTerm2-Color-Schemes/master/screenshots/dracula.png)
  87 - <a href="/packages/iterm2/schemes/Elemental.itermcolors" download>Elemental</a>
  88   ![](https://raw.githubusercontent.com/mbadolato/iTerm2-Color-Schemes/master/screenshots/elemental.png)
  89 - <a href="/packages/iterm2/schemes/Ubuntu.itermcolors" download>Ubuntu</a>
  90   ![](https://raw.githubusercontent.com/mbadolato/iTerm2-Color-Schemes/master/screenshots/ubuntu.png)
  91 - <a href="/packages/iterm2/schemes/cyberpunk.itermcolors" download>cyberpunk</a>
  92   ![](https://raw.githubusercontent.com/mbadolato/iTerm2-Color-Schemes/master/screenshots/cyberpunk.png)
  93 - <a href="/packages/iterm2/schemes/Hivacruz.itermcolors" download>Hivacruz</a>
  94   ![](https://raw.githubusercontent.com/mbadolato/iTerm2-Color-Schemes/master/screenshots/hivacruz.png)
  95 - <a href="/packages/iterm2/schemes/Builtin%20Solarized%20Dark.itermcolors" download>Builtin
  96   Solarized Dark</a>
  97   ![](https://raw.githubusercontent.com/mbadolato/iTerm2-Color-Schemes/master/screenshots/builtin_solarized_dark.png)
  98 - <a href="/packages/iterm2/schemes/ToyChest.itermcolors" download>ToyChest</a>
  99   (not for the colorblind)
 100   ![](https://raw.githubusercontent.com/mbadolato/iTerm2-Color-Schemes/master/screenshots/toy_chest.png)
 101
 102 <!--
 103 Other considerations:
 104 Grape
 105 -->
 106
 107 If you're using [fish](https://webinstall.dev/fish) (as you should be!), be sure
 108 to set your shell color theme to the same or similar:
 109
 110 ```bash
 111 fish_config colors
 112 ```