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 的快捷鍵移動和刪除，那就算完美啦。