# ZaneyOS FAQ for v2.3
- **Revision v1.10**
- **Date:** 25-Mar-2025
Why did you create ZaneyOS ?
Orginally, it was simply my configuration saved on a GIT repository. It was there to promote NixOS and Hyprland. Providing a stable,
working configuration. It has never been intended as a full NixOS distro. The `ZaneyOS` name is an inside joke among friends. The intent is this can be used as a daily driver, play games via steam, and be modified to fit your needs. That is the key take away.
Ideally you will fork ZaneyOS, modify it to your needs. If you find an issue and fix it, or provide a new feature we hope that
you will share that with us also. ZaneyOS is not a distro. At this time there are no plans to create an install ISO.
How do I change the Timezone?
1. In the file, `~/zaneyos/modules/core/system.nix`
2. Edit the line: time.timeZone = "America/New_York";
3. Save the file and rebuild using the `fr` alias.
How do I change the monitor settings?
Monitor settings are in the file: `~/zaneyos/hosts/
After you finish configring the monitors as you wish, hit `Apply` to save the changes to `~/.config/hypr/monitor.conf`
The contents will look something like this:
```
# Generated by nwg-displays on 2025-03-20 at 13:13:49. Do not edit manually.
monitor=HDMI-A-1,1920x1080@74.97,2136x268,1.0
monitor=eDP-1,1920x1080@144.0,216x268,1.0
```
You only need to copy the `monitor=` lines and paste them into the `variables.nix` file as described in the process above.
Once you have that done. Run the command alias `fr` to build a new generation to make the chnages effective.
More information on configuring monitors is available on the [Hyprland Wiki](https://wiki.hyprland.org/Configuring/Monitors/)
How do I add applications to ZaneyOS?
### There are two options. One for all hosts you have, another for a specific host.
1. For applications to be included in all defined hosts edit the
`~/zaneyos/modules/core/packages.nix` file.
There is a section that begins with:
` environment.systemPackages = with pkgs; `
Followed by a list of packages These are required for ZaneyOS.
We suggest you add a comment at the end of the package names. Then add in your packages.
```
...
virt-viewer
wget
### My Apps ###
bottom
dua
emacs-nox
fd
gping
lazygit
lunarvim
luarocks
mission-center
ncdu
nvtopPackages.full
oh-my-posh
pyprland
shellcheck
multimarkdown
nodejs_23
ugrep
zoxide
];
}
```
2. For applications that will only be on specific host.
You edit the `host-packages.nix` associated with that host. `~/zaneyos/hosts/ I added the package names, now how do I install them ?
- Use the `fr`, Flake Rebuild alias.
If the rebuild completes successfully, a new generation with your added packages will be created.
How do I update the packages I've already installed?
- Use the `fu`, Flake Update alias. This will check for updated packages, download and install them.
I made a change to my ZaneyOS configuration, how do I activate it?
- Use the `fr` Flake Rebuild alias. If you **created a new file** please note you will need to run a `git add .` command in the zaneyos folder. If successful, a new generation will be generated with your changes. A logout or reboot could be required depending on what you changed.
How can I configure a different kernel on a specific host?
1. You have to edit the `hardware.nix` file for that host in `~/zaneyos/hosts/HOSTNAME/hardware.nix` and override the default.
2. Near the top you will find this section of the `hardware.nix` file.
```
boot.initrd.availableKernelModules = ["xhci_pci" "ahci" "nvme" "usbhid" "usb_storage" "sd_mod" "rtsx_usb_sdmmc"];
boot.initrd.kernelModules = [];
boot.kernelModules = ["kvm-intel"];
boot.extraModulePackages = [];
```
3. Add the override. E.g. to set the kernel to 6.12.
- `boot.kernelPackages = lib.mkForce pkgs.linuxPackages_6_12;`
4. The updated code should look like this:
```
boot.initrd.availableKernelModules = ["xhci_pci" "ahci" "nvme" "usbhid" "usb_storage" "sd_mod" "rtsx_usb_sdmmc"];
boot.kernelPackages = lib.mkForce pkgs.linuxPackages_6_12;
boot.initrd.kernelModules = [];
boot.kernelModules = ["kvm-intel"];
boot.extraModulePackages = [];
```
5. Use the command alias `fr` to create a new generation and reboot to take effect.
What are the major Kernel options in NixOS?
NixOS offers several major kernel types to cater to different needs and preferences. Below are the available options, excluding specific kernel versions:
1. **`linuxPackages`**
- The default stable kernel, typically an LTS (Long-Term Support) version. LTS in 25.05 (warbler) is 6.12.x Older kernels, 6.6.x, 6.8.x are not supported.
2. **`linuxPackages_latest`**
- The latest mainline kernel, which may include newer features but could be less stable.
3. **`linuxPackages_zen`**
- A performance-optimized kernel with patches aimed at improving responsiveness and interactivity. Commonly used by gamers and desktop users.
4. **`linuxPackages_hardened`**
- A security-focused kernel with additional hardening patches for enhanced protection.
5. **`linuxPackages_rt`**
- A real-time kernel designed for low-latency and time-sensitive applications, such as audio production or robotics.
6. **`linuxPackages_libre`**
- A kernel stripped of proprietary firmware and drivers, adhering to free software principles.
7. **`linuxPackages_xen_dom0`**
- A kernel tailored for running as the host (dom0) in Xen virtualization environments.
8. **`linuxPackages_mptcp`**
- A kernel with support for Multipath TCP, useful for advanced networking scenarios.
I have older generations I want to delete, how can I do that?
- The `ncg` NixOS Clean Generations alias will remove **ALL** but the most current generation. Make sure you have booted from that generation before using this alias. There is also a schedule that will remove older generations automatically over time.
How do I change the hostname?
To change the hostname, there are several steps and you will have to reboot to make the change effective.
1. Copy the directory of the host you want to rename to a directory with the new name.
- `cp -rpv ~/zaneyos/hosts/OLD-HOSTNAME ~/zaneyos/hosts/NEW-HOSTNAME `
2. Edit the `~/zaneyos/flake.nix` file. Change the line:
- `host = "NEW-HOSTNAME"`
3. In the `~/zaneyos` Directory run `git add .` *The rebuild will fail with a 'file not found' error if you forget this step.*
4. Use the `fr` alias to create a new generation with the new hostname. You must reboot to make the change effective.
How do I enable or disable Stylix?
- To Enable:
1. Edit the `~/zaneyos/modules/core/stylix.nix` file.
2. Comment out from `base16Scheme` to the `};` after `base0F`
```
# Styling Options
stylix = {
enable = true;
image = ../../wallpapers/Anime-girl-sitting-night-sky_1952x1120.jpg;
#image = ../../wallpapers/Rainnight.jpg;
#image = ../../wallpapers/zaney-wallpaper.jpg;
# base16Scheme = {
# base00 = "282936";
# base01 = "3a3c4e";
# base02 = "4d4f68";
# base03 = "626483";
# base04 = "62d6e8";
# base05 = "e9e9f4";
# base06 = "f1f2f8";
# base07 = "f7f7fb";
# base08 = "ea51b2";
# base09 = "b45bcf";
# base0A = "00f769";
# base0B = "ebff87";
# base0C = "a1efe4";
# base0D = "62d6e8";
# base0E = "b45bcf";
# base0F = "00f769";
#};
polarity = "dark";
opacity.terminal = 1.0;
cursor = {
package = pkgs.bibata-cursors;
name = "Bibata-Modern-Ice";
size = 24;
};
```
3. Select the image you wasnt stylex to use for the colorpalette.
4. Run `fr` command alias to create a new generation with this colorscheme.
- To disable uncomment
1. Edit the `~/zaneyos/modules/core/stylix.nix` file.
2. Uncomment out from `base16Scheme` to the `};` after `base0F`
```
base16Scheme = {
base00 = "282936";
base01 = "3a3c4e";
base02 = "4d4f68";
base03 = "626483";
base04 = "62d6e8";
base05 = "e9e9f4";
base06 = "f1f2f8";
base07 = "f7f7fb";
base08 = "ea51b2";
base09 = "b45bcf";
base0A = "00f769";
base0B = "ebff87";
base0C = "a1efe4";
base0D = "62d6e8";
base0E = "b45bcf";
base0F = "00f769";
};
```
3. Run the `fr`command alias to build a new generation with either the default dracula or set your own custom colors
How do I change the image Stylix uses to theme with?
1. Edit the `~/zaneyos/hosts/HOSTNAME/varibles.nix`
2. Change the `stylixImage = ` to the filename you want to use. Wallpapers are in `~/zaneyos/wallpapers`
``` # Set Stylix Image
stylixImage = ../../wallpapers/AnimeGirlNightSky.jpg;
```
How do I add more wallpapers?
- Wallpapers are stored in the `~/zaneyos/wallpapers` directory.
- Simply copy the new ones to that diretory.
How do I change the background?
- SUPER + ALT + W will select a new background
How can I set a timer to change the wallpaper automatically?
1. Edit the `~/zaneyos/modules/home/hyprland/config.nix` file.
2. Comment out the line `sleep 1.5 && swww img ...`
3. Add new line after that with `sleep 1 && wallsetter`
```
settings = {
exec-once = [
"dbus-update-activation-environment --all --systemd WAYLAND_DISPLAY XDG_CURRENT_DESKTOP"
"systemctl --user import-environment WAYLAND_DISPLAY XDG_CURRENT_DESKTOP"
"killall -q swww;sleep .5 && swww init"
"killall -q waybar;sleep .5 && waybar"
"killall -q swaync;sleep .5 && swaync"
"nm-applet --indicator"
"lxqt-policykit-agent"
"pypr &"
#"sleep 1.5 && swww img /home/${username}/Pictures/Wallpapers/zaney-wallpaper.jpg"
"sleep 1 && wallsetter"
];
```
4. Run the command alias `fr` to create a new generation.
5. You will need to logout or reboot to make the change effective.
How do I change the interval the wallpaper changes?
1. Edit the `~/zaneyos/modules/home/scripts/wallsetter`
2. Change the `TIMEOUT = ` value. Which is in seconds.
3. Run the command alias `fr` to create a new generation.
4. You will need to logout or reboot to make the change effective.
How do I disable the spinning snowflake at startup?
1. Edit the `~/zaneyos/modules/core/boot.nix` file.
2. Look for:
```
};
plymouth.enable = true;
};
```
3. Change it to `false`
4. Run the command alias `fr` to create a new generation.
I update my version ZaneyOS ?
For versions v2.3+
1. First backup your existing `zaneyos` directory.
- `cp -rpv ~/zaneyos ~/Backup-ZaneyOS`
*Any changes you made to the ZaneyOS config will need to be re-done*
2. In the `zaneyos` directory run `git stash && git pull`
3. Copy back your previously created host(s).
- `cp -rpv ~/Backup-ZaneyOS/hosts/HOSTNAME ~/zaneyos/hosts `
4. If you did not use the `default` host during your initial install
- Then do not copy the `default` host from your backup. The new default host might have updates or fixes you will need for the next host you create.**
- Then you will have to manually compare your backup to the new updated `default` host template, and potentially merge the changes and overwrite your `hardware.nix` file to the `~/zaneyos/hosts/default/hardware.nix` file.**
5. In the `zaneyos` directory run `git add .` when you have finished copying your host(s).
6. For any other changes you've made. For example: hyprland keybinds, waybar config, if you added additional packages to the `modules/packages.nix` file. Those you will have to manually merge back into the new version.
For versions v2.0->2.2
1. First backup your existing `zaneyos` directory. e.g. `cp -r ~/zaneyos ~/zaneyos-backup`
2. There is no direct update. When you clone the the new config the config files and layout have changed.
3. You need to install zaneyos like a new install. `./install-zaneyos.sh`
4. Once the build completes and you have rebooted you can review the new layout and decide what if any changes you made on the earlier version can be migrated to v2.3.
For version v1.x
1. The layout and configuration are completely different. Virtually noting from 1.x is applicable to v2.3.
2. Backup your `zaneyos` directory e.g. `cp -r ~/zaneyos ~/zaneyos-backup`
3. Run the `./install-zaneyos.sh` script and follow the new install instructions.
How do I know when a new version of ZaneyOS is released?
It will be announced on the Zaney [Discord](https://discord.gg/W7efsSDS) server.
How do I configure my hybrid laptop with Intel/NVIDIA GPUs?
1. Either run the `install-zaneyos.sh` script and select `nvidia-laptop` template or if configuring manually, set the template in the `flake.nix` to `nvidia-prime`
2. In the `~/zaneyos/hosts/HYBRID-HOST/variables.nix` file you will need to set the PCI IDs for the Intel and NVIDIA GPUs. Refer to [this page](https://nixos.wiki/wiki/Nvidia) to help determine those values.
3. Once you have everything configured properly, use the `fr` Flake Rebuild alias to create a new generation.
4. In the `~/zaneyos/modules/home/hyprland/config.nix` file is an ENV setting` "AQ_DRM_DEVICES,/dev/dri/card0:/dev/dri/card1"` This sets the primary and secondary GPUs. Using the info from the weblink above you might have to change the order of these values.
What is the difference between Master and Dwindle layouts
### **Master vs. Dwindle Layouts in Hyprland**
#### **1. Master Layout**
- The **Master** layout divides the workspace into two main areas:
- A **master area** for the primary window, which takes up a larger portion of the screen.
- A **stack area** for all other windows, which are tiled in the remaining space.
- This layout is ideal for workflows where you want to focus on a single main window while keeping others accessible.
#### **2. Dwindle Layout**
- The **Dwindle** layout is a binary tree-based tiling layout:
- Each new window splits the available space dynamically, alternating between horizontal and vertical splits.
- The splits are determined by the aspect ratio of the parent container (e.g., wider splits horizontally, taller splits vertically).
- This layout is more dynamic and evenly distributes space among all windows.
---
### **How to Verify the Current Layout**
To check which layout is currently active, use the `hyprctl` command:
`hyprctl getoption general:layout`
What are the Yazi keybindings and how can I change them?
The Yazi configuration file is located in `~/zaneyos/modules/home/yazi.nix`
Yazi is configured like VIM and VIM motions
The keymap is in the `~/zaneyos/modules/home/yazi/keymap.toml` file