Windows ターミナルでの外観プロファイル設定


カーソル

カーソルの形

これにより、プロファイルのカーソルの形が設定されます。 使用できるカーソルは次のとおりです: "bar" ( ┃ )、"vintage" ( ▃ )、"underscore" ( ▁ )、"filledBox" ( █ )、"emptyBox" ( ▯ )、"doubleUnderscore" ( ‗ )

プロパティ名:

必須かどうか: オプション

受け入れ可能:"vintage""underscore""filledBox""emptyBox""doubleUnderscore"

既定値:

カーソルの高さ

これにより、下部からのカーソルの高さの割合が設定されます。 これは cursorShape"vintage" に設定されている場合にのみ機能します。

プロパティ名:

必須かどうか: オプション

受け入れ可能: 1 から 100 までの整数



背景画像とアイコン

Windows ターミナルでは、各コマンドライン プロファイルの設定 UI メニューまたは settings.json ファイルを使用して、カスタムの背景イメージとアイコンを指定できます。これにより、各プロファイルを個別に構成/ブランド化/スタイル設定することができます。 これを行うには、目的の backgroundImage を指定し、backgroundImageAlignment を使用してそれを配置し、backgroundImageOpacity で不透明度を設定し、必要に応じて backgroundImageStretchMode を使用して、表示可能領域に画像をどのように表示するかを指定します。

次に例を示します。

    "backgroundImage": "C:\\Users\\username\\OneDrive\\WindowsTerminal\\bg-ubuntu-256.png",
    "backgroundImageAlignment": "bottomRight",
    "backgroundImageOpacity": 0.1,
    "backgroundImageStretchMode": "none"

アイコンと画像を (上記のように) OneDrive に格納すれば、すべてのコンピューターで画像とアイコンのコレクションを簡単にローミングできます。

背景画像のパス

これにより、ウィンドウの背景に描画する画像のファイルの場所が設定されます。 背景画像には、.jpg、.png、.gif のいずれかのファイルを指定できます。 "desktopWallpaper" を使用すると、背景画像がデスクトップの壁紙に設定されます。

プロパティ名:

必須かどうか: オプション

受け入れ可能: ファイルの場所を表す文字列または

カスタムの画像やアイコンはシステムで提供されているフォルダーに格納するようにし、正しい URI スキームを使用することをお勧めします。 URI スキームを使用すると、物理パス (将来変更される可能性があります) に依存せず、ファイルを参照することができます。 背景画像とアイコンをカスタマイズするうえで覚えておくべき最も便利な URI スキームは次のとおりです。

URI スキーム 対応する物理パス 用途/説明
ms-appdata:///Local/ %localappdata%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\ コンピューターごとのファイル
ms-appdata:///Roaming/ %localappdata%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\RoamingState\ 共通ファイル

警告

ms-appx URI スキーム (つまりアイコン) を使用したファイル参照に依存することは避けてください。 これらのファイルは内部実装の詳細と見なされ、名前や場所が変更される可能性がありますし、将来的に省略される可能性もあります。

アイコン

Windows ターミナルでは、組み込みシェル (たとえば、PowerShell Core、PowerShell、インストールされている Linux/WSL ディストリビューションなど) に対してターミナルが生成する、各プロファイルのアイコンが表示されます。 各プロファイルでは、ms-appx URI スキームを使用してストック アイコンが参照されます。 独自のカスタム アイコンを参照するには、次のように、settings.json ファイルにパスを入力します。

    "icon" : "C:\\Users\\username\\OneDrive\\WindowsTerminal\\icon-ubuntu-32.png",

アイコンには適切なラスター画像形式 (.PNG、.GIF、.ICOなど) を使用し、サイズを 32x32px に設定する必要があります。これにより、実行時にアイコンのサイズを変更する必要がなくなり、大きな遅延の発生や品質の低下を回避することができます。

背景画像のストレッチ モード

これにより、ウィンドウいっぱいに広がるように背景画像のサイズが変更されます。

プロパティ名:

必須かどうか: オプション

受け入れ可能:"fill""uniform""uniformToFill"

既定値:

背景画像の配置

これにより、ウィンドウの境界への背景画像の配置方法が設定されます。

プロパティ名:

必須かどうか: オプション

受け入れ可能:"left""top""right""bottom""topLeft""topRight""bottomLeft""bottomRight"

既定値:

背景画像の不透明度

これにより、背景画像の透明度が設定されます。

プロパティ名:

必須かどうか: オプション

受け入れ可能: 0 - 1 の浮動小数点値の数値

既定値:



透明性

不透明度 (プレビュー)

