除了 {app_icon}、{indent}、{urgency_start} 和 {urgency_end} 之外，可以根据需要提供格式字符串，该字符串由 Rust 的 std::fmt 指定。语法是 {<占位符>:<fmt_str><clipped_str>}。例如，{app_name:{:>10.10}} 表示应用程序名称将打印出正好10个字符。如果它更短，则将右对齐（使用 >）并用空格填充，如果它更长，则将在第10个字符后截断。另一个例子，{app_name:{:.10}...} 表示应用程序名称将在第10个字符处截断。如果它更短，则将按原样打印（不带填充），如果它更长，则将在第10个字符后截断，并将该子字符串的最后3个字符替换为 ...（《<clipped_str>）。

在选择（使用 wofi 或其他菜单程序）期间，每个窗口都应该有一个不同的显示字符串，这是非常重要的。因此，强烈建议至少在 container_format 和 window_format 中包含 {id} 占位符。否则，例如，同一工作空间上的两个垂直分割或两个终端（同一终端应用程序的终端）具有相同的当前工作目录（因此，相同的标题），将无法区分。

关于 wofi 的提示：wofi 支持使用 'img:<image-file>:text:<text>' 语法添加图标，因此具有应用程序图标的合适 window_format 应以 img:{app_icon}:text: 开头。

rofi 提示： rofi 支持使用以下语法添加图标："<text>\u0000icon\u001f<image-file>"，因此，带有应用程序图标的合适 window_format 应以 "\u0000icon\u001f{app_icon}" 结尾。此外，请注意，您必须用双引号而不是单引号括起您的 window_format 值。在 TOML 中，单引号字符串是字面字符串，不处理转义序列，而双引号字符串（所谓的基本字符串）则处理转义序列。 rofi 需要一个空字符和一个段落分隔符来处理图像序列。

fuzzel 提示：据我所知，fuzzel 支持与上面讨论的 rofi 相同的图标语法。

布局部分

在 [layout] 部分中，您可以通过将 auto_tile 设置为 true（默认为 false）来启用自动平铺。选项 auto_tile_min_window_width_per_output_width 定义了每个输出宽度的最小宽度（以像素为单位）。例如，上面的示例设置表示在一个1600像素宽的输出上，每个窗口至少应有780像素的宽度，因此最多可以有两个并排窗口（注意，包括您的边框和间隙在计算中！）。如果没有包含输出确切宽度的自动平铺，则不会进行自动平铺。

如果启用了 auto_tile，swayr 将根据此算法自动垂直或水平分割

• 对于所有输出
  • 对于该输出上所有（嵌套）容器（除了临时便笺）
    • 对于该容器的所有子窗口
      • 如果容器水平分割，并且创建另一个窗口会使当前子窗口小于最小宽度，则在子窗口上执行 split vertical（通过 IPC 的 swaymsg 命令）。
      • 否则，如果容器垂直分割，并且现在有足够的空间，创建另一个窗口仍然可以使当前子窗口的宽度等于或大于最小宽度，则在子窗口上调用 split horizontal。
      • 否则，对此容器不执行任何操作。这意味着堆叠或标签式容器永远不会受自动平铺的影响。

有一个需要注意的问题：当窗口或容器大小调整时，也很有必要触发自动平铺，但不幸的是，大小调整不会在 IPC 中发出任何事件。因此，自动平铺是通过新窗口事件、关闭事件、移动事件、浮动事件以及焦点事件触发的。后者是作为解决方案，如果存在大小调整事件，则不需要这些。

焦点部分

在 [focus] 部分中，您可以配置窗口保持焦点的时间，以便影响 LRU 顺序，即 lockin_delay（以毫秒为单位）。如果一个窗口只是短暂地被聚焦，例如，当 sway 的 focus_follows_mouse 设置为 yes 或 always 时，鼠标移到另一个窗口上，那么其位置在 LRU 顺序中不会发生变化。

杂项部分

在 [misc] 节中，有 auto_nop_delay 选项。当执行某些 swayr 命令时，会等待一定毫秒数，然后执行 nop 命令（参见 命令文档），以跳出 next-*-窗口/prev-*-窗口 序列或 switch-to-*或-urgent--或-lru-窗口 循环。如果在指定时间内执行了另一个 swayr 命令，则自动 nop 执行将被延迟另一个 auto_nop_delay 毫秒。如果没有明确指定此选项，则不会执行任何自动 nop 命令。

在 用法 部分的末尾讨论了一个更优雅的解决方案，使用键释放绑定。然而，这需要一个尚未合并到 sway 中的 PR。

seq_inhibit 布尔值控制 swayrd 在执行一系列 窗口循环命令 时的行为。

• 当设置值为 true 时，swayrd 将在窗口循环命令序列进行时阻止更新窗口 LRU 排序。序列结束时重新激活 LRU 更新。当一个非窗口循环命令被 swayrd 接收到时（例如一个 nop 命令），则认为序列已结束。

  注意：LRU 更新抑制也适用于在 swayr 外部进行的焦点更改，例如直接使用 sway 命令。

• 当设置值为 false（默认值）时，swayrd 将以相同的方式处理焦点事件，无论窗口循环序列是否正在进行。

注意，键释放绑定解决方案适用于使用 seq_inhibit=true。

swaymsg_commands 节

本节配置 execute-swaymsg-command 命令。

