Hypr Ecosystem: reword/revamp

This commit is contained in:
Mihai Fufezan 2024-07-30 23:44:45 +03:00
parent ea9d39dbf0
commit 14503e7771
2 changed files with 28 additions and 23 deletions

View file

@ -7,14 +7,15 @@ over the widely used xcursor.
## Hyprcursor themes ## Hyprcursor themes
You will need to obtain those yourself. If you are on the Discord server, see `#hyprcursor-themes`. You will need to obtain those yourself. If you are on the Discord server, see
`#hyprcursor-themes`.
Put your theme(s) in `~/.local/share/icons` or `~/.icons` Put your theme(s) in `~/.local/share/icons` or `~/.icons`
{{< callout type=warning >}} {{< callout type=warning >}}
It's not recommended to put cursor themes in system-wide `/usr/share/icons` due to It's not recommended to put cursor themes in system-wide `/usr/share/icons` due
potential permission issues. to potential permission issues.
{{< /callout >}} {{< /callout >}}
@ -39,19 +40,22 @@ See the `docs/` and `hyprcursor-util/` directories for instructions.
## Important notes ## Important notes
Although many apps support server-side cursors (e.g. qt, chromium, electron, hypr ecosystem) Although many apps support server-side cursors (e.g. Qt, Chromium, Electron,
some apps still don't (like gtk) Hypr Ecosystem) some apps still don't (e.g. GTK).
Apps that do not support server-side cursors and hyprcursor will still fall back to XCursor. Apps that do not support server-side cursors and hyprcursor will still fall back
to XCursor.
For those apps, you need to export `XCURSOR_THEME` and `XCURSOR_SIZE` to a valid XCursor theme, For those apps, you need to export `XCURSOR_THEME` and `XCURSOR_SIZE` to a valid
and run `gsettings set org.gnome.desktop.interface cursor-theme 'THEME_NAME'` for gtk. XCursor theme, and run `gsettings set org.gnome.desktop.interface cursor-theme
If `gsettings` schemas are not available to you (e.g. on NixOS you will get `No schemas installed`), you can run instead: 'THEME_NAME'` for gtk. If `gsettings` schemas are not available to you (e.g. on
`dconf write /org/gnome/desktop/interface/cursor-theme "'THEME_NAME'"`. NixOS you will get `No schemas installed`), you can run instead: `dconf write
/org/gnome/desktop/interface/cursor-theme "'THEME_NAME'"`.
If the app is a flatpak, run `flatpak override --filesystem=~/.themes:ro --filesystem=~/.icons:ro --user` and put If the app is a flatpak, run `flatpak override --filesystem=~/.themes:ro
your themes in both `/usr/share/themes` and `~/.themes`, and put your --filesystem=~/.icons:ro --user` and put your themes in both `/usr/share/themes`
icons and XCursors in both `/usr/share/icons` and `~/.icons`. and `~/.themes`, and put your icons and XCursors in both `/usr/share/icons`
and `~/.icons`.
## I don't want to use hyprcursor ## I don't want to use hyprcursor

View file

@ -15,33 +15,34 @@ the `wallpaper` keyword is used to apply the preloaded image to your monitor(s):
```ini ```ini
preload = /home/me/amongus.png preload = /home/me/amongus.png
wallpaper = monitor,/home/me/amongus.png wallpaper = monitor, /home/me/amongus.png
``` ```
`monitor` can be left empty to set to all monitors without a set wallpaper: `monitor` can be left empty to set to all monitors without a set wallpaper:
``` ```ini
wallpaper = ,/home/me/amongus.png wallpaper = , /home/me/amongus.png
``` ```
Monitor names can be checked with `hyprctl monitors` Monitor names can be checked with `hyprctl monitors`
Also can be used with `desc:` followed by the monitor's description without the (PORT) at the end Also can be used with `desc:` followed by the monitor's description without the (PORT) at the end
You may add `contain:` before the file path in `wallpaper=` to set the mode to contain instead of cover: You may add `contain:` before the file path in `wallpaper =` to set the mode to contain instead of cover:
``` ```ini
wallpaper = monitor,contain:/home/me/amongus.png wallpaper = monitor, contain:/home/me/amongus.png
``` ```
You can use `unload` to unload preloaded images. You can also specify `unload all` You can use `unload` to unload preloaded images. You can also specify `unload all`
to unload all images or `unload unused` to unload images that aren't being used. to unload all images or `unload unused` to unload images that aren't being used.
Also you can use `reload` to unload preloaded image from your monitor(s), Also you can use `reload` to unload preloaded image from your monitor(s),
preload another and set it to your monitor(s). It has the same syntax as `wallpaper` keyword. preload another and set it to your monitor(s). It has the same syntax as
`wallpaper` keyword.
To run hyprpaper at startup edit `hyprland.conf` and add: To run hyprpaper at startup edit `hyprland.conf` and add: `exec-once =
`exec-once = hyprpaper`. hyprpaper`.
### Misc options ### Misc options