4
4
5
5
.. is a minimalistic menu for Wayland-based compositors.
6
6
7
- ** The project still in the early development stage, use with caution. **
7
+ ## Installation
8
8
9
- ## Configuring
9
+ Make sure you have a setup wayland environment, in particularly ` WAYLAND_DISPLAY `
10
+ env var must be set. ` wlr_layer_shell ` protocol is not necessary but preferred.
11
+ There are several installation options:
10
12
11
- Sample configuration:
13
+ - Pre-built release binaries are published at the [ Release page] ( https://github.com/l4l/yofi/releases ) .
14
+ Although these are built in Ubuntu environment it should also work for other Linux distributions.
15
+ - \[ for Archlinux\] there are [ yofi-bin] ( https://aur.archlinux.org/packages/yofi-bin/ ) and
16
+ [ yofi-git] ( https://aur.archlinux.org/packages/yofi-git/ ) AUR packages for binary and from-source builds.
17
+ - Or you can [ build from sources] ( #running ) .
12
18
13
- ``` toml
14
- # This file should be placed at ~/.config/yofi/yofi.config
19
+ # User documentation
15
20
16
- # ~~Global values, used as fallback if needed
17
- width = 400
18
- height = 512
19
- # If set forces usage of common window instead of Layer Shell protocol
20
- force_window = false
21
- # if unset, places window at the center
22
- # window_offsets = [500, -50] # in format [top_offset, left_offset]
23
- # font = "DejaVu Sans"
24
- font_size = 24
25
- bg_color = 0x272822ee # ~~colors are specified in 0xRRGGBBAA format
26
- # font_color = 0xf8f8f2ff
27
- # HiDPI scaling factor; default is requested from compositor but
28
- # fractional values are truncated, thus need to set it explicitly.
29
- scale = 3
21
+ User documentation is located at [ Wiki pages] ( https://github.com/l4l/yofi/wiki ) .
22
+ Feel free to [ open an issue] ( https://github.com/l4l/yofi/issues/new ) if something
23
+ is unclear, missing or outdated.
30
24
31
- # ~~Block for input field
32
- [input_text ]
33
- # font = ...
34
- font_color = 0xf8f8f2ff
35
- bg_color = 0x75715eff
36
- # Margin/padding values are specified as in CSS
37
- # i.e. either a signle for all directions
38
- # or two values, the first for top/bottom and the second for left/right
39
- # or finally four values for top, right, bottom and left directions.
40
- margin = " 5"
41
- padding = " 1.7 -4"
42
-
43
- # ~~Block for a list with search results
44
- [list_items ]
45
- # font = ...
46
- font_color = 0xf8f8f2ff
47
- selected_font_color = 0xa6e22eff
48
- # if specified, search match will be emphasize with this color
49
- match_color = 0xe69f66ff
50
- margin = " 5 10"
51
- # Additional spacing between list items.
52
- # By default there's around 10 pixels spaced,
53
- # the amount can be reduced by specifying a negative value
54
- item_spacing = 2
55
- # Spacing between an icon and a text.
56
- icon_spacing = 5
57
-
58
- # When section presents, icons are displayed
59
- [icon ]
60
- size = 16 # no scaling is performed, so need to choose exact size
61
- theme = " Adwaita"
62
- # if no icon found for an app, this on will be used instead
63
- fallback_icon_path = " /usr/share/icons/Adwaita/16x16/categories/applications-engineering-symbolic.symbolic.png"
64
- ```
65
-
66
- ## Running
25
+ ## Building
67
26
68
27
For building the project you need rust compiler and cargo package manager
69
28
(usually distributed via [ rustup] ( https://rustup.rs/ ) ). Once installed, for
@@ -73,15 +32,11 @@ launch, you may build & run project with the following command:
73
32
cargo run --release
74
33
```
75
34
76
- ## Hotkeys
35
+ ## Contributing
77
36
78
- These cannot be configured yet, so the following keys are handled :
37
+ Contributions are welcome, but make sure that :
79
38
80
- | Key | Alternative | Binding |
81
- | ---------------------| ------------------------| ----------------------------------------------|
82
- | Esc | Ctrl + c | Close menu |
83
- | Up Arrow | Ctrl + k / Shift + Tab | Select previous item |
84
- | Down Arrow | Ctrl + j / Tab | Select next item |
85
- | Return | N/A | Execute selected item |
86
- | Ctrl + ] | N/A | Clear input |
87
- | Ctrl + w | Ctrl + backspace | Delete single word |
39
+ - \[ If that's a new feature or it changes the existing behavior\] you've discussed it in the issue page before the implementation.
40
+ - Your patch is not a refactoring.
41
+ - rustfmt and clippy are checked.
42
+ - \[ optionally\] Added docs if necessary and an entry in CHANGELOG.md.
0 commit comments