ArchWiki - 利用者の投稿記録 [ja]

Xterm

2026-01-18T14:19:06Z

Mycelithyl: /* カラー */ 衍字を除去、man pageの記法を修正

[[Category:ターミナルエミュレータ]]
[[de:Xterm]]
[[en:Xterm]]
[[fr:Xterm]]
[[ru:Xterm]]
'''xterm''' は [[Xorg|X Window System]] の標準の[[Wikipedia:Terminal emulator|ターミナルエミュレータ]]です。様々なカスタマイズができ、多数の役に立つ機能と、少数のあまり役に立たない機能を備えています。

== インストール ==

{{Pkg|xterm}} パッケージを [[インストール]] して下さい。

== 基本設定 ==

=== リソースファイルの設定 ===

ターミナルエミュレータとして使いやすさを向上させるオプションを [[X リソース]]ファイルで設定することができます。オプションのリストは {{ic|man xterm}} を見て下さい。

==== TERM 環境変数 ====

xterm が {{ic|TERM}} 変数を適切に設定できるようにしてください。{{ic|~/.bashrc}} や {{ic|~/.bash_profile}} などのファイルから TERM 変数を設定してはいけません。ターミナルが自ら適切な {{ic|TERM}} を設定することで、適切な ''terminfo'' ファイルが使われるようになります。利用できる terminfo ファイルは ''xterm'' と ''xterm-256color'' です。

TERM を明示的に設定しなかった場合、xterm は {{ic|$TERM}} を {{ic|xterm}} と設定します。以下のコマンドを xterm の中から実行することで確認できます:

$ echo $TERM
$ tset -q

TERM が明示的に設定されていない場合、vim など、プログラムによっては何かキーが押されるまでカラースキームが正しく表示されないことがあります。この問題は以下のようにリソースを設定することで直せます:

xterm*termName: xterm-256color

==== UTF-8 ====

[[ロケール]] が UTF-8 に設定されていることを確認してください。UTF-8 を使用しない場合は、設定によって xterm がロケールに厳密に従うように強制する必要がある場合があります。

XTerm.vt100.locale: true

UTF-8 を強制するには、次のように設定します。

XTerm.vt100.locale: false
XTerm.vt100.utf8: true

XTerm は {{ic|eo.UTF-8}} を含むすべての UTF-8 ロケールをサポートしているわけではないためこの設定は、多くの場合必要になります。

==== 'Alt' キーを他のターミナルエミュレータと同じように動作させる ====

