#+AUTHOR: Tony #+STARTUP: overview

A dynamic window manager written in Rust, inspired by dwm but designed to evolve beyond it. OXWM features a clean, functional Lua API for configuration with hot-reloading support, ditching the suckless philosophy of "edit + recompile". Instead, we focus on lowering friction for users with sane defaults, LSP-powered autocomplete, and instant configuration changes without restarting your X session.

** NixOS (with Flakes) *** Adding OXWM to your flake inputs Add oxwm to your =flake.nix= inputs:

#+begin_src nix { inputs = { nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable"; oxwm.url = "github:tonybanters/oxwm"; oxwm.inputs.nixpkgs.follows = "nixpkgs"; };

outputs = { self, nixpkgs, oxwm, ... }: { nixosConfigurations.yourhost = nixpkgs.lib.nixosSystem { system = "x86_64-linux"; modules = [ ./configuration.nix oxwm.nixosModules.default ]; }; }; } #+end_src

*** Enabling OXWM in configuration.nix Add this to your =configuration.nix=:

{ services.xserver = { enable = true;

*** Initialize your config After rebuilding your system with =sudo nixos-rebuild switch=, log in via your display manager.

On first launch, your initial config file will be automatically created and placed in =~/.config/oxwm/config.lua=. Edit it and reload with =Mod+Shift+R=.

*** Advanced: Using a specific oxwm version If you want to pin or customize the oxwm package:

#+begin_src nix { services.xserver.windowManager.oxwm = { enable = true;

Use a specific version or build with custom options

package = oxwm.packages.${pkgs.system}.default; }; } #+end_src