プロファイルのウィンドウの透明度を設定します。 指定できるのは、"不透明度のパーセンテージ" を表す 0 から 100 までの整数値です。 100 で "完全に不透明"、50 で半透明、0 で完全に透明になります。

useAcrylictrue に設定された場合は、ウィンドウにアクリル素材が使用され、ターミナルの背景がぼやけた表示になります。 useAcrylic が false に設定された場合、ターミナルの不透明度にぼかしは適用されません。

プロパティ名:

必須かどうか: オプション

受け入れ可能: 0 から 100 までの整数値

既定値:useAcrylic が false の場合は useAcrylic が true の場合は 50

Windows ターミナル アクリルの不透明度

重要

Windows ターミナル バージョン 1.12 より前では、この設定は acrylicOpacity でした。これは 0.0 から 1.0 までの float で指定され、既定は 0.5 でした。また、useAcrylic が true に設定された場合にのみ、不透明度が適用されていました。 1.12 以降でも、acrylicOpacityopacity に相当する値として正常に機能します。

重要

ぼかしなしの不透明度 ("useAcrylic": false) は、"useAcrylic": falseがインストールされた Windows 11 以上でのみ機能します。

アクリルを有効にする

これを true に設定すると、ウィンドウにアクリルの背景が表示されます。 false に設定すると、ウィンドウは無地の平坦な背景になります。 透過性は、OS の制限のため、フォーカスされているウィンドウにのみ適用されます。

プロパティ名:

必須かどうか: オプション

受け入れ可能:false

既定値:

Windows ターミナルのアクリル



ウィンドウ

余白

これにより、ウィンドウ内のテキストの周囲の余白が設定されます。 これには、次の 3 つの異なる形式が使用できます。"#"# は、すべての辺に同じ余白を設定し、"#, #" は左右と上下に同じ余白を設定し、"#, #, #, #" は左、上、右、下に個別に余白を設定します。

プロパティ名:

必須かどうか: オプション

受け入れ可能: 次の形式の文字列: "#, #""#, #, #, #" または整数値: #

既定値:

Windows ターミナルの余白

スクロールバーの表示

これにより、スクロールバーの表示が設定されます。

プロパティ名:

必須かどうか: オプション

受け入れ可能:"hidden"



色の設定

タブの色

プロファイルのタブの色を設定します。タブ カラー ピッカーを使用すると、この色はオーバーライドされます。

プロパティ名:

必須かどうか: オプション

受け入れ可能: 色を表す 16 進形式の文字列: または "#rrggbb"

前景色

これにより、プロファイルの前景色が変更されます。 これにより、配色で設定された foreground がオーバーライドされます (colorScheme が設定されている場合)。

プロパティ名:

必須かどうか: オプション

受け入れ可能: 色を表す 16 進形式の文字列: または "#rrggbb"

背景の色

これにより、プロファイルの背景色がこの設定で変更されます。 これにより、配色で設定された background がオーバーライドされます (colorScheme が設定されている場合)。

プロパティ名:

必須かどうか: オプション

受け入れ可能: 色を表す 16 進形式の文字列: または "#rrggbb"

選択範囲の背景色

これにより、プロファイル内の選択範囲の背景色が設定されます。 これにより、配色で設定された selectionBackground がオーバーライドされます (colorScheme が設定されている場合)。

プロパティ名:

必須かどうか: オプション

受け入れ可能: 色を表す 16 進形式の文字列: または "#rrggbb"

見分けがつかない色を調整する (プレビュー)

true に設定された場合は、背景色に基づいて、前面の色がより見やすくなるように調整されます (必要な場合)。

プロパティ名:

必須かどうか: オプション

受け入れ可能:false

既定値:

重要

この機能は、Windows ターミナル プレビューでのみ使用できます。

カーソルの色

これにより、プロファイルのカーソルの色が設定されます。 これにより、配色で設定された cursorColor がオーバーライドされます (colorScheme が設定されている場合)。

プロパティ名:

必須かどうか: オプション

受け入れ可能: 色を表す 16 進形式の文字列: または "#rrggbb"



非フォーカス時の外観設定

プロファイルに追加して、そのプロファイルがフォーカスされていないときに設定を適用できるオブジェクトです。 この設定で指定できるのは外観の設定のみです。

プロパティ名:

必須かどうか: オプション

受け入れ可能:backgroundImageAlignmentbackgroundImageOpacitybackgroundImageStretchModecursorHeightcursorShapecursorColorcolorSchemeforegroundbackgroundselectionBackgroundexperimental.retroTerminalEffectexperimental.pixelShaderPath

例:

// Sets the profile's background image opacity to 0.3 when it is unfocused
"unfocusedAppearance": 
{
    "backgroundImageOpacity": 0.3
},


