Enhance gamescoperun and wrappers with improved environment handling and display features

modules/home/gamescoperun.nix

@@ -81,18 +81,54 @@ let
   # Merge user environment with defaults
   finalEnvironment = defaultEnvironment // cfg.environment;
 
+  toEchoCommands =
+    env:
+    lib.concatStringsSep "\n" (
+      lib.mapAttrsToList (name: value: ''
+        echo -e "    \033[1;33m${name}\033[0m=\033[0;35m${toString value}\033[0m"
+      '') env
+    );
+
   gamescoperun = pkgs.writeScriptBin "gamescoperun" ''
     #!${lib.getExe pkgs.fish}
 
+    # Function to display the wrapper environment state
+    function show_environment
+        echo -e "\033[1;36m[gamescoperun]\033[0m Environment:"
+        # Display environment from the module
+        ${toEchoCommands finalEnvironment}
+
+        # Display environment from the calling wrapper, if any
+        if set -q GAMESCOPE_WRAPPER_ENV
+            echo -e "    \033[1;36m(from wrapper)\033[0m"
+            for pair in (string split ';' -- "$GAMESCOPE_WRAPPER_ENV")
+                set parts (string split -m 1 '=' -- "$pair")
+                if test (count $parts) -eq 2
+                    echo -e "        \033[1;33m$parts[1]\033[0m=\033[0;35m$parts[2]\033[0m"
+                end
+            end
+        end
+    end
+
     # Check if we're already inside a Gamescope session
     if set -q GAMESCOPE_WAYLAND_DISPLAY
       echo "Already inside Gamescope session ($GAMESCOPE_WAYLAND_DISPLAY), running command directly..."
       exec $argv
     end
 
-    # Set environment variables for the gamescope session
+    # Set base environment variables from the module
     ${toEnvCommands finalEnvironment}
 
+    # Set environment variables from the calling wrapper, overriding if necessary
+    if set -q GAMESCOPE_WRAPPER_ENV
+        for pair in (string split ';' -- "$GAMESCOPE_WRAPPER_ENV")
+            set parts (string split -m 1 '=' -- "$pair")
+            if test (count $parts) -eq 2
+                set -gx $parts[1] "$parts[2]"
+            end
+        end
+    end
+
     # Define and parse arguments using fish's built-in argparse
     argparse -i 'x/extra-args=' -- $argv
     if test $status -ne 0
@@ -123,7 +159,8 @@ let
         set -a final_args (string split ' ' -- $GAMESCOPE_EXTRA_OPTS)
     end
 
-    # Show the command being executed
+    # Show the environment and command being executed
+    show_environment
     echo -e "\033[1;36m[gamescoperun]\033[0m Running: \033[1;34m${lib.getExe gamescopePackages.gamescope}\033[0m $final_args \033[1;32m--\033[0m $argv"
 
     # Execute gamescope with the final arguments and the command

modules/home/wrappers.nix

@@ -22,9 +22,13 @@ let
       baseCommand =
         if wrapperCfg.command != null then wrapperCfg.command else lib.getExe wrapperCfg.package;
 
-      # Create environment variable exports
+      # Convert wrapper-specific environment to a single string for gamescoperun
-      envExports = lib.concatStringsSep "\n" (
+      gamescopeWrapperEnv = lib.optionalString (wrapperCfg.environment != { }) (
-        lib.mapAttrsToList (name: value: "set -x ${name} '${toString value}'") wrapperCfg.environment
+        let
+          envList = lib.mapAttrsToList (name: value: "${name}=${toString value}") wrapperCfg.environment;
+        in
+        # Set as a global exported variable so gamescoperun can see it
+        "set -gx GAMESCOPE_WRAPPER_ENV '${lib.concatStringsSep ";" envList}'"
       );
 
       # Convert extraOptions to CLI args
@@ -35,8 +39,8 @@ let
       wrapperScript = pkgs.writeScriptBin name ''
         #!${lib.getExe pkgs.fish}
 
-        # Set additional environment variables
+        # Set environment for gamescoperun to consume
-        ${envExports}
+        ${gamescopeWrapperEnv}
 
         # Execute with gamescoperun
         exec ${lib.getExe config.play.gamescoperun.package} ${extraArgs} ${baseCommand} $argv

readme.md

@@ -48,17 +48,32 @@ play = {
 ### Home Manager Configuration
 
 ```nix
-play = {
+{
+  config,
+  osConfig, # This config only works with home-manager as a nixos module
+  lib,
+  pkgs,
+  inputs, # Ensure inputs is available to your home-manager configuration
+  ...
+}:
+{
+  imports = [
+    inputs.play.homeManagerModules.play
+  ];
+
+  play = {
     # Configure monitors for automatic gamescope settings
-  monitors = [{
+    monitors = [
+      {
         name = "DP-1";
         primary = true;
         width = 2560;
         height = 1440;
-    refreshRate = 165;
+        refreshRate = 144;
         hdr = true;
         vrr = true;
-  }];
+      }
+    ];
 
     # Enable gamescope wrapper
     gamescoperun.enable = true;
@@ -72,16 +87,25 @@ play = {
         # Note: Special case for steam, this is the pkg you should use
         # Also sas of 06/25, steam does not open in normal "desktop mode" with gamescope
         # You can however exit big picture mode once already open to access the normal ui
-      command = "${lib.getExe osConfig.programs.steam.package} -tenfoot -bigpicture";
+        command = "${lib.getExe osConfig.programs.steam.package} -bigpicture -tenfoot";
         extraOptions = {
-        "steam" = true;
+          "steam" = true; # equivalent to --steam flag
+        };
+        environment = {
+          STEAM_FORCE_DESKTOPUI_SCALING = 1;
+          STEAM_GAMEPADUI = 1;
         };
       };
 
       lutris-gamescope = {
         enable = true;
         package = osConfig.play.lutris.package; # play.nix provides readonly packages
-      extraOptions."force-windows-fullscreen" = true;
+        extraOptions = {
+          "force-windows-fullscreen" = true;
+        };
+        environment = {
+          LUTRIS_SKIP_INIT = 1;
+        };
       };
 
       heroic-gamescope = {
@@ -90,14 +114,14 @@ play = {
         extraOptions."fsr-upscaling" = true;
       };
     };
-};
+  };
 
-# Recomendation: Override desktop entries to use gamescope wrappers
+  # Recomendation: Override desktop entries to use gamescope wrappers
-xdg.desktopEntries = {
+  xdg.desktopEntries = {
-  steam = {
+    steam = lib.mkDefault {
       name = "Steam";
       comment = "Steam Big Picture (Gamescope Session)";
-    exec = "${lib.getExe config.play.wrappers.steam.wrappedPackage}";
+      exec = "${lib.getExe config.play.wrappers.steam-gamescope.wrappedPackage}";
       icon = "steam";
       type = "Application";
       terminal = false;
@@ -114,21 +138,26 @@ xdg.desktopEntries = {
         Keywords = "gaming;";
       };
       actions = {
-      bigpicture = {
+        client = {
           name = "Steam Client (No Gamescope)";
-        exec = "${lib.getExe (config.play.steam.package or pkgs.steam)}";
+          exec = "${lib.getExe osConfig.programs.steam.package}";
+        };
+        steamdeck = {
+          name = "Steam Deck (Gamescope)";
+          exec = "${lib.getExe config.play.wrappers.steam-gamescope.wrappedPackage} -steamdeck";
         };
       };
     };
 
     heroic = {
       name = "Heroic (Gamescope)";
-    exec = "${lib.getExe config.play.wrappers.heroic-gaming.wrappedPackage}";
+      exec = "${lib.getExe config.play.wrappers.heroic-gamescope.wrappedPackage}";
       icon = "com.heroicgameslauncher.hgl";
       type = "Application";
       categories = [ "Game" ];
     };
-};
+  };
+}
 ```
 
 ## Usage