Wofi使用教程

上次在介绍 labwc 的时候，wofi 启动器部分没有说明，类似的有 rofi、yofi 等，大同小异。我之前写过一个 yofi 相关的文章，有兴趣的读者可以看看。

wofi 的仓库地址不在 github，在https://hg.sr.ht/~scoopta/wofi，官方描述：

Wofi is a launcher/menu program for wlroots based wayland compositors such as sway

从这个描述中可知，它既可以当一个启动器(launcher)来使用，也当展示菜单(menu)。本文介绍这两个使用模式，整体体验下来，非常满意。

先看示例截图：

启动器：

clipman 的剪切板历史展示(菜单)

不得不说，一个软件多态使用，响应快速，界面美观，没什么毛病，推荐使用。

1. 安装

• 直接 apt 安装(推荐)

  1sudo apt install wofi
  

• 源码编译安装

  源码安装的好处是可以安装最新版本

  1hg clone https://hg.sr.ht/~scoopta/wofi
  2cd wofi
  3meson setup build
  4ninja -C build
  5sudo ninja -C build install
  

2. 启动器配置

可以直接使用我的配置：https://github.com/kmephistoh/dotfiles/tree/main/.config/wofi

工作日每天都在使用，童叟无欺。

 1➜  cat config
 2show=drun
 3width=750
 4height=400
 5always_parse_args=true
 6show_all=false
 7insensitive=true
 8allow_images=true
 9normal_window=true
10allow_markup=true
11prompt= 👍启动快，快启动！就怕你不会用！🤔
12➜  pwd
13/home/mephisto/.config/wofi

值得一提的是 allow_images=true 意为开启图标展示，allow 和 images 之间为下划线，我一开始看文档用连字符，没有生效。翻看源码才确认是下划线才行，貌似双单词的参数都是要用下划线。其它的参数都很简单，无需介绍。

style.css 就是 css 文件，控制界面的显示模样，css 高手可以尽情发挥了，哪里不喜欢改哪里。

再看你使用过的什么桌面环境，给配置个触发键，以前用 Gnome 现在用 labwc，配置起来都很方便。

labwc 配置示例，按 F8 弹出 wofi 启动器

1<keybind key="F8">
2    <action name="Execute" command="wofi" />
3</keybind>

3. 剪切板菜单配置

这部分比较复杂，需要三个软件配合，才能完成工作，我测试 Gnome 下无法工作(Mutter 的锅)。

三个软件分别为：

• wl-clipboard wayland 下的剪切板工具，可以直接 apt 安装，或者点链接看下文档，这里不在赘述。

• clipman wayland 下的剪切板管理器，也可以直接 apt 安装，需要用到其中的 clipboard history 功能。

• wofi 此时用于 clipboard history 查询和选择

核心配置点：

• 1）设置开机启动

1# clipman
2wl-paste -t text --watch clipman store > /dev/null 2>&1 &

意思是每次 wl-paste 的内容有变化的话，都给存到 clipman 中

• 2）设置 wofi 为 clipman 的选择器

1clipman pick --tool wofi -T'--prompt=clipboard-history -i'

单引号内的为 wofi 的参数，分别为提示短语和忽略大小写。配置完成后可以直接运行测试下，看看是否能弹出菜单。

• 3）配置快捷键 在 labwc 中的示例：

1<keybind key="C-semicolon">
2    <action name="Execute" command="clipman pick --tool wofi -T'--prompt=clipboard-history -i'" />
3</keybind>

意思为按 Ctrl+; 弹出剪切板历史记录菜单，同 Fcitx5 的默认快捷键设置(决定使用 wofi+clipman 接管剪切板的话，需要关闭在 Fcitx5 的剪切板功能)。

Gnome 下，我记得以前没有设置成功(mutter 的原因)，因为我已经切换到 labwc 了，有兴趣的读者可以自己动手试试。

key="C-semicolon" 这个按键名怎么得来的呢？请查看这个openbox 的文档，就是在运行 xev 命令，再按 ; 号看对应叫什么名字，openbox 真是特立独行啊，labwc 使用的 openbox 那一套配置。

其它常见对应关系：

• S Shift key
• C Control key
• A Alt key
• W Super key (Usually bound to the Windows key on keyboards which have one)
• M Meta key
• H Hyper key (If it is bound to something)

最后，当你选中目标条后，需要按 Ctrl+v 才能复制到目标上去，这一点多少有点不方便，但是 Fcitx5 和 copyq 等软件也不是每次都能正确粘贴上。考虑到 wofi 的颜值，目前没有遇到粘贴不上的情况，所以勉强可以接受，毕竟读取剪切历史也不是特别高频的操作。当然，如果后续能设置为自动粘贴，并能使用 vi 的快捷键移动和删除，那就算完美啦。