開発

Tessa は SSH 越しの headless Linux マシンだけで開発できます。コンポジタも パネルも普通の Wayland プログラムなので、grim で headless 出力を撮影して 見た目をすぐ確認できます。仮想キーボード（wtype）と Fcitx5 を使えば、 物理ディスプレイなしでキーボードや IME の経路もテストできます。

ビルド

chmod +x scripts/*.sh scripts/tessa-session
./scripts/build.sh -Doptimize=ReleaseSafe

デバッグビルド:

./scripts/build.sh

角丸と背景ブラーは既定の scenefx ビルドに含まれます。scenefx 0.5 を導入して 通常どおりビルドしてください。このバイナリは GLES2 レンダラーに切り替わり、 pixman では実行できません。

./scripts/build.sh

scenefx なしの plain wlroots シーンにする場合は、明示的に無効にします。

./scripts/build.sh -Dscenefx=false

必要なものはメイン README にまとめています。要点は Zig 0.17、wlroots 0.20、 Wayland、xkbcommon、pixman、DRM/input/seat の開発ヘッダー、Cairo、Pango、 フォントです。X11 をテストする場合は xwayland-satellite も PATH に 入れてください。

ライブラリの確認:

pkg-config --modversion wlroots-0.20
ldconfig -p | grep wlroots
fc-list | grep -i -E 'Inter|JetBrains|Noto Sans CJK'

headless セッション

ターミナル 1:

./scripts/run-headless.sh

/tmp/tessa-headless を作成し、pixman レンダラーを強制して zig-out/bin からパネルを起動します。出力は 1920×1080 の headless ディスプレイ HEADLESS-1 です。

ターミナル 2:

# 画面を撮影
./scripts/screenshot.sh /tmp/tessa.png

# セッション内でターミナルを起動
printf 'CMD spawn foot -T notes\n' \
  | socat - UNIX-CONNECT:/tmp/tessa-headless/tessa.sock

# master <-> mosaic
printf 'CMD layout\n' \
  | socat - UNIX-CONNECT:/tmp/tessa-headless/tessa.sock

# ランチャー（クエリ付きでもよい）
printf 'CMD launcher\n' \
  | socat - UNIX-CONNECT:/tmp/tessa-headless/tessa.sock
printf 'CMD launcher ter\n' \
  | socat - UNIX-CONNECT:/tmp/tessa-headless/tessa.sock

# ワークスペース切り替え / ウィンドウへフォーカス
printf 'CMD workspace 2\n' \
  | socat - UNIX-CONNECT:/tmp/tessa-headless/tessa.sock

headless バックエンドには物理入力デバイスがないため、Tessa は標準 XKB キーマップを持つフォールバックキーボードを作成します。これによりパネル、 IME、XWayland が正しく起動できます。キーボード入力は virtual-keyboard プロトコル経由で注入します:

export XDG_RUNTIME_DIR=/tmp/tessa-headless
export WAYLAND_DISPLAY=wayland-0

printf 'CMD launcher\n' | socat - UNIX-CONNECT:/tmp/tessa-headless/tessa.sock
wtype "foot"
wtype -k Return

wtype は現在キーボードフォーカスを持つサーフェスへ入力します。

tessa-ctl でセッションを操作できます。ビルド出力を PATH に入れ、 XDG_RUNTIME_DIR を揃えてください。

export PATH="$PWD/zig-out/bin:$PATH"
export XDG_RUNTIME_DIR=/tmp/tessa-headless

tessa-ctl state
tessa-ctl spawn foot -T notes
tessa-ctl dispatch layout
tessa-ctl launcher ter
tessa-ctl status demo "hello from an extension"
tessa-ctl events window-focus

tessa-ctl status --clear でエントリを削除できます。tessa-ctl events は 購読後にだけイベントを受け取るので、常駐スクリプトとして安全に使えます。

IME テスト

セッション内で Fcitx5 を起動し、Mozc を選択してランチャーに入力します:

printf 'CMD spawn fcitx5\n' \
  | socat - UNIX-CONNECT:/tmp/tessa-headless/tessa.sock
printf 'CMD launcher\n' \
  | socat - UNIX-CONNECT:/tmp/tessa-headless/tessa.sock

wtype "nihongo"      # プリエディット
wtype -k space       # 変換
wtype -k Return      # 確定
grim -o HEADLESS-1 /tmp/ime.png

実際の Fcitx 設定に触れたくない場合は、mozc を選択した fcitx5/profile を含む一時ディレクトリを XDG_CONFIG_HOME に指定して ください。候補ポップアップは入力メソッドのポップアップサーフェスとして 検索欄の下に描画されます。

XWayland テスト

xwayland-satellite が PATH にある（または TESSA_XWAYLAND_BIN を設定 した）状態で、Tessa は空いているディスプレイを自動選択し DISPLAY を エクスポートします。きれいなマシンでは通常 :0 です。

printf 'CMD spawn xeyes\n' \
  | socat - UNIX-CONNECT:/tmp/tessa-headless/tessa.sock
printf 'CMD spawn xclock\n' \
  | socat - UNIX-CONNECT:/tmp/tessa-headless/tessa.sock
sleep 2
DISPLAY=:0 xdpyinfo | head
grim -o HEADLESS-1 /tmp/xwayland.png
printf 'STATE\n' \
  | socat - UNIX-CONNECT:/tmp/tessa-headless/tessa.sock

STATE の出力に XEyes と XClock が通常のウィンドウとして並べば成功です。 xev と wtype で X11 クライアントへのキーイベント到達も確認できますが、 wtype は独自の小さなキーマップをインストールするため、実際の文字入力の テストには物理キーボードの方が適しています。

HiDPI と出力設定の永続化テスト

2 倍スケールを設定してパネルを撮影します。1920x1080 モードではバーが物理 88 px になり、文字が鮮明なままであることを確認できます。

wlr-randr --output HEADLESS-1 --scale 2
grim -o HEADLESS-1 /tmp/hidpi.png

wlr-randr の apply は ~/.config/tessa/outputs.conf（または $XDG_CONFIG_HOME/tessa/outputs.conf）も更新します。保存先は TESSA_OUTPUT_CONFIG または設定キー output_config で変更できます。 自己完結の headless テストもあります。

WLR_RANDR=/path/to/wlr-randr sh tests/output-persistence.sh

このテストは 1280x720 のカスタムモード、スケール 2、位置 40,30 を適用し、 設定ファイルを確認して実行中レイアウトを設定してから再起動し、 モード/スケール/位置とレイアウトの復元を検証します。2 倍時のランチャーは 同じ 760x620 デザインをフィットさせるため、ヒット矩形と IME カーソルも 見た目のスケーリングに追従します。

レイアウトテスト

セッション内で複数のターミナルを起動し、tessa-ctl（または Super+T）で レイアウトを巡回・設定します。

for n in one two three four; do tessa-ctl spawn foot -T "layout-$n"; done
tessa-ctl layout grid
./scripts/screenshot.sh /tmp/grid.png
tessa-ctl layout columns
./scripts/screenshot.sh /tmp/columns.png
tessa-ctl layout mosaic

tests/layout-geometry.sh は 8 ウィンドウを起動してモザイクを選び、 タイルが重ならないこと、すべて 160×160 以上であることを検証します。

tessa-ctl state の OUT 行の末尾に現在のレイアウト名が出ます。ワークスペース ごとの初期レイアウトは layout_1 … layout_9 で設定します。実行中の変更は 出力・ワークスペースごとに保持され、outputs.conf の layout 行として保存 され、次回起動時に復元されます。設定の再読み込みは実行中の上書きがない ワークスペースだけを更新します。Super+Alt+H/J/K/L または tessa-ctl resize <dx> <dy> でフォーカス中のフローティングウィンドウを 最小 160×120 でリサイズできます。

ルールとカスタマイズのテスト

tests/customization.sh は専用の headless セッションを起動し、foot の ウィンドウにフローティング、ワークスペース、フルスクリーン、サイズ、位置の ルールを適用します。tessa-ctl config を確認し、ルールファイルを書き換えて 再読み込みした後、既存ウィンドウが再評価されることも検証します。 tests/layout-geometry.sh は master_count、grid_columns、ワークスペース別の 隙間/マスター比率の調整値も確認します。

sh tests/customization.sh
sh tests/layout-geometry.sh

レイアウトヘルパーのテスト

tests/layout-helper.sh は layout = custom でコンポジタを起動し、小さな Python ヘルパーに既知の矩形を返させてジオメトリを検証します。壊れた ヘルパーへ切り替えてマスターレイアウトへのフォールバックを確認し、元の ヘルパーへ戻して再読み込み後の再起動も検証します。

sh tests/layout-helper.sh

設定検証と JSON のテスト

tests/config-validation.sh は未知キー、不正値、壊れたルール、存在しない include を含む設定を書き、報告される行番号を確認します。さらに、リロードが 以前の設定を維持すること、ファイルを直すまで tessa-ctl config-check が失敗することを検証します。

tests/json-ipc.sh は state --json と config --json を Python で解析し、 スキーマバージョン 1 とウィンドウジオメトリを確認します。拒否された リロードの JSON 診断も検証します。

sh tests/config-validation.sh
sh tests/json-ipc.sh

入力モードのテスト

tests/modes.sh は resize モードを定義し、tessa-ctl mode で入ってから 修飾キーなしの l/Escape を wtype で送ります。モード固有バインドが 消費され、default モードへ戻った後は通常キーがクライアントへ渡ることを 確認します。

sh tests/modes.sh

パネルテーマのテスト

tests/panel-theme.sh は実際のパネルをカスタムのバー高さ、マージン、配色で 起動し、起動ログを確認します。その後ジオメトリを変更してリロードし、 パネルを落とさずにバーの layer surface が新しいサイズで再作成されることを 検証します。

sh tests/panel-theme.sh

アニメーション/視覚設定のテスト

tests/animations.sh はパネルなしのプライベートな headless コンポジタを 起動し、500 ms のアニメーション、シャドウ、明示的な壁紙グラデーションを 有効にします。foot を起動して開く遷移のデバッグログ （animation: start id=1 from=0,18 と対応する done 行）を確認し、 ワークスペース 2 へ切り替えて戻ることで横方向の遷移（from=-54,0）も 検証します。続いてウィンドウ 1 を閉じ、閉じるスナップショットの開始と完了 （close animation: start id=1 / close animation: done id=1）、および tessa-ctl state からウィンドウが消えたことを確認します。grim と ImageMagick がある環境では、閉じるスナップショット中央の画素もサンプルし、 コンテンツが失われていたら失敗します。animation-start、animation-done、 close-animation-start、close-animation-done のフックはログへ追記され、 テストは open/workspace と close の各フェーズを待ちます。最後に tessa-ctl config-check で視覚設定キーとフックが受け付けられることを 確認します。

sh tests/animations.sh

フラクショナルスケールのテスト

tests/fractional-scale.sh は wp_fractional_scale_manager_v1 をバインドする 小さな xdg-shell クライアントをコンパイルし、サーフェスを map して 1/120 単位の preferred scale を出力します。1.0 で scale 120、wlr-randr で出力を 1.5 に変えて scale 180、続いて 2.0 にして scale 240 を待ちます。 これによりプロトコルの広告と、既存サーフェスへ再通知する実行時の出力 commit 経路の両方を検証します。

sh tests/fractional-scale.sh

エフェクトのテスト

tests/effects.sh は既定の scenefx ビルドを検査します。tessa-ctl config が scenefx 0 を返した場合（-Dscenefx=false ビルド）は 0 でスキップします。 24 px の角丸、赤い ボーダー、黒い壁紙で起動し、背景を白にした foot を起動してスクリーン ショットの画素を検査します。ウィンドウ中央は白、左上隅は白/赤ではなく 背景色、上部ボーダー中央は赤である必要があります。FX ビルドでは LD_LIBRARY_PATH に scenefx のライブラリを設定して実行してください。

sh tests/effects.sh

出力ルールのテスト

tests/output-rules.sh は 2 出力の headless セッションを起動し、出力全体の grid/gap ルールと、出力+ワークスペース指定のルールを含む設定をリロード します。2 番目の出力に 3 ウィンドウを起動し、グリッドのセル幅、横/縦の 間隔、最終行の中央寄せを検証します。続いてその出力をワークスペース 2 に 切り替えて 2 ウィンドウを起動し、ws= 付き出力ルールの外周間隔とマスター レイアウトが、汎用ワークスペースルールより優先されることを確認します。

sh tests/output-rules.sh

ワークスペース固定のテスト

tests/workspace-pinning.sh は 2 出力の headless セッションを起動し、両方の 出力名を検出します。ワークスペース 3 を 2 番目の出力に固定した設定を リロードし、1 番目の出力で foot を起動します。tessa-ctl workspace 3 が 固定先の出力へフォーカスすること、CMD move-workspace 3 がウィンドウと フォーカスを出力間で移動すること、workspace 3 <1番目の出力> と明示しても リダイレクトされること、ピン留めされていないワークスペースは指定した出力に 残ることを確認します。

sh tests/workspace-pinning.sh

名前付きワークスペースのテスト

tests/workspace-names.sh は bind とウィンドウルールの名前解決が設定全体の 読み込み後に行われること、テキスト/JSON 設定スナップショット、状態の WORKSPACE 行、tessa-ctl workspace <name> を検証します。存在しない名前を 参照した場合にリロードが拒否され、以前の設定が維持されることも確認します。

sh tests/workspace-names.sh

スクラッチパッドのテスト

tests/scratchpad.sh はウィンドウルールでテスト用トップレベルを スクラッチパッドへ割り当て、非表示・非フォーカスで開始することを確認します。 CMD toggle-scratchpad で表示し、フォーカスと可視状態を検証した後、 CMD move-to-scratchpad で通常タイルへ戻し、再度スクラッチパッドへ 移動します。

sh tests/scratchpad.sh

ウィンドウグループのテスト

tests/window-groups.sh は 2 つのテスト用トップレベルを起動し、 CMD toggle-group でグループ化します。表示メンバーが 1 つだけであること、 両方が同じグループ ID を持つことを確認し、CMD group-next でタブを切り替え、 グループ解除後に CMD group-remove / CMD group-add を検証します。

sh tests/window-groups.sh

壁紙画像のテスト

tests/wallpaper-image.sh は単色 PNG を生成し、wallpaper_fit = stretch で パネルを起動して grim でスクリーンショットを取得します。設定を wallpaper_fit = contain にリロードし、画像中央と背景のレターボックス画素を 確認します。grim がない場合はスキップします。

sh tests/wallpaper-image.sh

ターミナルフォールバックのテスト

tests/terminal-fallback.sh は PATH から kitty を隠し、偽の foot を 用意して、既定ターミナルが foot に解決されること、起動時のカーソルログが 出ること、明示的に指定した存在しない terminal = ... は置き換えずに保持する ことを確認します。

sh tests/terminal-fallback.sh

入力・ジェスチャ・pointer constraints のテスト

tests/input.sh はジェスチャ/タッチ/タブレット/pointer-constraints の設定 キー、JSON スナップショット、起動ログ、zwp_pointer_gestures_v1、 zwp_tablet_manager_v2、zwp_pointer_constraints_v1 グローバルの公開を 確認します。入力/カーソルルールの解析、コネクタ/EDID 出力ルール、カーソル マネージャのリロードログも検証します。headless バックエンドにはタッチ、 タッチパッド、VRR 対応の実デバイスがないため、libinput の実動作と adaptive-sync のコミットは実機での検証が必要です。

tests/pointer-constraints.sh は小さな xdg-shell クライアントをコンパイルし、 persistent な locked pointer を作成します。ワークスペース切り替えで ウィンドウがフォーカスを失う/取り戻すたびに locked、unlocked、 再 locked が届くことを確認します。

sh tests/input.sh
sh tests/pointer-constraints.sh

XIM のテスト

tests/xim.sh はプライベートな dbus-run-session の下で自分自身を再実行し、 XWayland と xim_start = fcitx5 -d を有効にして Tessa を起動します。 startup コマンドが XMODIFIERS を継承したこと、X ディスプレイ出現後に Fcitx5 が起動されたこと、Fcitx5 が XIM サーバセレクション （XIM_SERVERS）を所有していることを確認します。 xwayland-satellite、fcitx5、xprop がない場合はスキップします。

sh tests/xim.sh

インタラクション自動テスト

tests/interaction.sh は wlr-virtual-pointer-v1 のクライアントをコンパイルし、 物理入力なしで実際のパネルとコンポジタを操作します。ワークスペースピルの クリック、Super を押した状態でのフローティング foot のドラッグ/リサイズ、 フルスクリーン切り替え、2 ウィンドウのクリックフォーカス、バーのウィンドウ チップ右クリックによる終了、ランチャーへの入力とカスタム項目の起動を 検証します。バー座標はパネルが報告するバーサイズから計算するため、 特定の出力解像度に依存しません。

sh tests/interaction.sh

XDG ポップアップのテスト

tests/popups.sh は xdg-shell の小さなクライアントをコンパイルし、 トップレベルとアンカー付きの赤いポップアップを作成します。headless 出力を grim で撮影し、ImageMagick でポップアップのピクセルを確認することで、 クライアントポップアップが親ウィンドウの上にマップ・描画されることを 検証します。grim または convert がない場合はスキップします。

sh tests/popups.sh

パネルポップオーバーのテスト

tests/panel-popovers.sh はコンポジタとパネルを起動し、panel IPC イベント経由でカレンダーを開き、wtype で月を移動して Escape で閉じる ことを確認します。続いて電源メニューを開き、Suspend を選んで、設定した power_suspend コマンドだけが実行され、再起動/電源オフは実行されないことを 検証します。

sh tests/panel-popovers.sh

クリップボード履歴のテスト

tests/clipboard.sh は 2 つの文字列を wl-copy でコピーし、wtype で Super+V を送って履歴を開きます。古い項目を選び、wl-paste でパネルが 新しいセレクションソースになったことを確認します。その後 3 つ目の文字列を コピーし、IPC 経由で履歴を開き直して最新項目が復元されることも検証します。

sh tests/clipboard.sh

パネルは wlr-data-control-v1 経由でセレクションを監視します。通常の wl_data_device のセレクションイベントはフォーカス中のクライアントにしか 届かないため、バー側の通常 data device に置き換えると履歴は動作しません。

スクリーンショットのテスト

tests/screenshot.sh は一時的な screenshot_dir を設定し、IPC 経由で スクリーンショット UI を開きます。Enter で全画面を保存し、生成された ファイルが 1920×1080 の PNG であることを確認します。Esc でキャンセルした 場合にファイルが増えないこと、既定の Super+Shift+S で UI が開くことも 検証します。

sh tests/screenshot.sh

自動テストは全画面撮影を対象にしています。範囲ドラッグは通常のポインタ 経路を使うため、実機のポインタか virtual-pointer を使ったテストが別途 必要です。

通知のテスト

tests/notifications.sh は自分自身を dbus-run-session の下で再実行し、 headless セッションを起動して gdbus から org.freedesktop.Notifications を呼びます。サーバー情報と capability、 トースト表示、CloseNotification、期限切れ、置換、積み重ねを確認します。 リッチ通知のセクションでは tests/rich-notification.py でアクション、 Pango マークアップ、32×32 の image-data アイコンを送り、 tessa-ctl notify-action <id> reply で ActionInvoked を確認します。

sh tests/notifications.sh

tests/notification-routing.sh は headless 出力を 2 つ起動し、トーストの layer サーフェスがフォーカス出力に作られること、フォーカス移動時に 移動すること、次の通知もその出力に出ることを確認します。

sh tests/notification-routing.sh

パネルの通知サービスにはセッション D-Bus が必要です。bus がない場合でも パネルの他の機能は動作し、サービスが失敗をログに残します。ディスプレイ マネージャーから Tessa を起動する通常の環境ではセッション bus が提供されます。

システム表示のテスト

tests/system-status.sh は TESSA_POWER_SUPPLY_PATH、TESSA_NET_PATH、 TESSA_ROUTE_PATH で偽の sysfs/proc ツリーを渡し、起動時のバッテリー/ ネットワーク表示と、5 秒ポーリングでバッテリー残量の変更が反映されることを 確認します。

sh tests/system-status.sh

メディアのテスト

tests/media.sh はプライベートなセッション bus 上で tests/fake-mpris.py を起動し、MPRIS の検出とバーのチップ、メディア ポップオーバー、再生/一時停止、次へ、前へ、Super+M を検証します。 偽プレイヤーは PyGObject を使うため、python3 と GObject バインディングが ない環境ではテストをスキップします。

sh tests/media.sh

トレイのテスト

tests/tray.sh はプライベートなセッション bus 上で偽の StatusNotifier 項目を動かします。watcher プロパティ、項目登録、22×22 ARGB32 pixmap 経路、 トレイポップオーバー、アクティベート、Super+Shift+T を確認します。 wtype と PyGObject がない環境ではスキップします。

sh tests/tray.sh

音量のテスト

tests/audio.sh は PATH に偽の wpctl を置き、Up、m、Down で音量 ポップオーバーを操作します。初期値 42%、ミュート/解除、音量変更、 Super+Shift+A を確認します。

sh tests/audio.sh

foreign-toplevel のテスト

tests/foreign-toplevels.sh は wlr-foreign-toplevel-management と ext-foreign-toplevel-list の小さな Wayland クライアントをコンパイルし、 foot を起動してタイトル、app-id、アクティベート状態を確認します。 foot、cc、wayland-scanner がない環境ではスキップします。これらは xdg-desktop-portal-wlr のウィンドウ選択に必要なコンポジタ側の前提です。

sh tests/foreign-toplevels.sh

ポータルと PipeWire 画面共有のテスト

tests/portal.sh はプライベートな headless Tessa セッション、PipeWire、 xdg-desktop-portal、xdg-desktop-portal-wlr を起動し、ScreenCast ポータル （CreateSession、SelectSources、Start、OpenPipeWireRemote）を呼びます。 ストリームノードと有効なリモート fd を確認します。テストは一時的な tessa.portal セレクタと chooser_type=none の xdpw 設定を使い、ポータル または PipeWire のバイナリがない環境ではスキップします。展開済みパッケージ ルートを試す場合は TESSA_PORTAL_ROOT を指定してください。

sh tests/portal.sh
TESSA_PORTAL_ROOT=/tmp/portal-root sh tests/portal.sh

ロックと idle のテスト

コンポジタは ext-session-lock-v1、ext-idle-notify-v1、 idle-inhibit-v1、出力電源管理を公開します。テスト用クライアントを インストールします:

sudo apt install swaylock swayidle wlopm

セッション内で swaylock -f を実行するか、Super+Escape を押します。 デスクトップ全体がロックサーフェスに置き換わり、ロック後に作成した仮想 キーボードからは入力できないことを確認してください。ロック中にロック クライアントを kill した場合、Tessa はデスクトップを露出せず終了する 必要があります。idle は swayidle -w timeout 5 'swaylock -f' で確認でき、 操作でロックが延期されること、idle-inhibit-v1 を持つクライアントが ある間はロックされないことを確認します。

拡張と統合テスト

headless スモークテストは、設定 include、フック、一時ランタイムを使って コンポジタを起動し、ワークスペース変更、レイアウトの永続化、実行中の上書き を保った設定再読み込みの反映、ステータス設定/削除、イベント購読、IPC の 半クローズ処理、フローティングのキーボードリサイズ、foot があれば ウィンドウの生成/フォーカス/終了イベントを確認します。

./scripts/build.sh
sh tests/smoke.sh

TESSA_CTL_DEBUG=1 tessa-ctl events は受信したイベント行を stderr に表示 します。API とフック環境は EXTENDING.ja.md を参照して ください。

拡張・シェルモジュール・エフェクトの変更は次のテストで確認します:

sh tests/extensions.sh      # マニフェスト、依存関係、token スコープ、enable/disable
sh tests/extension-api.sh   # v1 契約: 認証、失効、timeout、JSON 診断
sh tests/panel-modules.sh   # panel_modules の所有権と supervisor 再起動
sh tests/effect-v2.sh       # tint とアニメーション上書き、v1 互換性
sh tests/effect-cache.sh    # scenefx 専用の適用キャッシュカウンタ
sh tests/shell-coexistence.sh # Quickshell/Noctalia が入っている場合の共存

全テスト一覧はメイン README にあります。tests/shell-v2.sh、 tests/rendering.sh、tests/tearing.sh、tests/ipc-version.sh と レイアウト/パネル系テストはすべて headless で動作し、リリース確認に含まれます。

デバッグログ

# wlroots のデバッグログ、Tessa のログ、IME/ポップアップの診断
TESSA_DEBUG=1 ./scripts/run-headless.sh

# パネル状態のスナップショット（アクティブワークスペース、ウィンドウ数）
TESSA_PANEL_DEBUG=1 ./scripts/run-headless.sh

# テストクライアントの完全な Wayland プロトコルログ
WAYLAND_DISPLAY=wayland-0 XDG_RUNTIME_DIR=/tmp/tessa-headless \
  WAYLAND_DEBUG=1 foot -T debug

環境変数による上書き:

• TESSA_IPC=/path/to/socket
• TESSA_CONFIG=/path/to/config
• TESSA_NO_PANEL=1
• TESSA_PANEL_BIN=/path/to/tessa-panel
• TESSA_PANEL_OUTPUT=<出力名>（出力ごとのパネルで自動設定）
• TESSA_OUTPUT_CONFIG=/path/to/outputs.conf
• TESSA_NO_XWAYLAND=1
• TESSA_XWAYLAND_BIN=/path/to/xwayland-satellite
• TESSA_DEBUG=1
• TESSA_PANEL_DEBUG=1

実機 TTY

DRM と libinput を使う場合は、マシンのアクティブな仮想ターミナルで Tessa を実行してください。コンポジタは DRM master と seat へのアクセスが 必要です。無関係な SSH セッションから起動しても、使えるハードウェア セッションにはなりません。

cd /path/to/Tessa
PATH="$PWD/zig-out/bin:$PATH" ./zig-out/bin/tessa

パネルは PATH から自動起動されます。scripts/install-session.sh で インストールした場合、セッションのエントリーポイントが自分自身の ディレクトリを PATH の先頭に追加するので、両方のバイナリが見つかります。

反復作業のヒント

• パネル設定を変更したら Super+R を押してください。パネルは config-reload を受けて配色、バーのジオメトリ、フォント、ターミナル、 ランチャー項目、電源コマンドを読み直します。ジオメトリ変更時はバーの layer surface を再作成します。
• SSH 越しでは pkill -x tessa と pkill -x tessa-panel を使う方が安全です。 pkill -f tessa は SSH のリモートコマンドライン自体にマッチして、 セッションを殺してしまうことがあります。
• headless 出力名は安定しています: grim -o HEADLESS-1。
• Zig の translate-c は Pango/GLib のヘッダーを処理できません。テキスト 描画は panel/text.c にあり、Pango を C 翻訳ヘッダーに入れないでください。
• layer-shell の EXCLUSIVE は enum 値の 1 です。2 は ON_DEMAND。
• ReleaseSafe では C インポートに _FORTIFY_SOURCE=0 が必要です。2 つの c.zig ですでに設定されています。
• Xwayland 24.x は起動時に親 seat のキーマップを必要とします。キーボードが ないと XKB: Failed to compile keymap で失敗します。input.zig の フォールバックキーボードはこのためにあります。
• 子プロセスを exec する前に SIGCHLD を SIG_DFL に戻してください。Tessa は 自分の子プロセスのために SIGCHLD を無視しているので、そのまま継承すると ヘルパーの起動と待機が壊れます（Xwayland の xkbcomp もこれに該当します）。
• wlr_xdg_toplevel_decoration_v1_set_mode() は xdg サーフェスの初回 commit 前に configure をスケジュールしてはいけません。未初期化なら scheduled_mode を設定し、初期化後にモードを適用してください。