ピクセル シェーダー効果

この設定では、ターミナルのコンテンツで使用するカスタム ピクセル シェーダーへのパスを指定できます。 これは試験的な機能であり、存続は保証されていません。 ターミナル用にカスタム ピクセル シェーダーを作成する方法の詳細については、こちらのドキュメントを参照してください。

設定された場合は、この設定によって experimental.retroTerminalEffect がオーバーライドされます。

プロパティ名:

必須かどうか: オプション

受け入れ可能: シェーダー ファイルへのパス (文字列)

以下の設定は、各プロファイルのビジュアル設定に個別に影響を及ぼします。 すべてのプロファイルに設定を適用したい場合は、defaults ファイル内のプロファイル一覧の上にある、defaults セクションに設定を追加できます。

"defaults":
{
    // SETTINGS TO APPLY TO ALL PROFILES
},
"list":
[
    // PROFILE OBJECTS
]

Text

配色

これは、プロファイルで使用される配色の名前です。 配色は schemes オブジェクトで定義されます。 詳細については、配色に関するページを参照してください。

プロパティ名:

必須かどうか: オプション

受け入れ可能: 配色の名前を表す文字列

既定値:

フォント

これは、別のフォント設定を定義するための構造体です。 これが JSON ファイル内でどのように記述されるかは、下記で示しています。

プロパティ名:

必須かどうか: オプション

フォント フェイス

これは、プロファイルで使用されるフォント フェイスの名前です。 これが見つからないか無効である場合は、ターミナルによって Consolas へのフォールバックが試行されます。 既定のフォント Cascadia Mono のその他のバリアントについては、Cascadia Code に関するページを参照してください。

プロパティ名: (font オブジェクト内で定義されます)

必須かどうか: オプション

受け入れ可能: フォント名を表す文字列

既定値:

フォント サイズ

これにより、プロファイルのフォント サイズがポイント単位で設定されます。

プロパティ名: (font オブジェクト内で定義されます)

必須かどうか: オプション

値: 整数

既定値:

フォントの太さ

これにより、プロファイルのフォントの太さ (ストロークの明るさまたは太さ) が設定されます。

プロパティ名: (font オブジェクト内で定義されます)

必須かどうか: オプション

受け入れ可能:"thin""extra-light""light""semi-light""medium""semi-bold""bold""extra-bold""black""extra-black"、OpenType フォントの太さの数値表記に対応する整数

既定値:

フォントの例

"font": {
    "face": "Cascadia Mono",
    "size": 12,
    "weight": "normal"
}

重要

この font オブジェクトは、font (バージョン 1.10 以降) でのみ使用できます。 それより前のバージョンでは、次に示すように、fontFacefontSizefontWeight の各プロパティを個別に使用する必要があります。

"fontFace": "Cascadia Mono",
"fontSize": 12,
"fontWeight": "normal"

フォントの特性

指定されたフォントの OpenType フォント特性を設定します。

プロパティ名: (font オブジェクト内で定義されます)

必須かどうか: オプション

受け入れ可能: 次の形式で指定された特性プロパティ:

例:

// Enables ss01 and disables ligatures
"font": {
    "face": "Cascadia Code",
    "features": {
        "ss01": 1,
        "liga": 0
    }
}

フォントの軸

指定されたフォントの OpenType フォント軸を設定します。

プロパティ名: (font オブジェクト内で定義されます)

必須かどうか: オプション

受け入れ可能: 次の形式で指定された軸プロパティ:

例:

// Sets the font to italic
"font": {
    "face": "Cascadia Code",
    "axes": {
        "ital": 1
    }
}

強調テキストの書式設定

ターミナルでの "強調" テキストの書式設定を制御します。 "強調" テキストとは、エスケープ シーケンス \x1b[1m を使用して書式設定されたテキストのことです。

プロパティ名:

必須かどうか: オプション

受け入れ可能:"bold""bright""all"

  • "all": "all"と明るさの両方を使って強調テキストを表示します
  • "bold": "bold"を使って強調テキストを表示します (明るさは使用しません)
  • "bright": 明るさを使って強調テキストを表示します (太字は使用しません)
  • "none": 強調テキストに対して、ターミナルでの特別な処理を行いません

既定値:

レトロ ターミナル効果

これを true に設定すると、走査線やぼやけたテキストの端がある古い CRT ディスプレイがターミナルでエミュレートされます。 これは試験的な機能であり、存続は保証されていません。

experimental.pixelShaderPath が設定されている場合は、その設定によってこの設定がオーバーライドされます。

プロパティ名:

必須かどうか: オプション

受け入れ可能:false

既定値: