add comments

modules/programs/hyprland/default.nix

@@ -18,16 +18,39 @@ in
   };
 
   config = mkIf cfg.enable {
+
+    # enable nix module
+    programs.hyprland = {
+      enable = true;
+      package = null; # because we use the home-manager module
+    };
+
+    # enable home-manager module
     home-manager.users.moritz = {
+      # import home-manager module
       imports = [ inputs.hyprland.homeManagerModules.default ];
 
-      programs.waybar = {
+      wayland.windowManager.hyprland = {
         enable = true;
+        package = hyprland;
+        extraConfig = import ./config.nix args;
+      };
+    };
+
+
+    # add waybar as a status bar
+    home-manager.users.moritz.programs.waybar = {
+      enable = true;
+
+      # use package with hyprland support for switching workspaces
       package = pkgs.waybar-hyprland;
+
+      # start using systemd service
       systemd = {
         enable = true;
         target = "hyprland-session.target";
       };
+
       settings = {
         mainBar = {
           layer = "top";
@@ -50,13 +73,9 @@ in
       };
     };
 
-      wayland.windowManager.hyprland = {
-        enable = true;
-        package = hyprland;
-        extraConfig = import ./config.nix args;
-      };
 
-      services.swayidle = {
+    # lock screen after timeout
+    home-manager.users.moritz.services.swayidle = {
       enable = true;
       events = [
         {
@@ -83,6 +102,20 @@ in
     # start swayidle as part of hyprland, not sway
     systemd.user.services.swayidle.Install.WantedBy = lib.mkForce [ "hyprland-session.target" ];
 
+    # adds pam module for swaylock
+    security.pam.services.swaylock = { };
+
+
+    # start hyprpaper daemon using systemd unit (to set wallpaper)
+    systemd.user.services.hyprpaper = {
+      enable = true;
+      path = [ pkgs.hyprpaper ];
+      wantedBy = [ "hyprland-session.target" ];
+      after = [ "hyprland-session.target" ];
+      script = "hyprpaper";
+    };
+
+    # set hyprpaper conf (for setting initial background)
     xdg.configFile."hypr/hyprpaper.conf" = {
       text =
         let
@@ -94,32 +127,32 @@ in
         setWallpaper "/home/moritz/.config/wallpapers/a_short_walk.png";
       onChange = "${pkgs.systemd}/bin/systemctl restart --user hyprpaper.service";
     };
-    };
+
-    systemd.user.services.hyprpaper = {
+
-      enable = true;
+    # only consider graphical-session.target started when hyprland-sesstion.target is reached
-      path = [ pkgs.hyprpaper ];
+    systemd.user.targets.hyprland-session = {
-      wantedBy = [ "hyprland-session.target" ];
+      wantedBy = [ "graphical-session.target" ];
-      after = [ "display-manager.service" ];
-      script = "hyprpaper";
     };
 
+
+    # add user packages for wayland and hyprland in particular
     users.users.moritz.packages = with pkgs; [
-      swayidle
+      # pulse audio cli
-      swaylock-effects
       pamixer
+      # control media playback
       playerctl
+      # control brightness
       brightnessctl
+      # screenshot tool for hyprland
       grimblast
+      # region select for wayland (for screensharing)
+      slurp
+      # clipboard tool for wayland
       wl-clipboard
     ];
 
-    security.pam.services.swaylock = { };
-
-    programs.hyprland = {
-      enable = true;
-      package = null;
-    };
 
+    # additional environment variables
     environment.sessionVariables =
       {
         XDG_CURRENT_DESKTOP = "Hyprland";
@@ -130,8 +163,7 @@ in
         QT_WAYLAND_DISABLE_WINDOWDECORATION = "1";
         QT_QPA_PLATFORMTHEME = "qt5ct";
         _JAVA_AWT_WM_NONEREPARENTING = "1";
-      } //
+      } // (optionalAttrs cfg.nvidiaSupport
-      (if cfg.nvidiaSupport then
         {
           LIBVA_DRIVER_NAME = "nvidia";
           XDG_SESSION_TYPE = "wayland";
@@ -139,10 +171,12 @@ in
           __GLX_VENDOR_LIBRARY_NAME = "nvidia";
           WLR_NO_HARDWARE_CURSORS = "1";
           __GL_VRR_ALLOWED = "0";
-        } else { });
+        });
+
 
     services = {
       dbus.enable = true;
+      # use pipewire (needed for screensharing)
       pipewire = {
         enable = true;
         alsa.enable = true;
@@ -158,12 +192,14 @@ in
             user = "moritz";
           };
           defaultSession = "hyprland";
-          sessionPackages = [ hyprland ];
+          sessionPackages = [ hyprland ]; # can't set the defaultSession otherwise
         };
       };
     };
     security.rtkit.enable = true;
 
+
+    # dekstop portal (for screensharing)
     xdg.portal = {
       enable = true;
       wlr.enable = true;