Skip to content

About

iTerm2 Dynamic Profiles managed as JSON — per-directory automatic profile switching

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

iTerm2 Dynamic Profiles 設定

iTerm2の設定をDynamic Profilesで管理するためのプロジェクトです。

📁 ディレクトリ構造

~/iterm2-config/
├── iterm2/
│   ├── DynamicProfiles/
│   │   └── profiles.json          # プロファイル定義
│   └── hotkey-window-backup.json  # Hotkey Windowのバックアップ
├── LICENSE
└── README.md                      # このファイル

🚀 セットアップ方法

1. Shell Integrationの有効化(必須)

Automatic Profile Switchingを使うには、iTerm2がディレクトリを追跡できる必要があります。

# .zshrcに以下を追加
test -e "${HOME}/.iterm2_shell_integration.zsh" && source "${HOME}/.iterm2_shell_integration.zsh"

または、iTerm2メニューから: iTerm2 > Install Shell Integration

2. シンボリックリンクの作成

# iTerm2のDynamicProfilesディレクトリにリンクを作成
ln -sf ~/iterm2-config/iterm2/DynamicProfiles/profiles.json \
  ~/Library/Application\ Support/iTerm2/DynamicProfiles/profiles.json

3. iTerm2の再起動

設定を反映するために、iTerm2を再起動してください。

4. プロファイルの確認

iTerm2 > Settings > Profiles で以下のプロファイルが追加されているはずです:

  • 📝 Obsidian (紫のアンダーラインカーソル) - ~/obsidian 配下で自動切り替え
  • ✔️ TickTick (黄緑のアンダーラインカーソル) - ~/ticktick 配下で自動切り替え
  • 🧪 Playground (シアンのアンダーラインカーソル) - ~/playground 配下で自動切り替え
  • Workspace (default) - 上記いずれにもマッチしないディレクトリで Default の見た目に戻すフォールバック

🎨 プロファイルの特徴

カーソルの種類

  • Type 0: ボックス (■)
  • Type 1: 縦棒 (|)
  • Type 2: アンダーライン (_)

色による区別

各プロファイルは以下で区別できます:

  • カーソルの色
  • バッジ(右上の薄いラベル)
  • カーソルガイドの色

🔧 カスタマイズ方法

新しいプロファイルの追加

DynamicProfiles/profiles.json を編集して、Profiles 配列に追加:

{
  "Name": "新しいプロファイル",
  "Guid": "unique-id-here",
  "Dynamic Profile Parent Name": "Default",
  "Cursor Type": 0,
  "Cursor Color": {
    "Red Component": 1.0,
    "Green Component": 1.0,
    "Blue Component": 1.0
  },
  "Badge Text": "🎯 LABEL",
  "Tags": ["custom"]
}

フォルダーごとに自動切り替え

プロファイルのJSONに "Automatic Profile Switching Rules" を追加することで、ディレクトリベースの自動切り替えができます。

{
  "Name": "My Project",
  "Automatic Profile Switching Rules": [
    "/Users/yourname/my-project/*"
  ]
}

重要な注意点:

  • パスは絶対パスで指定(~は使えません)
  • ワイルドカード*でサブディレクトリも含める
  • Shell Integrationが必須
  • iTerm2 のAPSは「マッチするルールが無いときセッション開始時のプロファイルに戻る」仕様。~/obsidian などで開始するとそのままロックされて見た目が戻らないため、Workspace (default) プロファイルが * にマッチしてフォールバックする役目を担う(より具体的なパターンが優先されるので、~/obsidian 内では Obsidian が勝つ)

すでに設定済みの自動切り替え:

  • /Users/<YOUR_USER>/obsidian/* → 📝 Obsidian プロファイル
  • /Users/<YOUR_USER>/ticktick/* → ✔️ TickTick プロファイル
  • /Users/<YOUR_USER>/playground/* → 🧪 Playground プロファイル

profiles.json 内のパスは作者環境の絶対パスになっています。フォークして使う場合は自分のユーザー名に置換してください(sed -i '' 's|/Users/x24ken/|/Users/YOUR_USER/|g' iterm2/DynamicProfiles/profiles.json など)。

GUIからも設定可能: iTerm2 > Settings > Profiles > 各プロファイル > Advanced > Automatic Profile Switching

📝 設定ファイルの管理

変更の確認

# 設定ファイルの内容を確認
cat ~/iterm2-config/iterm2/DynamicProfiles/profiles.json | jq .

Gitで管理

cd ~/iterm2-config
git add iterm2/
git commit -m "Update iTerm2 profiles"

🔗 参考リンク

⚠️ 注意事項

  • プロファイルのGuidは必ず一意にしてください
  • iTerm2を再起動しないと変更が反映されない場合があります
  • 既存のプロファイルと名前が被らないように注意してください

About

iTerm2 Dynamic Profiles managed as JSON — per-directory automatic profile switching

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors