## ZaneyOS π° Best βοΈ NixOS Configs
** Updated: June 3rd,2025
ZaneyOS is a simple way of reproducing my configuration on any NixOS system.
This includes the wallpaper, scripts, applications, config files, and more.

**Inspiration for the Waybar config
[here](https://github.com/justinlime/dotfiles).**

**Third waybar option**
### Please note:
> **This project has a [Wiki](https://zaney.org/wiki/zaneyos-2.3/). Find out how
> to use ZaneyOS here!** **ddubs has put a lot of effort into the
> [FAQ](https://zaney.org/wiki/zaneyos-2.3/faq) so it should be accurate.
> However, please if you notice that something is wrong with it create an issue
> or reach out to us on Discord.**
#### π Requirements
- You must be running on NixOS, version 23.11+.
- The `zaneyos` folder (this repo) is expected to be in your home directory.
- You must have installed NIXOS using **GPT** parition with booting with
**UEFI**.
- ** 500MB minimum /boot partition required. **
- Systemd-boot is what is supported.
- For GRUB you will have to brave the internet for a how-to. βΊοΈ
- Manually editing your host specific files.
- The host is the specific computer your installing on.
#### πΉ Pipewire & Notification Menu Controls
- We are using the latest and greatest audio solution for Linux. Not to mention
you will have media and volume controls in the notification center available
in the top bar.
#### π Optimized Workflow & Simple Yet Elegant Neovim
- Using Hyprland for increased elegance, functionality, and efficiency.
- No massive NeoVIM project here. This is my simple, easy to understand, yet
incredible NeoVIM setup. With language support already added in.
#### π₯οΈ Multi Host & User Configuration
- You can define separate settings for different host machines and users.
- Easily specify extra packages for your users in the `modules/core/user.nix`
file.
- Easy to understand file structure and simple, but encompassing, configuration.
#### πΌ An Incredible Community Focused On Support
- The entire idea of ZaneyOS is to make NixOS an approachable space.
- NixOS is actually a great community that you will want to be a part of.
- Many people who are patient and happy to spend their free time helping you are
running ZaneyOS.
- Feel free to reach out on the Discord for any help with anything.
Please do yourself a favor and
[read the wiki](https://zaney.org/wiki/zaneyos-2.3/).
#### π¦ How To Install Packages?
- You can search the [Nix Packages](https://search.nixos.org/packages?) &
[Options](https://search.nixos.org/options?) pages for what a package may be
named or if it has options available that take care of configuration hurdles
you may face.
- To add a package there are the sections for it in `modules/core/packages.nix`
and `modules/core/user.nix`. One is for programs available system wide and the
other for your users environment only.
#### π Having Issues / Questions?
- Please feel free to raise an issue on the repo, please label a feature request
with the title beginning with [feature request], thank you!
- Contact us on [Discord](https://discord.gg/2cRdBs8) as well, for a potentially
faster response.
- Don't forget to checkout the [FAQ](https://zaney.org/wiki/zaneyos-2.3/faq)
# Hyprland Keybindings
Below are the keybindings for Hyprland, formatted for easy reference.
## Application Launching
- `$modifier + Return` β Launch `terminal`
- `$modifier + K` β List keybinds
- `$modifier + Shift + Return` β Launch `rofi-launcher`
- `$modifier + Shift + W` β Open `web-search`
- `$modifier + Alt + W` β Open `wallsetter`
- `$modifier + Shift + N` β Run `swaync-client -rs`
- `$modifier + W` β Launch `Web Browser`
- `$modifier + Y` β Open `kitty` with `yazi`
- `$modifier + E` β Open `emopicker9000`
- `$modifier + S` β Take a screenshot
- `$modifier + D` β Open `Discord`
- `$modifier + O` β Launch `OBS Studio`
- `$modifier + C` β Run `hyprpicker -a`
- `$modifier + G` β Open `GIMP`
- `$modifier + V` β Show clipboard history via `cliphist`
- `$modifier + T` β Toggle terminal with `pypr`
- `$modifier + M` β Open `pavucontrol`
## Window Management
- `$modifier + Q` β Kill active window
- `$modifier + P` β Toggle pseudo tiling
- `$modifier + Shift + I` β Toggle split mode
- `$modifier + F` β Toggle fullscreen
- `$modifier + Shift + F` β Toggle floating mode
- `$modifier + Alt + F` β Float all windows
- `$modifier + Shift + C` β Exit Hyprland
## Window Movement
- `$modifier + Shift + β / β / β / β` β Move window left/right/up/down
- `$modifier + Shift + H / L / K / J` β Move window left/right/up/down
- `$modifier + Alt + β / β / β / β` β Swap window left/right/up/down
- `$modifier + Alt + 43 / 46 / 45 / 44` β Swap window left/right/up/down
## Focus Movement
- `$modifier + β / β / β / β` β Move focus left/right/up/down
- `$modifier + H / L / K / J` β Move focus left/right/up/down
## Workspaces
- `$modifier + 1-10` β Switch to workspace 1-10
- `$modifier + Shift + Space` β Move window to special workspace
- `$modifier + Space` β Toggle special workspace
- `$modifier + Shift + 1-10` β Move window to workspace 1-10
- `$modifier + Control + β / β` β Switch workspace forward/backward
## Window Cycling
- `Alt + Tab` β Cycle to next window
- `Alt + Tab` β Bring active window to top
## Installation: