Polybar

polybar 是一種能簡單快速地創建狀態欄的工具。它可以自定義許多功能模塊，比如工作區、日期和音量等等。Polybar 對於一些沒有狀態欄或者狀態欄的功能有限的窗口管理器格外有用，例如 awesome 和 i3。Polybar 也可以用於 Plasma 這樣的桌面環境。

安裝[編輯 | 編輯原始碼]

安裝 polybar^包包，或者安裝它的開發版本 polybar-git^AUR。

配置[編輯 | 編輯原始碼]

將配置文件樣例 /etc/polybar/config.ini 複製到 $XDG_CONFIG_HOME/polybar/config。polybar 默認按 ~/.config/polybar/config.ini、/etc/xdg/polybar/config.ini 和 / etc/polybar/config.ini 的順序查找文件，並將最先找到的作為配置文件。

運行 Polybar[編輯 | 編輯原始碼]

Polybar 可以使用以下參數運行：

Usage: polybar [OPTION]... [BAR]

  -h, --help                   顯示幫助信息並退出
  -v, --version                顯示構建詳情並退出
  -l, --log=LEVEL              設置日誌的詳細級別（默認：notice）
                               LEVEL 可以是：error, warning, notice, info, trace
  -q, --quiet                  保持安靜，不顯示日誌（會覆蓋 -l）
  -c, --config=FILE            配置文件的路徑
  -r, --reload                 當配置文件被修改後自動重新加載
  -d, --dump=PARAM             輸出參數 PARAM 的值並退出
  -m, --list-monitors          輸出可用的顯示器列表並退出（不含克隆的顯示器）
  -M, --list-all-monitors      輸出可用的顯示器列表並退出（包含克隆的顯示器）
  -w, --print-wmname           輸出生成的 WM_NAME 並退出
  -s, --stdout                 將數據打印到標準輸出，而不是在圖形界面中展示
  -p, --png=FILE               運行3秒後將 png 截圖保存到 FILE

你可能想要在你的窗口管理器的引導程序中啟動 Polybar，詳見#在窗口管理器中運行。

配置樣例[編輯 | 編輯原始碼]

以下是一份基礎的配置：

[bar/mybar]
modules-right = date

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

它定義了一個 bar mybar 並在其中加入了一個模塊 date。

Polybar 默認生成了一個包含很多配置好的模塊的配置文件 /usr/share/doc/polybar/config。

在窗口管理器中運行[編輯 | 編輯原始碼]

創建一個包含啟動邏輯的executable，例如 $HOME/.config/polybar/launch.sh：

#!/bin/bash

# 終止正在運行的 bar 實例
killall -q polybar
# 如果你所有的 bar 都啟用了 ipc，你也可以使用
# polybar-msg cmd quit

# 運行 Polybar，使用默認的配置文件路徑 ~/.config/polybar/config.ini
polybar mybar 2>&1 | tee -a /tmp/polybar.log & disown

echo "Polybar launched..."

這個腳本會在窗口管理器重啟後重新運行 Polybar。

bspwm[編輯 | 編輯原始碼]

如果使用的是 bspwm，將下面內容添加到 bspwmrc：

$HOME/.config/polybar/launch.sh

i3[編輯 | 編輯原始碼]

如果使用的是i3，將下面內容添加到你的 i3 的配置文件：

exec_always --no-startup-id $HOME/.config/polybar/launch.sh

參見[編輯 | 編輯原始碼]

Polybar Github Wiki