• 选项 include_predefined 定义是否应包含 swayr 提供了很长时间的默认 swaymsg 命令。
• commands 映射定义了您的自定义命令作为 label = command 对。由于它是一个映射，因此标签（键）必须是唯一的。

从 0.8.0 版本开始，我开始编写一个 新闻 文件，列出新闻、swayr 命令或配置选项的更改。如果在更新后某些事情似乎没有按预期工作，请查阅此文件以检查是否进行了某些（可能是不兼容的）更改，需要更新您的配置。

swayrbar 是 sway 的 swaybar 的状态命令，实现了 swaybar-protocol(7)。这意味着，您可以在 ~/.config/sway/config 中这样设置您的 swaybar：

bar {
    swaybar_command swaybar
    # Use swayrbar as status command with some logging output which
    # is redirected to /tmp/swayrbar.log.  Be sure to only redirect
    # stderr because the swaybar protocol requires the status_command
    # to emit JSON to stdout which swaybar reads.
    status_command env RUST_BACKTRACE=1 RUST_LOG=swayr=debug swayrbar 2> /tmp/swayrbar.log
    position top
    font pango:Iosevka 11
    height 20

    colors {
        statusline #f8c500
        background #33333390
    }
}

swayrbar 类似于 waybar，由一系列模块组成，您可以通过其配置文件启用和配置这些模块，无论是通过命令行选项 --config-file 指定，还是使用用户特定（~/.config/swayrbar/config.toml），或全局（/etc/xdg/swayrbar/config.toml）。模块会发出信息，然后 swaybar 显示这些信息，并在 swaybar 中的模块空间上点击鼠标会将点击事件传播回去并触发某些动作（例如，shell 命令）。

目前，有以下模块

1. window 模块可以显示 sway 中当前窗口的标题和应用程序名称。
2. sysinfo 模块可以显示 CPU/内存利用率或系统负载等信息。
3. battery 模块可以显示当前 充电状态、状态（例如，正在充电）和 健康状态。
4. date 模块可以显示当前的日期和时间！
5. pactl 模块可以显示当前音量百分比和静音状态。点击可以增加/减少音量或切换静音状态。
6. nmcli 模块使用 NetworkManager 的 nmcli 命令行工具显示当前连接的 Wi-Fi 和其信号强度。
7. iwctl 模块使用 iwctl 命令行工具显示当前连接的 Wi-Fi 和其信号强度。

我相信随着时间的推移，会有更多的模块出现。补丁 当然非常受欢迎！

一些发行版有 swayrbar 软件包，您可以使用发行版的包管理器进行安装，有关详细信息，请参阅 repology 网站。或者，使用 cargo 构建和安装它也很简单。

通过 Cargo 安装

您需要使用官方rust安装页面上的单行命令安装当前稳定的rust工具链。

然后您可以像这样安装 swayrbar

cargo install swayrbar

为了轻松获取更新，我推荐 cargo install-update 插件。

# Install it once.
cargo install install-update

# Then you can update all installed rust binary crates including swayr using:
cargo install-update --all

# If you only want to update swayr, you can do so using:
cargo install-update -- swayrbar

当 swayrbar 首次运行时，如果在 ~/.config/swayrbar/config.toml（用户特定）或 /etc/xdg/swayrbar/config.toml（系统全局）找不到现有配置文件，它将创建一个新的用户特定配置文件，其中所有模块都已启用，并使用一些合理的默认值（根据作者）进行设置。根据您的需要进行调整。

配置文件的语法是 TOML。以下是一个包含所有顶级选项（一个！）和一个模块的简短示例。

refresh_interval = 1000

[[modules]]
name = 'window'
instance = '0'
format = '🪟 {title} — {app_name}'
html_escape = false

[modules.on_click]
Left = ['swayr', 'switch-to-urgent-or-lru-window']
Right = ['kill', '{pid}']

refresh_interval 定义了 swaybar 刷新之间的毫秒数。

配置文件的其余部分定义了一个模块列表及其配置（在 TOML 中是一个 表格数组，其中包含模块的 on_click）。

• name 是模块的名称或类型，例如 window、sysinfo、battery、date、...。
• instance 是一个用于区分同名模块的任意字符串。例如，你可能想要有两个 sysinfo 模块，一个用于 CPU 利用率，另一个用于内存利用率，只是为了在这些不同类型的信息之间有一个分隔符。这很容易实现，只需给它们不同的 instance 值即可。
• format 是在 swaybar 中打印的字符串，其中某些占位符被模块特定的值替换。通常，这样的占位符写成 {title} 的形式，即在花括号内。就像在 swayr 一样，格式化（填充、对齐、精度等）是可用的，请参阅 此处。
• html_escape 定义是否应将 <、> 和 & 转义为 <、> 和 &，因为 format 可能包含 pango 标记。显然，如果你使用此功能，你想要将该模块的 html_escape = true 设置为 true。此选项是可选的，可以省略。
• on_click 是一个表格，定义了在 swaybar 中点击模块空间时要执行的操作。这里也提供了所有在 format 中可用的占位符。每个鼠标按钮的动作指定为一个数组 ['command', 'arg1', 'arg2',...]。可分配的按钮名称有 Left、Middle、Right、WheelUp、WheelDown、WheelLeft 和 WheelRight。

on_click = { Left = ['swayr', 'switch-to-urgent-or-lru-window'], Right = ['kill', '{pid}'] }