Polybar - Arch Linux 中文维基

跳至內容

# Polybar

出自 Arch Linux 中文维基
翻譯狀態：

- 本文（或部分內容）譯自 Polybar，最近一次同步於 2022-07-10，若英文版本有所更改，則您可以幫助同步與翻譯更改的內容。
- 您可以在 ArchWiki 的對應頁面找到本文翻譯的原始修訂歷史。
- 本文可能與英文原文存在出入。

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

## 安裝

安裝 polybar包 包，或者安裝它的開發版本 polybar-gitAUR。

## 配置

將配置文件樣例 `/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

分類：​

- 小提升

Polybar
新增話題