#配置文件 #启动 #命令 #任务

应用 raffi

基于 YAML 文件的简单 fuzel 启动器

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 次

Apache-2.0

8.5MB
291

raffi - YAML 配置文件上的 fuzel 启动器

image

(此使用我的 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 的完整示例。

Apache-2.0

作者

依赖项

~4–14MB
~180K SLoC