7 个版本 (4 个重大更改)
0.4.0 | 2024年1月4日 |
---|---|
0.3.0 | 2023年11月20日 |
0.2.0 | 2023年9月29日 |
0.1.0 | 2023年9月18日 |
0.0.5 | 2023年2月28日 |
#931 in 命令行工具
每月下载 32 次
8.5MB
291 行
raffi - YAML 配置文件上的 fuzel 启动器
(此使用我的 fuzel 配置,见下文)
描述
raffi 是 fuzel 的启动器,它使用 YAML 配置文件来定义要执行的命令。
安装
二进制文件
转到 发布页面 并获取针对您平台的存档或软件包。
请确保您已安装 fuzzel
Homebrew
brew tap chmouel/raffi https://github.com/chmouel/raffi
brew install raffi
Crates.io
cargo install raffi
Arch
使用您喜欢的 aurhelper,例如 yay
yay -S raffi-bin
使用
您可以直接运行它,它将执行配置中定义的二进制文件和参数。
使用选项 -/-print-only
,它将只打印要执行的命令。
您可以使用选项 -/--configfile
指定自定义配置文件。
图标路径将自动在您的系统上搜索并缓存,如果需要刷新缓存,可以使用选项 -/--refresh-cache
。
Sway
以下是如何与 Sway 一起使用此工具的示例
// set a variable that can be easily used later in the config file
// those variables are optionals
set $menu raffi -p
// Mod4 is the Super key for me but use whatever you want.
set $super Mod4
// will bind the super+space key to launch the launcher
bindsym $super+Space exec $menu|xargs swaymsg exec --
配置
Fuzzel
首先,您可能想通过配置文件 ~/.config/fuzzel/fuzzel.ini
来配置您的 fuzel 外观和行为,请参阅这里的手册页面。我的配置
dpi-aware=yes
font=RobotoMonoNerdFont-Thin:size=16
terminal=kitty
width=50
layer=overlay
exit-on-keyboard-focus-loss=no
inner-pad=15
fields=filename,name
[colors]
background=282a36ff
text=f8f8f2ff
match=8be9fdff
selection-match=8be9fdff
selection=44475add
selection-text=f8f8f2ff
border=bd93f9ff
Raffi
Raffi 配置文件位于 $HOME/.config/raffi/raffi.yaml
,其结构如下
firefox:
binary: firefox
args: [--marionette]
icon: firefox
description: Firefox browser with marionette enabled
- binary:要执行的二进制文件(如果不在 PATH 中,将跳过)
- description:在启动器中显示的描述
- args:要作为数组传递给二进制文件的参数,例如:
[foo, bar]
(可选) - 图标:在启动器中显示的图标,如果没有指定,将尝试使用二进制名称(可选)。图标将在 /usr/share/icons、/usr/share/pixmaps、$HOME/.local/share/icons 或 $XDG_DATA_HOME(如果设置且与图标名称匹配)中搜索。您也可以指定完整的路径。
条件
有一些对条件的最小支持,以便您在满足条件的情况下运行命令。它们都是可选的,并且不能组合使用。
ifexist:如果 PATH 或完整路径中存在文件,则显示条目 ifenvset:如果设置了环境变量,则显示条目 ifenvnotset:如果环境变量未设置,则显示条目 ifenveq:如果环境变量等于指定的值,则显示条目,例如
ifenvset: [FOO, bar]
仅当环境变量 FOO 设置且其值为 bar 时才显示条目。
示例
请参阅位于 examples/raffi.yaml 的完整示例。
版权
作者
- Chmouel Boudjnah https://github.com/chmouel
- Fediverse - <@[email protected]>
- Twitter - <@chmouel>
- 博客 - <https://blog.chmouel.com>
依赖项
~4–14MB
~180K SLoC