hyprland-wiki/pages/Nix/Options & Overrides.md

88 lines
2.3 KiB
Markdown
Raw Normal View History

2022-12-18 14:20:19 +01:00
You can override the package through `.override` or `.overrideAttrs`. This is
easily achievable through NixOS or Home Manager.
## Package options
These are the default options that the Hyprland package is built with. These
can be changed by setting the appropriate option to `true`/`false`.
### Package
```nix
2023-04-09 14:02:54 +02:00
(pkgs.hyprland.override { # or inputs.hyprland.packages.${pkgs.stdenv.hostPlatform.system}.default
2022-12-18 14:20:19 +01:00
enableXWayland = true;
hidpiXWayland = true;
nvidiaPatches = false;
})
```
### NixOS & HM modules
```nix
programs.hyprland = { # or wayland.windowManager.hyprland
enable = true;
xwayland = {
enable = true;
hidpi = true;
};
nvidiaPatches = false;
2022-12-28 16:31:43 +01:00
};
2022-12-18 14:20:19 +01:00
```
## Options descriptions
### XWayland
XWayland is enabled by default in the Nix package. You can disable it either
in the package itself, or through the module options.
### XWayland HiDPI
By default, the Nix package includes a patched wlroots that can render HiDPI
XWayland windows.
In order to enable the functionality, you have to add:
```toml
2023-02-14 14:30:40 +01:00
exec-once = xprop -root -f _XWAYLAND_GLOBAL_OUTPUT_SCALE 32c -set _XWAYLAND_GLOBAL_OUTPUT_SCALE 2
2022-12-18 14:20:19 +01:00
```
This will make XWayland programs look as if they were unscaled. To fix this, you
2023-03-05 15:53:44 +01:00
have to set different environment variables to make the specific toolkits
render at the proper scaling. For example, add this to your `hyprland.conf`:
2022-12-18 14:20:19 +01:00
2023-03-05 15:53:44 +01:00
```ini
env = GDK_SCALE,2
env = XCURSOR_SIZE,48
2022-12-18 14:20:19 +01:00
```
{{< hint >}}
The GDK_SCALE variable won't conflict with wayland-native GTK programs.
{{< /hint >}}
Usually, there's no reason to disable this functionality, as it won't affect
people who don't have HiDPI screens.
If you _do_ insist on disabling it though (e.g. for adding your own patches
to wlroots), you can do so by either using the `hyprland-no-hidpi` package,
or by passing the `hidpiXWayland = false;` flag, the same way as
2023-02-14 14:30:40 +01:00
[disabling XWayland](#package).
2022-12-18 14:20:19 +01:00
### Nvidia Patches
Nvidia is notorious for not working by default with wlroots. That's why we
patch wlroots.
## Using Nix repl
If you're using Nix (and not NixOS or Home Manager) and you want to override,
you can do it like this
```sh
$ nix repl
nix-repl> :lf "github:hyprwm/Hyprland"
nix-repl> :bl outputs.packages.x86_64-linux.hyprland.override {nvidiaPatches = true;} # option = value
```
Then you can run Hyprland from the built path.