107 lines
3.5 KiB
Markdown
107 lines
3.5 KiB
Markdown
# Worf - Wayland Optimized Run Facilitator
|
|
|
|
Worf is yet another style launcher, heavily inspired by wofi, rofi and walker.
|
|
Worf is written in Rust on top of GTK4.
|
|
|
|
It started out as a drop in replacement for wofi, so styles and config in most part (should) be compatible,
|
|
with a few exception documented below.
|
|
Worf has more features than wofi though, so there won't be 100% compatibility.
|
|
|
|
**While the main branch in general is stable and I am using this on a daily basis, it is not ready yet
|
|
to be used as a library, a lot of things are still moving around.**
|
|
|
|
It supports various modes:
|
|
* Math
|
|
* DRun
|
|
* File
|
|
* Ssh
|
|
* Run
|
|
* Emoji
|
|
* // WebSearch
|
|
* Auto
|
|
|
|
Auto mode tries to detect the desired mode automatically, to achieve this some modes require a prefix in the search.
|
|
The standard view will show `ssh` and `drun`, for other modes the following prefixes are available:
|
|
* `ssh` (optional)
|
|
* `?` web search
|
|
* `/`, `$` or `~` for files
|
|
* `emoji` for emojis
|
|
|
|
<img src="images/demo.gif">
|
|
|
|
## Not finished
|
|
* [ ] key support
|
|
* [ ] full config support
|
|
* [ ] web search mode
|
|
* [ ] publish library
|
|
|
|
|
|
## Additional functionality compared to Wofi
|
|
* Support passing 'hidden' parameters that are not visible in the launcher but will be returned to the application
|
|
* Window switcher for hyprland
|
|
* All arguments expect show are supported by config and args
|
|
|
|
### New config / command line options
|
|
* fuzzy-length: Defines how long a string must be to be considered for fuzzy match
|
|
* row-box-orientation: Allows aligning values vertically to place the label below the icon
|
|
|
|
### New Styling options
|
|
|
|
## Styling
|
|
|
|
Styling names and classes are inspired by wofi, so most of the documentation and styling is the same
|
|
|
|
### Selectors
|
|
|
|
|name|description|
|
|
window|Entire main window|
|
|
|outer-box|A box that everything else sits inside of|
|
|
|input|Text box for filtering items|
|
|
|scroll|Scroll window containing inner-box|
|
|
|inner-box|Box containing the menu entries|
|
|
|entry|Box containing the text and optionally the image of an entry|
|
|
|text|Name of the program/option inserted|
|
|
|img|Images displayed in entries|
|
|
|row|The row containing the entry, i.e. used to control hover effects|
|
|
|
|
Checkout more showcases in the styles directory of this repo.
|
|
|
|
|
|
|
|
|
|
## Setup
|
|
|
|
### Hyprland
|
|
|
|
Allow blur for Worf
|
|
```
|
|
layerrule = blur, worf
|
|
```
|
|
|
|
|
|
## Library
|
|
|
|
The launcher and UI can be used to build any launcher, as the ui, config and run logic is available as a separate crate.
|
|
This library is not available publicly yet as the interface is not stable enough.
|
|
|
|
## Wofi compatibility
|
|
|
|
### Breaking changes
|
|
* Runtime behaviour is not guaranteed to be the same and won't ever be, this includes error messages and themes.
|
|
* Themes in general are mostly compatible. Worf is using the same entity ids,
|
|
because worf is build on GTK4 instead of GTK3 there will be differences in the look and feel.
|
|
* Configuration files are not 100% compatible, Worf is using toml files instead, for most part this only means strings have to be quoted
|
|
* Color files are not supported
|
|
* `line_wrap` is now called `line-wrap`
|
|
* Wofi has a C-API, that is not and won't be supported, but Worf can be used as a rust library.
|
|
|
|
### Dropped arguments / config values
|
|
* `mode`, use show
|
|
* `dmenu`, use show
|
|
* `D`, arguments are the same as config in worf, no need to have this flag.
|
|
* `dark`, dark setting from theme is used now.
|
|
* `filter-rate`, worf is fast enough not to need this debounce
|
|
|
|
### Dropped configuration options
|
|
* stylesheet -> use style instead
|
|
* color / colors -> GTK4 does not support color files
|