2024-02-20 21:16:07 +01:00
|
|
|
---
|
|
|
|
title: Options & Overrides
|
|
|
|
---
|
|
|
|
|
|
|
|
You can override the package through `.override` or `.overrideAttrs`. This is
|
|
|
|
easily achievable on [NixOS](../hyprland-on-nixos) or
|
|
|
|
[Home Manager](../hyprland-on-home-manager).
|
2022-12-18 14:20:19 +01:00
|
|
|
|
|
|
|
## Package options
|
|
|
|
|
2024-02-20 21:16:07 +01:00
|
|
|
These are the default options that the Hyprland package is built with. These can
|
|
|
|
be changed by setting the appropriate option to `true`/`false`.
|
2022-12-18 14:20:19 +01:00
|
|
|
|
|
|
|
### Package
|
|
|
|
|
|
|
|
```nix
|
2023-07-17 18:14:43 +02:00
|
|
|
(pkgs.hyprland.override { # or inputs.hyprland.packages.${pkgs.system}.hyprland
|
2023-11-27 12:36:33 +01:00
|
|
|
enableXWayland = true; # whether to enable XWayland
|
|
|
|
legacyRenderer = false; # whether to use the legacy renderer (for old GPUs)
|
|
|
|
withSystemd = true; # whether to build with systemd support
|
2022-12-18 14:20:19 +01:00
|
|
|
})
|
|
|
|
```
|
|
|
|
|
|
|
|
### NixOS & HM modules
|
|
|
|
|
|
|
|
```nix
|
|
|
|
programs.hyprland = { # or wayland.windowManager.hyprland
|
|
|
|
enable = true;
|
2023-08-26 18:31:56 +02:00
|
|
|
xwayland.enable = true;
|
2022-12-28 16:31:43 +01:00
|
|
|
};
|
2022-12-18 14:20:19 +01:00
|
|
|
```
|
|
|
|
|
|
|
|
## Options descriptions
|
|
|
|
|
|
|
|
### XWayland
|
|
|
|
|
2024-02-20 21:16:07 +01:00
|
|
|
XWayland is enabled by default in the Nix package. You can disable it either in
|
|
|
|
the package itself, or through the module options.
|
2022-12-18 14:20:19 +01:00
|
|
|
|
|
|
|
### XWayland HiDPI
|
|
|
|
|
2024-02-20 21:16:07 +01:00
|
|
|
See [XWayland](../../configuring/xwayland).
|
2022-12-18 14:20:19 +01:00
|
|
|
|
|
|
|
## 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
|
|
|
|
|
2023-08-26 18:31:56 +02:00
|
|
|
```nix
|
2022-12-18 14:20:19 +01:00
|
|
|
$ nix repl
|
|
|
|
nix-repl> :lf "github:hyprwm/Hyprland"
|
2023-11-27 12:36:33 +01:00
|
|
|
nix-repl> :bl outputs.packages.x86_64-linux.hyprland.override { /* flag here */ }
|
2022-12-18 14:20:19 +01:00
|
|
|
```
|
|
|
|
|
|
|
|
Then you can run Hyprland from the built path.
|