📖

Wezterm を試してみたメモ

2025/02/09に公開

Wezterm は設定ファイルによるカスタマイズが魅力のターミナルエミュレータです。
この記事では、Wezterm の設定ファイルの記載例と構成について説明し、初見の人がWeztermを使えるようになることを目指します。
なお、Windows を前提とした環境での設定例となります。

インストール

インストール方法は、公式サイト に記載されています。私はインストーラ(setup.exe)を使用しました。

設定ファイル

Wezterm の設定ファイルは Lua スクリプトで記述します。公式サイト に従い、設定ファイルを $HOME/.config/wezterm/wezterm.lua に配置すれば OK です。

サンプルコード

サンプルコードを GitHub にアップロードしています。私の環境では、見やすさを考慮して、メインの設定ファイル wezterm.lua に加え、キーバインド用の keybinds.lua と起動メニュー用の launch_menu.lua の 3 つに分割しています。

各ファイルの役割は以下の通りです。

1. wezterm.lua

メインの設定ファイル

  • 外観や動作に関する基本設定を記述
  • keybinds.lua, launch_menu.luarequire を使って読み込み

2. keybinds.lua

キーバインドの設定

  • コピー、貼り付け、タブ操作などのショートカットを設定

3. launch_menu.lua

起動メニューの設定

  • Command Prompt、PowerShell、WSL2 などを起動するためのメニュー項目を定義
  • ショートカットから呼び出して各シェルを選択・起動できる

設定ファイルの構成

サンプルコードだけだと、自分の好みの設定に変えたい時に分かり辛いと思うので、構成について簡単に説明します。

Wezterm の設定ファイルはオブジェクト指向の考え方に基づいており、設定内容をひとまとめにした config オブジェクトに対して各種設定を施してます。最終的に、この config オブジェクトを返すことで、Wezterm は起動時にその内容を読み込み、ターミナルの動作や見た目を構築します。

local config = {}  -- 設定用のオブジェクト(テーブル)

-- 各種プロパティを設定
config.default_cwd = "C:/dev"
config.font = wezterm.font("Ricty Diminished")
config.font_size = 12
-- ...(他の設定項目もここに記述)

return config  -- このオブジェクトを返すことで、Wezterm が設定内容を取得

Lua と JavaScript の比較

個人的には、Lua の基本的な書き方は JavaScript に似た部分が多く、直感的に理解しやすいと感じました。

変数宣言

  • Lua:

    local a = 10
    
  • JavaScript:

    let a = 10;
    

オブジェクト(テーブル)

Lua のテーブルは、JavaScript のオブジェクトや配列に相当します。

  • Lua:

    local person = { name = "Alice", age = 30 }
    
  • JavaScript:

    const person = { name: "Alice", age: 30 };
    

イベントハンドラ

  • Lua:

    wezterm.on('gui-startup', function(cmd)
      local tab, pane, window = wezterm.mux.spawn_window(cmd or {})
      window:gui_window():maximize()
    end)
    
  • JavaScript:

    wezterm.on('gui-startup', (cmd) => {
      const [tab, pane, window] = wezterm.mux.spawn_window(cmd || {});
      window.gui_window().maximize();
    });
    

まとめ

以上の基本を理解した上で、あとは利用用途に応じて公式ドキュメントを参照すれば設定を変更していくことができると思います。参考になれば幸いです。

GitHubで編集を提案

Discussion