hyprwm/hyprland-wiki
1
0
Fork 0
mirror of https://github.com/hyprwm/hyprland-wiki.git synced 2024-11-16 18:15:58 +01:00
Code Issues Projects Releases Packages Wiki Activity

Useful Utilities: reword/revamp

Browse source
This commit is contained in:
Mihai Fufezan 2024-07-31 01:00:24 +03:00
parent 14503e7771
commit c093d71c2d
9 changed files with 94 additions and 109 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
pages/Useful Utilities/App-Launchers.md
View file

@ -5,7 +5,7 @@ title: App launchers
## Wofi ## Wofi
Wofi is a GTK-based customizable launcher for wayland. Wofi is a GTK-based customizable launcher for Wayland.
[SourceHut](https://hg.sr.ht/~scoopta/wofi). [SourceHut](https://hg.sr.ht/~scoopta/wofi).
## Rofi (Wayland fork) ## Rofi (Wayland fork)
@ -19,7 +19,7 @@ bemenu is a Wayland-native replacement for dmenu.
## fuzzel ## fuzzel
Fuzzel is an application launcher for wlroots based Wayland compositors, similar Fuzzel is an application launcher for wlroots-based Wayland compositors, similar
to rofi's `drun` mode. [Codeberg](https://codeberg.org/dnkl/fuzzel) to rofi's `drun` mode. [Codeberg](https://codeberg.org/dnkl/fuzzel)
## tofi ## tofi
@ -29,22 +29,28 @@ replacement for wlroots-based Wayland compositors. When configured correctly,
tofi can get on screen within a single frame. tofi can get on screen within a single frame.
[Github](https://github.com/philj56/tofi) [Github](https://github.com/philj56/tofi)
For a more comprehensive list of launchers, check
[awesome-hyprland](https://github.com/hyprland-community/awesome-hyprland#runners-menus-and-application-launchers).
## Emacs ## Emacs
If you are already running an emacs server you can use Emacs. If you are already running an emacs server you can use Emacs.
For the config you can check out [DistroTube's Configuring Emacs](https://gitlab.com/dwt1/configuring-emacs/-/blob/main/07-the-final-touches/scripts/app-launchers.el?ref_type=heads) or [Sebastian Wae's `app-launcher`](https://github.com/SebastienWae/app-launcher) repositories. For the config you can check out
[DistroTube's Configuring Emacs](https://gitlab.com/dwt1/configuring-emacs/-/blob/main/07-the-final-touches/scripts/app-launchers.el?ref_type=heads)
or [Sebastian Wae's `app-launcher`](https://github.com/SebastienWae/app-launcher)
repositories.
## Anyrun ## Anyrun
Anyrun is a Wayland-native krunner-like runner, made with customizability in Anyrun is a Wayland-native krunner-like runner, made with customizability in
mind. It is modular and extensible through plugins. It can be used as an app launcher with its Applications Plugin. mind. It is modular and extensible through plugins. It can be used as an app
launcher with its Applications Plugin.
[GitHub](https://github.com/anyrun-org/anyrun) [GitHub](https://github.com/anyrun-org/anyrun)
## Walker ## Walker
Walker is an extensible Wayland-native runner with various built-in modules (applications, runner, hyprland windows, websearch [as of 2024-03-15]). It can be run as a service for faster startups. Walker is an extensible Wayland-native runner with various built-in modules
(applications, runner, hyprland windows, websearch [as of 2024-03-15]). It can
be run as a service for faster startups.
[GitHub](https://github.com/abenz1267/walker) [GitHub](https://github.com/abenz1267/walker)
For a more comprehensive list of launchers, check
[awesome-hyprland](https://github.com/hyprland-community/awesome-hyprland#runners-menus-and-application-launchers).

29
pages/Useful Utilities/Clipboard-Managers.md
View file

@ -23,7 +23,10 @@ To fix this problem, you can use `wl-clip-persist` which will preserve the data
in the clipboard after the application is closed. in the clipboard after the application is closed.
[Github](https://github.com/Linus789/wl-clip-persist) [Github](https://github.com/Linus789/wl-clip-persist)
`clipse` - Utilizes Wayland with `wl-clipboard` support and runs from a single binary. Stores text and images indefinitely, accessible via a nice TUI that can be bound to a floating window in your Hyprland config. Allows custom themes, image/text previews, multi-select, pinned items and more. `clipse` - Utilizes Wayland with `wl-clipboard` support and runs from a single
binary. Stores text and images indefinitely, accessible via a nice TUI that can
be bound to a floating window in your Hyprland config. Allows custom themes,
image/text previews, multi-select, pinned items and more.
[GitHub](https://github.com/savedra1/clipse) [GitHub](https://github.com/savedra1/clipse)
## copyq ## copyq
@ -35,22 +38,23 @@ exec-once = copyq --start-server
``` ```
If the main window of `copyq` cannot close/hide properly, try to enable its If the main window of `copyq` cannot close/hide properly, try to enable its
"Hide main window" option in the Layout configuration tab in the Preferences dialog. "Hide main window" option in the Layout configuration tab in the Preferences
dialog.
## cliphist ## cliphist
Start by adding the following lines to your `~/.config/hypr/hyprland.conf` Start by adding the following lines to your `~/.config/hypr/hyprland.conf`
```ini ```ini
exec-once = wl-paste --type text --watch cliphist store #Stores only text data exec-once = wl-paste --type text --watch cliphist store # Stores only text data
exec-once = wl-paste --type image --watch cliphist store #Stores only image data exec-once = wl-paste --type image --watch cliphist store # Stores only image data
``` ```
Note that any of the above lines can be disabled based on your needs. Note that any of the above lines can be disabled based on your needs.
To bind `cliphist` to a hotkey and display it under `rofi` or `dmenu` or `wofi`, To bind `cliphist` to a hotkey and display it under `rofi` or `dmenu` or `wofi`,
you can edit it in `~/.config/hypr/hyprland.conf`. you can edit it in `hyprland.conf`.
### For `rofi` users ### For `rofi` users
@ -76,7 +80,7 @@ For further info, please refer to the repository mentioned above.
## clipman ## clipman
Start by adding the following line to your `~/.config/hypr/hyprland.conf` Start by adding the following line to your `hyprland.conf`
```ini ```ini
exec-once = wl-paste -t text --watch clipman store --no-persist exec-once = wl-paste -t text --watch clipman store --no-persist
@ -115,7 +119,7 @@ mentioned above.
## clipse ## clipse
Start by adding the following line to your `~/.config/hypr/hyprland.conf` Start by adding the following line to your `hyprland.conf`
```ini ```ini
exec-once = clipse -listen exec-once = clipse -listen
@ -124,13 +128,16 @@ exec-once = clipse -listen
You can bind the TUI to a something nice like this: You can bind the TUI to a something nice like this:
```ini ```ini
windowrulev2 = float,class:(clipse) windowrulev2 = float, class:(clipse)
windowrulev2 = size 622 652,class:(clipse) windowrulev2 = size 622 652, class:(clipse)
bind = SUPER, V, exec, alacritty --class clipse -e clipse bind = SUPER, V, exec, alacritty --class clipse -e clipse
``` ```
Replace `alacritty` with the terminal environment you use if necessary. The class is optional, but it's recommended to use a floating window to achieve more GUI-like behavior. Replace `alacritty` with the terminal environment you use if necessary. The
class is optional, but it's recommended to use a floating window to achieve more
GUI-like behavior.
For more details on `clipse`, please refer to its GitHub repo linked at the top of the page. For more details on `clipse`, please refer to its GitHub repo linked at the top
of the page.

3
pages/Useful Utilities/Color-Pickers.md
View file

@ -11,5 +11,6 @@ only one that doesn't suck.
## Hyprpicker ## Hyprpicker
Dead simple to use. Launch, click, and you're done. Dead simple to use. Launch, click, and you're done. Also see
[its wiki page](../../Hypr-Ecosystem/hyprpicker).
[GitHub](https://github.com/hyprwm/hyprpicker) [GitHub](https://github.com/hyprwm/hyprpicker)

36
pages/Useful Utilities/Hypr-Ecosystem.md
View file

@ -1,34 +1,4 @@
The hypr ecosystem is a collection of apps developed by me (aka hyprwm) The hypr ecosystem is a collection of apps developed by HyprWM, that are
that are designed for Hyprland and to integrate with it as nicely as possible. designed for Hyprland and to integrate with it as nicely as possible.
## hyprpaper See [Hypr Ecosystem](../../Hypr-Ecosystem).
A cool, fast, IPC-controlled wallpaper utility.
[Github link](https://github.com/hyprwm/hyprpaper)
## hyprpicker
A neat color picker for your Hyprland desktop.
[Github link](https://github.com/hyprwm/hyprpicker)
## xdg-desktop-portal-hyprland
A must-have, see [The wiki page](../xdg-desktop-portal-hyprland)
## hypridle
An idle management daemon for Hyprland, for things like opening lock screens or powering off the monitor when idle.
[Github link](https://github.com/hyprwm/hypridle)
## hyprlock
A simple, but fast, multithreaded, GPU-accelerated screen locker for Hyprland.
[Github link](https://github.com/hyprwm/hyprlock)
## More
and more to come! :)

8
pages/Useful Utilities/Must-have.md
View file

@ -33,8 +33,8 @@ when starting a graphical shell,[^1] non-systemd distros like Gentoo or Artix
provide a dedicated launcher. provide a dedicated launcher.
It can be usually found by running `whereis <distro>-pipewire-launcher`. If such It can be usually found by running `whereis <distro>-pipewire-launcher`. If such
a file does not exist on your install, please refer to your distro's documentation a file does not exist on your install, please refer to your distro's
for help. documentation for help.
[^1]: https://wiki.gentoo.org/wiki/PipeWire#OpenRC [^1]: https://wiki.gentoo.org/wiki/PipeWire#OpenRC
@ -59,7 +59,9 @@ Our recommendation is the KDE one. For arch, it's `polkit-kde-agent`.
You can autostart it with You can autostart it with
`exec-once=/usr/lib/polkit-kde-authentication-agent-1`. On some distributions `exec-once=/usr/lib/polkit-kde-authentication-agent-1`. On some distributions
you might have to use a different path which could be you might have to use a different path which could be
`/usr/libexec/polkit-kde-authentication-agent-1`, `/usr/libexec/kf5/polkit-kde-authentication-agent-1`, or `/usr/libexec/kf6/polkit-kde-authentication-agent-1`. `/ usr/libexec/polkit-kde-authentication-agent-1`,
`/usr/libexec/kf5/polkit-kde-authentication-agent-1`, or
`/usr/libexec/kf6/polkit-kde-authentication-agent-1`.
On other distributions that use a more recent version, such as Gentoo, it may be On other distributions that use a more recent version, such as Gentoo, it may be
necessary to use necessary to use

13
pages/Useful Utilities/Other.md
View file

@ -43,27 +43,24 @@ swapping and scheduling screen shaders; also functions as an
_Starting method:_ manual ('exec-once') _Starting method:_ manual ('exec-once')
USB mass storage devices, like thumb drives, mobile phones, digital cameras, USB mass storage devices, like thumb drives, mobile phones, digital cameras,
etc. do not mount automatically to the file system. etc. are not mounted automatically to the file system.
Typically, we have to manually mount them, often using root and `umount` to do so. Typically, they have to be manually mounted, often using root and `umount` to do so.
Many popular DEs automatically handle this by using `udisks2` wrappers. Many popular DEs automatically handle this by using `udisks2` wrappers.
`udiskie` is a udisks2 front-end that allows to manage removable media such as `udiskie` is a udisks2 front-end that allows to manage removable media such as
CDs or flash drives from userspace. CDs or flash drives from userspace.
Install `udiskie` via your repositories, or Install `udiskie` via your package manager, or
[build manually](https://github.com/coldfix/udiskie/wiki/installation) [build manually](https://github.com/coldfix/udiskie/wiki/installation)
Head over to your `~/.config/hypr/hyprland.conf` and add the following lines: Head over to your `hyprland.conf` and add the following line:
```ini ```ini
exec-once = udiskie & exec-once = udiskie
``` ```
This launches `udiskie` and the `&` argument launches it in the
background.
[See more uses here](https://github.com/coldfix/udiskie/wiki/Usage). [See more uses here](https://github.com/coldfix/udiskie/wiki/Usage).
### Advanced Systemd Session Management ### Advanced Systemd Session Management

19
pages/Useful Utilities/Screen-Sharing.md
View file

@ -7,8 +7,9 @@ Screensharing is done through PipeWire on Wayland.
## Prerequisites ## Prerequisites
Make sure you have `pipewire` and `wireplumber` installed, enabled and running Make sure you have `pipewire`, `wireplumber` and
if you don't have them yet. [`xdg-desktop-portal-hyprland`](../../Hypr-Ecosystem/xdg-desktop-portal-hyprland)
installed, enabled and running if you don't have them yet.
## Screensharing ## Screensharing
@ -16,10 +17,6 @@ Read
[this amazing gist by Bruno Ancona Sala](https://gist.github.com/brunoanc/2dea6ddf6974ba4e5d26c3139ffb7580) [this amazing gist by Bruno Ancona Sala](https://gist.github.com/brunoanc/2dea6ddf6974ba4e5d26c3139ffb7580)
for a great tutorial. for a great tutorial.
## Better screensharing
See [the hyprland portal page](../xdg-desktop-portal-hyprland)
## XWayland ## XWayland
If your screensharing application is running under XWayland (like Discord or If your screensharing application is running under XWayland (like Discord or
@ -37,9 +34,9 @@ the same effect. See
more information. For example: more information. For example:
```ini ```ini
windowrulev2 = opacity 0.0 override,class:^(xwaylandvideobridge)$ windowrulev2 = opacity 0.0 override, class:^(xwaylandvideobridge)$
windowrulev2 = noanim,class:^(xwaylandvideobridge)$ windowrulev2 = noanim, class:^(xwaylandvideobridge)$
windowrulev2 = noinitialfocus,class:^(xwaylandvideobridge)$ windowrulev2 = noinitialfocus, class:^(xwaylandvideobridge)$
windowrulev2 = maxsize 1 1,class:^(xwaylandvideobridge)$ windowrulev2 = maxsize 1 1, class:^(xwaylandvideobridge)$
windowrulev2 = noblur,class:^(xwaylandvideobridge)$ windowrulev2 = noblur, class:^(xwaylandvideobridge)$
``` ```

63
pages/Useful Utilities/Status-Bars.md
View file

@ -9,32 +9,37 @@ Waybar is a GTK status bar made specifically for wlroots compositors and
supports Hyprland by default. To use it, it's recommended to use your distro's supports Hyprland by default. To use it, it's recommended to use your distro's
package. package.
If you want to use the workspaces module, first, copy the configuration files To start configuring, copy the configuration files from
from `/etc/xdg/waybar/` into `~/.config/waybar/`. Then, in `/etc/xdg/waybar/` into `~/.config/waybar/`. Then, in `~/.config/waybar/config`
`~/.config/waybar/config` replace all the references to `sway/workspaces` with
`hyprland/workspaces`. To use the workspaces module, replace all the occurrences of `sway/workspaces`
with `hyprland/workspaces`.
For more info regarding configuration, see For more info regarding configuration, see
[The Waybar Wiki](https://github.com/Alexays/Waybar/wiki/Module:-Hyprland). [The Waybar Wiki](https://github.com/Alexays/Waybar/wiki/Module:-Hyprland).
### How to launch ### How to launch
After getting everything set up, you might want to check if Waybar is configured Type `waybar` into your terminal. In order to have Waybar launch alongside
to your liking. To launch it, simply type `waybar` into your terminal. If you Hyprland, add this line to your Hyprland configuration:
would like Waybar to launch alongside Hyprland, you can do this by adding a line
to your Hyprland configuration that reads `exec-once=waybar`.
### Waybar popups render behind the windows ```ini
exec-once = waybar
```
### Waybar FAQ
#### Waybar popups render behind the windows
In `~/.config/waybar/config`, make sure that you have the `layer` configuration In `~/.config/waybar/config`, make sure that you have the `layer` configuration
set to `top` and not `bottom`. set to `top` and not `bottom`.
### Active workspace doesn't show up #### Active workspace doesn't show up
Replace `#workspaces button.focused` with `#workspaces button.active` in Replace `#workspaces button.focused` with `#workspaces button.active` in
`~/.config/waybar/style.css`. `~/.config/waybar/style.css`.
### Scrolling through workspaces #### Scrolling through workspaces
Since a lot of configuration options from `sway/workspaces` are missing, Since a lot of configuration options from `sway/workspaces` are missing,
you should deduce some of them by yourself. In the case of scrolling, it should you should deduce some of them by yourself. In the case of scrolling, it should
@ -67,27 +72,26 @@ If you are using multiple monitors, you may want to insert the following option:
## Eww ## Eww
[Eww](https://github.com/elkowar/eww) (ElKowar's Wacky Widgets) is a widget system made in Rust, which lets you [Eww](https://github.com/elkowar/eww) (ElKowar's Wacky Widgets) is a widget
create your own widgets similarly to how you can in AwesomeWM. The key difference system made in Rust + GTK, which lets allows the creation of custom widgets
is that it is independent of your window manager/compositor. similarly to AwesomeWM. The key difference is that it is independent of window
manager/compositor.
In order to use [Eww](https://github.com/elkowar/eww), you first have to install Install Eww either using your distro's package manager, by searching
it, either using your distro's package manager, by searching `eww-wayland`, or `eww-wayland`, or by manually compiling. In the latter case, you can follow the
by manually compiling. In the latter case, you can follow the
[instructions](https://elkowar.github.io/eww). [instructions](https://elkowar.github.io/eww).
### Configuration ### Configuration
After you've successfully installed Eww, you can move onto configuring it. There There are a few examples listed in the [Readme](https://github.com/elkowar/eww).
are a few examples listed in the [Readme](https://github.com/elkowar/eww). It's It's also highly recommended to read through the
also highly recommended to read through the
[Configuration options](https://elkowar.github.io/eww/configuration.html). [Configuration options](https://elkowar.github.io/eww/configuration.html).
{{< callout >}} {{< callout >}}
Read Read
[the Wayland section](https://elkowar.github.io/eww/configuration.html#wayland) [the Wayland section](https://elkowar.github.io/eww/configuration.html#wayland)
carefully before asking why your bar doesn't work. carefully, otherwise Eww won't work on Hyprland.
{{< /callout >}} {{< /callout >}}
@ -222,23 +226,26 @@ socat -u UNIX-CONNECT:$XDG_RUNTIME_DIR/hypr/$HYPRLAND_INSTANCE_SIGNATURE/.socket
Like Waybar, [Hybrid](https://github.com/vars1ty/HybridBar) is a GTK status bar Like Waybar, [Hybrid](https://github.com/vars1ty/HybridBar) is a GTK status bar
mainly focused on wlroots compositors. mainly focused on wlroots compositors.
You can install it by installing `hybrid-bar` from the AUR. It can be installed using the `hybrid-bar` package from the AUR.
### Configuration ### Configuration
The configuration is done through JSON, more information is available The configuration is done through JSON. More information is available
[here](https://github.com/vars1ty/HybridBar). [here](https://github.com/vars1ty/HybridBar).
### How to launch ### How to launch
After configuring HybridBar, you can launch it by typing `hybrid-bar` into your After configuring HybridBar, it can be launched by typing `hybrid-bar` into a
terminal to try it out. It is also possible to set it to launch at start, to do terminal. It is also possible to set it to launch at startup. To do this, add
this you can add a line to your Hyprland configuration that reads this line to `hyprland.conf`:
`exec-once=hybrid-bar`
```ini
exec-once = hybrid-bar
```
#### Blur #### Blur
To activate blur, set `blurls=NAMESPACE` in your Hyprland configuration, where To activate blur, set `blurls = NAMESPACE` in your Hyprland configuration, where
`NAMESPACE` is the gtk-layer-shell namespace of your HybridBar. The default `NAMESPACE` is the gtk-layer-shell namespace of your HybridBar. The default
namespace is `gtk-layer-shell` and can be changed in the HybridBar configuration namespace is `gtk-layer-shell` and can be changed in the HybridBar configuration
at at

10
pages/Useful Utilities/Wallpapers.md
View file

@ -3,18 +3,16 @@ weight: 3
title: Wallpapers title: Wallpapers
--- ---
Launch your wallpaper utility with `exec-once=`. Launch your wallpaper utility with `exec-once =`.
## hyprpaper ## hyprpaper
Straight from our oven, `hyprpaper` is a wallpaper utility from the Hypr Straight from our oven, `hyprpaper` is a wallpaper utility from the Hypr
Development team. See its usage and config by following the README on the Development team. See its usage and config [here](../../Hypr-Ecosystem/hyprpaper).
[GitHub Page](https://github.com/hyprwm/hyprpaper).
## swaybg ## swaybg
Great utility if all you want is one simple static wallpaper that will never Great utility if all you want is one simple static wallpaper. Get it
change, and don't want to make a config file. Get it
[here](https://github.com/swaywm/swaybg). [here](https://github.com/swaywm/swaybg).
## wpaperd ## wpaperd
@ -36,5 +34,5 @@ means you can change wallpapers without even needing to restart.
## waypaper ## waypaper
GUI wallpaper manager that allows to visually choose the static or animated GUI wallpaper manager that allows to visually choose the static or animated
wallpapers, and supports `swaybg` and `swww` as backends on wayland. wallpapers, and supports `swaybg` and `swww` as backends on Wayland.
[GitHub](https://github.com/anufrievroman/waypaper) [GitHub](https://github.com/anufrievroman/waypaper)