Polybarのソースを表示

[[Category:視覚効果]]
[[en:Polybar]]
[https://github.com/jaagr/polybar polybar] はステータスバーを簡単に素早く作れるツールです。多数のモジュールを利用して、ワークスペース・日付・システムボリュームの表示など様々な機能を簡単にカスタマイズできるようになっています。Polybar は [[awesome]] や [[i3]] などステータスバーが付属していない[[ウィンドウマネージャ]]で特に有用です。また、Polybar は [[Plasma]] などの[[デスクトップ環境]]でも使用できます。

== インストール ==

{{Pkg|polybar}} パッケージを[[インストール]]してください。開発版は {{AUR|polybar-git}} です。

== 設定 ==
デフォルトの設定例は{{ic|/etc/polybar/config.ini}}です。Polybarは、{{ic|~/.config/polybar/config.ini}}または{{ic|/etc/xdg/polybar/config.ini}}、{{ic|/etc/polybar/config.ini}}から最初に見つかったものに応じて設定ファイルをロードします。設定を編集したければ、{{ic|/etc/polybar/config.ini}}から{{ic|~/.config/polybar/config.ini}}にコピーして編集してください。

=== Polybarの実行 ===

Polybarは以下のように起動できます:

{{bc|
Usage: polybar [OPTION]... BAR

  -h, --help               Display this help and exit
  -v, --version            Display build details and exit
  -l, --log&#61;LEVEL          Set the logging verbosity (default: WARNING)
                           LEVEL is one of: error, warning, info, trace
  -q, --quiet              Be quiet (will override -l)
  -c, --config&#61;FILE        Path to the configuration file
  -r, --reload             Reload when the configuration has been modified
  -d, --dump&#61;PARAM         Print value of PARAM in bar section and exit
  -m, --list-monitors      Print list of available monitors and exit
  -w, --print-wmname       Print the generated WM_NAME and exit
  -s, --stdout             Output data to stdout instead of drawing it to the X window
  -p, --png&#61;FILE           Save png snapshot to FILE after running for 3 seconds
}}

ウィンドウマネージャの起動時にPolybarを実行したい場合は[[#ウィンドウマネージャで実行]]を見てください。

=== 設定例 ===

基本的なPolybarの設定は以下のようになります。

{{bc|1=
[bar/mybar]
modules-right = date

[module/date]
type = internal/date
date = %Y-%m-%d%
}}

{{ic|mybar}}という名前のバーと、{{ic|date}}というモジュールを定義しています。

デフォルトでは、Polybarは{{ic|/etc/polybar/config.ini}}に多数の構成済みモジュールを含むサンプル構成もインストールします。

=== ウィンドウマネージャで実行 ===

{{ic|$HOME/.config/polybar/launch.sh}}などに実行ファイルを作成してください:

{{bc|
#!/bin/bash

# Terminate already running bar instances
killall -q polybar

# Wait until the processes have been shut down
while pgrep -u $UID -x polybar >/dev/null; do sleep 1; done

# Launch Polybar, using default config location ~/.config/polybar/config
polybar &

echo "Polybar launched..."
}}

上記のスクリプトを使うとウィンドウマネージャを再起動したときにPolybarも再起動されます。以下のようにカスタマイズすることもできます:
{{bc|
MONITOR&#61;HDMI-A-1 polybar &
}}
上記のコマンドでは指定したモニターにPolybarが表示されます (モニターは[[xrandr]]コマンドで確認できます)。Polybarの位置を指定するには:
{{bc|
polybar top &
}}

==== bspwm ====

[[bspwm]]を使用する場合、以下を{{ic|bspwmrc}}に追加:
{{bc|
$HOME/.config/polybar/launch.sh
}}

==== i3 ====

[[i3]]を使用する場合、以下を設定に追加:

{{bc|
exec_always --no-startup-id $HOME/.config/polybar/launch.sh
}}

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

=== 共有オブジェクトファイル libjsoncpp.so を開けません ===

GitHubの [https://github.com/jaagr/polybar/issues/885 issue] の説明に従って再インストールを試みます。

失敗した場合は、{{Pkg|jsoncpp}} パッケージを [[インストール]] してみてください。

== 参照 ==

* [https://github.com/jaagr/polybar/wiki/ Polybar Github Wiki]