• w:<workspace>：切换到可能不存在的工作区。 <workspace> 必须是一个数字、一个名称或 <digit>:<name> 格式。该格式在 man 5 sway 中解释。如果提供了该格式，swayr 将使用 workspace number <digit>:<name> 创建工作区。如果只提供一个数字或名称，则不使用 number 参数。
• s:<cmd>：使用 swaymsg 执行 sway 命令 <cmd>。
• 任何其他输入都假定为工作区名称，因此按 w:<input> 处理。

这些命令按最近使用顺序循环（窗口的子集）。

• next-window (all-workspaces|current-workspace) 和 prev-window (all-workspaces|current-workspace) 在树的最深优先迭代顺序中聚焦下一个/前一个窗口。参数 all-workspaces 或 current-workspace 定义是否考虑所有工作区的所有窗口或仅当前工作区的窗口。
• next-tiled-window 和 prev-tiled-window 的功能与 next-window 和 prev-window 相同，但仅切换包含在平铺容器中的窗口。
• next-tabbed-or-stacked-window 和 prev-tabbed-or-stacked-window 的功能与 next-window 和 prev-window 相同，但仅切换包含在标签或堆叠容器中的窗口。
• next-floating-window 和 prev-floating-window 的功能与 next-window 和 prev-window 相同，但仅切换浮动窗口。
• next-window-of-same-layout 和 prev-window-of-same-layout 的功能类似于 next-floating-window 或 prev-floating-window，如果当前窗口是浮动的；如果当前窗口在标签或堆叠容器中，则类似于 next-tabbed-or-stacked-window 或 prev-tabbed-or-stacked-window；如果当前窗口在平铺容器中，则类似于 next-tiled-window 或 prev-tiled-window；如果不是以上情况，则类似于 next-window 或 prev-window。
• next-matching-window 和 prev-matching-window 都需要一个 查询标准。

• get-windows-as-json 返回一个包含所有窗口的 JSON，如果提供了 --include-scratchpad，则可能包括便签窗口。此外，可以使用 --matching <CRITERIA> 来限制窗口到符合给定查询条件的窗口（见 条件部分）。最后，如果提供了 --error-if-no-match 且不存在窗口或窗口不符合给定的查询条件，则命令以非零退出而不是打印 JSON 数组。这使得它适合用于 shell 脚本。基本上，swayr get-windows-as-json --matching <CRITERIA> --error-if-no-match 与 swaymsg <CRITERIA> nop 类似，但它返回 JSON 格式的窗口，并支持 swayr 的扩展条件查询，而不是 sway 支持的简单查询。
• for-each-window <CRITERIA> <SHELL_COMMAND> 对每个符合 <CRITERIA> 的窗口执行 <SHELL_COMMAND>（见 条件部分）。在 <SHELL_COMMAND> 中，几乎所有的占位符都已被替换。例如，swayr for-each-window true echo "应用 {app_name} 的 PID 是 {pid}。" 会显示每个窗口的应用程序名称和 PID。命令的结果是一个包含退出码、标准输出、标准错误和（系统）错误字段的 JSON 数组。如果任何命令返回非零，则 for-each-window 也会返回非零。shell 命令将并行执行，它们必须在 2 秒内完成，否则将被杀死。否则，命令执行会阻塞 swayrd，直到最慢的线程完成，例如，sleep 10 将会阻塞大约 10 秒。

[|| [app_id="firefox" tiling]
    [&& !app_id="firefox" floating workspace=__focused__]]

cargo install swayr

# Install it once.
cargo install cargo-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 -- swayr

exec env RUST_BACKTRACE=1 RUST_LOG=swayr=debug swayrd > /tmp/swayrd.log 2>&1

bindsym $mod+Space       exec swayr switch-window
bindsym $mod+Delete      exec swayr quit-window
bindsym $mod+Tab         exec swayr switch-to-urgent-or-lru-window
bindsym $mod+Next        exec swayr next-window all-workspaces
bindsym $mod+Prior       exec swayr prev-window all-workspaces
bindsym $mod+Shift+Space exec swayr switch-workspace-or-window
bindsym $mod+c           exec swayr execute-swaymsg-command
bindsym $mod+Shift+c     exec swayr execute-swayr-command

bindsym --release Super_L exec swayr nop

[menu]
executable = 'wofi'
args = [
    '--show=dmenu',
    '--allow-markup',
    '--allow-images',
    '--insensitive',
    '--cache-file=/dev/null',
    '--parse-search',
    '--height=40%',
    '--prompt={prompt}',
]

[format]
output_format = '{indent}<b>Output {name}</b>    <span alpha=\"20000\">({id})</span>'
workspace_format = '{indent}<b>Workspace {name} [{layout}]</b>    <span alpha="20000">({id})</span>'
container_format = '{indent}<b>Container [{layout}]</b> on workspace {workspace_name} <i>{marks}</i>    <span alpha="20000">({id})</span>'
window_format = 'img:{app_icon}:text:{indent}<i>{app_name}</i> — {urgency_start}<b>“{title}”</b>{urgency_end} on workspace {workspace_name} <i>{marks}</i>    <span alpha="20000">({id})</span>'
indent = '    '
urgency_start = '<span background="darkred" foreground="yellow">'
urgency_end = '</span>'
html_escape = true
icon_dirs = [
    '/usr/share/icons/hicolor/scalable/apps',
    '/usr/share/icons/hicolor/64x64/apps',
    '/usr/share/icons/hicolor/48x48/apps',
    '/usr/share/icons/Adwaita/64x64/apps',
    '/usr/share/icons/Adwaita/48x48/apps',
    '/usr/share/pixmaps',
]

[layout]
auto_tile = false
auto_tile_min_window_width_per_output_width = [
    [1024, 500],
    [1280, 600],
    [1400, 680],
    [1440, 700],
    [1600, 780],
    [1920, 920],
    [2560, 1000],
    [3440, 1000],
    [4096, 1200],
]

[focus]
lockin_delay = 750

[misc]
auto_nop_delay = 3000
seq_inhibit = false

[swaymsg_commands]
include_predefined = true
[swaymsg_commands.commands]
"Window to workspace XXX" = "move window to workspace XXX"
"Workspace to left output" = "move workspace to output left"
"Workspace to right output" = "move workspace to output right"

除了 {app_icon}、{indent}、{urgency_start} 和 {urgency_end}，其他所有内容都可以根据 Rust 的 std::fmt 指定的方式提供一个格式字符串。语法为 {<placeholder>:<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将根据此算法自动垂直或水平分割

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

有一个注意事项：当窗口或容器大小调整时，也很希望同时触发自动平铺，但遗憾的是，调整大小不会通过IPC引发任何事件。因此，自动平铺是由新窗口事件、关闭事件、移动事件、浮动事件和焦点事件触发的。后者是一种变通方法，如果存在调整大小事件，则不需要。

焦点部分

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

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
    }
}

cargo install swayrbar

# 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

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}']

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