例えば {{Ic|Alt+f}} を押すと {{Ic|æ}} が挿入されます。{{ic|Alt}} の代わりに {{Ic|^[}} を送るようにするには、(gnome-terminal や konsole のように) 以下を設定します。

XTerm.vt100.metaSendsEscape: true

==== バックスペースキーの修正 ====

Arch Linux では、xterm は backspace が押されると {{ic|^H}} キーを送信します。これは [[Emacs]] の {{ic|Ctrl+H}} キーコンビネーションを壊してしまいます。
回避策として、リソースに以下を追加して下さい。

XTerm.vt100.backarrowKey: false
XTerm.ttyModes: erase ^?

==== キーバインド ====

xterm は端末を操作するための一連の "アクション" を定義しています。例えば、 {{ic|copy-selection()}}, {{ic|hard-reset()}}, {{ic|scroll-back()}} などです。これらのアクションは {{ic|translations}} リソースを使用してマウスとキーの組み合わせにマッピングできます。例えば、ウィンドウを最大化/復元するために {{ic|Ctrl+M}} と {{ic|Ctrl+R}} をマップすることができます。

XTerm.vt100.translations: #override \n\
Ctrl <Key>M: maximize() \n\
Ctrl <Key>R: restore()

{{ic|#override}} は、これらのキー割り当てが既存のキー割り当てを上書きすることを示します (カスタムキー割り当てでは、ほとんどの場合、これが必要です。) 各バインドはエスケープシーケンス {{ic|n}} で区切らなければなりません。もし、リテラルな改行を挿入したい場合は、それもエスケープする必要があります（{{ic|ac|n}} となります。）動作の完全なリストと多くの例は {{man|1|xterm}} の '''KEY BINDINGS''' セクションを参照してください。

{{Tip|キーバインドを切り替えて使うこともできます。man ページの {{ic|keymap()}} アクションを参照してください。}}

=== スクロール ===

xterm ウィンドウの一番下に新しい行が書き込まれると、一番上の古い行は消えます。マウスホイールや {{ic|Shift+PageUp}} または {{ic|Shift+PageDown}} のキーコンビネーション、あるいはスクロールバーを使うことで画面から消えた行をスクロールして見ることができます。

デフォルトでは、1024行が保存されます。保存する行数は {{ic|saveLines}} リソースで変更できます:

XTerm.vt100.saveLines: 4096

スクロールの設定を変更する他の X リソースとしては {{ic|jumpScroll}} (デフォルトでは {{ic|true}}) や、{{ic|multiScroll}} と {{ic|fastScroll}} があります (どちらもデフォルトでは {{ic|false}}) [[#VT オプションメニュー|別のスクリーン]] の中をスクロールするには、{{ic|alternateScroll}} を {{ic|true}} に設定してください。

==== スクロールバー ====

スクロールバーはデフォルトでは表示されません。これを有効にしたり、リソース設定を通じて外観を調整することができます ("scrollbar" の大文字と小文字の違いに注意してください)

XTerm.vt100.scrollBar: true
XTerm.vt100.scrollbar.width: 8

他のスクロールバーリソースについては、{{man|1|xterm|Scrollbar Resources}} を参照してください。

スクロールバーの使い方は普段使用するようなスクロールバーとは異なっています。

*下にスクロール:
** スクロールバーを左マウスボタンでクリック
** スクロールバーの ''つまみ'' (サム) の下部を中マウスボタンでクリック
*上にスクロール:
** スクロールバーを右マウスボタンでクリック
** スクロールバーの ''つまみ'' (サム) の上部を中マウスボタンでクリック
*上下どちらかに移動:
** 中マウスボタンで ''つまみ'' をクリックして "クリックアンドドラッグ"

=== メニュー ===

Arch Linux の xterm ではツールバーやメニューバーは無効にしてコンパイルされています。メニューは xterm ウィンドウの中で {{ic|Ctrl+MouseButton}} を押すことでポップアップして表示されます。メニューアイテムで設定できることは、大抵コマンドラインオプションやリソースの設定でも可能です。

{{Tip|ポップアップメニューウィンドウが小さく表示される場合、リソースファイルに {{ic|xterm*geometry: 80x32}} などと設定しているのが原因です。この設定だと xterm のメインウィンドウが80列32行で起動するのではなく、メニューウィンドウが80ピクセルx32ピクセルになります。次のように置き換えてください: {{ic|xterm*VT100.geometry: 80x32}}。}}

メニューオプションは以下で説明します。

==== メインのオプションメニュー ====

'''''Ctrl + 左マウス'''''

*{{ic|Secure Keyboard}} を設定すると xterm ウィンドウだけがキーストロークを受け取れるようになり、他のアプリケーションがキーストロークを傍受することはできなくなります。実行すると画面の色が反転します。色が反転しない場合、''Secure Keyboard'' モードが有効になっていません。このオプションの制限については xterm の man ページの "SECURITY" セクションを読んで下さい。

*{{ic|Allow SendEvents}} は他のプロセスが xterm ウィンドウに打鍵やマウスのイベントを送信できるようにします。セキュリティ上のリスクがあるため、何の効果があるのかよくわからないときは有効にしないでください。

*{{ic|Log to File}} – ログファイルの名前は {{ic|Xterm.log.hostname.yyyy.mm.dd.hh.mm.ss.XXXXXX}} になります。このファイルには印字された出力とマウスの移動が全て記録されます。ログ出力はセキュリティリスクになることもあります。

*6つの {{ic|Send *** Signal}} メニューアイテムはキーボードが動作しなくなったような場合を除いて、基本的に使うことはありません。{{ic|HUP}}, {{ic|TERM}}, {{ic|KILL}} は xterm ウィンドウを終了します。{{ic|KILL}} はできるだけ使わないでください。

*{{ic|Quit}} メニューアイテムは xterm ウィンドウを終了します。{{ic|HUP}} シグナルを送信するのと同じです。キーボードで {{ic|Ctrl+d}} を押すか、または {{ic|exit}} を入力することでも xterm は終了できます。
==== VT オプションメニュー ====

'''''Ctrl + 中マウス'''''
*{{ic|Select to Clipboard}} – 通常、選択されたテキストは PRIMARY に保存され、中マウスボタンを使うか {{ic|Shift+Insert}} で貼り付けることができます。このオプションをオンにすると、選択されたテキストは CLIPBOARD を使うようになり、xterm ウィンドウで選択したテキストを {{ic|Ctrl+v}} で GUI アプリケーションに貼り付けることができます。対応する XTerm リソースは {{ic|selectToClipboard}} です。

*{{ic|Show Alternate Screen}} – ''vim'' や ''less'' などのターミナルアプリケーションを使うときに、新しい画面が開きます。メインの VT ウィンドウは非表示になりますが、メモリ上に残ります。このメニューオプションを有効にすると、メインウィンドウを見ることができるようになりますが、メインウィンドウでコマンドを実行することはできません。メインウィンドウからテキストを選択・コピーすることは可能です。

{{Tip|代替画面で実行中のプロセスを一時停止してから再開すると、{{ic|Show Alternate Screen}} を使用するよりも多くの機能が提供されます。bash シェルでは、{{ic|Ctrl+z}} を押すとプロセスが中断され、{{ic|fg}} コマンドを発行するとプロセスが再開されます。}}

*{{ic|Show Tek Window}} と {{ic|Switch to Tek Mode}} – [[Wikipedia:Tektronix 4010|Tektronix 4014]] は CAD やプロットアプリケーションで使われていた1970年代のグラフィックスターミナルです。{{Pkg|plotutils}} に含まれているコマンドラインプログラム {{ic|graph}} やアプリケーション {{Pkg|gnuplot}} が xterm の Tek エミュレーションを使うことができます。ただし、普通の人はデータを図に記すのに近代的なディスプレイオプションを使うでしょう。下の [[#Tek 4014 デモンストレーション]] を見て下さい。

==== VT フォントメニュー ====

'''''Ctrl + 右マウス'''''

*XLFD フォントを使用する場合、最初の7つのメニューアイテムが xterm ウィンドウで使われるフォントフェイスやフォントサイズを変更します。Xft フォントを使う場合、フォントサイズだけが変わります。フォントフェイスは変わりません。

{{Tip|プロセスを監視したいが、ターミナルウィンドウに大きな画面スペースを割きたくない場合に、{{ic|Unreadable}} と {{ic|Tiny}} が便利です。例えば、長時間のコンパイル処理で、処理が完了したことだけを確認したいような場合に使用します。}}

* XLFD フォントの名前を使うときに、{{ic|Selection}} で PRIMARY (または CLIPBOARD) セレクションに保存されたフォントの名前に切り替えられます。

==== Tek オプションメニュー ====

'''Tek Window''' から '''''Ctrl + 中マウス'''''

最初のセクションのオプションは Tek ウィンドウのフォントサイズを変えられます。2番目のセットのオプションは Tek エミュレーションウィンドウとメインウィンドウ、''VT'' ウィンドウのフォーカスを移動したり、Tek ウィンドウを終了・非表示にするのに使います。

=== コピーアンドペースト ===
まず、xterm（または他のアプリケーション）でマウスを使ってテキストをハイライトすると、コピーするテキストが選択され、マウスの中ボタンをクリックすると、ハイライトされたテキストがペーストされます。また、キーの組み合わせ {{ic|Shift+Insert}} でも貼り付けられますが、これは xterm 内に限られます。

==== PRIMARY または CLIPBOARD ====

デフォルトでは、X で動作する xterm などのアプリケーションは、選択されたテキストを PRIMARY セレクションと呼ばれるバッファにコピーします。PRIMARY セレクションは短命です。他のテキストが選択されるとすぐに新しい PRIMARY セレクションによってテキストは置き換えられます。アプリケーションによっては ({{ic|Shift+Insert}} ではなく) 中マウスで PRIMARY セレクションを貼り付けることができますが、PRIMARY を全く貼り付けることができないアプリケーションも存在します。

テキストをコピーするときは CLIPBOARD セレクションと呼ばれるバッファも使われます。CLIPBOARD のテキストは長命で、ユーザーによって上書きされるまで保存されます。{{ic|Ctrl+c}}, {{ic|Ctrl+x}}, {{ic|Ctrl+v}} を使ってテキストのコピー・切り取り・貼り付けをするアプリケーションはこの CLIPBOARD を使っています。

他のセレクションを選択するとすぐコピーしたテキストが消失してしまう PRIMARY セレクションの儚さが鬱陶しいと感じられるかもしれません。Xterm では [[#VT オプションメニュー]] の {{ic|Select to Clipboard}} や {{ic|selectToClipboard}} リソースを使うことで PRIMARY と CLIPBOARD の使用を切り替えることができます。

==== PRIMARY と CLIPBOARD ====

上記の設定では PRIMARY または CLIPBOARD どちらかを使うことを選択できますが、両方使いたい場合、{{ic|.Xresources}} に以下のように記述する必要があります:

XTerm*VT100.translations: #override <Btn1Up>: select-end(PRIMARY, CLIPBOARD, CUT_BUFFER0)

==== テキストの選択 ====

初めて使う人は、マウスの左ボタンで ''クリック＆ドラッグ'' することでテキストを選択できます。ダブルクリックすると、単語が選択されます。単語は、連続したアルファベット文字とアンダースコア、または基本正規表現（BRE）{{ic|[A-Za-z_]}} で定義されます。トリプルクリックは行を選択し、''タブ'' 文字は通常複数の ''スペース'' 文字としてコピーされます。

もう一つのテキスト選択の方法は、特に複数の全画面をコピーするときに便利です。
#選択したい部分の始点で左クリックします。
#選択範囲の終端が見える位置までスクロールする。
#選択範囲の終点で右クリック。
ハイライトされた選択範囲は、右クリックによって拡大・縮小することができます。

xterm ウィンドウ内の任意の場所で左クリックすると、選択したテキストを消去することができます。

== カラー ==

xtermのデフォルトは、白の ''背景色'' に黒の ''前景色'' です。前景色と背景色を逆にするには、リソースを設定することで逆転できます。

XTerm.vt100.reverseVideo: true

あるいは、リソースを使用して、前景色と背景色 (および最初の 16 個の端子色) を直接変更することもできます。

XTerm.vt100.foreground: white
XTerm.vt100.background: black
XTerm.vt100.color0: rgb:28/28/28
! ...
XTerm.vt100.color15: rgb:e4/e4/e4

{{Note|X ライブラリを使用するアプリケーションの色は、さまざまな方法で指定することができます。いくつかの色は、割り当てられた名前で指定することができます。 {{Pkg|emacs}} または {{Pkg|vim}} がインストールされていれば、 {{ic|/usr/share/emacs/*/etc/rgb.txt}} または {{ic|/usr/share/vim/*/rgb.txt}} で色名のリストとその 10 進数の RGB 値を確認することができます。色は 16 進数の RGB 値で {{ic|rgb:RR/GG/BB}} というフォーマットで指定することもできますし、古い構文で推奨されていない {{ic|#RRGGBB}} という構文で指定することもできます。{{ic|PapayaWhip}} の色は {{ic|rgb:ff/ef/d5}} と同じで、これは {{ic|#ffefd5}} と同じです。色の構文についてのより完全な説明は {{Pkg|xorg-docs}} の {{man|7|X}} を参照してください。}}

カラースキームについては [https://bbs.archlinux.org/viewtopic.php?id=51818&p=1 Terminal Colour Scheme Screenshots] のフォーラムスレッドに様々な設定例が載っています。

{{Tip|多くの人は、アプリケーションクラスやアプリケーションインスタンスを指定せずに、X リソースファイルで色を指定します

*foreground: rgb:b2/b2/b2
*background: rgb:08/08/08

上記の例では、これらのリソースを使用するすべての''Xlib'' アプリケーション (xclock、xfontsel など) の前景色と背景色の値を設定しています。これは、統一された配色を実現するための優れた簡単な方法です。}}

== フォント ==

=== デフォルトフォント ===

Xterm のデフォルトフォントは [[X Logical Font Description]] エイリアスで {{ic|fixed}} という名前のビットマップフォントです。大抵は以下のフォントになります:

-misc-fixed-medium-r-semicondensed--13-120-75-75-c-60-iso8859-?

このフォントは {{ic|6x13}} という名前でもエイリアスされていて、ユニコードのグリフに対して驚くほど広いカバー範囲を持っています。デフォルトの "TrueType" フォントは {{ic|mono}} という名前の 14-point フォントになります。使用される ''FreeType'' フォントは、このコマンドで見つけることができます。

$ fc-match mono

フォントが TrueType であるかどうかに応じて、リソースでフォントを指定できます:

XTerm.vt100.faceName: Liberation Mono:size=10:antialias=false
XTerm.vt100.font: 7x13

テストするには、コマンドラインでフォントを設定することもできます: {{ic|faceName}} の場合は {{ic|-fa}}、{{ic|font}} の場合は {{ic|-fn}}。両方の種類のフォントを設定した場合は、[[Xterm#VT フォントメニュー|VT フォントメニュー]] から {{ic|TrueType フォント}} を切り替えることで、2 つのフォントを切り替えることができます。次のリソースを使用してデフォルトを選択することもできます

! start with TrueType fonts disabled
XTerm.vt100.renderFont: false

=== 太字フォントと下線フォント ===

xterm で XLFD 名を使用する場合、イタリック体のフォントは下線文字として表示されます。 TrueType フォントは斜体の書体を使用する必要があります。

コマンドライン、{{ic|-fb}}、または {{ic|XTerm.vt100.boldFont}} リソースで太字フォントを指定しない場合、xterm は通常のフォントに一致する太字フォントを探そうとします。一致するフォントが見つからない場合、太字フォントは通常フォントを ''overstriking'' することによって作成されます。

=== CJK フォント ===

中国語や日本語、韓国語で使われる全角文字が含まれているフォントは多くありません。これらの言語を使う場合は [[urxvt]] など別のターミナルエミュレータを使うほうが良いでしょう。

xterm における CJK のビットマップの XLFD フォントの使用は落とし穴がたくさんあります。CJK を表示するときは {{ic|faceNameDoublesize}} リソースを利用して TrueType フォントを使うほうがずっと楽です。以下の例では通常フォントとして ''DejaVu Sans Mono'' を全角フォントとして ''WenQuanYi Bitmap Song'' を使用します:

XTerm.vt100.faceName: DejaVu Sans Mono:style=Book:antialias=false
XTerm.vt100.faceNameDoublesize: WenQuanYi WenQuanYi Bitmap Song
XTerm.vt100.faceSize: 8

== ヒントとテクニック ==

=== 自動透過 ===

{{AUR|transset-df}} パッケージと [[Xcompmgr]] などの[[Wikipedia:Compositing window manager|コンポジットマネージャ]]をインストールして、以下の行を {{ic|~/.bashrc}} に追加します:
[ -n "$XTERM_VERSION" ] && transset-df -a >/dev/null

これで、xterm でシェルを起動し、コンポジットマネージャーが起動している場合は、毎回、xterm ウィンドウが透明になります。
{{ic|transset-df}} の前にあるテストは {{ic|XTERM_VERSION}} が定義されていない場合に transet が実行されないようにするものです。この方法でシェル以外のプログラムを起動した場合、ターミナルが透明にならないことに注意してください。この機能が必要であれば、これを回避できる可能性があります。

[[en2:Per Application Transparency|アプリケーションごとの透過設定]] も参照。

=== 緊急ベルの有効化 ===

ベルの文字がウィンドウマネージャーに緊急事態を知らせるようにするには、次のように設定します:

XTerm.vt100.bellIsUrgent: true

=== フォントのヒント ===

==== 太字や斜体の代わりに色を使う ====

フォントサイズを小さくしている場合、太字や斜体の文字を読むのは困難です。太字や斜体、下線を無効にして代わりにテキストに色を付けることができます。例:

! disable bold font faces, instead make text light blue.
XTerm.vt100.colorBDMode: true
XTerm.vt100.colorBD: rgb:82/a4/d3
! disable underlined text, instead make it white.
XTerm.vt100.colorULMode: true
XTerm.vt100.colorUL: rgb:e4/e4/e4
! similarly use colorIT for italics

書式設定の情報については、[[Xterm#カラー|カラー]] を参照してください。

==== 行間の調整 ====

テキストの行が近すぎたり、間隔が広すぎたりすることがあります。一例として、''DejaVu Sans Mono'' を使用すると、アンダーバー記号が CJK グリフまたは下の行のカーソルブロックに突き当たる可能性があります。タイポグラフによって ''leading '' と呼ばれる行間隔は、たとえば間隔を広げるために、次のリソースを使用して調整できます:

XTerm.vt100.scaleHeight: 1.01

{{ic|scaleHeight}} に設定できる値は {{ic|0.9}} から {{ic|1.5}} までの間の数値で、デフォルトは {{ic|1.0}} です。

=== Tek 4014 デモンストレーション ===

{{Pkg|plotutils}} をインストールしている場合、xterm の Tektronix 4014 エミュレーションを使って plotutils パッケージのテストファイルを表示することができます。[[#VT オプションメニュー]] のメニューアイテム {{ic|Switch to Tek Mode}} を使うか次のコマンドで xterm を起動することで Tek ウィンドウを開いて下さい:
$ xterm -t -tn tek4014
完全に表示されると、PS1 は正しく表示されなくなります。新しいウィンドウで、次のコマンドを入力してください:
cat /usr/share/tek2plot/dmerc.tek
Tek ウィンドウに世界地図が表示されます。同じディレクトリにある他の {{ic|*.tek}} ファイルを表示することもできます。Tek ウィンドウを終了するには、xterm メニューを使います。

=== X11 の入力スヌーピングからの保護 ===

[[Xterm#メインのオプションメニュー|メインのオプションメニュー]] から "Secure Keyboard" モードを有効にするのは不便な場合があります。代わりに、[[Xterm#キーバインド|キーバインド]] を使用して {{ic|secure()}} アクションを呼び出すことができます:

Ctrl Alt <Key>S: secure()

== トラブルシューティング ==

=== スクロールでチラつきが発生する ===

{{Note|ダブルバッファを使用すると非ビットマップフォントが正しく表示されなくなることがあります。}}

[[ABS]] を使って {{ic|--enable-double-buffer}} フラグを指定して xterm をリビルドしてください:

./configure --prefix=/usr \
...
--with-utempter \
--enable-double-buffer

詳しくは [https://bbs.archlinux.org/viewtopic.php?id=146023 Xterm modifications] を参照。

=== 設定が適用されない ===

[[i3]] などの一部のアプリケーションでは、{{ic|xterm}} の代わりに {{ic|uxterm}} のラッパーを呼び出すことがあります。このような場合は、{{ic|uxterm}} と同じ設定を追加することで解決することができます。
UXTerm.vt100.reverseVideo: true

設定ファイルに重複した項目を書かない方が良い場合は、ワイルドカードによるマッチングを使用することができます。
*.vt100.reverseVideo: true

=== フォントサイズメニューでフォントサイズが変更されない ===

フォントサイズの変更で問題が発生した場合は、{{Pkg|xorg-mkfontscale}} パッケージをインストールしてください。

== 参照 ==

* [http://lukas.zapletalovi.com/2013/07/hidden-gems-of-xterm.html Hidden gems of Xterm]
* [http://www.in-ulm.de/~mascheck/X11/XTerm Commented XTerm resources]

Nnn

2025-12-22T05:06:23Z

Mycelithyl: /* 終了時に cd (Ctrl-G) */

{{DISPLAYTITLE:nnn}}
[[Category:ファイルマネージャ]]
[[Category:コンソールアプリケーション]]
[[en:nnn]]
[[ru:Nnn]]
{{Related articles start}}
{{Related|ファイルマネージャの機能}}
{{Related|Midnight Commander}}
{{Related|ranger}}
{{Related|vifm}}
{{Related articles end}}

[https://github.com/jarun/nnn nnn] (n³ とも表記されます) は C 言語で書かれた携帯端末用ファイルマネージャです。フラットテキストプラグインシステムにより簡単に拡張でき、[https://github.com/mcchrish/nnn.vim (neo)vim] プラグインを含む、すでに利用できるプラグインに加えて独自の言語依存スクリプトを追加することができます。 ''xz'' のような一般的にインストールされるフォーマットへのアーカイブ/解凍、ディスク使用量の分析、ファジーアプリランチャー、バッチファイルリネーマー、ファイルピッカーがプラグインアーキテクチャによりネイティブに機能します。''nnn'' は、正規表現 (または単純な文字列) フィルタによる即時の ''search-as-you-type'' と、ディレクトリ自動選択によるフィルタモードで連続的にナビゲーションする ''navigate-as-you-type'' モードをサポートします。また、コンテキスト、ブックマーク、複数のソートオプション、SSHFS、選択範囲（選択されたファイルのグループ）に対するバッチ操作など、さまざまな機能がサポートされています。

その豊富な機能にもかかわらず、''nnn'' は使いやすいように設計されており、設定ファイルを使用せずに [[環境変数]] によって設定されるようになっています。

== インストール ==

nnn は {{Pkg|nnn}} パッケージで[[インストール]]できます。

=== 使用方法 ===

nnn は vim ライクな {{ic|hjkl}} の文字、あるいは方向キーで制御できます。キーを覚える必要はありません。方向キーと {{ic|/}} と {{ic|q}} で十分です。{{ic|?}} を押すことでキーボードショートカットのヘルプをいつでも表示できます。

=== 設定 ===

nnn は[[環境変数]]で設定します。{{ic|~/.bashrc}} を編集してください。設定について詳しくはマニュアルページの {{man|1|nnn}} や nnn wiki の [https://github.com/jarun/nnn/wiki 設定ページ] に詳しく書かれています。

{{hc|head=~/.bashrc|output=
export NNN_BMS='d:~/Documents;u:/home/user/Cam Uploads;D:~/Downloads/'
export NNN_SSHFS="sshfs -o follow_symlinks" # make sshfs follow symlinks on the remote
export NNN_COLORS="2136" # use a different color for each context
export NNN_TRASH=1 # trash (needs trash-cli) instead of delete
}}

{{Note|ディスプレイマネージャを使っている場合、nnn を {{ic|nnn.desktop}} から起動させるときに {{ic|.bashrc}} が読み込まれないことがあります。[https://github.com/jarun/nnn/wiki/Advanced-use-cases#desktop-integration Desktop Integration] にしたがって設定してください。}}
{{ic|NNN_BMS}} 変数で、ブックマークしたディレクトリに簡単にジャンプするショートカットを選択します。デフォルトでは {{ic|b}} に設定されている {{ic|<leader-key>}} で呼び出せます。上記の例の場合 {{ic|bD}} とキーを押すことで nnn は {{ic|~/Downloads}} に移動します。ただし、これらはすべてオプションです。''nnn'' は、すべてのマシンで一貫して同じように動作します。

==== ターミナルでファイルを選択 ====

{{ic|nnn}} で選択したファイルのリストを取得するには以下のエイリアスを作成します:

{{hc|head=~/.bashrc|output=
<nowiki>alias ncp="cat ${NNN_SEL:-${XDG_CONFIG_HOME:-$HOME/.config}/nnn/.selection} | tr '\0' '\n'"</nowiki>
}}

他のツールに選択したファイルをパイプで渡すことができます。

==== nnn シェルで深度レベルを指定 ====

{{ic|!}} を使ってカレントディレクトリでシェルを開く場合、以下を追加すると良いでしょう:

{{hc|head=~/.bashrc|output=
[ -n "$NNNLVL" ] && PS1="N$NNNLVL $PS1"
}}

シェル内にいる状態を維持しながら終了時に nnn に戻るプロンプトに示させるには、次のようにします。

[[#終了時に cd (CTRL-G)]] と組み合わせることで強力なコンビになります。

==== 終了時に cd (Ctrl-G) ====

以下を {{ic|.bashrc}}/{{ic|.zshrc}} に追加してください。
{{hc|~/.bashrc or ~/.zshrc|output=
if [ -f /usr/share/nnn/quitcd/quitcd.bash_sh_zsh ]; then
source /usr/share/nnn/quitcd/quitcd.bash_sh_zsh
fi
}}
そして、{{ic|nnn}} の代わりに {{ic|n}} コマンドを実行します(正確には n の bash 関数です)

[https://github.com/jarun/nnn/wiki/Basic-use-cases#configure-cd-on-quit nnn wiki] も参照してください。

==== 自分のプラグインを追加 ====

{{ic|${XDG_CONFIG_HOME:-$HOME/.config}/nnn/plugins}} に追加することでプラグインを実行できます。例えば実行シェルスクリプトを作成:

{{hc|head=${XDG_CONFIG_HOME:-$HOME/.config}/nnn/plugins/git-changes|output=
#!/usr/bin/env sh
git log -p -- "$@"
}}

{{ic|R}} を押してから {{ic|git-changes}} を選択することで起動でき、特定のファイルの git ログとコードが表示されます。

== 参照 ==

* [https://github.com/jarun/nnn nnn の公式リポジトリ]
* [https://github.com/jarun/nnn/wiki/Basic-use-cases Guides for additional configuration of nnn]
* [https://www.youtube.com/watch?v=U2n5aGqou9E Introduction to nnn video]

ネットワークタイムプロトコルデーモン

2025-12-18T04:50:11Z

Mycelithyl: /* NetworkManager */ リンク先の修正・AURパッケージに対する「公式リポジトリ」の言及を削除

[[Category:ネットワークタイムプロトコル]]
[[en:Network Time Protocol daemon]]
[[es:Network Time Protocol daemon]]
[[fr:ntp]]
[[it:Network Time Protocol daemon]]
[[ru:Network Time Protocol daemon]]
[[zh-hans:Network Time Protocol daemon]]
{{Related articles start}}
{{Related|NTPsec}}
{{Related|Chrony}}
{{Related|時刻同期}}
{{Related articles end}}
[[Wikipedia:ja:Network Time Protocol|ネットワークタイムプロトコル(NTP)]] は GNU/Linux の[[時刻|ソフトウェアクロック]]をインターネット上の時刻サーバーと同期するのに使われる最も一般的な方法です。変動的なネットワークの遅延を軽減し、インターネットを使って数十ミリ秒の範囲で時刻を維持できるように設計されています。ローカルエリアネットワークの場合、一ミリ秒まで正確性を保てます。

[http://support.ntp.org/bin/view/Main/WebHome#The_NTP_Project NTP プロジェクト] は NTP という名前のプロトコルのリファレンス実装を提供しています。NTP の代わりになるものとして、ダイアルアップフレンドリで常時オンラインではない環境用に設計されている [[Chrony]] と、OpenBSD プロジェクトの [[OpenNTPD]] があります。

この記事ではクライアント・サーバー両方で NTP デーモンを設定・起動する方法を説明しています。

==インストール==

[[公式リポジトリ]]にある {{pkg|ntp}} を[[pacman|インストール]]してください。

==設定==

メインのデーモンは ''ntpd'' で、{{ic|/etc/ntp.conf}} から設定を行います。

''ntp'' パッケージのデフォルトの設定ファイルでは、設定のカスタマイズを行わなくてもクライアントモードで ''ntpd'' が動作するようになっています。デフォルト設定を使って起動したい場合は、[[#使用方法]] までスキップできます。

以下ではメイン設定のアイテムのカスタマイズについて説明しています。マニュアルページも参照してください: {{man|5|ntp.conf}} や関連する {{ic|man <nowiki>{ntpd|ntp_auth|ntp_mon|ntp_acc|ntp_clock|ntp_misc}</nowiki>}}。

===NTP サーバーへの接続の設定===

{{ic|/etc/ntp.conf}} を手動で設定したい場合は、まずマシンが同期するサーバを設定してください。

NTP サーバは階層的なシステムによって ''strata'' と呼ばれるたくさんのレベルにクラス分けされています。その定義は、独立したタイムソースとされるデバイスは ''stratum 0'' ソース、''stratum 0'' のデバイスに直接接続しているサーバーを ''stratum 1'' ソース、''stratum 1'' ソースに接続しているサーバーを ''stratum 2'' ソース、と続きます。

サーバーの stratum は正確性や信頼性を表しているわけではないことを理解する必要があります。一般的に、stratum 2 のサーバーが時刻同期に使われます: どのサーバーに接続するのかまだ決めてない場合、[http://www.pool.ntp.org/ pool.ntp.org] サーバー ([http://support.ntp.org/bin/view/Servers/NTPPoolServers alternative link]) を使って一番地理的に近いサーバープールを選んで下さい。

サンプル:
{{hc|/etc/ntp.conf|
server 0.jp.pool.ntp.org iburst
server 1.jp.pool.ntp.org iburst
server 2.jp.pool.ntp.org iburst
server 3.jp.pool.ntp.org iburst
}}
{{ic|iburst}} オプションは推奨です。最初に試行した時に接続できなかったときだけパケットのバーストを送信するようになります。{{ic|burst}} オプションは常時バーストを送信するので、許可を得ているときにだけ使って下さい。さもないとブラックリストに入れられてしまう可能性があります。

===あなた自身の NTP サーバーの設定===
NTP サーバーを設定する場合、サーバーとして [http://www.ntp.org/ntpfaq/NTP-s-refclk.htm#Q-LOCAL-CLOCK ''local clock''] を追加する必要があります。これによりインターネットアクセスを失った時でも、ネットワークへの時刻の提供を続行することができます。(''fudge'' コマンドを使って) stratum 12 サーバーとして ''local clock'' を追加すればインターネットアクセスが失われない限り使用されません ([http://www.ntp.org/ntpfaq/NTP-s-algo.htm#Q-ALGO-BASIC-STRATUM stratum 15] まで設定することができます):

server 127.127.1.1
fudge 127.127.1.1 stratum 12

次に、''restrict'' コマンドを使ってあなたのサービスに接続できるクライアント (''localhost'' もクライアントとして見なされます) を制限するルールを定義します。あなたのファイルには次のような行がすでに存在するはずです:

restrict default nomodify nopeer noquery

これで誰も何も変更できなくなり時刻サーバーの状態の問い合わせも制止されます: {{ic|nomodify}} は ''ntpd'' (と ''ntpq'' または ''ntpdc'') の再設定を無視し、{{ic|noquery}} は ''ntpd'' (と ''ntpq'' または ''ntpdc'') の状態データのダンプを[https://mailman.archlinux.org/pipermail/arch-dev-public/2014-February/025872.html 防ぎます]。

また、他のオプションを加えることも可能です:

restrict default kod nomodify notrap nopeer noquery

{{Note|これは他の人々があなたの時刻サーバーに問い合わせるのを許可します。{{ic|noserve}} を追加して時刻の提供を止めて下さい。また ntpq と ntpdc クエリ以外の全てのパケットをブロックするので時刻同期もブロックされます。}}

"restrict" オプションの完全なドキュメントは {{ic|man ntp_acc}} にあります。詳しい説明は https://support.ntp.org/bin/view/Support/AccessRestrictions を参照してください。

次の行のように、サーバーへの接続を許可する IP を ''ntpd'' に伝える必要があります; NTP サーバーを設定しない場合はこのままで問題ありません:

restrict 127.0.0.1

DNS 解決を IPv6 ネームスペースに強制したい時は、IP アドレスやホストネームの前に {{ic|-6}} を書いて下さい ({{ic|-4}} は IPv4 を強制します)。例:

restrict -6 default kod nomodify notrap nopeer noquery
restrict -6 ::1 # ::1 is the IPv6 equivalent for 127.0.0.1

最後に、ドリフトファイル (時計の時刻のズレを記録します) と任意でログファイルの場所を指定してください:

driftfile /var/lib/ntp/ntp.drift
logfile /var/log/ntp.log

基本的な設定ファイルは以下のようになります:

{{hc|/etc/ntp.conf|
server 0.pool.ntp.org iburst
server 1.pool.ntp.org iburst
server 2.pool.ntp.org iburst
server 3.pool.ntp.org iburst

restrict default kod nomodify notrap nopeer noquery
restrict -6 default kod nomodify notrap nopeer noquery

restrict 127.0.0.1
restrict -6 ::1

driftfile /var/lib/ntp/ntp.drift
logfile /var/log/ntp.log
}}

{{Note|ログファイルの定義は必須ではありませんが、''ntpd'' の操作のフィードバックを得るのはどんなときでも良い考えです。}}

==使用方法==

このセクションでは ntpd やその他の ntp パッケージに入っているコマンドの使い方を扱います。

===デーモンとして使う===

NTP デーモンを起動する基本コマンドは:

# ntpd

ただし、これだと ''root'' としてバックグラウンドで動作します。このため、user オプションを毎回指定するべきです:
# ntpd -u ntp:ntp

[[#systemd サービス]] も見て下さい。

====デーモンが正しく同期を実行しているか確認する====

''ntpq'' を使って設定されたピアの一覧を見て下さい:
$ ntpq -p
delay, offset, jitter のカラムがゼロではないはずです。''ntpd'' が同期しているサーバーにはアスタリスクが前に付けられます。''ntpd'' が同期するサーバーを選ぶまで数分間かかることがあります。17分 (1024秒) 後に確認してみてください。

===デーモンを使わない===

デーモンを使わずにシステム時刻を同期させることも可能です。ただし、この方法は数日以上再起動を行わないようなマシンには相応しくありません。システム時刻を一度だけ同期するには、''ntpd'' を起動する代わりに、次を実行してください:
# ntpd -q

{{ic|-q}} フラグは ''ntpd'' で時刻を一度だけ設定して終了します。つまりデーモンは起動しません。この操作が失敗した場合、システムクロックは同期されません。

{{Note|上のコマンドは[http://support.ntp.org/bin/view/Dev/DeprecatingNtpdate 今はもう廃止された] {{ic|ntpdate}} コマンドと同じ働きをします。}}

また、システムプロセスの実行を保護するために、システム時刻と ntp サーバーの時刻が所与の閾値以上に食い違っている場合はシステム時刻は同期されません (いわゆる ''panic-gate'')。ただし、{{ic|-g}} オプションを使うことでこの閾値は無効にすることができ制限を越えることができます (時刻を初めて設定するときやハードウェアクロックが誤っている場合など)。

== 自動起動 ==

=== systemd サービス ===

ブート時に systemd によって ''ntpd'' を自動起動することが可能です。

====ブート時にデーモンを起動する====

''ntp'' パッケージには systemd 用に {{ic|ntpd.service}} が入っています。このサービスを [[Systemd#ユニットを使う|systemctl]] を使ってブート時にデーモンを起動してください。

もしくは次のコマンドを使って下さい:

====起動毎に同期する====

{{Warning|サーバーや、数日間電源を落とさないようなマシンではこの方法は非推奨です。}}

''ntp'' パッケージには {{ic|ntpdate.service}} が入っています。このサービスを [[Systemd#ユニットを使う|systemd]] によって有効化して起動毎に時刻を同期するようにできます。この ''oneshot'' サービスは、一度時刻同期が完了したらもうデーモンを起動し続ける必要がない場合に助けになる選択肢になります。

同期した時刻をハードウェアクロックにも書き込む必要があるときは、[[systemd#ユニットファイルの編集]] に書かれているように既存のユニットを設定してください:

{{hc|/etc/systemd/system/ntpdate.service.d/hwclock.conf|2=
[Service]
ExecStart=/usr/bin/hwclock -w
}}

それから起動してください。

=== ネットワーク接続時 ===

''ntpd'' をネットワークマネージャによって起動させることも可能です。こうすることでコンピュータがオンラインのときだけデーモンが動くようになります。

====Netctl====

以下の行をあなたの [[netctl]] プロファイルに追加してください:
ExecUpPost='/usr/bin/ntpd || true'
ExecDownPre='killall ntpd || true'

{{Note|[[#使用方法]] で説明されているように ''ntpd'' コマンドのオプションをカスタマイズすることを推奨します。}}

====NetworkManager====

[[NetworkManager#ネットワークサービスで NetworkManager dispatcher を使用する|NetworkManager の dispatcher スクリプト]]を使ってネットワーク接続にあわせて ''ntpd'' デーモンを立ち上げたり終了することができます。{{AUR|networkmanager-dispatcher-ntpd}} をインストールしてください。

==== Wicd ====

[[Wicd]] の場合、{{ic|postconnect}} に起動スクリプトを、{{ic|predisconnect}} ディレクトリに停止スクリプトを作成してください。スクリプトは忘れずに実行可能にしてください:

{{hc|/etc/wicd/scripts/postconnect/ntpd|
#!/bin/bash

/usr/bin/ntpd &
-or-
systemctl start ntpd &
}}

{{hc|/etc/wicd/scripts/predisconnect/ntpd|
#!/bin/bash

killall ntpd &
-or-
systemctl stop ntpd &
}}

{{Note|[[#使用方法]] で説明されているように ''ntpd'' コマンドのオプションをカスタマイズすることを推奨します。}}

[[Wicd#スクリプト]] も参照。

== ヒントとテクニック ==

=== GPS で ntpd を使う ===

GPS から時刻を取得するように ''ntpd'' を設定する方法が書かれたネット上の記事は大抵 SHM (共有メモリ) を使うことを推奨しています。しかしながら、''ntpd'' バージョン 4.2.8 からはさらに良い方法が存在します。直接 ''gpsd'' に接続するため、{{Pkg|gpsd}} をインストールしてください。

以下の行を {{ic|/etc/ntp.conf}} に追加:

{{hc|head=/etc/ntp.conf|output=
#=========================================================
# GPSD native ntpd driver
#=========================================================
# This driver exists from at least ntp version 4.2.8
# Details at
# https://www.eecis.udel.edu/~mills/ntp/html/drivers/driver46.html
server 127.127.46.0
fudge 127.127.46.0 time1 0.0 time2 0.0 refid GPS
}}

''gpsd'' が動作していれば上記で問題なく動作します。ローカルソケットを使って ''gpsd'' に接続し、返ってきた "gpsd_json" オブジェクトを問い合わせます。

セットアップをテストするには、まず以下を実行して ''gpsd'' が動作していることを確認してください:

$ cgps -s

それから数分待ってから {{ic|ntpq -p}} を実行します。''ntpd'' が ''gpsd'' と対話できていれば以下のように表示されます:

{{hc|$ ntpq -p|output=
remote refid st t when poll reach delay offset jitter
==================================================================================
*GPSD_JSON(0) .GPS. 0 l 55 64 377 0.000 2.556 14.109
}}

{{Tip|''reach'' カラムが 0 の場合、''ntpd'' は ''gpsd'' と通信できていません。さらに数分間待ってから再度実行してみてください。しばらく時間がかかることがあります。}}

{{Note|''ntpd'' は GPS デバイスの名前が {{ic|/dev/gps0}} などとなっていることを前提としています。USB で GPS デバイスを接続している場合、{{ic|/dev/ttyUSB0}} という名前になるため、シンボリックリンクを作成 ({{ic|ln -s /dev/ttyUSB0 /dev/gps0}}) してリンクを張った {{ic|/dev/gps0}} に対して ''gpsd'' を実行しないと {{ic|GPSD_JSON}} 行が正しく機能しません。}}

===chroot で実行する===

{{Note|''ntpd'' should be started as non-root (default in the Arch Linux package) before attempting to jail it in a chroot, since chroots are relatively useless at securing processes running as root.}}

新しいディレクトリ {{ic|/etc/systemd/system/ntpd.service.d/}} を作成してその中に {{ic|customexec.conf}} という名前のファイルを以下の内容で追加してください:
[Service]
ExecStart=
ExecStart=/usr/bin/ntpd -g -u ntp:ntp '''-i /var/lib/ntp'''

そして {{ic|/etc/ntp.conf}} を編集して driftfile のパスを実際の root ではなく chroot ディレクトリの相対パスに変えて下さい:
driftfile /var/lib/ntp/ntp.drift

を
driftfile /ntp.drift

に変えて下さい。適切な chroot 環境を作成してください。getaddrinfo() を動作させるために適切なディレクトリとファイルを (root で) 作成し:
# mkdir /var/lib/ntp/etc /var/lib/ntp/lib /var/lib/ntp/proc
# mkdir /var/lib/ntp/usr /var/lib/ntp/usr/lib
# touch /var/lib/ntp/etc/resolv.conf /var/lib/ntp/etc/services

そして上記のファイルをバインドマウントしてください:

{{hc|/etc/fstab|
...
#ntpd chroot mounts
/etc/resolv.conf /var/lib/ntp/etc/resolv.conf none bind 0 0
/etc/services /var/lib/ntp/etc/services none bind 0 0
/lib /var/lib/ntp/lib none bind 0 0
/usr/lib /var/lib/ntp/usr/lib none bind 0 0
/proc /var/lib/ntp/proc none bind 0 0
}}

# mount -a

最後に、デーモンを再起動してください。再起動したら {{ic|/proc/{PID}/root}} のシンボリックリンク先をチェックすることでデーモンプロセスが chroot されてることを確認できます:
# ps -C ntpd | awk '{print $1}' | sed 1d | while read -r PID; do ls -l /proc/$PID/root; done
{{ic|/}} ではなく {{ic|/var/lib/ntp}} にリンクしているはずです。

''ntpd'' は読み書きをあまり頻繁に行わないため、driftfile の設定が実際に機能しているか確認するには少し待つしかありません。何か問題が起こったら、エラーをログ出力します。問題がない場合、タイムスタンプが更新されます。一日中動かして何もエラーが表示されない、そしてタイムスタンプが更新されていれば大丈夫だと思われます。

=== 受信ソケットを制限する ===

''ntpd'' が listen するソケットを制限するには ''interface'' オプションを使います:
interface [listen | ignore | drop] [all | ipv4 | ipv6 | wildcard | name | address[/prefixlen]]

設定例:

{{hc|head=/etc/ntp.conf|output=
interface listen lo
interface listen enp3s0
interface ignore enp5s0
}}

== トラブルシューティング ==

=== Cannot assign requested address ===

以下のように ''Cannot assign requested address'' メッセージが表示される場合:

{{hc|$ journalctl -u ntpd|2=
ntpd[2130]: bind(21) AF_INET6 fe80::6ef0:49ff:fe51:4946%2#123 flags 0x11 failed: Cannot assign requested address
ntpd[2130]: unable to create socket on eth0 (5) for fe80::6ef0:49ff:fe51:4946%2#123
ntpd[2130]: failed to init interface for address fe80::6ef0:49ff:fe51:4946%2
}}

IPv6 を無効化することでメッセージを消すことができます。{{ic|ntpd.service}} を[[systemd#ユニットファイルの編集|編集]]して {{ic|-4}} を追加:

[Service]
ExecStart=
ExecStart=/usr/bin/ntpd -g -u ntp:ntp '''-4'''

==参照==

* http://www.ntp.org/
* https://support.ntp.org/
* http://www.pool.ntp.org/
* https://www.eecis.udel.edu/~mills/ntp/html/index.html
* http://www.akadia.com/services/ntp_synchronize.html

Systemd-boot

2025-12-07T20:55:51Z

Mycelithyl: /* EFI ブートマネージャのインストール */ 斜体のマークアップ位置を修正

{{lowercase title}}
[[Category:ブートローダー]]
[[de:Gummiboot]]
[[en:Systemd-boot]]
[[es:Systemd-boot]]
[[pt:Systemd-boot]]
[[ru:Systemd-boot]]
[[zh-hans:Systemd-boot]]
{{Related articles start}}
{{Related|Arch ブートプロセス}}
{{Related|ブートローダー}}
{{Related|セキュアブート}}
{{Related|Unified Extensible Firmware Interface}}
{{Related articles end}}
'''systemd-boot''' (旧名 '''gummiboot'''。ドイツ語で「ゴムボート」)は、設定された EFI イメージを実行するシンプルな [[UEFI]] [[ブートマネージャー]]です。デフォルトのエントリは設定されたパターン (glob) または矢印キーで操作する画面上のメニューによって選択されます。{{Pkg|systemd}} に含まれており、Arch システムにデフォルトでインストールされます。

systemd-boot は EFI 実行可能ファイル ([[EFISTUB]]、[[UEFI シェル]]、[[GRUB]]、[https://learn.microsoft.com/en-us/windows-hardware/drivers/bringup/boot-and-uefi#understanding-the-windows-boot-manager Windows ブートマネージャ]) のみを起動できることに注意してください。

== サポートされているファイルシステム ==

systemd-boot はファイルシステムのサポートを [[Arch ブートプロセス#UEFI|ファームウェア]] から引き継ぎます (少なくとも FAT12、FAT16、FAT32) さらに、{{ic|''esp''/EFI/systemd/drivers/}} にある [[Unified Extensible Firmware Interface#UEFI ドライバ|UEFI ドライバ]] を全てロードします。

== インストール ==

''systemd-boot'' は、{{Pkg|base}} メタパッケージの依存関係である {{Pkg|systemd}} パッケージとともに出荷されるため、追加のパッケージを手動でインストールする必要はありません。

== EFI ブートマネージャのインストール ==

''systemd-boot'' の EFI ブートマネージャをインストールする場合、まず UEFI モードでシステムが起動しているかどうか、[[Unified Extensible Firmware Interface#UEFI 変数|UEFI 変数]] が利用できるかどうか確かめてください。{{ic|efivar --list}} コマンドを実行することでチェックできます。または、efivar がインストールされていない場合は、{{ic|ls /sys/firmware/efi/efivars}} を実行してください (ディレクトリが存在する場合、システムは UEFI モードにブートされます)

このページでは ESP のマウントポイントを {{ic|''esp''}} として表します (大抵の場合は {{ic|/efi}} か {{ic|/boot}} です) これは、システムのマウントポイントに [[chroot]] していることを前提としています。

{{man|1|bootctl}} を使用して EFI システムパーティションに ''systemd-boot'' をインストールします:

# bootctl install

これにより、''systemd-boot'' UEFI ブートマネージャーが ESP にコピーされ、その UEFI ブートエントリが作成され、UEFI ブート順序の最初に設定されます。

* x64 UEFI では、{{ic|/usr/lib/systemd/boot/efi/systemd-bootx64.efi}} は {{ic|''esp''/EFI/systemd/systemd-bootx64.efi}} と {{ic|''esp''/EFI/BOOT/BOOTX64.EFI}} にコピーされます。
* IA32 UEFI では、{{ic|/usr/lib/systemd/boot/efi/systemd-bootia32.efi}} は {{ic|''esp''/EFI/systemd/systemd-bootia32.efi}} と {{ic|''esp''/EFI/BOOT/BOOTIA32.EFI}} にコピーされます。

UEFI ブートエントリは "Linux Boot Manager" と呼ばれ、UEFI のビット数によって、ESP 上の {{ic|EFI}systemd-bootx64.efi}} か {{ic|EFI}systemd-bootia32.efi}} を指します。

{{Note|
* {{ic|bootctl install}} を実行すると、''systemd-boot'' は ESP を {{ic|/efi}},{{ic|/boot}},{{ic|/boot/efi}} に配置しようとします。{{ic|''esp''}} を別の場所に設定するには、{{ic|1=--esp-path=''esp''}} オプションを渡す必要があります。(詳細は {{man|1|bootctl|OPTIONS}} を参照)
* ''systemd-boot'' をインストールすると既存の {{ic|''esp''/EFI/BOOT/BOOTX64.EFI}} は上書きされます。(または、{{ic|''esp''/EFI/BOOT/BOOTIA32.EFI}} の IA32 UEFI)、例えば Microsoft 版のファイルなどです。
}}

インストールを完了するには、''systemd-boot'' を[[systemd-boot#設定|設定]]します。

=== XBOOTLDR を使用したインストール ===

カーネルと initramfs を ESP から分離するために、"Linux extended boot" タイプ (XBOOTLDR) の別の [[パーティショニング#/boot|/boot パーティション]]を作成することができます。これは、既存の [[EFI システムパーティション|ESP]] が小さすぎる [[Windows と Arch のデュアルブート]] 時に特に役立ちます。

通常どおり ESP を作成し、同じ物理ドライブに XBOOTLDR 用の別のパーティションを作成します。XBOOTLDR のパーティションタイプ GUID は {{ic|"bc13c2ff-59e6-4262-a352-b275fd6f7172}} である必要があります。XBOOTLDR パーティションのサイズは、インストールする全てのカーネルを収納できる十分な大きさが必要です。

{{Note|
* systemd-boot は、 ESP の場合のようにファイルシステムチェックを行いません。したがって、他のファイルシステムを使用することは可能ですが、 UEFI 実装が起動中にそれを読み取ることができる場合に限ります。
* "fast boot" モードが有効の場合、UEFI ファームウェアは ESP 以外のパーティションのロードをスキップすることがあります。これにより、''システム起動'' が XBOOTLDR パーティション上のエントリを見つけられなくなる可能性があります。XBOOTLDRを使用するには、"fast boot" を無効にする必要があります。
* XBOOTLDR パーティションは、system-boot が認識できるように ESP と同じ物理ディスク上になければならない場合があります。
}}

インストール中に、ESP を {{ic|/mnt/efi}} にマウントし、 {{ic|''boot''}} を {{ic|/mnt/boot}} にマウントします。

chroot になったら、次のコマンドを使用します:

# bootctl --esp-path=/efi --boot-path=/boot install

インストールを完了するには ''systemd-boot'' を[[#設定|設定]]します。

=== UEFI ブートマネージャの更新 ===

新しいバージョンの ''systemd-boot'' がリリースされるたびに、UEFI ブートマネージャはオプションでユーザーによって再インストールできます。これは手動または自動で行うことができ、以下にその2つの方法を説明します。

{{Note|UEFI ブートマネージャは独立した EFI 実行可能ファイルであり、任意のバージョンを使用してシステムをブートできます(部分的な更新は適用されません。pacman は ''systemd-boot'' インストーラーのみをインストールし、''systemd-boot'' 本体はインストールしません)ただし、新しいバージョンは新機能を追加したり、バグを修正したりする可能性があるため、''systemd-boot'' の更新はおそらく良いアイデアです。}}

{{Warning|[[セキュアブート]] が有効な場合、ブートローダーの更新に署名する必要があります。詳細は [[#セキュアブートのための署名]] を参照してください。}}

==== 手動で更新 ====

''bootctl'' を使用して ''systemd-boot'' を更新:

# bootctl update

{{Note|{{ic|bootctl install}} と同様に、''systemd-boot''は ESP を {{ic|/efi}}、{{ic|/boot}}、{{ic|/boot/efi}} に配置しようとします。{{ic|''esp''}} を別の場所に設定するには、{{ic|1=--esp-path=''esp''}} オプションを渡す必要があります。}}

==== 自動で更新 ====

''systemd-boot'' を自動的に更新するには、[[systemd#ユニットを使う|systemd サービス]] または [[pacman フック]] を使用してください。これらの2つの方法については、以下に説明します。

===== systemd サービス =====

バージョン 250 以降、{{Pkg|systemd}} には {{ic|systemd-boot-update.service}} が同梱されています。このサービスを [[有効化]] すると、次回の起動時にブートローダーが更新されます。

===== Pacman フック =====

{{AUR|systemd-boot-pacman-hook}} パッケージは {{Pkg|systemd}} がアップグレードされる度に実行される pacman フックを追加します。

systemd-boot-pacman-hook をインストールするのではなく、次のファイルを {{ic|/etc/pacman.d/hooks/}} に手動で配置することをお勧めします:

{{hc|/etc/pacman.d/hooks/95-systemd-boot.hook|2=
[Trigger]
Type = Package
Operation = Upgrade
Target = systemd

[Action]
Description = Gracefully upgrading systemd-boot...
When = PostTransaction
Exec = /usr/bin/systemctl restart systemd-boot-update.service
}}

=== セキュアブートのための署名 ===

[[セキュアブート]] が有効な場合、パッケージのアップグレード時にブートマネージャを自動的に署名するために、pacmanフックを追加したい場合:

{{hc|/etc/pacman.d/hooks/80-secureboot.hook|2=
[Trigger]
Operation = Install
Operation = Upgrade
Type = Path
Target = usr/lib/systemd/boot/efi/systemd-boot*.efi

[Action]
Description = Signing systemd-boot EFI binary for Secure Boot
When = PostTransaction
Exec = /bin/sh -c 'while read -r i; do sbsign --key ''/path/to/keyfile.key'' --cert ''/path/to/certificate.crt'' "$i"; done;'
Depends = sh
Depends = sbsigntools
NeedsTargets
}}

{{ic|''/path/to/keyfile.key''}} と {{ic|''/path/to/certificate.crt''}} をそれぞれ署名鍵と証明書に置き換えてください。このフックの詳細な理解には、{{man|1|sbsign}} を参照してください。

作成された {{ic|/usr/lib/systemd/boot/efi/systemd-boot*.efi.signed}} は、{{ic|bootctl install}} または {{ic|bootctl update}} によって自動的に認識されます。詳細は {{man|1|bootctl|SIGNED .EFI FILES}} を参照してください。

別の方法としてこちらも参照、[[Unified Extensible Firmware Interface/セキュアブート#pacman フックを使って自動的に署名する|sbctl]]

== 設定 ==

=== ローダー設定 ===

ローダーの設定は {{ic|''esp''/loader/loader.conf}} ファイルに保存されます。詳細は、{{man|5|loader.conf|OPTIONS}} を参照してください。

ローダーの設定例を以下に示します:

{{hc|''esp''/loader/loader.conf|
default arch.conf
timeout 4
console-mode max
editor no
}}

{{Tip|
* systemd-boot はインデント用のタブを受け入れません。代わりにスペースを使用してください。
* {{ic|default}} と {{ic|timeout}} はブートメニューで変更することができ、変更した場合は EFI 変数として保存されます。上記のオプションよりも優先して設定されます。
* {{ic|bootctl set-default ""}} を使用すると、 {{ic|default}} オプションに優先して EFI 変数をクリアできます。
* 基本的なローダーの設定ファイルは {{ic|/usr/share/systemd/bootctl/loader.conf}} に存在します。
* {{ic|timeout 0}} を設定している場合、{{ic|Space}} を押すことでブートメニューにアクセスできます。
* ブートローダー(エントリ選択中)が歪んで表示される場合や、誤った解像度が使用されている場合は、{{ic|console-mode}} を {{ic|auto}}(最適な解像度を選択するためのヒューリスティックスを使用)、{{ic|keep}}(ファームウェアが提供する解像度を維持)、または {{ic|2}}(最初の非 UEFI 標準解像度を選択しようと試みる)に設定してみることができます。}}

=== ローダーの追加 ===

''bootctl'' は {{ic|''esp''/loader/entries/*.conf}} からブートメニューのアイテムを検索します – 各ファイルにそれぞれひとつだけローダーを記述してください。利用可能なオプション:

* {{ic|title}} – オペレーティングシステムの名前。'''必須。'''
* {{ic|version}} – カーネルバージョン、同じ title のエントリが複数存在する場合にのみ表示されます。任意。
* {{ic|machine-id}} – {{ic|/etc/machine-id}} のマシン識別子、title と version が同じエントリが複数存在する場合にのみ表示されます。任意。
* {{ic|efi}} – 起動する EFI プログラム、ESP ({{ic|/boot}}) からの相対パス。例: {{ic|/vmlinuz-linux}}。このオプションか {{ic|linux}} (下を参照) のどちらか一方が'''必須'''です。
* {{ic|options}} – EFI プログラムに渡すコマンドラインオプションまたは[[カーネルパラメータ]]。任意ですが、Linux を起動する場合 {{ic|1=initrd=''efipath''}} と {{ic|1=root=''dev''}} が最低限必要になります。

Linux を起動する場合、{{ic|efi}} と {{ic|options}} を使う代わりに以下のオプションが使用できます:
* {{ic|linux}} と {{ic|initrd}} で ESP の適切なファイルの相対パスを指定します。例: {{ic|/vmlinuz-linux}}。この値は自動で {{ic|efi ''path''}} と {{ic|1=options initrd=''path''}} に翻訳されます – この文法は利便性のためにサポートされており機能に違いはありません。

''arch_os'' というラベルが付いたパーティションから Arch を起動して Intel CPU の[[マイクロコード]]をロードするローダーファイルの例:
{{hc|''esp''/loader/entries/arch.conf|2=
title Arch Linux
linux /vmlinuz-linux
initrd /initramfs-linux.img
options root=UUID=''xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'' rw
}}

{{hc|''esp''/loader/entries/arch-fallback.conf|2=
title Arch Linux (fallback initramfs)
linux /vmlinuz-linux
initrd /initramfs-linux-fallback.img
options root=UUID=''xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'' rw
}}

''bootctl'' は自動的に "Windows Boot Manager" ({{ic|/EFI/Microsoft/Boot/Bootmgfw.efi}}), "EFI Shell" ({{ic|/shellx64.efi}}), "EFI Default Loader" ({{ic|/EFI/BOOT/bootx64.efi}}) をチェックします。また、{{ic|/EFI/Linux}} にカーネルファイルが存在しないかもチェックされます。これらが検出された場合、自動的に適切なエントリが生成されます ({{ic|auto-windows}}, {{ic|auto-efi-shell}}, {{ic|auto-efi-default}})。これらのエントリを手動でローダー設定する必要はありません。ただし、([[rEFInd]] など) 他の EFI アプリケーションは自動検出されないため、Linux カーネルを起動するには、手動で設定してエントリを作成する必要があります。

{{Note|
* Windows とデュアルブートする場合、Windows のデフォルトオプションである[[Windows と Arch のデュアルブート#高速スタートアップ|高速スタートアップ]]を無効にすることを強く推奨します。
* 必要な場合は {{ic|initrd}} で Intel のマイクロコードをロードしてください。例は[[マイクロコード#systemd-boot]] を参照。
* {{ic|1=blkid -s PARTUUID -o value /dev/sd''xY''}} コマンドを使うことで root パーティションの PARTUUID を確認できます。{{ic|''x''}} はデバイス文字、{{ic|''Y''}} はパーティション番号に置き換えて下さい。確認するのは root パーティションだけで大丈夫です。{{ic|''esp''}} は確認する必要がありません。
}}

{{Tip|
* 設定済みのブートエントリは {{ic|bootctl list}} コマンドで確認できます。
* サンプルエントリファイルが {{ic|/usr/share/systemd/bootctl/arch.conf}} に存在します。
* [[LVM]], [[LUKS]], [[dm-crypt]] などで必要な[[カーネルパラメータ]]についてはそれぞれのページを確認してください。
}}

==== EFI シェルや他の EFI アプリ ====

[[Unified Extensible Firmware Interface#UEFI シェル|UEFI シェル]] を {{Pkg|edk2-shell}} パッケージとともにインストールした場合、"systemd-boot" は EFI ファイルが {{ic|''esp''/shellx64.efi}} に配置されると自動的に検出して新しいエントリを作成します。
これを実行するには、パッケージをインストールした後に以下のようなコマンドを使用します:

# cp /usr/share/edk2-shell/x64/Shell.efi /boot/shellx64.efi

それ以外の場合は、[[rEFInd#ツール|その他の EFI アプリケーション]] を ESP にインストールした場合、次のスニペットを使用できます。

{{Note|{{ic|efi}} 行のファイルパスパラメータは、[[EFI システムパーティション]] のルートに対して相対的です。もし EFI システムパーティションが {{ic|/boot}} にマウントされていて、EFI バイナリが {{ic|/boot/EFI/xx.efi}} と {{ic|/boot/yy.efi}} に存在する場合、それぞれのパラメータは {{ic|efi /EFI/xx.efi}} と {{ic|efi /yy.efi}} のように指定します。}}

{{hc|''esp''/loader/entries/fwupd.conf|
title Firmware updater
efi /EFI/tools/fwupdx64.efi
}}

{{hc|''esp''/loader/entries/gdisk.conf|
title GPT fdisk (gdisk)
efi /EFI/tools/gdisk_x64.efi
}}

===== Memtest86+ =====

これを機能させるには、{{pkg|memtest86+-efi}} をインストールする必要があります。また、セキュアブートを使用するときに EFI バイナリに署名する必要があります。

{{hc|''esp''/loader/entries/memtest.conf|
title Memtest86+
efi /memtest86+/memtest.efi
}}

===== Netboot =====

"systemd-boot" は [[Netboot]] をチェーンロードできます。{{ic|ipxe-arch.efi}} EFI バイナリとその署名をダウンロードし、それを検証した後、提案された場所に {{ic|''esp''/EFI/arch_netboot/arch_netboot.efi}} として配置します。

{{hc|''esp''/loader/entries/arch_netboot.conf|
title Arch Linux Netboot
efi /EFI/arch_netboot/arch_netboot.efi
}}

===== GRUB =====

''systemd-boot'' は [[GRUB]] をチェーンロードできます。{{ic|grubx64.efi}} バイナリの場所は、GRUB が ESP にインストールされた際に使用された {{ic|1=--bootloader-id=}} と一致します。

{{hc|''esp''/loader/entries/grub.conf|
title GRUB
efi /EFI/GRUB/grubx64.efi
}}

==== 別のディスクから起動 ====

"systemd-boot" は起動元の ESP や同一ディスク上のXBOOTLDRパーティション以外のパーティションからEFIバイナリを起動 [https://github.com/systemd/systemd/issues/3252 できませんが、] [[UEFI シェル]] を使ってそれを行うことができます。

まず、上記の [[#EFI シェルや他の EFI アプリ]] のセクションに従って、{{Pkg|edk2-shell}} パッケージをインストールします。UEFI シェルで "map" コマンドを使用して、対応する PARTUUID を持つパーティションの '''FS エイリアス''' (例:HD0a66666a2、HD0b、FS1、BLK7) を確認します。

次に、{{ic|exit}} コマンドを使用して Linux に戻り、UEFI シェルを通じてターゲット EFI プログラムを実行するための新しいローダーエントリを作成します:

{{hc|''esp''/loader/entries/windows.conf|
title Windows
efi /shellx64.efi
options -nointerrupt -nomap -noversion HD0b:EFI\Microsoft\Boot\Bootmgfw.efi
}}

{{ic|efi}} パスは、 {{ic|shellx64.efi}} がコピーされた "esp" パーティション内の場所と一致していることを確認してください。また、{{ic|shellx64.efi}} EFI ファイルは、"systemd-boot" による自動エントリ作成を避けるために他の場所に移動することもできます。

{{ic|HD0b}} は、前述の "FS エイリアス" に置き換えてください。

* {{ic|-nointerrupt}} オプションは、{{ic|Ctrl+c}} でターゲット EFI プログラムを中断しないようにします。
* {{ic|-nomap -noversion}} オプションは、デフォルトの UEFI シェルの挨拶を非表示にします。
* ターゲットEFIプログラムが終了した場合(例えばエラーで)にUEFIシェルが自動的にブートローダーに戻るようにするには、{{ic|-exit}} オプションを追加します。
* もし UEFI シェル内にまだ不要な出力がある場合、{{ic|-noconsoleout}} オプションを追加できます。

=== UEFI ファームウェアセットアップの起動 ===

systemd-boot は、デバイスのファームウェアが OS からセットアップに再起動することをサポートしている場合、UEFI ファームウェアセットアップに起動するエントリを自動的に追加します。

=== ハイバネーション ===

[[サスペンドとハイバネート]]の記事を参照してください。

=== パスワードで保護されたカーネルパラメータエディタ ===

{{ic|password}} 設定オプションをサポートしている {{AUR|systemd-boot-password}} をインストールすることもできます。{{ic|sbpctl generate}} を使ってオプションで指定する値を生成できます。

''systemd-boot-password'' は以下のコマンドでインストールしてください:

{{bc|1=# sbpctl install ''esp''}}

カーネルパラメータを編集する前にパスワードの入力が求められるようになります。

== ヒントとテクニック ==

=== ブートメニューで使用できるキー ===

ブートメニューで使用できるキー割り当てについては、{{man|7|systemd-boot|KEY BINDINGS}} を参照してください。

=== 再起動後の起動対象を選択する ===

ブートマネージャーは systemctl コマンドに統合されており、再起動後に起動させるオプションを選択できます。例えば、カスタムカーネルのエントリファイルが {{ic|''esp''/loader/entries/arch-custom.conf}} にあるとき、次のようにするとデフォルト設定はそのままにカスタムカーネルが起動します:

$ systemctl reboot --boot-loader-entry=arch-custom


マザーボードのファームウェアを起動させるときは次のようにします:

$ systemctl reboot --firmware-setup

=== ユニファイドカーネルイメージを使う ===

{{ic|''esp''/EFI/Linux/}} にある [[ユニファイドカーネルイメージ|Unified kernel image]] (UKI)は、systemd-boot によって自動的に読み込まれ、{{ic|''esp''/loader/entries}} にエントリを追加する必要はありません。(Unified kernel image は、systemd-boot によって識別されるためには、{{ic|.efi}} 拡張子を持っている必要があります。)

{{Tip|{{ic|''esp''/loader/entries/}} 内のファイルは、{{ic|''esp''/loader/loader.conf}} に {{ic|default}} が設定されていない場合、最初に起動されます。それらのエントリを削除するか、フルファイル名でデフォルトを設定してください。例:{{ic|1=default arch-linux.efi}}}}

=== ESP 上の Grml ===

{{Note|以下の手順は、Grml 専用ではありません。若干の調整で他のソフト (例: [http://www.system-rescue-cd.org/ SystemRescueCD]) のインストールも可能です。}}
{{Tip|{{ic|PKGBUILD}} が利用可能です: {{AUR|archiso-systemd-boot}}}}

[https://grml.org/ Grml] は、システム管理とレスキュー用のソフトウェアを集めた小さなライブシステムです。

Grml を ESP にインストールするには、カーネル {{ic|vmlinuz}}、 initramfs {{ic|initrd.img}}、圧縮イメージ {{ic|grml64-small.squashfs}} を iso ファイルから ESP にコピーするだけです。そのためには、まず [https://grml.org/ grml64-small.iso] ファイルをダウンロードして(マウントポイントは以降 ''mnt'' と表記される) ファイルをマウントします。カーネルと initramfs は {{ic|''mnt''/boot/grml6 small/}} にあり、圧縮されたイメージは {{ic|''mnt''/live/grml64-small/}} にあります。

次に、Grml 用のディレクトリを ESP に作成します:

# mkdir -p ''esp''/grml

上記のファイルをコピーします:

# cp ''mnt''/boot/grml64small/vmlinuz ''esp''/grml
# cp ''mnt''/boot/grml64small/initrd.img ''esp''/grml
# cp ''mnt''/live/grml64-small/grml64-small.squashfs ''esp''/grml

最後のステップで、システムブートローダー用のエントリを作成します。 {{ic|''esp''/loader/entries}} 次の内容の {{ic|grml.conf}} ファイルを作成します:

{{hc|''esp''/loader/entries/grml.conf|2=
title Grml Live Linux
linux /grml/vmlinuz
initrd /grml/initrd.img
options apm=power-off boot=live live-media-path=/grml/ nomce net.ifnames=0}}

使用可能なブートオプションの概要については、 [http://git.grml.org/?p=grml-live.git;a=blob_plain;f=templates/GRML/grml-cheatcodes.txt;hb=HEAD cheatcode for Grml]

=== ESP 上の Archiso ===

{{Tip|{{ic|PKGBUILD}} が利用可能です: {{AUR|archiso-systemd-boot}}}}

Grml と同様に、Arch Linux の ISO を使用することができます。そのためには、ISO ファイルからカーネル {{ic|vmlinuz-linux}}、initramfs {{ic|initramfs-linux.img}}、および squashfs イメージ {{ic|airootfs.sfs}} を EFI システムパーティションにコピーする必要があります。

最初に [https://archlinux.org/download/ archlinux-yyy.mm.dd-x86_64.iso] をダウンロードします。

次に、ESP に Archiso のディレクトリを作成します:

# mkdir -p ''esp''/EFI/archiso

そこに {{ic|arch}} ディレクトリの内容を抽出します:

# bsdtar -v -x --no-same-permissions --strip-components 1 -f archlinux-''YYYY''.''MM''.''DD''-x86_64.iso -C ''esp''/EFI/archiso arch

最後のステップでは、systemd-boot Loader のブートエントリを作成します:{{ic|''esp''/roader/entries}}:

{{hc|''esp''/loader/entries/arch-rescue.conf|2=
title Arch Linux (rescue system)
linux /EFI/archiso/boot/x86_64/vmlinuz-linux
initrd /EFI/archiso/boot/x86_64/initramfs-linux.img
options archisobasedir=/EFI/archiso archisosearchfilename=/EFI/archiso/boot/x86_64/vmlinuz-linux
}}

利用可能なブートオプションの概要については、[https://gitlab.archlinux.org/archlinux/mkinitcpio/mkinitcpio-archiso/-/blob/master/docs/README.bootparams README.bootparams for mkinitcpio-archiso] を参照してください。

=== BIOS システムでの systemd-boot ===

[https://systemd.io/BOOT_LOADER_SPECIFICATION/ ブートローダーの仕様] に従う BIOS システム用のブートローダーが必要な場合は、 BIOS システムで systemd-boot を押してサービスを開始できます。 [[Clover]] ブートローダーは BIOS システムからの起動をサポートし、シミュレートされた EFI 環境を提供します。

== トラブルシューティング ==

=== systemd-boot がブートエントリを表示しない ===

これは、カーネルへのパスが間違って指定されているなど、設定ファイルに関するさまざまな問題が原因である可能性があります。確認するには、次のコマンドを実行してください:

# bootctl

=== BIOS モードで起動後にインストール ===

{{Note|こちらの起動方法は推奨されません。}}

BIOS モードで OS を起動したいときも ''systemd-boot'' をインストールすることは可能です。ただし、起動時に ''systemd-boot'' の EFI ファイルを実行するようにファームウェアを設定する必要があります:

* 他の場所に機能する UEFI Shell がある場合。
* ファームウェアのインターフェイスから起動時にロードされる EFI ファイルを設定する。
* 一部のファームウェアは、UEFI に他のエントリが設定されていない場合、デフォルトで {{ic|''esp''/EFI/BOOT/BOOTX64.EFI}} を使用することがあります。

設定できる場合、インストールは簡単です: EFI シェルやファームウェアの設定インターフェイスを開いて、マシンのデフォルトの EFI ファイルを {{ic|''esp''/EFI/systemd/systemd-bootx64.efi}} (32ビット環境の場合 {{ic|systemd-bootia32.efi}}) に変更してください。

{{Note|Dell Latitude シリーズのファームウェアインターフェースは、UEFI ブートの設定に必要なすべてを提供しますが、UEFI シェルはコンピュータの ROM に書き込むことができません。}}

=== efibootmgr を使って手動エントリを追加する ===

{{ic|bootctl install}} コマンドが失敗した場合、{{Pkg|efibootmgr}} ユーティリティを使って EFI ブートエントリを手動で作成することができます:

# efibootmgr --create --disk /dev/sd''X'' --part ''Y'' --loader '\EFI\systemd\systemd-bootx64.efi' --label "Linux Boot Manager" --unicode

{{ic|/dev/sdXY}} は [[EFI システムパーティション]]に置き換えてください。

{{Note|EFI イメージのパスでは区切り文字としてバックスラッシュ ({{ic|\}}) を使用します。}}

=== Windows の bcdedit を使用した手動入力 ===

何らかの理由で Windows から EFI ブートエントリを作成する必要がある場合は、管理者プロンプトから次のコマンドを使用してください。

> bcdedit /copy {bootmgr} /d "Linux Boot Manager"
> bcdedit /set {''guid''} path \EFI\systemd\systemd-bootx64.efi

{{ic|''guid''}} を最初のコマンドによってリターンされた ID に置き換えます。これをデフォルトのエントリとして設定するには:

> bcdedit /default {''guid''}

=== Windows をアップグレードした後にメニューが表示されない ===

[[Unified Extensible Firmware Interface#Windows によってブート順序が変わってしまう]]を見てください。

=== Windows BitLocker TPM ロック解除のサポートを追加 ===

BitLocker による回復キーの要求を停止するには、次の行を ''loader.conf'' に追加します。

{{hc|''esp''/loader/loader.conf|
reboot-for-bitlocker yes
}}

これにより、''BootNext'' UEFI 変数が設定され、BitLocker が回復キーを必要とせずに ''Windows ブートマネージャー'' がロードされます。これは 1 回限りの変更であり、''systemd-boot'' がデフォルトのブートローダーのままです。Windows が自動検出された場合は、エントリとして指定する必要はありません。

これは実験的な機能なので、必ず {{man|5|loader.conf}} を参照してください。

== 参照 ==

* https://systemd.io/BOOT/
* https://bbs.archlinux.org/viewtopic.php?id=254374
* https://uapi-group.org/specifications/specs/boot_loader_specification/

Sway

2025-10-18T17:31:10Z

Mycelithyl: /* カスタムキーバインド */ パッケージwevをAURから公式リポジトリへ

[[Category:Wayland コンポジタ]]
[[es:Sway]]
[[en:Sway]]
[[it:Sway]]
[[pt:Sway]]
[[zh-hans:Sway]]
{{Related articles start}}
{{Related|ウィンドウマネージャ}}
{{Related articles end}}
sway ('''S'''irCmpwn's '''Way'''land compositor [https://github.com/swaywm/sway/blob/f0ddf6d74c98ba6c502783b8f41be859c56712c9/README.md] から派生) は [[i3]] と互換性を持つように設計された [[Wayland]] コンポジタです。[http://swaywm.org 公式ウェブサイト] より:
:Sway はタイリング Wayland コンポジタであり、X11 の i3 ウィンドウマネージャの代替品です。既存の i3 設定で動作し、i3 の機能に加えて、いくつかの追加機能をサポートしています。

見た目に興味がある場合は、Sway のフォークとして {{AUR|swayfx}} が存在します。

== インストール ==

sway は {{Pkg|sway}} パッケージで[[インストール]]できます。最新の開発版は {{AUR|sway-git}} でインストールできます。''sway'' は ''wlroots'' に緻密に依存しているので、''sway'' 更新時には ''wlroots'' も更新するのが望ましいです。

{{Note|[[NVIDIA]] を含む、すべてのプロプライエタリなグラフィックスドライバは [https://github.com/swaywm/sway/wiki#nvidia-users サポートされていません]。NVIDIA ドライババージョン 495 以降より、[[NVIDIA#DRM カーネルモード設定|カーネルモード設定]] を有効化して sway を {{ic|1=--unsupported-gpu}} 付きで実行すれば、sway は機能します。}}

また、画面をロックする {{Pkg|swaylock}} や、アイドル時間管理デーモンの {{Pkg|swayidle}} もインストールできます。

デフォルトのアプリケーションランチャーは {{Pkg|wmenu}} です。(ただし、デフォルトの設定はまだ {{Pkg|dmenu}} が提供する ''dmenu_path'' に依存しています)、デフォルトの[[ターミナルエミュレータ]] は {{Pkg|foot}} です。インストールするか、あるいは設定ファイルで別のアプリケーションに変更するかを、初回起動の前に行なうことが望ましいです。i3 パッケージの Wayland 対応版については、sway wiki の [https://github.com/swaywm/sway/wiki/i3-Migration-Guide migration guide] を参照してください。

== sway の起動 ==

Sway を起動する前に、キーボード、マウス、グラフィックカードなどのハードウェアデバイスにアクセスする必要があります。 {{man|3|sd-login}} で説明されているように、これらのハードウェアデバイスのコレクションはシートと呼ばれます。

Arch Linux では、Sway は次のどちらかを使ってシートにアクセスすることができます。

* {{man|8|systemd-logind}} と {{Pkg|polkit}} または
* {{Pkg|seatd}} これは、{{Pkg|wlroots}} の依存関係として Sway と一緒にインストールされます。

{{ic|polkit}} がすでにシステムにインストールされている場合、Sway は自動的にあなたのシートにアクセスできるはずです。

また、{{ic|polkit}} がシステムにインストールされておらず、代わりに seatd を使用したい場合は、seat ユーザーグループに自分を追加し、{{ic|seatd.service}} を [[起動/有効化]]し、再ログインして、以下の方法のいずれかを選択して Sway を起動することができます。

=== 手動 ===

Linux コンソールで {{ic|sway}} と入力すれば sway が起動します。

=== TTY ログイン時に自動起動 ===

X と同様に、Sway はシェル初期化ファイルに以下を追加することで開始できます。([[コマンドシェル#ログインシェル]]を参照):

{{bc|1=<nowiki>
if [ -z "${WAYLAND_DISPLAY}" ] && [ "${XDG_VTNR}" -eq 1 ]; then
exec sway
fi
</nowiki>}}

詳細については、[[xinitrc#ログイン時に X を自動起動]] を参照してください。

=== ディスプレイマネージャを使う ===
{{Note|Sway は公式にはディスプレイマネージャをサポートしていません。}}
sway のセッションは {{ic|/usr/share/wayland-sessions/sway.desktop}} にあります。[[GDM]] や [[SDDM]] などのディスプレイマネージャは自動的にセッションを認識します。

ディスプレイマネージャを通して、[https://github.com/swaywm/sway/wiki/Systemd-integration#running-sway-itself-as-a---user-service systemd ユーザーサービス] として sway を開始することも可能です。

あるいは、テキストベースのセッションマネージャを使うこともできます。[[ディスプレイマネージャ#コンソール]]を参照してください。

== 設定 ==
i3 を既に使っている場合、i3 の設定を {{ic|~/.config/sway/config}} にコピーすればそのまま動作します。i3 を使ったことがない場合は、サンプル設定ファイルを {{ic|~/.config/sway/config}} にコピーしてください。サンプル設定ファイルは {{ic|/etc/sway/config}} にあります。ただし {{ic|DFALLBACK_CONFIG_DIR}} フラグが設定されている場合は存在しません。設定方法は {{man|5|sway}} を見てください。

{{Note|ドロップインファイルの設定スニペットを適用するために、ユーザの設定には {{ic|include /etc/sway/config.d/*}} が含まれていることが期待されます。{{Pkg|sway}} パッケージは、いくつかの環境変数を systemd ユーザセッションと dbus にインポートする {{ic|50-systemd-user.conf}} ドロップインファイルを提供しています。このドロップインファイルは、{{Pkg|xdg-desktop-portal-wlr}} などのいくつかのアプリケーションで必要です。}}

=== キーマップ ===
デフォルトでは、sway は US QWERTY キーマップで起動します。キーマップを書き換えるには:
{{hc|~/.config/sway/config|
input * {
xkb_layout "us,de,ru"
xkb_variant "colemak,,typewriter"
xkb_options "grp:win_space_toggle"
}

input <identifier> xkb_model "pc101"
}}

詳細は {{man|5|sway-input}} および {{man|7|xkeyboard-config}} を参照してください。

なお、Sway は起動時に {{ic|XKB_DEFAULT_LAYOUT}} や {{ic|XKB_DEFAULT_VARIANT}} などの[[環境変数]]を読み込みますが、環境変数よりも設定ファイルの内容が優先されます。

=== キーのオートリピート設定 ===
Typematic Delay (オートリピート開始までの時間) と Typematic Rate (1秒間のリピート回数) は、{{ic|input}} セクションに以下の行を加えると変更できます。設定項目について詳しくは[[コンソールでのキーボード設定#typematic delay と rate の調整]]を参照してください。

{{hc|~/.config/sway/config|
input <identifier> repeat_delay 300
input <identifier> repeat_rate 30
}}

=== ステータスバー ===

sway には pure Wayland 環境で動作する ''swaybar'' がデフォルトのステータスバーとして同梱されています。''swaybar'' はシェルスクリプトや他のプログラムを呼び出して、ステータスバーに情報を表示することができます。詳細については、{{man|5|sway-bar}} や {{man|7|swaybar-protocol}} を参照してください。

{{Tip|{{Pkg|waybar}} は sway に含まれているバー (swaybar) の代替になります。}}

{{Pkg|i3status}} のインストールは、 Wayland で実用的なデフォルトのステータスバーを取得するためのオプションです。sway の設定の末尾に以下のスニペットを追加するだけで表示できます:
{{hc|~/.config/sway/config|<nowiki>
bar {
status_command i3status
}</nowiki>}}
i3status をカラー出力させたい場合、i3status の設定の以下の部分を調整してください:
{{hc|~/.config/i3status/config|<nowiki>
general {
colors = true
interval = 5
}
</nowiki>}}
どちらの例でも、システム全体にインストールされた設定ファイルはユーザーディレクトリにコピーされるので、それを修正してください。

=== 壁紙 ===
Sway 1.1 以降、壁紙機能は {{Pkg|swaybg}} に分割され、{{ic|output}} コマンドを動作させるのに必要です。

以下の行を sway の設定の最後に追加することで、全ての画面 ({{ic|"*"}} という名前にマッチする画面) で背景画像を設定できます:
{{hc|~/.config/sway/config|<nowiki>
output "*" background /path/to/image.jpg fill
</nowiki>}}
ファイルの名前やパスは適当に置き換えて下さい。

また、背景は単一色にもできます:
{{bc|output * bg #000000 solid_color}}

{{Pkg|swaybg}} コマンドの GTK3 フロントエンドとして {{AUR|azote}} を使うことができます。

=== 入力デバイス ===
特定の入力デバイスの設定を調整することができます。例えば、タッチパッドの tap-to-click とナチュナルスクロールを有効にするには、以下の input ブロックを追加:
{{hc|~/.config/sway/config|<nowiki>
input type:touchpad {
tap enabled
natural_scroll enabled
}
</nowiki>}}

特定のタッチパッドの設定をセットするには、{{ic|swaymsg -t get_inputs}} を使用して、デバイスの Identifier を取得し、{{ic|type:touchpad}} の代わりにそれを使用します。

{{Note|
上記のコマンドの出力には、"/" などの記号をエスケープするために "\" が付いていることがあります (例: {{ic|"2:14:ETPS\/2_Elantech_Touchpad"}})。設定に追加するときはエスケープを取り除いてください。}}

アクセラレーションなど他のオプションについては {{man|5|sway-input}} で詳細を確認できます。

グラフィックタブレットをお使いの方は、[[ペンタブレット#Sway]]をご覧ください。

==== タッチディスプレイのマッピング ====

マルチディスプレイ環境で使用されるタッチディスプレイのタッチ入力ターゲットは、そのタッチディスプレイにのみマッピングできます。

{{hc|~/.config/sway/config|
set $display1 "Dell Inc. DELL P2414H VHVTW542165L"
set $display2 "Dell Inc. DELL P2418HT MYDM775F152L"
set $display2-touch "8146:24835:Melfas_LGD_AIT_Touch_Controller"

input $display2-touch map_to_output $display2
}}

=== HiDPI ===

設定ファイルの {{ic|output}} コマンドでディスプレイのスケールファクタを設定してください。スケールファクタは小数でも指定できます。HiDPI ディスプレイの場合は 2 などに設定してください。

{{hc|~/.config/sway/config|
output <name> scale <factor>
}}

ディスプレイの名前は以下のコマンドで確認できます:
$ swaymsg -t get_outputs

=== タッチディスプレイのマッピング ===

マルチディスプレイ環境で使用するタッチディスプレイのタッチ入力のターゲットを、そのタッチディスプレイのみにマッピングすることができます。

{{hc|~/.config/sway/config|
set $display1 "Dell Inc. DELL P2414H VHVTW542165L"
set $display2 "Dell Inc. DELL P2418HT MYDM775F152L"
set $display2-touch "8146:24835:Melfas_LGD_AIT_Touch_Controller"

input $display2-touch map_to_output $display2
}}

=== カスタムキーバインド ===
キーボードの[[キーボード入力|特殊なキー]]を使ってコマンドを実行することができます。例えば、ボリュームや画面の明るさを制御するには:

{{hc|~/.config/sway/config|
bindsym XF86AudioRaiseVolume exec pactl set-sink-volume @DEFAULT_SINK@ +5%
bindsym XF86AudioLowerVolume exec pactl set-sink-volume @DEFAULT_SINK@ -5%
bindsym XF86AudioMute exec pactl set-sink-mute @DEFAULT_SINK@ toggle
bindsym XF86AudioMicMute exec pactl set-source-mute @DEFAULT_SOURCE@ toggle
bindsym XF86MonBrightnessDown exec brightnessctl set 5%-
bindsym XF86MonBrightnessUp exec brightnessctl set 5%+
bindsym XF86AudioPlay exec playerctl play-pause
bindsym XF86AudioNext exec playerctl next
bindsym XF86AudioPrev exec playerctl previous
bindsym XF86Search exec $menu
}}

詳細や代替ユーティリティについては、[[PulseAudio#キーボードのボリュームコントロール]]、[[Advanced Linux Sound Architecture#キーボードのボリュームコントロール]]、[[バックライト#バックライトユーティリティ]]、[[MPRIS]] を参照してください。

ロック画面がアクティブなときにキーバインドを実行できるようにするには、{{ic|--locked}} パラメーターを bindsym に追加します。

bindsym --locked XF86AudioPlay exec playerctl play-pause

{{Tip|{{Pkg|wev}} は、Wayland の {{Pkg|xorg-xev}} と同様の機能を提供するツールです。}}

{{Note|systemd は、電源キーやふたの開閉などの特別なキーや、閉じるイベントを処理します。これらは、sway で設定されたものと干渉する可能性があります。[[systemd]] での設定方法の詳細については、{{man|1|loginctl}} および {{man|5|logind.conf}}} を参照してください。}}

==== グラフィカルインジケーターバー ====

明るさや音量などのパーセント値設定の現在のレベルを、調整時にグラフィカルなバーで表示することが望ましい場合があります。Sway でこの機能を提供する良い選択肢は {{Pkg|wob}} (あるいは {{AUR|wob-git}}) です。これは、人気な X ツール {{AUR|xob}} の機能の一部を提供し、layer-shell プロトコルを実装している Wayland ネイティブなユーティリティです。使用例は[https://github.com/francma/wob プロジェクトのウェブサイト]を見てください。

==== ワークスペースの概要 ====

たくさんのワークスペースをたくさんのウィンドウで使っていて、何がどこにあるかわからなくなったら、{{AUR|sov}} が便利です。これはすべてのワークスペースのスキーマを表示するオーバーレイで、sway のナビゲーションを容易にします。プログラム名、ウィンドウのタイトルを表示し、マルチ出力のセットアップをサポートします。詳しくは [https://github.com/milgra/sov プロジェクトページ]をご覧ください。

=== アイドリング ===

Sway には、アイドルセッションを処理するための専用のアイドル管理デーモン {{pkg|swayidle}} があります。デーモンを起動してパラメータ化する方法はいくつかあります。最も簡単な方法は、sway 自体の設定を使用することです。{{ic|swayidle}} は、{{ic|timeout}} (別名 idling)、{{ic|resume}} (resume from sleep) 、{{ic|before-sleep}} などのイベントを構成するための多数の引数を受け取ります。イベントの詳細と詳細については、{{man|1|swayidle}} を参照してください。その後、各イベントにアクションを割り当てることができます。イベントに複数のアクションを割り当てるには、トリガーを繰り返すだけです。

次の例では、{{ic|swayidle}} 30分後に画面をロックし、5 秒後に画面をオフにします。

{{hc|~/.config/sway/config|
exec swayidle -w \
timeout 1800 'swaylock -f' \
timeout 1805 'swaymsg "output * power off"' \
resume 'swaymsg "output * power on"'
}}

ロックされたスクリーンをもっと早く、例えば10秒後にオフにするには、ロックマネージャのプロセスリストを grep し、以下のように {{ic|swaymsg "output * power off"}} を実行します。

timeout 10 'if pgrep -x swaylock; then swaymsg "output * dpms off"; fi'

再生中のメディアを一時停止または一時停止する前に画面をロックするには、swayidle コマンドの次の手順を修正します。

before-sleep 'playerctl pause'
before-sleep 'swaylock'

{{note|systemd も sway で設定されたイベントと競合する可能性のあるアイドルイベントを処理します。構成方法の詳細については、{{man|1|loginctl}} および {{man|5|logind.conf}} を参照してください。}}

=== フローティングウィンドウ ===

フローティングウィンドウまたはウィンドウの割り当てを有効にするには、アプリケーションを開き、{{ic|app_id}}、{{ic|class}}、{{ic|instance}}、および {{ic|title}} 属性を使用して、フローティングウィンドウの割り当てを有効にします。次のコマンドは、開いているすべてのウィンドウのプロパティを一覧表示します。

$ swaymsg -t get_tree

開いているすべてのウィンドウの {{ic|app_id}} のみを取得するには、次を使用します。

$ swaymsg -t get_tree | grep "app_id"

フォーカスのあるウィンドウの {{ic|app_id}} を取得するには、次を使用します。

$ swaymsg -t get_tree | jq -r '..|try select(.focused == true)'

一部のウィンドウで {{ic|app_id}} が null になる場合は、{{ic|class}} 属性または {{ic|instance}} 属性 (あるいはその両方) を使用して、フローティングモード/ウィンドウの割り当てを有効にする必要があります。出力を検索して、ウィンドウの細かいルールを作成できます。

{{hc|~/.config/sway/config|2=
for_window [app_id="galculator"] floating enable
assign [class="firefox"] -> 3
assign [class="^Urxvt$" instance="^htop$"] -> 9
}}

これは、{{Pkg|xorg-xprop}} を使用して [[X11]] の {{ic|class}} または {{ic|wm_name}} 属性を検索するのと似ています。

複数のモニターを使用する場合、フローティングスクラッチパッドウィンドウが大きくなりすぎて、複数のモニターをカバーする可能性があります。このコマンドはフローティングウィンドウを中央に配置し、現在のモニターのサイズの 80% のサイズに変更します。

$ swaymsg move position center; swaymsg resize set 80ppt 80ppt

=== クリップボード ===

デフォルトでは、ウィンドウを閉じるとクリップボードは空になります。これは意外なことにデフォルトの動作だったりします。

クリップボードの内容をウィンドウ間で共有するには、 "クリップボードマネージャ" をインストールする必要があります。

Wayland 用に設計されたクリップボードマネージャの一例は、{{AUR|clipman}} または {{AUR|clipman-git}} からインストールできる [https://github.com/chmouel/clipman clipman] です。

Sway で clipman を起動するには、設定ファイルに次の行を追加します。

{{hc|~/.config/sway/config|2=
exec wl-paste -t text --watch clipman store --no-persist
}}

=== Xresources ===
sway で使用するには {{ic|.Xresources}} を {{ic|.Xdefaults}} にコピーしてください。

=== XWayland ===

詳細と利用可能なパッケージの概要については、[[Wayland#Xwayland]] を参照してください。

XWayland の使用はデフォルトで有効になっています。

一方、XWayland を無効化し、Sway の純粋な Wayland セッションを使うには次のようにします:
{{hc|~/.config/sway/config|
xwayland disable
}}
{{Note|プログラムによっては Wayland でネイティブに動作させるために [[Wayland#GUI ライブラリ|特殊な環境変数や設定オプション]] を必要とするものもありますし、Wayland を全くサポートしていないプログラム(ほとんどの独自アプリケーションを含む)もあります。現在のところ、レガシーアプリケーションが使えるようにXWaylandをオンにしておくことが推奨されています。}}

=== 別の wlroots レンダラーを使用する ===

環境変数 {{ic|WLR_RENDERER}} を指定することにより、別の [https://gitlab.freedesktop.org/wlroots/wlroots/-/tree/master/render wlroots レンダラー]を使用することができます。利用可能なレンダラーの一覧は、[https://gitlab.freedesktop.org/wlroots/wlroots/-/blob/master/docs/env_vars.md wlroots のドキュメント]にあります。

=== 自動起動 ===

[[i3#自動起動]] を参照して、sway の設定ファイル名を調整してください。

== ヒントとテクニック ==

=== 最初に CapsLock/NumLock を有効にする ===

デフォルトでは、sway は起動時に最初に {{ic|CapsLock}} と {{ic|NumLock}} キーを無効にします。代わりに、起動時にこれらを有効にするには、キーボード入力設定の {{ic|xkb_capslock}} または {{ic|xkb_numlock}} あるいはその両方を {{ic|enable}}に設定します。例えば、すべてのキーボードで有効にするには、sway 設定に次の行を追加します。

{{hc|~/.config/sway/config|
input type:keyboard xkb_capslock enabled
input type:keyboard xkb_numlock enabled
}}

いずれの場合も、キーボードの該当するキーを押すことで {{ic|CapsLock}} と {{ic|NumLock}} を切り替えることができます。

{{Note|1=これらのオプションを有効にすると、sway 設定ファイル [https://bugzilla.mozilla.org/show_bug.cgi?id=1652820 Bugzilla 1652820] をリロードしたときに Firefox がクラッシュする可能性があります。}}

=== 現在のキーボードレイアウト ===

現在のキーボードレイアウトは、次のようにして取得できます。{{ic|''kbd_identifier''}} は、キーボードの識別子で置き換える必要があります。

$ swaymsg -t get_inputs {{!}} jq -r '.[] {{!}} select(.identifier == "''kbd_identifier''") {{!}} .xkb_active_layout_name'

=== コンポーズキー ===

{{ic|PrintScreen}} を[[Xorg でのキーボード設定#コンポーズキーの設定|コンポーズキー]]として設定するには、

$ swaymsg 'input * xkb_options compose:prsc'

コンポーズキーの組み合わせは、[[Xorg でのキーボード設定#キーの組み合わせ|XCompose ファイル]]で設定することもできます。この変更を有効にするには、アプリケーションを再起動する必要があります。

{{ic|/usr/include/X11/keysymdef.h}} でキーの名前を調べたり、{{man|1|xev}} のようなデバッガ {{man|1|xkbcli-interactive-wayland}} ({{ic|/usr/lib/xkbcommon/}}フォルダ中) を使ったりすることができます。

=== バックライト切り替え ===

ディスプレイの電源をオフ (またはオン) にするには (例:{{ic|Pause}})、次のスクリプトを Sway {{ic|config}} でバインドします。

{{bc|
#!/bin/sh
read lcd < /tmp/lcd
if [ "$lcd" -eq "0" ]; then
swaymsg "output * power on"
echo 1 > /tmp/lcd
else
swaymsg "output * power off"
echo 0 > /tmp/lcd
fi
}}

または、[https://github.com/swaywm/sway/pull/6099 toggle] オプションを直接使用することもできますが、複数のモニターがある場合は出力を明示的に指定する必要があります。

$ swaymsg "output ''output_name'' power toggle"

=== 画面キャプチャと画面共有 ===

こちらを参照 [[スクリーンショットの取得#Wayland]]

=== 色温度調整 ===

こちらを参照 [[バックライト#Wayland]].

=== キーボードを使用して swaynag を制御する ===

既定の警告/プロンプトプログラムである Swaynag は、sway に付属しており、ユーザーによるマウス操作のみをサポートしています。キーボードショートカットによる対話を有効にするには、{{AUR|swaynagmode}} などのヘルパープログラムを使用します。

Swaynag モードは、まず swaynag を起動し、次のボタンの選択、プロンプトの削除、選択したボタンの受け入れなどのアクションをトリガーするシグナルを待機します。これらのシグナルは、制御引数 ({{ic|swaynagmode--select right}} や {{ic|swaynagmode--confirm}}など) を指定して swaynagmode スクリプト自体の別のインスタンスを起動することで送信されます。

デフォルトでは、Swaynagmode は初期化時にスウェイモード {{ic|nag}} をトリガーし、終了時に {{ic|default}} をトリガーします。これにより、sway 構成でキーバインディングを簡単に定義できます。

{{hc|~/.config/sway/config|
set $nag exec swaynagmode
mode "nag" {
bindsym {
Ctrl+d mode "default"

Ctrl+c $nag --exit
q $nag --exit
Escape $nag --exit

Return $nag --confirm

Tab $nag --select prev
Shift+Tab $nag --select next

Left $nag --select next
Right $nag --select prev

Up $nag --select next
Down $nag --select prev
}
}
}}

sway バージョン1.2以降では、モード名で大文字と小文字が区別されることに注意してください。

swaynagmode を使用するように sway を設定するには、設定コマンド {{ic|swaynag_command swaynagmode}} を使用します。

=== カーソルテーマとカーソルの大きさ ===
[[カーソルテーマ]] やカーソルの大きさを変更するには:

{{hc|~/.config/sway/config|
seat seat0 xcursor_theme ''my_cursor_theme'' ''my_cursor_size''
}}

{{ic|''my_cursor_theme''}} は {{ic|Default}}, {{ic|Adwaita}}, {{ic|Simple-and-Soft}} などに置きかえ、{{ic|''my_cursor_size''}} は {{ic|48}} などに置きかえます。

{{ic|echo $XCURSOR_SIZE}} と {{ic|echo $XCURSOR_THEME}} でこれらの値を調べることができます。

変更を反映させるにはアプリケーションを再起動してください。

{{Note|Wayland ではクライアント側でカーソルテーマが決定されます。アプリケーションが{{ic|$XCURSOR_SIZE}}, {{ic|$XCURSOR_THEME}} 環境変数を参照しないこともありえます。}}

=== systemd で sway 固有のデーモンを管理する ===

一部のサービス/デーモン ({{Pkg|swayidle}} や {{Pkg|kanshi}}など) は、現在のウィンドウマネージャが Sway の場合にのみ開始し、Sway が停止したときにこれらのサービスを停止したい場合があります。これを行うには、{{ic|sway-session.target}} を作成し、{{ic|sway-session.target}} が必要とするデーモン/サービスを作成します。この systemd ターゲットは、ユーザーターゲットである必要があります ([[systemd/ユーザー]] を参照) 例:

{{hc|1=~/.config/systemd/user/sway-session.target|2=
[Unit]
Description=Sway compositor session
Documentation=man:systemd.special
BindsTo=graphical-session.target
Wants=graphical-session-pre.target
After=graphical-session-pre.target
}}

次に、Sway の設定ファイル(たとえば、{{ic|~/.config/sway/config}} に行を追加するか、{{ic|/etc/sway/config.d/}} に新しいファイルを追加して) 次の行を追加します。

{{hc|1=~/.config/sway/config|2=
...
...
...
exec_always "systemctl --user start sway-session.target"
}}

設定ファイルの上記の行追加で、Sway が起動するたびに {{ic|sway-session.target}} もアクティブになります。

最後に、目的のサービスを {{ic|sway-session.target}} にリンクします。たとえば、{{Pkg|kanshi}} (または {{AUR|kanshi-git}}) サービスを追加するには、次のように入力します。

{{hc|1=~/.config/systemd/user/kanshi.service|2=
[Unit]
Description=Dynamic output configuration for Wayland compositors
Documentation=https://sr.ht/~emersion/kanshi
BindsTo=sway-session.target

[Service]
Type=simple
ExecStart=/usr/bin/kanshi

[Install]
WantedBy=sway-session.target
}}

この[[ユーザーユニット]]を[[有効化]]は、Sway が動作している時のみ有効で、Sway が停止すると無効になります。

{{ic|sway-session.target}} ファイルの作成と環境のインポートは、{{AUR|sway-systemd-git}} をインストールすることでも行うことができます。sway-systemd はサービスを cgroup に分けるだけでなく、各 GUI アプリケーションを独自の cgroup に配置します。これにより、個々のアプリケーションに対して cgroup 単位のリソース制約を課すことができます。[https://github.com/alebastr/sway-systemd sway-systemd README] を参照してください。

=== 起動後の画面解像度の変更 ===

グラフィカルプログラム {{AUR|wdisplays}} またはターミナルプログラム {{AUR|wlr-randr}}
を使って、回転、解像度を変更し、ディスプレイを配置します。

=== ヘッドレス出力の作成 ===

物理的なビデオインターフェイスに関連しない出力を作成する、 HEADLESS-1、HEADLESS-2 など。

$ swaymsg create_output

新しい出力の説明を表示します。

$ swaymsg -pt get_outputs | grep -A 10 HEADLESS

新しい出力を、たとえば {{ic|output}} コマンドで設定します。

{{hc|1=~/.config/sway/config|2=
output HEADLESS-1 {
pos 1920,0
mode 1280x720@75Hz
}
}}

== 既知の問題 ==

=== アプリケーションランチャー ===

{{Tip|Sway の wiki には [https://github.com/swaywm/sway/wiki#program-launchers 既知のアプリケーションランチャーのリスト] もあります。}}

i3-dmenu-desktop {{Pkg|dmenu}}、および {{Pkg|rofi}} はすべて Sway では比較的うまく機能しますが、すべて XWayland で実行されており、カーソルをネイティブの Wayland ウィンドウに移動すると応答しなくなるという同じ問題があります。この問題の理由は、Wayland のクライアント/ウィンドウが画面のフォーカスを持っていない限り、入力デバイスにアクセスできないためです。XWayland サーバ自体が Wayland コンポジタのクライアントであるためで、XWayland クライアントの1つは、ユーザ入力にアクセスするためのフォーカスを持っている必要があります。しかし、クライアントの1つがフォーカスを取得すると、入力を収集し、X11 プロトコルを介してすべての XWayland クライアントが利用できるようにします。そのため、XWayland のウィンドウにカーソルを移動して Esc キーを押すと問題が解決し、{{ic|pkill}} を実行しても問題が解決する場合があります。

{{Pkg|bemenu}} は Wayland の dmenu をネイティブに置き換えたものです。どちらもオプションで {{Pkg|j4-dmenu-desktop}} と組み合わせることで、デスクトップファイルを起動するための Wayland ネイティブな組み合わせを提供できます (i3-dmenu-desktop がそうであるように)。例えば

j4-dmenu-desktop --dmenu='bemenu -i --nb "#3f3f3f" --nf "#dcdccc" --fn "pango:DejaVu Sans Mono 12"' --term='termite'

XWayland を無効にしない場合は、{{ic|BEMENU_BACKEND}} 環境変数を "wayland" に設定する必要があります。

フローティングターミナルと fzf を使用して独自のビルドを行うこともできます ([https://github.com/swaywm/sway/issues/1367 GitHub の問題] を参照)

また、{{Pkg|plasma-workspace}} パッケージが提供する {{ic|krunner}} バイナリもランチャーとして機能し、XWayland とネイティブ Wayland の両方をサポートします。

{{AUR|rofi-lbonn-wayland-git}} は {{Pkg|rofi}} の派生形で、Wayland で動作します。また、X11 セッションで起動する必要がある場合は {{ic|-x11}} フラグがあります。

{{Pkg|wofi}} はコマンド・ランチャーで、rofi と同じ機能の一部を提供します、wofi には、SSH モードやウィンドウ切り替えモードなど、rofi の機能の一部が欠けています。これは {{Pkg|wlroutes}} ライブラリに基づいており、レンダリングには GTK3 を使用していて、sway にはとてもよく効きます。

=== 仮想環境で使う ===

Sway は [[VirtualBox]] や [[VMware]] ESXi の両方で動作します。

[[QEMU]] で Sway を機能させるには、{{ic|-vga qxl}} で QEMU を開始する必要があります。 [[QEMU#qxl]]も参照してください。

==== Sway を tty から起動できない ====

3D アクセラレーションを有効にする必要があります。[[VMware#Intel と Optimus で 3D グラフィックを有効化]] を参照してください。

==== マウスカーソルが表示されない ====

特定のグラフィックスドライバー(VMSVGA グラフィックコントローラーやのプロプライエタリ NVIDIA ドライバーなど)を使うとカーソルが表示されません。これは、[https://github.com/swaywm/sway/issues/3814] で説明されているようにソフトウェアカーソルを使用して修正できます。

$ export WLR_NO_HARDWARE_CURSORS=1

=== Sway Socket Not Detected ===

{{ic|swaymsg -t get_outputs}} などの {{ic|swaymsg}} 引数を使用すると、次のメッセージが返されることがあります。

sway socket not detected.
ERROR: Unable to connect to

ターミナルマルチプレクサ ([[GNU Screen]] や [[tmux]] など) 内で実行される場合。これは、{{ic|swaymsg}} が {{ic|SWAYSOCK}} で提供されたソケットに接続できなかったことを意味します。

{{ic|SWAYSOCK}} の現在の値を確認するには:

{{hc|$ env {{!}} grep -F "SWAYSOCK"|2=
SWAYSOCK=/run/user/1000/sway-ipc.1000.4981.sock
}}

この問題を回避するには、実行中の sway プロセスに基づいてソケットにアタッチしてみてください。

$ export SWAYSOCK=/run/user/$(id -u)/sway-ipc.$(id -u).$(pgrep -x sway).sock

上記のエラーを解決するには、マルチプレクサの外でコマンドを実行する必要があります。

=== Wayland サーバーへの接続に失敗する ===

Tmux はセッションごとにローカルな環境変数を作成します (確認するには {{ic|tmux show-environment}} と入力) そのため、[https://github.com/tmux-plugins/tmux-resurrect tmux-resurrect] や [https://github.com/tmux-plugins/tmux-continuum tmux-continuum] で以前の tmux セッションに再アタッチしたり、sway の起動前に tmux サーバを起動すると、環境変数は、古くなっています。

{{ic|update-environment}} を使って、セッションにアタッチするたびにそれらを更新するように tmux に指示するには、以下を {{ic|.tmux.conf}} に追加してください。

set-option -g update-environment "DISPLAY WAYLAND_DISPLAY SWAYSOCK SSH_AUTH_SOCK"

=== Unable to retrieve socket path ===

tty から {{ic|swaymsg -t}} を実行すると、
Unable to retrieve socket path
というメッセージが表示されます。これは {{ic|SWAYLOCK}} 環境変数が Sway 起動後に設定されるためで、{{ic|swaymsg}} は Sway 内のターミナルで実行してください。

=== キー割り当てとキーボードレイアウト ===

デフォルトでは、複数のキーボードレイアウト {{ic|<nowiki>input * xkb_layout "us,ru"</nowiki>}} を使用している場合、セカンダリレイアウトを切り替えたときにバインディングが壊れることがあります。

https://github.com/swaywm/sway/pull/3058, のおかげで、以下のように {{ic|--to-code}} 行に {{ic|--to-code}}キーを追加するだけで済みます。

{{bc|<nowiki>
bindsym --to-code {
$mod+$left focus left
$mod+$down focus down
$mod+$up focus up
$mod+$right focus right
}</nowiki>
}}

または、変数 {{ic|set$mybind bindsym--to-code}} を作成し、{{ic|bindsym}} のすべてのインスタンスを {{ic|$mybind}} で置き換えることもできます。{{ic|$mybind$mod+w thing}}

=== Java アプリケーション ===

一部の Java ベースのアプリケーション (IntelliJ、CLion、PyCharm などの JetBrains エディタ) を開くと、空白の画面が表示されます。これを軽減するには、{{ic|_JAVA_AWT_WM_NONREPARENTING}} 環境変数を1に設定してアプリケーションを起動します。

{{Pkg|rofi}} や {{Pkg|dmenu}} などのランチャーからアプリケーションを起動する場合は、 [[デスクトップエントリ#環境変数の修正]] に示すように、アプリケーションのデスクトップエントリを変更してください。

Java アプリケーションに関するいくつかの問題は、OpenJDK11 および Sway 1.5 で修正されました。ただし、一部のアプリケーションでは、新しいバージョンの OpenJDK を使用するために追加の構成が必要です。Android Studio の場合は、{{ic|1=STUDIO_JDK=/usr/lib/jvm/java-11-openjdk/}} を設定する必要があります。 [https://github.com/swaywm/sway/issues/5414]

=== ボーダーでスクロール ===

アプリケーションのボーダー上でマウスのスクロールホイールを使用するとクラッシュする場合は、{{ic|app_id}} (例:Firefox) に {{ic|border none}} を設定してください。

=== Program cannot open display ===

起動時に ''Program cannot open display'' というエラーメッセージが表示されてプログラムがクラッシュする場合は、使用しているプログラムが X11 プログラムである可能性があります。XWayland 互換性レイヤを使って Wayland で X11 プログラムを実行することができます。詳細は [[Sway#Xwayland]] を参照してください。

=== Unable to open wayland socket ===

sway が起動せず、"Unable to open wayland socket" というエラーメッセージが出力される場合は、`$XDG_RUNTIME_DIR` 環境変数が設定されているが、指定したディレクトリがないことを意味する場合があります。

=== WINE アプリケーションでマウスが動作しない ===

プログラムを実行するとき、WINE はプライマリーモニターが設定されていることを期待しますが、Wayland にはプライマリーモニターの概念がないため、(クリックが認識されないなど) 問題を引き起こす可能性があります。代わりに、Sway の設定にこの行を追加することで、[[xrandr]] を介して XWayland が使用するプライマリモニタを指定することができます。

{{hc|~/.config/sway/config|2=
...
exec_always xrandr --output XWAYLAND0 --primary
...
}}

For this to work your display position offset needs to be 0,0 because of a bug [https://github.com/swaywm/sway/issues/6651] in sway.
XWAYLAND0 (または任意の XWAYLAND ディスプレイ名) はあなたのモニターを表していない可能性があり、異なるセッションで変更される可能性があります。代わりに、次の行を使用して最初の XWAYLAND ディスプレイを指定することができます。:

exec_always xrandr --output $(xrandr | grep -m 1 XWAYLAND | awk '{print $1;}') --primary

これらの行は、あなたのニーズに合わせて調整する必要があるかもしれません。どのディスプレイがどの名前にマッピングされているかは、引数なしで {{ic|xrandr}} コマンドを使用することで確認できます。

{{Note|XWayland は、新しく接続されたモニターを(電源を切って再び入れたものも含めて)まったく新しいディスプレイとして認識します。もしこれが "プライマリーモニター" に起こった場合、それはもはやプライマリーとはみなされていません。}}

== 参照 ==

* [https://github.com/SirCmpwn/sway Github プロジェクト]
* [https://github.com/swaywm/sway/wiki Sway user-maintained wiki]
* [http://swaywm.org ウェブサイト]
* [https://drewdevault.com/2019/03/11/Sway-1.0-released.html Announcing the release of sway 1.0]

{{TranslationStatus|Sway|2023/4/11|775342}}

Sway

2025-10-17T19:56:53Z

Mycelithyl:

[[Category:Wayland コンポジタ]]
[[es:Sway]]
[[en:Sway]]
[[it:Sway]]
[[pt:Sway]]
[[zh-hans:Sway]]
{{Related articles start}}
{{Related|ウィンドウマネージャ}}
{{Related articles end}}
sway ('''S'''irCmpwn's '''Way'''land compositor [https://github.com/swaywm/sway/blob/f0ddf6d74c98ba6c502783b8f41be859c56712c9/README.md] から派生) は [[i3]] と互換性を持つように設計された [[Wayland]] コンポジタです。[http://swaywm.org 公式ウェブサイト] より:
:Sway はタイリング Wayland コンポジタであり、X11 の i3 ウィンドウマネージャの代替品です。既存の i3 設定で動作し、i3 の機能に加えて、いくつかの追加機能をサポートしています。

見た目に興味がある場合は、Sway のフォークとして {{AUR|swayfx}} が存在します。

== インストール ==

sway は {{Pkg|sway}} パッケージで[[インストール]]できます。最新の開発版は {{AUR|sway-git}} でインストールできます。''sway'' は ''wlroots'' に緻密に依存しているので、''sway'' 更新時には ''wlroots'' も更新するのが望ましいです。

{{Note|[[NVIDIA]] を含む、すべてのプロプライエタリなグラフィックスドライバは [https://github.com/swaywm/sway/wiki#nvidia-users サポートされていません]。NVIDIA ドライババージョン 495 以降より、[[NVIDIA#DRM カーネルモード設定|カーネルモード設定]] を有効化して sway を {{ic|1=--unsupported-gpu}} 付きで実行すれば、sway は機能します。}}

また、画面をロックする {{Pkg|swaylock}} や、アイドル時間管理デーモンの {{Pkg|swayidle}} もインストールできます。

デフォルトのアプリケーションランチャーは {{Pkg|wmenu}} です。(ただし、デフォルトの設定はまだ {{Pkg|dmenu}} が提供する ''dmenu_path'' に依存しています)、デフォルトの[[ターミナルエミュレータ]] は {{Pkg|foot}} です。インストールするか、あるいは設定ファイルで別のアプリケーションに変更するかを、初回起動の前に行なうことが望ましいです。i3 パッケージの Wayland 対応版については、sway wiki の [https://github.com/swaywm/sway/wiki/i3-Migration-Guide migration guide] を参照してください。

== sway の起動 ==

Sway を起動する前に、キーボード、マウス、グラフィックカードなどのハードウェアデバイスにアクセスする必要があります。 {{man|3|sd-login}} で説明されているように、これらのハードウェアデバイスのコレクションはシートと呼ばれます。

Arch Linux では、Sway は次のどちらかを使ってシートにアクセスすることができます。

* {{man|8|systemd-logind}} と {{Pkg|polkit}} または
* {{Pkg|seatd}} これは、{{Pkg|wlroots}} の依存関係として Sway と一緒にインストールされます。

{{ic|polkit}} がすでにシステムにインストールされている場合、Sway は自動的にあなたのシートにアクセスできるはずです。

また、{{ic|polkit}} がシステムにインストールされておらず、代わりに seatd を使用したい場合は、seat ユーザーグループに自分を追加し、{{ic|seatd.service}} を [[起動/有効化]]し、再ログインして、以下の方法のいずれかを選択して Sway を起動することができます。

=== 手動 ===

Linux コンソールで {{ic|sway}} と入力すれば sway が起動します。

=== TTY ログイン時に自動起動 ===

X と同様に、Sway はシェル初期化ファイルに以下を追加することで開始できます。([[コマンドシェル#ログインシェル]]を参照):

{{bc|1=<nowiki>
if [ -z "${WAYLAND_DISPLAY}" ] && [ "${XDG_VTNR}" -eq 1 ]; then
exec sway
fi
</nowiki>}}

詳細については、[[xinitrc#ログイン時に X を自動起動]] を参照してください。

=== ディスプレイマネージャを使う ===
{{Note|Sway は公式にはディスプレイマネージャをサポートしていません。}}
sway のセッションは {{ic|/usr/share/wayland-sessions/sway.desktop}} にあります。[[GDM]] や [[SDDM]] などのディスプレイマネージャは自動的にセッションを認識します。

ディスプレイマネージャを通して、[https://github.com/swaywm/sway/wiki/Systemd-integration#running-sway-itself-as-a---user-service systemd ユーザーサービス] として sway を開始することも可能です。

あるいは、テキストベースのセッションマネージャを使うこともできます。[[ディスプレイマネージャ#コンソール]]を参照してください。

== 設定 ==
i3 を既に使っている場合、i3 の設定を {{ic|~/.config/sway/config}} にコピーすればそのまま動作します。i3 を使ったことがない場合は、サンプル設定ファイルを {{ic|~/.config/sway/config}} にコピーしてください。サンプル設定ファイルは {{ic|/etc/sway/config}} にあります。ただし {{ic|DFALLBACK_CONFIG_DIR}} フラグが設定されている場合は存在しません。設定方法は {{man|5|sway}} を見てください。

{{Note|ドロップインファイルの設定スニペットを適用するために、ユーザの設定には {{ic|include /etc/sway/config.d/*}} が含まれていることが期待されます。{{Pkg|sway}} パッケージは、いくつかの環境変数を systemd ユーザセッションと dbus にインポートする {{ic|50-systemd-user.conf}} ドロップインファイルを提供しています。このドロップインファイルは、{{Pkg|xdg-desktop-portal-wlr}} などのいくつかのアプリケーションで必要です。}}

=== キーマップ ===
デフォルトでは、sway は US QWERTY キーマップで起動します。キーマップを書き換えるには:
{{hc|~/.config/sway/config|
input * {
xkb_layout "us,de,ru"
xkb_variant "colemak,,typewriter"
xkb_options "grp:win_space_toggle"
}

input <identifier> xkb_model "pc101"
}}

詳細は {{man|5|sway-input}} および {{man|7|xkeyboard-config}} を参照してください。

なお、Sway は起動時に {{ic|XKB_DEFAULT_LAYOUT}} や {{ic|XKB_DEFAULT_VARIANT}} などの[[環境変数]]を読み込みますが、環境変数よりも設定ファイルの内容が優先されます。

=== キーのオートリピート設定 ===
Typematic Delay (オートリピート開始までの時間) と Typematic Rate (1秒間のリピート回数) は、{{ic|input}} セクションに以下の行を加えると変更できます。設定項目について詳しくは[[コンソールでのキーボード設定#typematic delay と rate の調整]]を参照してください。

{{hc|~/.config/sway/config|
input <identifier> repeat_delay 300
input <identifier> repeat_rate 30
}}

=== ステータスバー ===

sway には pure Wayland 環境で動作する ''swaybar'' がデフォルトのステータスバーとして同梱されています。''swaybar'' はシェルスクリプトや他のプログラムを呼び出して、ステータスバーに情報を表示することができます。詳細については、{{man|5|sway-bar}} や {{man|7|swaybar-protocol}} を参照してください。

{{Tip|{{Pkg|waybar}} は sway に含まれているバー (swaybar) の代替になります。}}

{{Pkg|i3status}} のインストールは、 Wayland で実用的なデフォルトのステータスバーを取得するためのオプションです。sway の設定の末尾に以下のスニペットを追加するだけで表示できます:
{{hc|~/.config/sway/config|<nowiki>
bar {
status_command i3status
}</nowiki>}}
i3status をカラー出力させたい場合、i3status の設定の以下の部分を調整してください:
{{hc|~/.config/i3status/config|<nowiki>
general {
colors = true
interval = 5
}
</nowiki>}}
どちらの例でも、システム全体にインストールされた設定ファイルはユーザーディレクトリにコピーされるので、それを修正してください。

=== 壁紙 ===
Sway 1.1 以降、壁紙機能は {{Pkg|swaybg}} に分割され、{{ic|output}} コマンドを動作させるのに必要です。

以下の行を sway の設定の最後に追加することで、全ての画面 ({{ic|"*"}} という名前にマッチする画面) で背景画像を設定できます:
{{hc|~/.config/sway/config|<nowiki>
output "*" background /path/to/image.jpg fill
</nowiki>}}
ファイルの名前やパスは適当に置き換えて下さい。

また、背景は単一色にもできます:
{{bc|output * bg #000000 solid_color}}

{{Pkg|swaybg}} コマンドの GTK3 フロントエンドとして {{AUR|azote}} を使うことができます。

=== 入力デバイス ===
特定の入力デバイスの設定を調整することができます。例えば、タッチパッドの tap-to-click とナチュナルスクロールを有効にするには、以下の input ブロックを追加:
{{hc|~/.config/sway/config|<nowiki>
input type:touchpad {
tap enabled
natural_scroll enabled
}
</nowiki>}}

特定のタッチパッドの設定をセットするには、{{ic|swaymsg -t get_inputs}} を使用して、デバイスの Identifier を取得し、{{ic|type:touchpad}} の代わりにそれを使用します。

{{Note|
上記のコマンドの出力には、"/" などの記号をエスケープするために "\" が付いていることがあります (例: {{ic|"2:14:ETPS\/2_Elantech_Touchpad"}})。設定に追加するときはエスケープを取り除いてください。}}

アクセラレーションなど他のオプションについては {{man|5|sway-input}} で詳細を確認できます。

グラフィックタブレットをお使いの方は、[[ペンタブレット#Sway]]をご覧ください。

==== タッチディスプレイのマッピング ====

マルチディスプレイ環境で使用されるタッチディスプレイのタッチ入力ターゲットは、そのタッチディスプレイにのみマッピングできます。

{{hc|~/.config/sway/config|
set $display1 "Dell Inc. DELL P2414H VHVTW542165L"
set $display2 "Dell Inc. DELL P2418HT MYDM775F152L"
set $display2-touch "8146:24835:Melfas_LGD_AIT_Touch_Controller"

input $display2-touch map_to_output $display2
}}

=== HiDPI ===

設定ファイルの {{ic|output}} コマンドでディスプレイのスケールファクタを設定してください。スケールファクタは小数でも指定できます。HiDPI ディスプレイの場合は 2 などに設定してください。

{{hc|~/.config/sway/config|
output <name> scale <factor>
}}

ディスプレイの名前は以下のコマンドで確認できます:
$ swaymsg -t get_outputs

=== タッチディスプレイのマッピング ===

マルチディスプレイ環境で使用するタッチディスプレイのタッチ入力のターゲットを、そのタッチディスプレイのみにマッピングすることができます。

{{hc|~/.config/sway/config|
set $display1 "Dell Inc. DELL P2414H VHVTW542165L"
set $display2 "Dell Inc. DELL P2418HT MYDM775F152L"
set $display2-touch "8146:24835:Melfas_LGD_AIT_Touch_Controller"

input $display2-touch map_to_output $display2
}}

=== カスタムキーバインド ===
キーボードの[[キーボード入力|特殊なキー]]を使ってコマンドを実行することができます。例えば、ボリュームや画面の明るさを制御するには:

{{hc|~/.config/sway/config|
bindsym XF86AudioRaiseVolume exec pactl set-sink-volume @DEFAULT_SINK@ +5%
bindsym XF86AudioLowerVolume exec pactl set-sink-volume @DEFAULT_SINK@ -5%
bindsym XF86AudioMute exec pactl set-sink-mute @DEFAULT_SINK@ toggle
bindsym XF86AudioMicMute exec pactl set-source-mute @DEFAULT_SOURCE@ toggle
bindsym XF86MonBrightnessDown exec brightnessctl set 5%-
bindsym XF86MonBrightnessUp exec brightnessctl set 5%+
bindsym XF86AudioPlay exec playerctl play-pause
bindsym XF86AudioNext exec playerctl next
bindsym XF86AudioPrev exec playerctl previous
bindsym XF86Search exec $menu
}}

詳細や代替ユーティリティについては、[[PulseAudio#キーボードのボリュームコントロール]]、[[Advanced Linux Sound Architecture#キーボードのボリュームコントロール]]、[[バックライト#バックライトユーティリティ]]、[[MPRIS]] を参照してください。

ロック画面がアクティブなときにキーバインドを実行できるようにするには、{{ic|--locked}} パラメーターを bindsym に追加します。

bindsym --locked XF86AudioPlay exec playerctl play-pause

{{Tip|{{AUR|wev}} は、Wayland の {{Pkg|xorg-xev}} と同様の機能を提供するツールです。}}

{{Note|systemd は、電源キーやふたの開閉などの特別なキーや、閉じるイベントを処理します。これらは、sway で設定されたものと干渉する可能性があります。[[systemd]] での設定方法の詳細については、{{man|1|loginctl}} および {{man|5|logind.conf}}} を参照してください。}}

==== グラフィカルインジケーターバー ====

明るさや音量などのパーセント値設定の現在のレベルを、調整時にグラフィカルなバーで表示することが望ましい場合があります。Sway でこの機能を提供する良い選択肢は {{Pkg|wob}} (あるいは {{AUR|wob-git}}) です。これは、人気な X ツール {{AUR|xob}} の機能の一部を提供し、layer-shell プロトコルを実装している Wayland ネイティブなユーティリティです。使用例は[https://github.com/francma/wob プロジェクトのウェブサイト]を見てください。

==== ワークスペースの概要 ====

たくさんのワークスペースをたくさんのウィンドウで使っていて、何がどこにあるかわからなくなったら、{{AUR|sov}} が便利です。これはすべてのワークスペースのスキーマを表示するオーバーレイで、sway のナビゲーションを容易にします。プログラム名、ウィンドウのタイトルを表示し、マルチ出力のセットアップをサポートします。詳しくは [https://github.com/milgra/sov プロジェクトページ]をご覧ください。

=== アイドリング ===

Sway には、アイドルセッションを処理するための専用のアイドル管理デーモン {{pkg|swayidle}} があります。デーモンを起動してパラメータ化する方法はいくつかあります。最も簡単な方法は、sway 自体の設定を使用することです。{{ic|swayidle}} は、{{ic|timeout}} (別名 idling)、{{ic|resume}} (resume from sleep) 、{{ic|before-sleep}} などのイベントを構成するための多数の引数を受け取ります。イベントの詳細と詳細については、{{man|1|swayidle}} を参照してください。その後、各イベントにアクションを割り当てることができます。イベントに複数のアクションを割り当てるには、トリガーを繰り返すだけです。

次の例では、{{ic|swayidle}} 30分後に画面をロックし、5 秒後に画面をオフにします。

{{hc|~/.config/sway/config|
exec swayidle -w \
timeout 1800 'swaylock -f' \
timeout 1805 'swaymsg "output * power off"' \
resume 'swaymsg "output * power on"'
}}

ロックされたスクリーンをもっと早く、例えば10秒後にオフにするには、ロックマネージャのプロセスリストを grep し、以下のように {{ic|swaymsg "output * power off"}} を実行します。

timeout 10 'if pgrep -x swaylock; then swaymsg "output * dpms off"; fi'

再生中のメディアを一時停止または一時停止する前に画面をロックするには、swayidle コマンドの次の手順を修正します。

before-sleep 'playerctl pause'
before-sleep 'swaylock'

{{note|systemd も sway で設定されたイベントと競合する可能性のあるアイドルイベントを処理します。構成方法の詳細については、{{man|1|loginctl}} および {{man|5|logind.conf}} を参照してください。}}

=== フローティングウィンドウ ===

フローティングウィンドウまたはウィンドウの割り当てを有効にするには、アプリケーションを開き、{{ic|app_id}}、{{ic|class}}、{{ic|instance}}、および {{ic|title}} 属性を使用して、フローティングウィンドウの割り当てを有効にします。次のコマンドは、開いているすべてのウィンドウのプロパティを一覧表示します。

$ swaymsg -t get_tree

開いているすべてのウィンドウの {{ic|app_id}} のみを取得するには、次を使用します。

$ swaymsg -t get_tree | grep "app_id"

フォーカスのあるウィンドウの {{ic|app_id}} を取得するには、次を使用します。

$ swaymsg -t get_tree | jq -r '..|try select(.focused == true)'

一部のウィンドウで {{ic|app_id}} が null になる場合は、{{ic|class}} 属性または {{ic|instance}} 属性 (あるいはその両方) を使用して、フローティングモード/ウィンドウの割り当てを有効にする必要があります。出力を検索して、ウィンドウの細かいルールを作成できます。

{{hc|~/.config/sway/config|2=
for_window [app_id="galculator"] floating enable
assign [class="firefox"] -> 3
assign [class="^Urxvt$" instance="^htop$"] -> 9
}}

これは、{{Pkg|xorg-xprop}} を使用して [[X11]] の {{ic|class}} または {{ic|wm_name}} 属性を検索するのと似ています。

複数のモニターを使用する場合、フローティングスクラッチパッドウィンドウが大きくなりすぎて、複数のモニターをカバーする可能性があります。このコマンドはフローティングウィンドウを中央に配置し、現在のモニターのサイズの 80% のサイズに変更します。

$ swaymsg move position center; swaymsg resize set 80ppt 80ppt

=== クリップボード ===

デフォルトでは、ウィンドウを閉じるとクリップボードは空になります。これは意外なことにデフォルトの動作だったりします。

クリップボードの内容をウィンドウ間で共有するには、 "クリップボードマネージャ" をインストールする必要があります。

Wayland 用に設計されたクリップボードマネージャの一例は、{{AUR|clipman}} または {{AUR|clipman-git}} からインストールできる [https://github.com/chmouel/clipman clipman] です。

Sway で clipman を起動するには、設定ファイルに次の行を追加します。

{{hc|~/.config/sway/config|2=
exec wl-paste -t text --watch clipman store --no-persist
}}

=== Xresources ===
sway で使用するには {{ic|.Xresources}} を {{ic|.Xdefaults}} にコピーしてください。

=== XWayland ===

詳細と利用可能なパッケージの概要については、[[Wayland#Xwayland]] を参照してください。

XWayland の使用はデフォルトで有効になっています。

一方、XWayland を無効化し、Sway の純粋な Wayland セッションを使うには次のようにします:
{{hc|~/.config/sway/config|
xwayland disable
}}
{{Note|プログラムによっては Wayland でネイティブに動作させるために [[Wayland#GUI ライブラリ|特殊な環境変数や設定オプション]] を必要とするものもありますし、Wayland を全くサポートしていないプログラム(ほとんどの独自アプリケーションを含む)もあります。現在のところ、レガシーアプリケーションが使えるようにXWaylandをオンにしておくことが推奨されています。}}

=== 別の wlroots レンダラーを使用する ===

環境変数 {{ic|WLR_RENDERER}} を指定することにより、別の [https://gitlab.freedesktop.org/wlroots/wlroots/-/tree/master/render wlroots レンダラー]を使用することができます。利用可能なレンダラーの一覧は、[https://gitlab.freedesktop.org/wlroots/wlroots/-/blob/master/docs/env_vars.md wlroots のドキュメント]にあります。

=== 自動起動 ===

[[i3#自動起動]] を参照して、sway の設定ファイル名を調整してください。

== ヒントとテクニック ==

=== 最初に CapsLock/NumLock を有効にする ===

デフォルトでは、sway は起動時に最初に {{ic|CapsLock}} と {{ic|NumLock}} キーを無効にします。代わりに、起動時にこれらを有効にするには、キーボード入力設定の {{ic|xkb_capslock}} または {{ic|xkb_numlock}} あるいはその両方を {{ic|enable}}に設定します。例えば、すべてのキーボードで有効にするには、sway 設定に次の行を追加します。

{{hc|~/.config/sway/config|
input type:keyboard xkb_capslock enabled
input type:keyboard xkb_numlock enabled
}}

いずれの場合も、キーボードの該当するキーを押すことで {{ic|CapsLock}} と {{ic|NumLock}} を切り替えることができます。

{{Note|1=これらのオプションを有効にすると、sway 設定ファイル [https://bugzilla.mozilla.org/show_bug.cgi?id=1652820 Bugzilla 1652820] をリロードしたときに Firefox がクラッシュする可能性があります。}}

=== 現在のキーボードレイアウト ===

現在のキーボードレイアウトは、次のようにして取得できます。{{ic|''kbd_identifier''}} は、キーボードの識別子で置き換える必要があります。

$ swaymsg -t get_inputs {{!}} jq -r '.[] {{!}} select(.identifier == "''kbd_identifier''") {{!}} .xkb_active_layout_name'

=== コンポーズキー ===

{{ic|PrintScreen}} を[[Xorg でのキーボード設定#コンポーズキーの設定|コンポーズキー]]として設定するには、

$ swaymsg 'input * xkb_options compose:prsc'

コンポーズキーの組み合わせは、[[Xorg でのキーボード設定#キーの組み合わせ|XCompose ファイル]]で設定することもできます。この変更を有効にするには、アプリケーションを再起動する必要があります。

{{ic|/usr/include/X11/keysymdef.h}} でキーの名前を調べたり、{{man|1|xev}} のようなデバッガ {{man|1|xkbcli-interactive-wayland}} ({{ic|/usr/lib/xkbcommon/}}フォルダ中) を使ったりすることができます。

=== バックライト切り替え ===

ディスプレイの電源をオフ (またはオン) にするには (例:{{ic|Pause}})、次のスクリプトを Sway {{ic|config}} でバインドします。

{{bc|
#!/bin/sh
read lcd < /tmp/lcd
if [ "$lcd" -eq "0" ]; then
swaymsg "output * power on"
echo 1 > /tmp/lcd
else
swaymsg "output * power off"
echo 0 > /tmp/lcd
fi
}}

または、[https://github.com/swaywm/sway/pull/6099 toggle] オプションを直接使用することもできますが、複数のモニターがある場合は出力を明示的に指定する必要があります。

$ swaymsg "output ''output_name'' power toggle"

=== 画面キャプチャと画面共有 ===

こちらを参照 [[スクリーンショットの取得#Wayland]]

=== 色温度調整 ===

こちらを参照 [[バックライト#Wayland]].

=== キーボードを使用して swaynag を制御する ===

既定の警告/プロンプトプログラムである Swaynag は、sway に付属しており、ユーザーによるマウス操作のみをサポートしています。キーボードショートカットによる対話を有効にするには、{{AUR|swaynagmode}} などのヘルパープログラムを使用します。

Swaynag モードは、まず swaynag を起動し、次のボタンの選択、プロンプトの削除、選択したボタンの受け入れなどのアクションをトリガーするシグナルを待機します。これらのシグナルは、制御引数 ({{ic|swaynagmode--select right}} や {{ic|swaynagmode--confirm}}など) を指定して swaynagmode スクリプト自体の別のインスタンスを起動することで送信されます。

デフォルトでは、Swaynagmode は初期化時にスウェイモード {{ic|nag}} をトリガーし、終了時に {{ic|default}} をトリガーします。これにより、sway 構成でキーバインディングを簡単に定義できます。

{{hc|~/.config/sway/config|
set $nag exec swaynagmode
mode "nag" {
bindsym {
Ctrl+d mode "default"

Ctrl+c $nag --exit
q $nag --exit
Escape $nag --exit

Return $nag --confirm

Tab $nag --select prev
Shift+Tab $nag --select next

Left $nag --select next
Right $nag --select prev

Up $nag --select next
Down $nag --select prev
}
}
}}

sway バージョン1.2以降では、モード名で大文字と小文字が区別されることに注意してください。

swaynagmode を使用するように sway を設定するには、設定コマンド {{ic|swaynag_command swaynagmode}} を使用します。

=== カーソルテーマとカーソルの大きさ ===
[[カーソルテーマ]] やカーソルの大きさを変更するには:

{{hc|~/.config/sway/config|
seat seat0 xcursor_theme ''my_cursor_theme'' ''my_cursor_size''
}}

{{ic|''my_cursor_theme''}} は {{ic|Default}}, {{ic|Adwaita}}, {{ic|Simple-and-Soft}} などに置きかえ、{{ic|''my_cursor_size''}} は {{ic|48}} などに置きかえます。

{{ic|echo $XCURSOR_SIZE}} と {{ic|echo $XCURSOR_THEME}} でこれらの値を調べることができます。

変更を反映させるにはアプリケーションを再起動してください。

{{Note|Wayland ではクライアント側でカーソルテーマが決定されます。アプリケーションが{{ic|$XCURSOR_SIZE}}, {{ic|$XCURSOR_THEME}} 環境変数を参照しないこともありえます。}}

=== systemd で sway 固有のデーモンを管理する ===

一部のサービス/デーモン ({{Pkg|swayidle}} や {{Pkg|kanshi}}など) は、現在のウィンドウマネージャが Sway の場合にのみ開始し、Sway が停止したときにこれらのサービスを停止したい場合があります。これを行うには、{{ic|sway-session.target}} を作成し、{{ic|sway-session.target}} が必要とするデーモン/サービスを作成します。この systemd ターゲットは、ユーザーターゲットである必要があります ([[systemd/ユーザー]] を参照) 例:

{{hc|1=~/.config/systemd/user/sway-session.target|2=
[Unit]
Description=Sway compositor session
Documentation=man:systemd.special
BindsTo=graphical-session.target
Wants=graphical-session-pre.target
After=graphical-session-pre.target
}}

次に、Sway の設定ファイル(たとえば、{{ic|~/.config/sway/config}} に行を追加するか、{{ic|/etc/sway/config.d/}} に新しいファイルを追加して) 次の行を追加します。

{{hc|1=~/.config/sway/config|2=
...
...
...
exec_always "systemctl --user start sway-session.target"
}}

設定ファイルの上記の行追加で、Sway が起動するたびに {{ic|sway-session.target}} もアクティブになります。

最後に、目的のサービスを {{ic|sway-session.target}} にリンクします。たとえば、{{Pkg|kanshi}} (または {{AUR|kanshi-git}}) サービスを追加するには、次のように入力します。

{{hc|1=~/.config/systemd/user/kanshi.service|2=
[Unit]
Description=Dynamic output configuration for Wayland compositors
Documentation=https://sr.ht/~emersion/kanshi
BindsTo=sway-session.target

[Service]
Type=simple
ExecStart=/usr/bin/kanshi

[Install]
WantedBy=sway-session.target
}}

この[[ユーザーユニット]]を[[有効化]]は、Sway が動作している時のみ有効で、Sway が停止すると無効になります。

{{ic|sway-session.target}} ファイルの作成と環境のインポートは、{{AUR|sway-systemd-git}} をインストールすることでも行うことができます。sway-systemd はサービスを cgroup に分けるだけでなく、各 GUI アプリケーションを独自の cgroup に配置します。これにより、個々のアプリケーションに対して cgroup 単位のリソース制約を課すことができます。[https://github.com/alebastr/sway-systemd sway-systemd README] を参照してください。

=== 起動後の画面解像度の変更 ===

グラフィカルプログラム {{AUR|wdisplays}} またはターミナルプログラム {{AUR|wlr-randr}}
を使って、回転、解像度を変更し、ディスプレイを配置します。

=== ヘッドレス出力の作成 ===

物理的なビデオインターフェイスに関連しない出力を作成する、 HEADLESS-1、HEADLESS-2 など。

$ swaymsg create_output

新しい出力の説明を表示します。

$ swaymsg -pt get_outputs | grep -A 10 HEADLESS

新しい出力を、たとえば {{ic|output}} コマンドで設定します。

{{hc|1=~/.config/sway/config|2=
output HEADLESS-1 {
pos 1920,0
mode 1280x720@75Hz
}
}}

== 既知の問題 ==

=== アプリケーションランチャー ===

{{Tip|Sway の wiki には [https://github.com/swaywm/sway/wiki#program-launchers 既知のアプリケーションランチャーのリスト] もあります。}}

i3-dmenu-desktop {{Pkg|dmenu}}、および {{Pkg|rofi}} はすべて Sway では比較的うまく機能しますが、すべて XWayland で実行されており、カーソルをネイティブの Wayland ウィンドウに移動すると応答しなくなるという同じ問題があります。この問題の理由は、Wayland のクライアント/ウィンドウが画面のフォーカスを持っていない限り、入力デバイスにアクセスできないためです。XWayland サーバ自体が Wayland コンポジタのクライアントであるためで、XWayland クライアントの1つは、ユーザ入力にアクセスするためのフォーカスを持っている必要があります。しかし、クライアントの1つがフォーカスを取得すると、入力を収集し、X11 プロトコルを介してすべての XWayland クライアントが利用できるようにします。そのため、XWayland のウィンドウにカーソルを移動して Esc キーを押すと問題が解決し、{{ic|pkill}} を実行しても問題が解決する場合があります。

{{Pkg|bemenu}} は Wayland の dmenu をネイティブに置き換えたものです。どちらもオプションで {{Pkg|j4-dmenu-desktop}} と組み合わせることで、デスクトップファイルを起動するための Wayland ネイティブな組み合わせを提供できます (i3-dmenu-desktop がそうであるように)。例えば

j4-dmenu-desktop --dmenu='bemenu -i --nb "#3f3f3f" --nf "#dcdccc" --fn "pango:DejaVu Sans Mono 12"' --term='termite'

XWayland を無効にしない場合は、{{ic|BEMENU_BACKEND}} 環境変数を "wayland" に設定する必要があります。

フローティングターミナルと fzf を使用して独自のビルドを行うこともできます ([https://github.com/swaywm/sway/issues/1367 GitHub の問題] を参照)

また、{{Pkg|plasma-workspace}} パッケージが提供する {{ic|krunner}} バイナリもランチャーとして機能し、XWayland とネイティブ Wayland の両方をサポートします。

{{AUR|rofi-lbonn-wayland-git}} は {{Pkg|rofi}} の派生形で、Wayland で動作します。また、X11 セッションで起動する必要がある場合は {{ic|-x11}} フラグがあります。

{{Pkg|wofi}} はコマンド・ランチャーで、rofi と同じ機能の一部を提供します、wofi には、SSH モードやウィンドウ切り替えモードなど、rofi の機能の一部が欠けています。これは {{Pkg|wlroutes}} ライブラリに基づいており、レンダリングには GTK3 を使用していて、sway にはとてもよく効きます。

=== 仮想環境で使う ===

Sway は [[VirtualBox]] や [[VMware]] ESXi の両方で動作します。

[[QEMU]] で Sway を機能させるには、{{ic|-vga qxl}} で QEMU を開始する必要があります。 [[QEMU#qxl]]も参照してください。

==== Sway を tty から起動できない ====

3D アクセラレーションを有効にする必要があります。[[VMware#Intel と Optimus で 3D グラフィックを有効化]] を参照してください。

==== マウスカーソルが表示されない ====

特定のグラフィックスドライバー(VMSVGA グラフィックコントローラーやのプロプライエタリ NVIDIA ドライバーなど)を使うとカーソルが表示されません。これは、[https://github.com/swaywm/sway/issues/3814] で説明されているようにソフトウェアカーソルを使用して修正できます。

$ export WLR_NO_HARDWARE_CURSORS=1

=== Sway Socket Not Detected ===

{{ic|swaymsg -t get_outputs}} などの {{ic|swaymsg}} 引数を使用すると、次のメッセージが返されることがあります。

sway socket not detected.
ERROR: Unable to connect to

ターミナルマルチプレクサ ([[GNU Screen]] や [[tmux]] など) 内で実行される場合。これは、{{ic|swaymsg}} が {{ic|SWAYSOCK}} で提供されたソケットに接続できなかったことを意味します。

{{ic|SWAYSOCK}} の現在の値を確認するには:

{{hc|$ env {{!}} grep -F "SWAYSOCK"|2=
SWAYSOCK=/run/user/1000/sway-ipc.1000.4981.sock
}}

この問題を回避するには、実行中の sway プロセスに基づいてソケットにアタッチしてみてください。

$ export SWAYSOCK=/run/user/$(id -u)/sway-ipc.$(id -u).$(pgrep -x sway).sock

上記のエラーを解決するには、マルチプレクサの外でコマンドを実行する必要があります。

=== Wayland サーバーへの接続に失敗する ===

Tmux はセッションごとにローカルな環境変数を作成します (確認するには {{ic|tmux show-environment}} と入力) そのため、[https://github.com/tmux-plugins/tmux-resurrect tmux-resurrect] や [https://github.com/tmux-plugins/tmux-continuum tmux-continuum] で以前の tmux セッションに再アタッチしたり、sway の起動前に tmux サーバを起動すると、環境変数は、古くなっています。

{{ic|update-environment}} を使って、セッションにアタッチするたびにそれらを更新するように tmux に指示するには、以下を {{ic|.tmux.conf}} に追加してください。

set-option -g update-environment "DISPLAY WAYLAND_DISPLAY SWAYSOCK SSH_AUTH_SOCK"

=== Unable to retrieve socket path ===

tty から {{ic|swaymsg -t}} を実行すると、
Unable to retrieve socket path
というメッセージが表示されます。これは {{ic|SWAYLOCK}} 環境変数が Sway 起動後に設定されるためで、{{ic|swaymsg}} は Sway 内のターミナルで実行してください。

=== キー割り当てとキーボードレイアウト ===

デフォルトでは、複数のキーボードレイアウト {{ic|<nowiki>input * xkb_layout "us,ru"</nowiki>}} を使用している場合、セカンダリレイアウトを切り替えたときにバインディングが壊れることがあります。

https://github.com/swaywm/sway/pull/3058, のおかげで、以下のように {{ic|--to-code}} 行に {{ic|--to-code}}キーを追加するだけで済みます。

{{bc|<nowiki>
bindsym --to-code {
$mod+$left focus left
$mod+$down focus down
$mod+$up focus up
$mod+$right focus right
}</nowiki>
}}

または、変数 {{ic|set$mybind bindsym--to-code}} を作成し、{{ic|bindsym}} のすべてのインスタンスを {{ic|$mybind}} で置き換えることもできます。{{ic|$mybind$mod+w thing}}

=== Java アプリケーション ===

一部の Java ベースのアプリケーション (IntelliJ、CLion、PyCharm などの JetBrains エディタ) を開くと、空白の画面が表示されます。これを軽減するには、{{ic|_JAVA_AWT_WM_NONREPARENTING}} 環境変数を1に設定してアプリケーションを起動します。

{{Pkg|rofi}} や {{Pkg|dmenu}} などのランチャーからアプリケーションを起動する場合は、 [[デスクトップエントリ#環境変数の修正]] に示すように、アプリケーションのデスクトップエントリを変更してください。

Java アプリケーションに関するいくつかの問題は、OpenJDK11 および Sway 1.5 で修正されました。ただし、一部のアプリケーションでは、新しいバージョンの OpenJDK を使用するために追加の構成が必要です。Android Studio の場合は、{{ic|1=STUDIO_JDK=/usr/lib/jvm/java-11-openjdk/}} を設定する必要があります。 [https://github.com/swaywm/sway/issues/5414]

=== ボーダーでスクロール ===

アプリケーションのボーダー上でマウスのスクロールホイールを使用するとクラッシュする場合は、{{ic|app_id}} (例:Firefox) に {{ic|border none}} を設定してください。

=== Program cannot open display ===

起動時に ''Program cannot open display'' というエラーメッセージが表示されてプログラムがクラッシュする場合は、使用しているプログラムが X11 プログラムである可能性があります。XWayland 互換性レイヤを使って Wayland で X11 プログラムを実行することができます。詳細は [[Sway#Xwayland]] を参照してください。

=== Unable to open wayland socket ===

sway が起動せず、"Unable to open wayland socket" というエラーメッセージが出力される場合は、`$XDG_RUNTIME_DIR` 環境変数が設定されているが、指定したディレクトリがないことを意味する場合があります。

=== WINE アプリケーションでマウスが動作しない ===

プログラムを実行するとき、WINE はプライマリーモニターが設定されていることを期待しますが、Wayland にはプライマリーモニターの概念がないため、(クリックが認識されないなど) 問題を引き起こす可能性があります。代わりに、Sway の設定にこの行を追加することで、[[xrandr]] を介して XWayland が使用するプライマリモニタを指定することができます。

{{hc|~/.config/sway/config|2=
...
exec_always xrandr --output XWAYLAND0 --primary
...
}}

For this to work your display position offset needs to be 0,0 because of a bug [https://github.com/swaywm/sway/issues/6651] in sway.
XWAYLAND0 (または任意の XWAYLAND ディスプレイ名) はあなたのモニターを表していない可能性があり、異なるセッションで変更される可能性があります。代わりに、次の行を使用して最初の XWAYLAND ディスプレイを指定することができます。:

exec_always xrandr --output $(xrandr | grep -m 1 XWAYLAND | awk '{print $1;}') --primary

これらの行は、あなたのニーズに合わせて調整する必要があるかもしれません。どのディスプレイがどの名前にマッピングされているかは、引数なしで {{ic|xrandr}} コマンドを使用することで確認できます。

{{Note|XWayland は、新しく接続されたモニターを(電源を切って再び入れたものも含めて)まったく新しいディスプレイとして認識します。もしこれが "プライマリーモニター" に起こった場合、それはもはやプライマリーとはみなされていません。}}

== 参照 ==

* [https://github.com/SirCmpwn/sway Github プロジェクト]
* [https://github.com/swaywm/sway/wiki Sway user-maintained wiki]
* [http://swaywm.org ウェブサイト]
* [https://drewdevault.com/2019/03/11/Sway-1.0-released.html Announcing the release of sway 1.0]

{{TranslationStatus|Sway|2023/4/11|775342}}