Skip to content

Commit 556ab18

Browse files
authored
Update README.md
1 parent 7245024 commit 556ab18

File tree

1 file changed

+20
-65
lines changed

1 file changed

+20
-65
lines changed

README.md

Lines changed: 20 additions & 65 deletions
Original file line numberDiff line numberDiff line change
@@ -4,66 +4,25 @@
44

55
.. is a minimalistic menu for Wayland-based compositors.
66

7-
**The project still in the early development stage, use with caution.**
7+
## Installation
88

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:
1012

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).
1218

13-
```toml
14-
# This file should be placed at ~/.config/yofi/yofi.config
19+
# User documentation
1520

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.
3024

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
6726

6827
For building the project you need rust compiler and cargo package manager
6928
(usually distributed via [rustup](https://rustup.rs/)). Once installed, for
@@ -73,15 +32,11 @@ launch, you may build & run project with the following command:
7332
cargo run --release
7433
```
7534

76-
## Hotkeys
35+
## Contributing
7736

78-
These cannot be configured yet, so the following keys are handled:
37+
Contributions are welcome, but make sure that:
7938

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

Comments
 (0)