Polybar (简体中文) - ArchWiki

Jump to content
翻译状态：本文是 Polybar 的翻译。上次翻译日期：2022-07-10。如果英文版本有所更改，则您可以帮助同步翻译。

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

Category:

- Eye candy (简体中文)