Migrate winiso script to fish

archiso/airootfs/root/.automated_script.sh

@@ -23,7 +23,7 @@ automated_script() {
                 sleep 1
             done
             printf '%s: downloading %s\n' "$0" "${script}"
-            curl "${script}" --location --retry-connrefused --retry 10 -s -o /tmp/startup_script
+            curl "${script}" --location --retry-connrefused --retry 10 --fail -s -o /tmp/startup_script
             rt=$?
         else
             cp "${script}" /tmp/startup_script

archiso/scripts/valhalla.patch

@@ -1,8 +1,8 @@
 diff --git a/airootfs/root/.zlogin b/airootfs/root/.zlogin
-index bf6bc8f..76e5893 100755
+index bf6bc8f..a0dae7b 100755
 --- a/airootfs/root/.zlogin
 +++ b/airootfs/root/.zlogin
-@@ -4,3 +4,18 @@ if grep -Fqa 'accessibility=' /proc/cmdline &> /dev/null; then
+@@ -4,3 +4,19 @@ if grep -Fqa 'accessibility=' /proc/cmdline &> /dev/null; then
  fi
  
  ~/.automated_script.sh
@@ -16,13 +16,14 @@ index bf6bc8f..76e5893 100755
 +
 +git diff -p -R --no-ext-diff --no-color --diff-filter=M \
 +    | grep -E "^(diff|(old|new) mode)" --color=never  \
++    | sed "/^diff/{ x; d; }; x; /./{ p; z; }; x;" \
 +    | git apply
 +
 +popd > /dev/null
 +
 +loadkeys de_CH-latin1
 diff --git a/packages.x86_64 b/packages.x86_64
-index 9e876e7..b89ab30 100755
+index 9e876e7..c5db92a 100755
 --- a/packages.x86_64
 +++ b/packages.x86_64
 @@ -30,8 +30,10 @@ ethtool
@@ -36,7 +37,15 @@ index 9e876e7..b89ab30 100755
  gnu-netcat
  gpart
  gpm
-@@ -75,6 +77,7 @@ nbd
+@@ -45,6 +47,7 @@ irssi
+ iw
+ iwd
+ jfsutils
++jq
+ kitty-terminfo
+ ldns
+ less
+@@ -75,6 +78,7 @@ nbd
  ndisc6
  nfs-utils
  nilfs-utils

flake.nix

@@ -6,7 +6,7 @@
     flake-utils.url = "github:numtide/flake-utils?ref=b1d9ab70662946ef0850d488da1c9019f3a9752a";
   };
 
-  outputs = { self, flake-utils, nixpkgs }: flake-utils.lib.eachDefaultSystem (
+  outputs = { self, flake-utils, nixpkgs }: (flake-utils.lib.eachDefaultSystem (
       system:
         let
           pkgs = import nixpkgs {
@@ -32,5 +32,11 @@
           packages = {
             archiso = pkgs.archiso;
           };
-        });
+        })) // {
+    valhalla = {
+      "DerGeret Windows" = import ./profiles/DerGeret/config.nix;
+      "der-geret Arch Linux" = import ./profiles/DerGeret/Arch/config.nix;
+      "manu-surface Arch Linux" = import ./profiles/ManuSurface/Arch/config.nix;
+    };
+  };
 }

lib/modules/git.nix

@@ -1,7 +0,0 @@
-{ lib, ... }: {
-  options = {
-    valhalla = {
-      git = (import ./git/options.nix) { inherit lib; };
-    };
-  };
-}

lib/modules/git/options.nix

@@ -1,33 +0,0 @@
-{ lib, ... }:
-  let
-    inherit (lib)
-      mkOption
-      types
-    ;
-  in {
-    defaultBranch = mkOption {
-      type = types.nullOr types.str;
-      description = "The name of the default branch in git.";
-      default = null;
-    };
-
-    flow = {
-      mainBranch = mkOption {
-        type = types.nullOr types.str;
-        description = "The name of the stable branch in git flow.";
-        default = null;
-      };
-
-      devBranch = mkOption {
-        type = types.nullOr types.str;
-        description = "The name of the development branch in git flow.";
-        default = null;
-      };
-    };
-
-    aliases = mkOption {
-      type = types.attrsOf types.str;
-      description = "Git command aliases to install.";
-      default = {};
-    };
-  }

lib/modules/hardware.nix

@@ -43,6 +43,12 @@
             description = "A value indicating whether an Elgato Wave device is present.";
             default = false;
           };
+
+          logitechG = mkOption {
+            type = types.bool;
+            description = "A value indicating whether a Logitech G device is present.";
+            default = false;
+          };
         };
       };
     };

lib/modules/os.nix

@@ -0,0 +1,52 @@
+{ lib, ... }:
+  let
+    inherit (lib)
+      mkOption
+      types
+    ;
+  in {
+    options = {
+      valhalla = mkOption {
+        type = types.submodule (
+          { extendModules, ... }:
+            let
+              osVariant = extendModules {
+                modules = [
+                  ({ config, ... }: {
+                    options = {
+                      config = mkOption {
+                        type = types.attrs;
+                        description = "The configuration of the Operating System.";
+                        default = builtins.removeAttrs config ["_module" "config" "linux" "windows"];
+                        visible = false;
+                      };
+                    };
+                  })
+                ];
+              };
+
+              linuxVariant = osVariant.extendModules { };
+              windowsVariant = osVariant.extendModules { };
+            in {
+              options = {
+                linux = mkOption {
+                  inherit (linuxVariant) type;
+                  description = "The options for setting up Linux.";
+                  default = {};
+                  visible = "shallow";
+                };
+
+                windows = mkOption {
+                  inherit (windowsVariant) type;
+                  description = "The options for setting up Windows.";
+                  default = {};
+                  visible = "shallow";
+                };
+              };
+            });
+
+        description = "Configuration for PortValhalla.";
+        default = {};
+      };
+    };
+  }

lib/modules/packages/git.nix

@@ -0,0 +1,59 @@
+{ lib, ... }:
+  let
+    inherit (lib)
+      mkOption
+      types
+    ;
+
+    gitType = types.submodule (
+      { ... }: {
+        options = {
+          defaultBranch = mkOption {
+            type = types.nullOr types.str;
+            description = "The name of the default branch in newly created repositories.";
+            default = null;
+          };
+
+          flow = {
+            mainBranch = mkOption {
+              type = types.nullOr types.str;
+              description = "The name of the stable branch in git flow.";
+              default = null;
+            };
+
+            devBranch = mkOption {
+              type = types.nullOr types.str;
+              description = "The name of the development branch in git flow.";
+              default = null;
+            };
+          };
+
+          aliases = mkOption {
+            type = types.attrsOf types.str;
+            description = "The git command aliases to install.";
+            default = {};
+          };
+        };
+      });
+
+    gitOption = mkOption {
+      type = gitType;
+      description = "The git related options.";
+      default = {};
+    };
+  in {
+    options = {
+      valhalla = {
+        git = gitOption;
+
+        users = mkOption {
+          type = types.attrsOf (types.submodule (
+            { ... }: {
+              options = {
+                git = gitOption;
+              };
+            }));
+        };
+      };
+    };
+  }

lib/modules/packages/nextcloud.nix

@@ -0,0 +1,44 @@
+{ lib, ... }:
+  let
+    inherit (lib)
+      mkEnableOption
+      mkOption
+      types
+    ;
+
+    syncType = types.submodule (
+      { ... }: {
+        options = {
+          remotePath = mkOption {
+            type = types.str;
+            description = "The path to the folder on the cloud to sync.";
+          };
+
+          localPath = mkOption {
+            type = types.str;
+            description = "The path to sync the cloud content to.";
+          };
+
+          virtualFiles = (mkEnableOption "virtual file support") // {
+            default = true;
+          };
+        };
+      });
+  in {
+    options = {
+      valhalla.windows.users = mkOption {
+        type = types.attrsOf (types.submodule (
+          { ... }: {
+            options = {
+              nextcloud = {
+                folderSyncs = mkOption {
+                  type = types.listOf syncType;
+                  description = "The folders to synchronize.";
+                  default = [];
+                };
+              };
+            };
+          }));
+      };
+    };
+  }

lib/modules/packages/oh-my-posh.nix

@@ -0,0 +1,60 @@
+{ lib, ... }:
+  let
+    inherit (lib)
+      mkOption
+      types
+    ;
+
+    themeType = types.submodule (
+      { config, ... }: {
+        options = {
+          source = mkOption {
+            type = types.nullOr types.path;
+            description = "The path to the oh-my-posh theme to use.";
+            default = null;
+          };
+
+          name = mkOption {
+            type = types.nullOr types.str;
+            description = "The name of the theme.";
+            default = if (config.source != null)
+            then
+              lib.strings.removeSuffix ".omp" (lib.strings.removeSuffix ".json" (builtins.baseNameOf config.source))
+            else
+              null;
+          };
+        };
+      });
+
+    ompType = types.submodule (
+      { config, ... }: {
+        options = {
+          theme = mkOption {
+            type = types.either types.str themeType;
+            description = "The default theme.";
+            default = {};
+          };
+
+          additionalThemes = mkOption {
+            type = types.listOf themeType;
+            description = "A set of additional themes to install.";
+            default = [];
+          };
+        };
+      });
+  in {
+    options = {
+      valhalla.users = mkOption {
+        type = types.attrsOf (types.submodule (
+          { ... }: {
+            options = {
+              oh-my-posh = mkOption {
+                type = ompType;
+                description = "The Oh My Posh configuration to apply.";
+                default = {};
+              };
+            };
+          }));
+      };
+    };
+  }

lib/modules/packages/rclone.nix

@@ -0,0 +1,40 @@
+{ lib, ... }:
+  let
+    inherit (lib)
+      mkOption
+      types
+    ;
+
+    syncType = types.submodule (
+      { ... }: {
+        options = {
+          dirName = mkOption {
+            type = types.str;
+            description = "The name of the directory to sync the remote files to.";
+          };
+
+          cacheDuration = mkOption {
+            type = types.nullOr types.str;
+            description = "The amount of time to keep cached files.";
+            default = null;
+          };
+        };
+      });
+  in {
+    options = {
+      valhalla.linux.users = mkOption {
+        type = types.attrsOf (types.submodule (
+          { ... }: {
+            options = {
+              rclone = {
+                configurations = mkOption {
+                  type = types.attrsOf syncType;
+                  description = "The configurations of the rclone mounts.";
+                  default = {};
+                };
+              };
+            };
+          }));
+      };
+    };
+  }

lib/modules/users.nix

@@ -5,24 +5,10 @@
       types
     ;
 
-    syncType = types.submodule (
+    capitalize = (import ../text.nix { inherit lib; }).capitalize;
-      { ... }: {
-        options = {
-          dirName = mkOption {
-            type = types.str;
-            description = "The name of the directory to sync the remote files to.";
-          };
-
-          cacheDuration = mkOption {
-            type = types.nullOr types.str;
-            description = "The amount of time to keep cached files.";
-            default = null;
-          };
-        };
-      });
 
     userType = types.submodule (
-      { ... }: {
+      { ... } : {
         options = {
           displayName = mkOption {
             type = types.nullOr types.str;
@@ -41,21 +27,27 @@
             description = "The additional groups of the user.";
             default = [];
           };
+        };
+      });
 
+    linuxUserType = types.submodule (
+      { ... }: {
+        options = {
           defaultShell = mkOption {
             type = types.nullOr types.str;
             description = "The default shell of the user.";
             default = null;
           };
+        };
+      });
 
-          git = (import ./git/options.nix) { inherit lib; };
+    winUserType = types.submodule (
-
+      { ... }: {
-          rclone = {
+        options = {
-            configurations = mkOption {
+          microsoftAccount = mkOption {
-              type = types.attrsOf syncType;
+            type = types.bool;
-              description = "The configurations of the rclone mounts.";
+            description = "A value indicating whether this user is a Microsoft Account.";
-              default = {};
+            default = false;
-            };
           };
         };
       });
@@ -67,6 +59,35 @@
           description = "The users to create on the machine.";
           default = {};
         };
+
+        linux.users = mkOption {
+          type = types.attrsOf linuxUserType;
+        };
+
+        windows = mkOption {
+          type = types.submoduleWith {
+            modules = [
+              ({ config, options, ... }: {
+                options = {
+                  users = mkOption {
+                    type = types.attrsOf winUserType;
+                  };
+
+                  winUsers = mkOption {
+                    type = options.users.type;
+                    description = "Blablabla";
+                    default = (lib.attrsets.concatMapAttrs (
+                      name: options: {
+                          ${capitalize name} = options // {
+                            groups = [];
+                          };
+                        }) config.users);
+                  };
+                };
+              })
+            ];
+          };
+        };
       };
     };
   }

lib/modules/valhalla.nix

@@ -6,9 +6,13 @@
     ;
   in {
     imports = [
-      ./git.nix
+      ./packages/git.nix
+      ./packages/nextcloud.nix
+      ./packages/oh-my-posh.nix
+      ./packages/rclone.nix
       ./hardware.nix
       ./i18n.nix
+      ./os.nix
       ./partition.nix
       ./software.nix
       ./users.nix

lib/modules/windows.nix

@@ -1,26 +1,18 @@
 { lib, config, ... }:
   let
     inherit (lib)
-      mkOption
+      mkDefault
       mkEnableOption
       mkIf
+      mkOption
       types
     ;
 
-    setupUser = lib.strings.stringToCharacters config.valhalla.setupUser.name;
+    capitalize = (import ../text.nix { inherit lib; }).capitalize;
-
+  in {
-    winType = types.submodule (
+    options = {
-      { config, ... }: {
+      valhalla = {
-        options = {
+        windows = {
-          setupUser = mkOption {
-            type = types.str;
-            description = "The name of the user for setting up Windows.";
-            default = lib.strings.concatStrings (
-              [(lib.strings.toUpper (builtins.elemAt setupUser 0))] ++
-              (lib.lists.drop 1 setupUser)
-            );
-          };
-
           dualboot = {
             enable = mkEnableOption "dual boot";
 
@@ -43,19 +35,13 @@
           dynamicLighting = mkEnableOption "dynamic lighting";
           adware = mkEnableOption "adware"; # Fuck you for displaying ads on an OS I fricking paid for!
         };
+      };
+    };
 
-        config = {
+    config = {
-          dualboot.linuxPercentage = mkIf (!config.dualboot.enable) 0;
+      valhalla.windows = {
-        };
+        setupUser.name = mkDefault (capitalize config.valhalla.setupUser.name);
-      });
+        dualboot.linuxPercentage = mkIf (!config.valhalla.windows.dualboot.enable) (mkDefault 0);
-  in {
-    options = {
-      valhalla = {
-        windows = mkOption {
-          type = winType;
-          description = "The options for setting up Windows.";
-          default = {};
-        };
       };
     };
   }

lib/text.nix

@@ -0,0 +1,9 @@
+{ lib, ... }: {
+    capitalize = text:
+      let
+        chars = lib.strings.stringToCharacters text;
+      in lib.strings.concatStrings (
+        [(lib.strings.toUpper (builtins.elemAt chars 0))] ++
+        (lib.lists.drop 1 chars)
+      );
+}

profiles/DerGeret/Windows/Backup.ps1

@@ -1,7 +1,7 @@
 #!/bin/pwsh
 $null = New-Module {
     . "$PSScriptRoot/../../../scripts/Common/Scripts/Context.ps1";
-    . "$PSScriptRoot/../../../scripts/Windows/OS/Manage.ps1";
+    . "$PSScriptRoot/../../../scripts/Windows/OS/Legacy.ps1";
 
     Write-Host "Starting Backup of Windows";
     $context = [Context]::new();

profiles/DerGeret/Windows/Restore.ps1

@@ -2,7 +2,7 @@
 . "$PSScriptRoot/Drivers.ps1";
 . "$PSScriptRoot/../../../scripts/Common/Scripts/Context.ps1";
 . "$PSScriptRoot/../../../scripts/Windows/Collections/Personal.ps1"
-. "$PSScriptRoot/../../../scripts/Windows/OS/Install.ps1";
+. "$PSScriptRoot/../../../scripts/Windows/OS/Manage.ps1";
 
 function Initialize-Configuration {
     # Fix synchronization between Linux and Windows clock

profiles/DerGeret/config.nix

@@ -10,6 +10,11 @@
           enable = true;
           linuxPercentage = 30;
         };
+
+        users.manuel = {
+          microsoftAccount = true;
+          groups = ["Administrators"];
+        };
       };
 
       partition.os.partitions = {
@@ -28,11 +33,13 @@
       hardware = {
         components = [
           "ROG Zenith Extreme Alpha"
+          "Predator Z301C"
         ];
 
         eyeX = true;
         amdCPU = true;
         nvidiaGPU = true;
+        logitechG = true;
         corsairDevice = true;
         elgatoWave = true;
       };

profiles/Generic/Windows/Install.ps1

@@ -1,6 +1,6 @@
 #!/bin/pwsh
 . "$PSScriptRoot/../../../scripts/Common/Scripts/Context.ps1";
-. "$PSScriptRoot/../../../scripts/Windows/OS/Install.ps1";
+. "$PSScriptRoot/../../../scripts/Windows/OS/Manage.ps1";
 . "$PSScriptRoot/../../../scripts/Windows/Collections/Generic.ps1"
 
 function Restore-Apps {

profiles/Generic/config.nix

@@ -3,6 +3,7 @@
     fs = import ../../lib/modules/partition/fs.nix;
   in {
     imports = [
+      ../manuel/config.nix
       ../../lib/modules/valhalla.nix
     ];
 
@@ -44,7 +45,10 @@
               "wheel"
               "nix-users"
             ];
+          };
+        };
 
+        linux.users.manuel = {
             defaultShell = "fish";
 
             rclone = {
@@ -57,6 +61,25 @@
                 };
               };
             };
+        };
+
+        windows.users.manuel = {
+          nextcloud = {
+            folderSyncs =
+              let
+                localPath = "C:/tools/RetroArch-Win64";
+                remotePath = "/Saved Games/RetroArch";
+              in [
+                {
+                  remotePath = "${remotePath}/Saves";
+                  localPath = "${localPath}/saves";
+                  virtualFiles = false;
+                }
+                {
+                  remotePath = "${remotePath}/System";
+                  localPath = "${localPath}/system";
+                }
+              ];
           };
         };
 

profiles/manuel/config.nix

@@ -0,0 +1,23 @@
+{ ... }: {
+  imports = [
+    ../../lib/modules/valhalla.nix
+  ];
+
+  config = {
+    valhalla = {
+      users.manuel = {
+        oh-my-posh = {
+          theme = {
+            source = ./manuel.omp.json;
+          };
+        };
+      };
+
+      partition = {
+        os = {
+          partitions = { };
+        };
+      };
+    };
+  };
+}

profiles/manuel/manuel.omp.json

@@ -0,0 +1,173 @@
+{
+    "$schema": "https://raw.githubusercontent.com/JanDeDobbeleer/oh-my-posh/main/themes/schema.json",
+    "version": 2,
+    "blocks": [
+        {
+            "type": "prompt",
+            "alignment": "left",
+            "segments": [
+                {
+                    "type": "os",
+                    "style": "diamond",
+                    "leading_diamond": "\ue0b6",
+                    "trailing_diamond": "\ue0b4",
+                    "background_templates": [
+                        "{{ if eq .OS \"ubuntu\" }}#EA531A{{ end }}",
+                        "{{ if eq .OS \"debian\" }}#D80150{{ end }}",
+                        "{{ if eq .OS \"arch\" }}#1793D1{{ end }}"
+                    ],
+                    "foreground": "p:white",
+                    "template": "{{ if ne .OS \"windows\" }}{{ .Icon }} {{ end }}"
+                },
+                {
+                    "type": "session",
+                    "style": "diamond",
+                    "leading_diamond": "\ue0b6",
+                    "trailing_diamond": "\ue0b0",
+                    "background": "p:yellow",
+                    "foreground": "p:black",
+                    "properties": {
+                        "display_host": false
+                    },
+                    "template": " {{ if .SSHSession }}\ueb39 {{ end }}{{ .UserName }} "
+                },
+                {
+                    "type": "path",
+                    "style": "powerline",
+                    "powerline_symbol": "\ue0b0",
+                    "background": "p:orange",
+                    "foreground": "p:black",
+                    "properties": {
+                        "home_icon": "~",
+                        "style": "folder"
+                    },
+                    "template": " \udb80\ude4b {{ path .Path .Location }} "
+                },
+                {
+                    "type": "dotnet",
+                    "style": "powerline",
+                    "powerline_symbol": "\ue0b0",
+                    "foreground": "p:black",
+                    "background": "#00ffff",
+                    "template": " \udb81\ude10 {{ .Full }} "
+                },
+                {
+                    "type": "java",
+                    "style": "powerline",
+                    "powerline_symbol": "\ue0b0",
+                    "background": "#4063d8",
+                    "template": " \udb82\udf37 {{ .Full }} "
+                },
+                {
+                    "type": "python",
+                    "style": "powerline",
+                    "powerline_symbol": "\ue0b0",
+                    "background": "#906cff",
+                    "template": " \udb80\udf20 {{ .Full }} "
+                },
+                {
+                    "type": "git",
+                    "style": "powerline",
+                    "powerline_symbol": "\ue0b0",
+                    "trailing_diamond": "\ue0b4",
+                    "background": "p:green",
+                    "background_templates": [
+                        "{{ if or (.Working.Changed) (.Staging.Changed) }}p:yellow{{ end }}",
+                        "{{ if and (gt .Ahead 0) (gt .Behind 0) }}p:red{{ end }}",
+                        "{{ if gt .Ahead 0 }}#49416D{{ end }}",
+                        "{{ if gt .Behind 0 }}#7A306C{{ end }}"
+                    ],
+                    "foreground": "p:black",
+                    "foreground_templates": [
+                        "{{ if or (.Working.Changed) (.Staging.Changed) }}p:black{{ end }}",
+                        "{{ if and (gt .Ahead 0) (gt .Behind 0) }}p:white{{ end }}",
+                        "{{ if gt .Ahead 0 }}p:white{{ end }}"
+                    ],
+                    "properties": {
+                        "branch_max_length": 25,
+                        "fetch_stash_count": true,
+                        "fetch_status": true,
+                        "fetch_upstream_icon": true,
+                        "upstream_icons": {
+                            "codeberg.org": "\uf330 ",
+                            "git.nuth.ch": "\uf335",
+                            "git.jonascosta.ch": "\uf339 ",
+                            "git.romhackersworld.eu": "\uf339 ",
+                            "aur.archlinux.org": "\uf303 "
+                        }
+                    },
+                    "templates": [
+                        "{{ if .UpstreamURL }} {{ url .UpstreamIcon .UpstreamURL }}{{ end }}",
+                        " {{ .HEAD }} ",
+                        "{{ if .BranchStatus }}{{ .BranchStatus }} {{ end }}",
+                        "{{ if .Working.Changed }} \uf044 {{ .Working.String }} {{ end }}",
+                        "{{ if and (.Working.Changed) (or (.Staging.Changed) (gt .StashCount 0)) }} | {{ end }}",
+                        "{{ if .Staging.Changed }} \uf046 {{ .Staging.String }} {{ end }}",
+                        "{{ if and (.Staging.Changed) (gt .StashCount 0) }} | {{ end }}",
+                        "{{ if gt .StashCount 0 }} \udb80\udd93 {{ .StashCount }}{{ end }} "
+                    ]
+                },
+                {
+                    "type": "node",
+                    "style": "powerline",
+                    "powerline_symbol": "\ue0b0",
+                    "background": "#6ca35e",
+                    "foreground": "p:white",
+                    "properties": {
+                        "fetch_version": true
+                    },
+                    "template": " \udb80\udf99 {{ if .PackageManagerIcon }}{{ .PackageManagerIcon }} {{ end }}{{ .Full }} "
+                },
+                {
+                    "type": "root",
+                    "style": "powerline",
+                    "powerline_symbol": "\ue0b0",
+                    "background": "p:yellow",
+                    "foreground": "p:white",
+                    "properties": {
+                        "root_icon": "\uf0e7"
+                    }
+                },
+                {
+                    "type": "executiontime",
+                    "style": "plain",
+                    "background": "#83769c",
+                    "foreground": "p:white",
+                    "properties": {
+                        "always_enabled": true
+                    },
+                    "template": "<transparent>\ue0b0</> \udb81\udead {{ .FormattedMs }}\u2800"
+                },
+                {
+                    "type": "text",
+                    "style": "diamond",
+                    "background": "p:blue",
+                    "trailing_diamond": "\ue0b4",
+                    "background_templates": [
+                        "{{ if gt .Code 0 }}p:red{{ end }}"
+                    ],
+                    "foreground": "p:white",
+                    "properties": {
+                        "always_enabled": true
+                    },
+                    "template": "<parentBackground>\ue0b0</> {{ if gt .Code 0 }}\uf00d{{ else }}\uf00c{{ end }} "
+                }
+            ]
+        }
+    ],
+    "transient_prompt": {
+        "background": "transparent",
+        "foreground": "p:black",
+        "template": "<p:yellow,transparent>\ue0b6</><,p:yellow> {{ .Folder }} </><p:yellow,transparent>\ue0b0</> "
+    },
+    "final_space": true,
+    "palette": {
+        "black": "#262B44",
+        "blue": "#4B95E9",
+        "green": "#59C9A5",
+        "orange": "#F07623",
+        "red": "#D81E5B",
+        "white": "#E0DEF4",
+        "yellow": "#F3AE35"
+    }
+}

scripts/Common/Scripts/BrowserAutomation.ps1

@@ -52,21 +52,25 @@ $null = New-Module {
             [string] $OutDir
         )
 
-        if (-not $OutDir) {
+        $downloadAction = $Action;
-            $OutDir = ".";
-        }
 
-        $dir = New-TemporaryDirectory;
+        Start-BrowserAutomation {
-        Write-Host "Downloading ``$URL`` using browser automation…";
+            if (-not $OutDir) {
-        $options = [OpenQA.Selenium.Firefox.FirefoxOptions]::new();
+                $OutDir = ".";
-        $options.SetPreference("browser.download.folderList", 2);
+            }
-        $options.SetPreference("browser.download.dir", "$dir");
+    
-
+            $dir = New-TemporaryDirectory;
-        $downloadChecker = {
+            Write-Host "Downloading ``$URL`` using browser automation…";
-            $files = Get-ChildItem $dir;
+            $options = [OpenQA.Selenium.Firefox.FirefoxOptions]::new();
-
+            $options.SetPreference("browser.download.folderList", 2);
-            if ((@($files)).Count -gt 0) {
+            $options.SetPreference("browser.download.dir", "$dir");
-                foreach ($file in $files) {
+    
+            $downloadChecker = {
+                $files = Get-ChildItem $dir;
+    
+                if ((@($files)).Count -eq 1) {
+                    $file = $files[0];
+                    
                     try {
                         $stream = [System.IO.File]::Open($file.FullName, [System.IO.FileMode]::Open, [System.IO.FileAccess]::ReadWrite, [System.IO.FileShare]::None);
 
@@ -77,28 +81,38 @@ $null = New-Module {
                     catch {
                         return $true;
                     }
+    
+                    return $false;
+                } else {
+                    return $true;
                 }
+            };
+    
+            $browser = [OpenQA.Selenium.Firefox.FirefoxDriver]::new($options);
+            $browser.Navigate().GoToUrl($URL);
 
-                return $false;
+            while (-not ($browser.ExecuteScript("return document.readyState;") -eq "complete")) {
-            } else {
+                Start-Sleep 0.1;
-                return $true;
             }
-        };
 
-        $browser = [OpenQA.Selenium.Firefox.FirefoxDriver]::new($options);
+            try {
-        $browser.Navigate().GoToUrl($URL);
+                $null = & $downloadAction -Browser $browser;
-        & $Action -Browser $browser;
+        
-
+                while (& $downloadChecker) {
-        while (& $downloadChecker) {
+                    Write-Host "Waiting for the download to finish…";
-            Write-Host "Waiting for the download to finish…";
+                    Start-Sleep 1;
-            Start-Sleep 1;
+                }
+        
+                $file = Get-ChildItem $dir;
+                $result = Move-Item $file $OutDir -PassThru;
+                $browser.Quit();
+                Remove-Item -Recurse $dir;
+                $result;
+            }
+            catch {
+                Write-Error $Error;
+            }
         }
-
-        $file = Get-ChildItem $dir;
-        $result = Move-Item $file $OutDir -PassThru;
-        $browser.Quit();
-        Remove-Item -Recurse $dir;
-        $result;
     }
 
     <#
@@ -113,12 +127,16 @@ $null = New-Module {
 
         .PARAMETER OutDir
         The directory to download the file to.
+
+        .PARAMETER Timeout
+        The number of seconds to wait before clicking the download button.
     #>
     function Start-BrowserDownload {
         param(
             [string] $URL,
             [string] $ButtonSelector,
-            [string] $OutDir = $null
+            [string] $OutDir = $null,
+            [double] $Timeout = 0
         )
 
         Start-CustomBrowserDownload @PSBoundParameters -Action {
@@ -126,7 +144,28 @@ $null = New-Module {
                 [OpenQA.Selenium.Firefox.FirefoxDriver] $Browser
             )
 
-            $Browser.FindElement([OpenQA.Selenium.By]::CssSelector($ButtonSelector)).Click();
+            $selector = [OpenQA.Selenium.By]::CssSelector($ButtonSelector);
+            [OpenQA.Selenium.IWebElement] $element = $null;
+
+            for ($i = 0; $i -lt 5; $i++) {
+                $element = $Browser.FindElement($selector);
+
+                if ($element) {
+                    break;
+                } else {
+                    Start-Sleep 1;
+                }
+            }
+
+            if ($Timeout -gt 0) {
+                Start-Sleep $Timeout;
+            }
+
+            if ($element) {
+                $Browser.FindElement($selector).Click();
+            } else {
+                Write-Error "Unable to find download button!";
+            }
         };
     }
 };

scripts/Common/Scripts/Config.ps1

@@ -2,15 +2,32 @@ using namespace Microsoft.Win32;
 using namespace System.Security.AccessControl;
 using namespace System.Security.Principal;
 
-enum SetupStage {
+enum WindowsInstallerStage {
     Initialize
+    Run
+    Completed
+}
+
+enum SetupStage {
     Configure
     Install
+    CreateUser
+}
+
+enum UserStage {
+    Create
+    Configure
+    Cleanup
+    Completed
 }
 
 $null = New-Module {
     [string] $configRoot = "HKLM:\Software\PortValhalla";
     [string] $stageOption = "Stage";
+    [string] $setupStageOption = "SetupStage";
+    [string] $userOption = "SetupUser";
+    [string] $userStageOption = "UserStage";
+    [string] $accountOption = "MSAccount";
     [string] $finishedOption = "Finished";
     [RegistryKey] $key = $null;
 
@@ -26,14 +43,36 @@ $null = New-Module {
             [string] $Path
         )
 
-        $job = Start-Job {
+        & {
-            $env:Value = Resolve-Path $Using:Path;
+            $ErrorActionPreference = 'Continue';
-            $env:WSLENV = "Value/p";
+            $completed = $false;
-            $result = wsl -- bash -c 'echo "$Value"';
-            wsl -e printf "%q" "$result";
-        };
 
-        Receive-Job -Wait $job;
+            while (-not $completed) {
+                $job = Start-Job {
+                    $env:Value = Resolve-Path $Using:Path;
+                    $env:WSLENV = "Value/p";
+                    $result = wsl -- bash -c 'echo "$Value"';
+                    wsl -e printf "%q" "$result";
+                };
+
+                $result = Receive-Job -Wait $job;
+
+
+                if ((Split-Path -Leaf $Path) -ne (Split-Path -Leaf $result)) {
+                    Write-Error "The result of the path conversion of ``$Path`` was unexpected: ``$result``";
+                    continue;
+                }
+
+                if ($job.State -ne ([System.Management.Automation.JobState]::Completed)) {
+                    Write-Error "An error occurred while converting ``$Path`` to a Linux path.`nOutput: ``$result``";
+                    continue;
+                }
+    
+                $completed = $true;
+            }
+
+            $result;
+        };
     }
 
     <#
@@ -75,11 +114,34 @@ $null = New-Module {
 
         $scriptPath = "$PSScriptRoot/../../Common/Scripts/config.fish";
 
-        function fish {
+        if ($env:CONFIG_MODULE) {
-            wsl --shell-type login -- nix --extra-experimental-features "nix-command flakes" run nixpkgs`#fish -- $args
+            $output = & {
-        }
+                if (-not $IsWindows) {
+                    $escapedPath = (fish -c 'string escape $argv' "$scriptPath");
+                    fish -c ". $escapedPath; $Script";
+                } else {
+                    function fish {
+                        wsl --shell-type login -- nix --extra-experimental-features "nix-command flakes" run nixpkgs`#fish -- $args
+                    }
 
-        fish -c ". $(ConvertTo-LinuxPath $scriptPath); $Script" | ConvertFrom-Json;
+                    $output = fish -c ". $(ConvertTo-LinuxPath $scriptPath); $Script";
+
+                    if (-not $?) {
+                        Write-Error "The configuration could not be retrieved!";
+                    } else {
+                        $output;
+                    }
+                }
+            }
+
+            if (-not ($output -and ($output | Test-Json))) {
+                Write-Error "The value ``$output`` is not valid JSON.";
+            } else {
+                $output | ConvertFrom-Json;
+            }
+        } else {
+            $null;
+        }
     }
 
     <#
@@ -91,10 +153,67 @@ $null = New-Module {
     #>
     function Get-Config {
         param(
+            [string] $Name,
+            [Parameter(ValueFromRemainingArguments)]
+            [string[]] $ArgumentList
+        )
+
+        Invoke-ConfigScript "getConfig $Name --json $ArgumentList";
+    }
+
+    <#
+        .SYNOPSIS
+        Gets the name of the config root.
+    #>
+    function Get-ConfigRootName {
+        return "valhalla.$($IsWindows ? "windows" : "linux")";
+    }
+
+    <#
+        .SYNOPSIS
+        Gets the name of the user root.
+    #>
+    function Get-UserRootName {
+        return "$(Get-ConfigRootName).$($IsWindows ? "winUsers" : "users")";
+    };
+
+    <#
+        .SYNOPSIS
+        Gets a user configuration.
+
+        .PARAMETER UserName
+        The name of the user to get the configuration for.
+
+        .PARAMETER Name
+        The name of the configuration to get.
+    #>
+    function Get-UserConfig {
+        param(
+            [string] $UserName = ($IsWindows ? $env:UserName : $env:USER),
+            [Parameter(Mandatory, Position = 0)]
             [string] $Name
         )
 
-        Invoke-ConfigScript "getConfig $Name --json";
+        if ((Get-Users) -contains $UserName) {
+            Get-Config "$(Get-UserRootName).$UserName.$Name";
+        } else {
+            return $null;
+        }
+    }
+
+    <#
+        .SYNOPSIS
+        Gets the attributes of a configuration object.
+
+        .PARAMETER Name
+        The name of the configuration to get the attributes of.
+    #>
+    function Get-Attributes {
+        param(
+            [string] $Name
+        )
+
+        Invoke-ConfigScript "getAttributes $Name";
     }
 
     <#
@@ -102,7 +221,19 @@ $null = New-Module {
         Gets the names of the users to create.
     #>
     function Get-Users {
-        Invoke-ConfigScript "getUsers";
+        [OutputType([string[]])]
+        param()
+        Get-Attributes "$(Get-UserRootName)";
+    }
+
+    <#
+        .SYNOPSIS
+        Gets the name of the setup user.
+    #>
+    function Get-SetupUser {
+        [OutputType([string])]
+        param()
+        Get-Config "$(Get-ConfigRootName).setupUser.name";
     }
 
     <#
@@ -148,11 +279,44 @@ $null = New-Module {
 
     <#
         .SYNOPSIS
-        Gets the name of the current setup stage.
+        Gets the name of the current stage of the Windows install script action.
     #>
     function Get-Stage {
         $stage = Get-SetupOption $stageOption;
 
+        if ($null -ne $stage) {
+            $stage = [WindowsInstallerStage]$stage;
+        }
+
+        return $stage;
+    }
+
+    <#
+        .SYNOPSIS
+        Sets the name of the current stage of the Windows install script action.
+
+        .PARAMETER Name
+        The name of the stage to set.
+    #>
+    function Set-Stage {
+        param(
+            $Name
+        )
+
+        if (-not (($null -eq $Name) -or ($Name -is [string]))) {
+            $Name = ([WindowsInstallerStage]$Name).ToString();
+        }
+
+        $null = Set-SetupOption $stageOption $Name;
+    }
+
+    <#
+        .SYNOPSIS
+        Gets the name of the current setup stage.
+    #>
+    function Get-SetupStage {
+        $stage = Get-SetupOption $setupStageOption;
+
         if ($null -ne $stage) {
             $stage = [SetupStage]$stage;
         }
@@ -167,7 +331,7 @@ $null = New-Module {
         .PARAMETER Name
         The name to set the current stage to.
     #>
-    function Set-Stage {
+    function Set-SetupStage {
         param(
             $Name
         )
@@ -176,7 +340,86 @@ $null = New-Module {
             $Name = ([SetupStage]$Name).ToString();
         }
 
-        $null = Set-SetupOption $stageOption $Name;
+        $null = Set-SetupOption $setupStageOption $Name;
+    }
+
+    <#
+        .SYNOPSIS
+        Gets the current user to set up.
+    #>
+    function Get-CurrentUser {
+        return (Get-SetupOption $userOption) ?? 0;
+    }
+
+    <#
+        .SYNOPSIS
+        Sets the index of the current user to set up.
+
+        .PARAMETER Value
+        The index of the user to set up.
+    #>
+    function Set-CurrentUser {
+        param(
+            [int] $Value
+        )
+
+        Set-SetupOption $userOption $value;
+    }
+
+    <#
+        .SYNOPSIS
+        Gets the name of the current stage of the user setup.
+    #>
+    function Get-UserStage {
+        $stage = Get-SetupOption $userStageOption;
+
+        if ($null -ne $stage) {
+            $stage = [UserStage]$stage;
+        }
+
+        return $stage;
+    }
+
+    <#
+        .SYNOPSIS
+        Sets the current stage of the user setup.
+
+        .PARAMETER Name
+        The name of the stage to set.
+    #>
+    function Set-UserStage {
+        param(
+            $Name
+        )
+
+        if (-not (($null -eq $Name) -or ($Name -is [string]))) {
+            $Name = ([UserStage]$Name).ToString();
+        }
+
+        $null = Set-SetupOption $userStageOption $Name;
+    }
+
+    <#
+        .SYNOPSIS
+        Gets the name of the microsoft account to create.
+    #>
+    function Get-MSAccountName {
+        return Get-SetupOption $accountOption;
+    }
+
+    <#
+        .SYNOPSIS
+        Sets the name of the microsoft account to create.
+
+        .PARAMETER Name
+        The name of the microsoft account to create.
+    #>
+    function Set-MSAccountName {
+        param(
+            [string] $Name
+        )
+
+        Set-SetupOption $accountOption $Name;
     }
 
     <#
@@ -184,7 +427,7 @@ $null = New-Module {
         Gets a value indicating whether the setup has finished.
     #>
     function Get-IsFinished {
-        return [bool] (Get-SetupOption $finishedOption);
+        return [bool](Get-SetupOption $finishedOption);
     }
 
     <#
@@ -211,7 +454,15 @@ $null = New-Module {
             [string] $Name
         )
 
-        Get-Config "valhalla.software.$Name";
+        Get-Config "$(Get-ConfigRootName).software.$Name";
+    }
+
+    <#
+        .SYNOPSIS
+        Checks whether the running system is a QEMU virtual machine.
+    #>
+    function Test-Qemu {
+        ((Get-WmiObject win32_computersystem).Manufacturer) -eq "QEMU";
     }
 
     <#
@@ -219,7 +470,7 @@ $null = New-Module {
         Checks whether the current user is the setup user.
     #>
     function Test-SetupUser {
-        $env:UserName -eq (Get-Config "valhalla.windows.setupUser");
+        ($IsWindows ? $env:UserName : $env:USER) -eq (Get-SetupUser);
     }
 
     <#

scripts/Common/Scripts/Operations.ps1

@@ -1,14 +1,412 @@
-function Start-Operation {
+using namespace System.Management.Automation.Host;
-    param(
-        [scriptblock] $Action
-    )
 
-    $ErrorActionPreference = 'Inquire';
+. "$PSScriptRoot/../Types/OneShotTask.ps1";
-    $env:WSLENV = "CONFIG_MODULE/p";
 
-    if ($env:CONFIG_MODULE) {
+$null = New-Module {
-        $env:CONFIG_MODULE = Resolve-Path $env:CONFIG_MODULE;
+    . "$PSScriptRoot/Config.ps1";
+    . "$PSScriptRoot/../Scripts/SoftwareManagement.ps1";
+    . "$PSScriptRoot/../Types/OneShotTask.ps1";
+    . "$PSScriptRoot/../../Windows/Scripts/Hooks.ps1";
+    . "$PSScriptRoot/../../Windows/Scripts/PowerManagement.ps1";
+    . "$PSScriptRoot/../../Windows/Scripts/Registry.ps1";
+    . "$PSScriptRoot/../../Windows/Scripts/Security.ps1";
+    . "$PSScriptRoot/../../Windows/Scripts/WSL.ps1";
+    $oneShotTaskName = "PortValhalla OneShot";
+    $logName = "Application";
+    $oneShotTrigger = 1337;
+    $taskOption = "OneShotTask";
+    # ToDo: Store "ProgramData/PortValhalla" path somewhere as const
+    $errorPath = "$env:ProgramData/PortValhalla/error.txt";
+
+    $getUserName = {
+        "$(Get-SetupUser)OneShot";
+    };
+
+    $taskSetter = {
+        param([Nullable[OneShotTask]] $Task)
+        Set-SetupOption $taskOption ([string]$Task);
+    };
+
+    function Start-Operation {
+        param(
+            [switch] $NonInteractive,
+            [switch] $NoImplicitCleanup,
+            [scriptblock] $Action
+        )
+
+        $cleanup = { };
+        $taskPending = $false;
+
+        if (-not $Global:InOperation) {
+            if ($env:DEBUG) {
+                Set-PSDebug -Trace 1;
+            }
+
+            if ($IsWindows -and ($null -ne (Get-OneShotTask))) {
+                $taskPending = $true;
+                [switch] $NonInteractive = $true;
+            }
+
+            $Global:InOperation = $true;
+            $Global:ErrorActionPreference = $NonInteractive.IsPresent ? 'Continue' : 'Inquire';
+
+            if ($IsWindows) {
+                $env:WSLENV = "CONFIG_MODULE/p";
+
+                if ($env:CONFIG_MODULE) {
+                    $env:CONFIG_MODULE = Resolve-Path $env:CONFIG_MODULE;
+                }
+
+                if (Test-Admin) {
+                    Disable-WindowsUpdateAutoRestart;
+                }
+
+                New-Alias -Force "sudo" gsudo;
+            }
+
+            if (-not $NoImplicitCleanup.IsPresent) {
+                $cleanup = {
+                    Clear-OperationResources;
+                };
+            }
+
+            & {
+                $initialized = $false;
+
+                while (-not $initialized) {
+                    if ($IsWindows) {
+                        if (-not ((Test-Command "choco") -and (Test-Command "refreshenv"))) {
+                            Invoke-Hook "Install-Chocolatey" -Fallback {
+                                # Install chocolatey
+                                New-Item -Force $PROFILE;
+                                [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072;
+                                Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'));
+                                Import-Module $env:ChocolateyInstall/helpers/chocolateyProfile.psm1;
+                                refreshenv;
+                            };
+
+                            continue;
+                        }
+
+                        if (-not (Test-ChocoPackage "powershell-core")) {
+                            Invoke-Hook "Install-PowerShellCore" -Fallback {
+                                choco install -y powershell-core --install-arguments='"ADD_FILE_CONTEXT_MENU_RUNPOWERSHELL=1 ADD_EXPLORER_CONTEXT_MENU_OPENPOWERSHELL=1 REGISTER_MANIFEST=1 USER_MU=1 ENABLE_MU=1"';
+                            };
+
+                            Restart-Intermediate;
+                            return;
+                        }
+
+                        if ($env:PWSH_PATH -and (Test-Path $env:PWSH_PATH)) {
+                            attrib "-R" "$env:PWSH_PATH\*" /S /D;
+                            Remove-Item -Recurse -Force $env:PWSH_PATH;
+                            continue;
+                        }
+
+                        if ($env:DEBUG) {
+                            $liveScriptOption = "LiveScripts";
+
+                            if (($null -eq (Get-SetupOption $liveScriptOption)) -and (Test-Qemu)) {
+                                $result = $Host.UI.PromptForChoice(
+                                    "Confirm",
+                                    "Do you wish to swap to live scripts?",
+                                    [ChoiceDescription[]]@(
+                                        [ChoiceDescription]::new("&No", "Use scripts stored in the virtual machine"),
+                                        [ChoiceDescription]::new("&Yes", "Use live scripts stored on the host")),
+                                    0);
+
+                                Set-SetupOption $liveScriptOption $result;
+
+                                if ($result -eq 1) {
+                                    Install-ChocoPackage winfsp qemu-guest-agent;
+                                    Get-Service VirtioFsSvc | Start-Service -PassThru | Set-Service -StartupType Automatic;
+
+                                    while (-not (Test-Path Z:\)) {
+                                        Start-Sleep 0.1;
+                                    }
+
+                                    foreach ($name in @("CONFIG_MODULE", "INSTALLER_SCRIPT")) {
+                                        $variable = Get-Item "Env:\$name";
+
+                                        $path = Join-Path `
+                                            "Z:\Repositories\PortValhalla" `
+                                            ([System.IO.Path]::GetRelativePath("$PSScriptRoot/../../..", $variable.Value));
+
+                                        Set-Item "Env:\$name" $path;
+                                        Write-Host "The new value of ``$name`` is ``$path``";
+                                    }
+
+                                    Restart-Intermediate;
+                                    exit;
+                                }
+                            }
+                        }
+
+                        if (-not (Test-Command "gsudo")) {
+                            Install-ChocoPackage gsudo;
+                            refreshenv;
+                            continue;
+                        }
+
+                        if ($env:DEBUG) {
+                            & {
+                                $sys32 = "$env:WINDIR/System32";
+                                $osk = (Get-Item "$sys32/osk.exe").FullName;
+                                $cmd = (Get-Item "$sys32/cmd.exe").FullName;
+
+                                if ((Get-FileHash $osk).Hash -ne (Get-FileHash $cmd).Hash) {
+                                    Set-MpPreference -ExclusionPath $osk;
+                                    gsudo -d --ti move $osk "${osk}_";
+                                    gsudo -d -s copy $cmd $osk;
+                                    continue;
+                                }
+                            };
+                        }
+
+                        if (-not (Test-Winget)) {
+                            . "$PSScriptRoot/../../Windows/Software/winget/Manage.ps1";
+                            continue;
+                        }
+
+                        if (-not (Test-Command "git")) {
+                            Install-WingetPackage Git.Git;
+                            refreshenv;
+                            continue;
+                        }
+
+                        if (-not (Test-Command "7z")) {
+                            Install-ChocoPackage 7zip.portable;
+                            refreshenv;
+                            continue;
+                        }
+
+                        if (-not (Test-Command "yq")) {
+                            Install-ChocoPackage "yq";
+                            refreshenv;
+                            continue;
+                        }
+
+                        if (-not (Test-Wsl)) {
+                            Install-Wsl;
+                            Restart-Intermediate;
+                            return;
+                        }
+
+                        if (-not (Test-WslDistribution)) {
+                            if (-not (Test-Path (Get-WslDistributionDisk))) {
+                                Install-WslDistribution;
+                            }
+
+                            Register-WslDistribution;
+                            continue;
+                        }
+
+                        if (-not (wsl --shell-type login type -t nix)) {
+                            wsl -- sh `<`(curl -L https://nixos.org/nix/install`) --daemon --yes;
+                            wsl --shutdown;
+                            continue;
+                        }
+
+                        if (-not (Test-PSPackage Selenium.WebDriver)) {
+                            Write-Host "Installing browser automation tools…";
+                            $null = Install-Package -Force Selenium.WebDriver -RequiredVersion 4.10.0 -SkipDependencies;
+                            continue;
+                        }
+
+                        Install-ChocoPackage selenium-gecko-driver firefox;
+                        Install-WingetPackage AutoHotkey.AutoHotkey;
+                        . "$PSScriptRoot/../../Windows/Software/PinnedItem/Manage.ps1";
+                    }
+
+                    Invoke-Hook "Install-PSModules" -Fallback {
+                        $modules = @(
+                            @("PSScriptAnalyzer")
+                        ) + (& {
+                            if (-not $IsWindows) {
+                                @()
+                            } else {
+                                @(
+                                    @("KnownFolders"),
+                                    @("PSWindowsUpdate"),
+                                    @("LocalAccounts", $true),
+                                    @("NuGet")
+                                )
+                            }
+                        });
+
+                        foreach ($module in $modules) {
+                            $parameters = @{ };
+
+                            if ($module -is [string]) {
+                                $module = @($module);
+                            }
+
+                            if ($module[1]) {
+                                $parameters = @{
+                                    allowPrerelease = $true;
+                                };
+                            }
+
+                            if (-not (Test-PSModule $module[0])) {
+                                Install-Module -Scope AllUsers -AcceptLicense -Force -AllowClobber $module[0] @parameters;
+                                Import-Module $module[0];
+                            }
+                        }
+                    };
+
+                    $initialized = $true;
+                }
+            }
+        }
+
+        if ($taskPending) {
+            Start-OneShot;
+        } else {
+            & $Action;
+        }
+
+        & $cleanup;
     }
 
-    & $Action;
+    <#
-}
+        .SYNOPSIS
+        Gets the current OneShot task.
+    #>
+    function Get-OneShotTask {
+        $task = Get-SetupOption $taskOption;
+
+        if ($task) {
+            return [OneShotTask]$task;
+        } else {
+            return $null;
+        }
+    }
+
+    <#
+        .SYNOPSIS
+        Registers a task for listening to OneShot invocations.
+    #>
+    function Enable-OneShotListener {
+        $tempTask = "PortValhalla Temp";
+        $user = & $getUserName;
+        $password = [string]([guid]::NewGuid());
+
+        $adminGroup = @{
+            SID = [SecurityIdentifier]::new([WellKnownSidType]::BuiltinAdministratorsSid, $null);
+        };
+
+        $null = New-LocalUser -Name $user -Password (ConvertTo-SecureString -AsPlainText $password);
+        Add-LocalGroupMember -Member $user @adminGroup;
+        $path = "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon\SpecialAccounts\UserList";
+        $null = New-Item -Force -ErrorAction SilentlyContinue $path;
+        Set-ItemProperty $path -Name $user -Value 0;
+
+        $action = New-ScheduledTaskAction -Execute "pwsh" -Argument "-Command & { $([string](Get-StartupCommand)) } 2>&1 | Tee-Object -FilePath `$env:ProgramData/PortValhalla/OneShotTask.log";
+        schtasks /Create /SC ONEVENT /EC $logName /MO "*[System[Provider[@Name='$logName'] and EventID=$($oneShotTrigger)]]" /TR cmd.exe /TN $tempTask;
+        $trigger = (Get-ScheduledTask $tempTask).Triggers;
+        $null = Register-ScheduledTask -Force $oneShotTaskName -Action $action -Trigger $trigger -RunLevel Highest -User $user -Password $password;
+        $null = Unregister-ScheduledTask -Confirm:$false $tempTask;
+    }
+
+    <#
+        .SYNOPSIS
+        Removes the OneShot task.
+    #>
+    function Disable-OneShotListener {
+        Unregister-ScheduledTask -Confirm:$false $oneShotTaskName;
+        $user = Get-LocalUser (& $getUserName);
+        [string] $sid = $user.SID;
+        Remove-LocalUser $user;
+        Get-CimInstance Win32_UserProfile | Where-Object { $_.SID -eq $sid } | Remove-CimInstance;
+    }
+
+    <#
+        .SYNOPSIS
+        Invokes a one-shot task.
+
+        .PARAMETER Task
+        The task to run.
+    #>
+    function Invoke-OneShot {
+        param(
+            [OneShotTask] $Task
+        )
+
+        & $taskSetter $Task;
+
+        & {
+            $identifier = "EventLog$oneShotTrigger";
+            $log = [System.Diagnostics.EventLog]::new($logName);
+            $log.EnableRaisingEvents = $true;
+
+            $null = Register-ObjectEvent -InputObject $log -EventName EntryWritten -Action {
+                    $entry = $Event.SourceEventArgs.Entry;
+                    $trigger = $Event.MessageData.Trigger;
+                    $identifier = $Event.MessageData.Identifier;
+
+                    if ($entry.EventID -eq $trigger) {
+                        $null = New-Event -SourceIdentifier $identifier;
+                    }
+                } `
+                -MessageData @{
+                    Trigger = $oneShotTrigger;
+                    Identifier = $identifier;
+                };
+
+            Write-EventLog -LogName $logName -Source $logName -EventId $oneShotTrigger -Message "Starting OneShot task ``$(Get-OneShotTask)``…";
+
+            for ($i = 0; $i -lt 2; $i++) {
+                Remove-Event -EventIdentifier (Wait-Event -SourceIdentifier $identifier).EventIdentifier;
+            }
+        };
+
+        if (Test-Path $errorPath) {
+            $errorMessage = Get-Content $errorPath;
+            Remove-Item $errorPath;
+
+            if ($errorMessage) {
+                Write-Error $errorMessage;
+            }
+        }
+    }
+
+    # ToDo: Store Run-OneShot and Receive-OneShot somewhere else in Windows folder
+
+    <#
+        .SYNOPSIS
+        Executes the specified action and notifies the OneShot task executor.
+    #>
+    function Start-OneShot {
+        try {
+            Write-Host "Running OneShot task ``$(Get-OneShotTask)``";
+
+            switch (Get-OneShotTask) {
+                ([OneShotTask]::InitializeMSAccount) {
+                    Initialize-UserCreation;
+                }
+                ([OneShotTask]::DisableUAC) {
+                    Disable-UAC;
+                    Register-Setup;
+                }
+            }
+        }
+        catch {
+            Set-Content -Path $errorPath -Value $Error;
+            Set-UserPermissions $errorPath;
+        }
+        finally {
+            & $taskSetter $null;
+            Write-EventLog -LogName $logName -Source $logName -EventId $oneShotTrigger -Message "The OneShot task ``$(Get-OneShotTask)`` finished.";
+        }
+    }
+
+    <#
+        .SYNOPSIS
+        Clears resources allocated during the operation.
+    #>
+    function Clear-OperationResources {
+        if ($IsWindows) {
+            Uninstall-WslDistribution;
+        }
+    }
+};

scripts/Common/Scripts/Scripting.ps1

@@ -51,6 +51,7 @@ function Write-PSScript {
 
     Import-Module PSScriptAnalyzer;
     $dirName = Split-Path -Parent $FileName;
+    $Script = ($Script -split "\r?\n") -join [System.Environment]::NewLine;
     $content = Invoke-Formatter -ScriptDefinition $Script;
     $exists = Test-Path -PathType Leaf $FileName;
 

scripts/Common/Scripts/Software.ps1

@@ -42,7 +42,7 @@ $null = New-Module {
         }
 
         if ($Names.Count -ge 1) {
-            choco install -y $ArgumentList $Names;
+            choco install -y @ArgumentList @Names;
         }
     }
 
@@ -56,23 +56,74 @@ $null = New-Module {
     function Install-WingetPackage {
         param(
             [switch] $Force,
+            [string[]] $ArgumentList,
+            [Parameter(Position=0)]
+            [string] $Name,
             [Parameter(ValueFromRemainingArguments = $true)]
-            [string[]] $Names
+            [string[]] $AdditionalNames = @()
         )
 
+        [System.Collections.ArrayList] $Names = @();
+        $null = $Names.Add($Name);
+        $Names.AddRange($AdditionalNames);
+
         foreach ($name in $Names) {
-            if ($Force.IsPresent -or -not (Test-WingetPackage $name)) {
+            if ($Force.IsPresent -or -not (Test-WingetPackage @PSBoundParameters)) {
                 winget install `
                     --accept-source-agreements --accept-package-agreements `
                     --source winget `
-                    --scope machine `
+                    $ArgumentList `
-                    --exact --id $name;
+                    --exact --id $name ;
             } else {
                 Write-Host "Package ``$name`` is already installed"
             }
         }
     }
 
+    <#
+        .SYNOPSIS
+        Installs a setup package from the specified source.
+
+        .PARAMETER Source
+        The location of the setup package.
+
+        .PARAMETER ArgumentList
+        The arguments to pass to the setup package.
+
+        .PARAMETER Local
+        A value indicating whether the setup package is stored locally.
+    #>
+    function Install-SetupPackage {
+        param(
+            [string] $Source,
+            [string[]] $ArgumentList = @("/S"),
+            [switch] $Local
+        )
+
+        [string] $dir = $null;
+        [string] $filePath = $null;
+
+        if (-not ($Local.IsPresent)) {
+            $dir = New-TemporaryDirectory;
+            Write-Host "Determining the file name of ``$Source``…";
+            $fileName = ([uri]$Source).Segments[-1];
+            Write-Host "Found name ``$fileName``";
+            $filePath = Join-Path $dir $fileName;
+
+            Write-Host "Downloading setup file from ``$Source``";
+            Invoke-WebRequest $Source -OutFile $filePath;
+        } else {
+            $filePath = $Source;
+        }
+
+        Write-Host "Starting installation of ``$(Split-Path -Leaf $filePath)``";
+        Start-Process -Wait -WorkingDirectory (Split-Path -Parent $filePath) -FilePath $filePath -ArgumentList $ArgumentList;
+
+        if ($dir) {
+            Remove-Item -Recurse $dir;
+        }
+    }
+
     <#
         .SYNOPSIS
         Installs a package downloaded from ASUS.
@@ -134,25 +185,35 @@ $null = New-Module {
             try {
                 & $download;
             } catch {
-                $Browser.ExecuteScript("document.querySelector('$cookieBannerSelector').remove()");
+                $null = $Browser.ExecuteScript("document.querySelector('$cookieBannerSelector').remove()");
                 & $download;
             }
         };
 
-        Start-Process -Wait -WorkingDirectory $dir -FilePath $file -ArgumentList "/S";
+        Start-Process -Wait -WorkingDirectory (Split-Path -Parent "$file") -FilePath "$file" -ArgumentList "/S";
         Remove-Item -Recurse $dir;
     }
 
     function Start-SoftwareInstaller {
         param(
             [string] $Name,
-            [scriptblock] $Installer = { },
+            [scriptblock] $Backup = $null,
-            [scriptblock] $Configurator = { },
+            [scriptblock] $Installer = $null,
-            [scriptblock] $UserConfigurator = { },
+            [scriptblock] $Configurator = $null,
-            [InstallerAction] $Action = [InstallerAction]::Install,
+            [scriptblock] $UserBackup = $null,
+            [scriptblock] $UserConfigurator = $null,
+            [Nullable[InstallerAction]] $Action,
             [hashtable] $Arguments
         )
 
+        [InstallerAction] $Action = & {
+            if ($null -ne $Action) {
+                $Action;
+            } else {
+                [InstallerAction]::Install;
+            }
+        };
+
         if (-not $Name) {
             $Name = Split-Path -Leaf (Split-Path -Parent ((Get-PSCallStack)[1].ScriptName));
         }
@@ -176,26 +237,54 @@ $null = New-Module {
                     installer = $installHandler;
                     arguments = $Arguments;
                 };
-    
-                if ($action -eq ([InstallerAction]::Install)) {
-                    Write-Host "Installing $Name…";
-                    & $Installer @argumentList;
-                    # ToDo: Automatically configure after installation
-                } elseif ($Action -eq ([InstallerAction]::Configure)) {
-                    Write-Host "Configuring $Name…";
-                    & $Configurator @argumentList;
 
-                    if (-not (Test-SetupUser)) {
+                switch ($Action) {
-                        $argumentList.Add("action", [InstallerAction]::ConfigureUser);
+                    ([InstallerAction]::Backup)  {
-                        & $installHandler @argumentList;
+                        if ($Backup) {
+                            Write-Host "Backing up $Name…";
+                            & $Backup @argumentList;
+                        }
                     }
-                } elseif ($Action -eq ([InstallerAction]::ConfigureUser)) {
+                    ([InstallerAction]::Install) {
-                    if ((-not $Arguments.ContainsKey($userArgument)) -or ($null -eq $Arguments[$userArgument])) {
+                        if ($Installer) {
-                        $argumentList.Add($userArgument, ($env:UserName));
+                            Write-Host "Installing $Name…";
+                            & $Installer @argumentList;
+                        }
+
+                        & $installHandler @argumentList -Action ([InstallerAction]::Configure);
+
+                        if ($UserConfigurator -and (-not (Test-SetupUser))) {
+                            & $installHandler @argumentList -Action ([InstallerAction]::ConfigureUser);
+                        }
+                    }
+                    ([InstallerAction]::Configure) {
+                        if ($Configurator) {
+                            Write-Host "Configuring $Name…";
+                            & $Configurator @argumentList;
+                        }
+                    }
+                    default {
+                        if ((-not $Arguments.ContainsKey($userArgument)) -or (-not $Arguments[$userArgument])) {
+                            $Arguments.Add($userArgument, ($IsWindows ? $env:UserName : $env:USER));
+                        }
+
+                        $user = $Arguments[$userArgument];
+
+                        switch ($_) {
+                            ([InstallerAction]::BackupUser) {
+                                if ($UserBackup) {
+                                    Write-Host "Backing up ``$Name`` for user ``$user``…";
+                                    & $UserBackup @argumentList;
+                                }
+                            }
+                            ([InstallerAction]::ConfigureUser) {
+                                if ($UserConfigurator) {
+                                    Write-Host "Configuring $Name for user ``$user``…";
+                                    & $UserConfigurator @argumentList;
+                                }
+                            }
+                        }
                     }
-    
-                    Write-Host "Configuring $Name for user ``$($Arguments[$userArgument])``…";
-                    & $UserConfigurator @argumentList;
                 }
             };
     

scripts/Common/Scripts/SoftwareManagement.ps1

@@ -53,10 +53,11 @@ function Test-ChocoPackage {
 function Test-WingetPackage {
     [OutputType([bool])]
     param(
-        [string] $ID
+        [string] $Name,
+        [string[]] $ArgumentList
     )
 
-    & { $null = winget list --accept-source-agreements -e --id $ID; $?; };
+    & { $null = winget list --accept-source-agreements -e --id $Name @ArgumentList; $?; };
 }
 
 <#
@@ -79,10 +80,14 @@ function Test-Command {
     Checks whether `winget` is working properly.
 #>
 function Test-Winget {
-    (Test-Command winget) -and -not (
+    (Test-Command winget) -and (
-        [System.Linq.Enumerable]::Any(
+        & {
-            [string[]](winget source update winget),
+            $output = winget source update winget;
-            [System.Func[string,bool]]{ param($line) $line -eq "Cancelled"; }));
+
+            $? -and -not ([System.Linq.Enumerable]::Any(
+                [string[]]($output),
+                [System.Func[string,bool]]{ param($line) $line -eq "Cancelled"; }));
+        });
 }
 
 <#
@@ -99,3 +104,18 @@ function Test-PSPackage {
 
     [bool] (Get-Package $Name -ErrorAction SilentlyContinue);
 }
+
+<#
+    .SYNOPSIS
+    Checks whether a module with the specified name is installed.
+
+    .PARAMETER Name
+    The name of the module to check.
+#>
+function Test-PSModule {
+    param(
+        [string] $Name
+    )
+
+    [bool](Get-Module -ListAvailable $Name -ErrorAction SilentlyContinue);
+}

scripts/Common/Scripts/System.ps1

@@ -29,3 +29,40 @@ function Remove-DesktopIcon {
         }
     }
 }
+
+<#
+    .SYNOPSIS
+    Adds a new shortcut to the start menu.
+
+    .PARAMETER Name
+    The name of the icon to create.
+
+    .PARAMETER Target
+    The file to link to.
+#>
+function Add-StartMenuIcon {
+    param(
+        [string] $Name,
+        [string] $Target
+    )
+
+    Import-Module KnownFolders;
+    Import-Module "$env:ChocolateyInstall/helpers/chocolateyInstaller.psm1";
+    Install-ChocolateyShortcut -ShortcutFilePath "$((Get-KnownFolder "Common Programs").Path)/$Name.lnk" -TargetPath ((Get-Item $Target).FullName);
+}
+
+<#
+    .SYNOPSIS
+    Removes icons from the task bar.
+
+    .PARAMETER Pattern
+    The pattern of the icon names to remove.
+#>
+function Remove-TaskbarItem {
+    param(
+        [string] $Pattern
+    )
+
+    Import-Module -UseWindowsPowerShell PinnedItem;
+    Get-PinnedItem -Type TaskBar | Where-Object { $_.Name -like "$Pattern" } | ForEach-Object { Remove-PinnedItem $_ };
+}

scripts/Common/Scripts/config.fish

@@ -8,8 +8,12 @@ function getConfig -S -a property
     evalModule "$CONFIG_MODULE" "$property" $argv[2..]
 end
 
+function getAttributes -S -a property
+    getConfig "$property" --apply "builtins.attrNames" --json
+end
+
 function getUsers -S
-    getConfig valhalla.users --apply "builtins.attrNames" --json
+    getAttributes "valhalla.users"
 end
 
 function isSet -S -a property

scripts/Common/Software/Oh My Posh/Manage.ps1

@@ -3,18 +3,12 @@ param (
     [hashtable] $Arguments
 )
 
+. "$PSScriptRoot/../aliae/Manage.ps1";
 . "$PSScriptRoot/../PowerShell/Profile.ps1";
 . "$PSScriptRoot/../../Scripts/Software.ps1";
 . "$PSScriptRoot/../../Types/InstallerAction.ps1";
 
 Start-SoftwareInstaller @PSBoundParameters `
-    -Installer {
-        param(
-            [scriptblock] $Installer
-        )
-
-        & $Installer -Action ([InstallerAction]::Configure);
-    } `
     -Configurator {
         Add-PowerShellProfileStatement `
             -System `
@@ -25,4 +19,39 @@ Start-SoftwareInstaller @PSBoundParameters `
                     (Get-ScriptInitializer "oh-my-posh init pwsh"),
                     (Get-ScriptInitializer "oh-my-posh completion powershell")
                 ) -join [System.Environment]::NewLine)
+    } `
+    -UserConfigurator {
+        param(
+            [hashtable] $Arguments
+        )
+
+        $theme = Get-UserConfig "oh-my-posh.theme";
+
+        if ($theme) {
+            $varName = "POSH_THEME";
+
+            if ($theme -isnot [string]) {
+                $root = "$($IsWindows ? $env:AppData : "~/.config")/oh-my-posh";
+                $path = Join-Path $root "$($theme.name).omp.json";
+                $null = New-Item -Force -ItemType Directory $root;
+
+                Set-Content $path (
+                    & {
+                        if ($IsWindows) {
+                            wsl cat $theme.source
+                        } else {
+                            cat $theme.source
+                        }
+                    });
+
+                $theme = [string] $path;
+            }
+    
+            if ($IsWindows) {
+                [System.Environment]::SetEnvironmentVariable($varName, $path, "User");
+            } else {
+                . "$PSScriptRoot/../aliae/Manage.ps1";
+                Add-EnvironmentVariable -User $Arguments.Name $varName $path;
+            }
+        }
     };

scripts/Common/Software/PowerShell/Manage.ps1

@@ -8,13 +8,6 @@ param (
 . "$PSScriptRoot/../../Types/InstallerAction.ps1";
 
 Start-SoftwareInstaller @PSBoundParameters `
-    -Installer {
-        param(
-            [scriptblock] $Installer
-        )
-
-        & $Installer -Action ([InstallerAction]::Configure);
-    } `
     -Configurator {
         [string] $globalDir = $null;
         $indicator = "# Profile Files";

scripts/Common/Software/PowerShell/Module.ps1

@@ -8,11 +8,18 @@ $null = New-Module {
 
         .PARAMETER Name
         The name of the module to install.
+
+        .PARAMETER NativeOnly
+        A value indicating whether the module is installed in Windows PowerShell only.
+
+        .PARAMETER NoProfile
+        A value indicating whether the module is not added to the profile script of users.
     #>
     function Get-ModuleInstallerComponents {
         param(
             [string] $Name,
-            [switch] $NativeOnly
+            [switch] $NativeOnly,
+            [switch] $NoProfile
         )
 
         @{
@@ -27,7 +34,14 @@ $null = New-Module {
                 )
 
                 $env:PENDING_MODULE_NAME = $Arguments.Name;
-                $installAction = { Install-Module -Scope AllUsers -Force $env:PENDING_MODULE_NAME @args };
+
+                $installAction = {
+                    $module = $env:PENDING_MODULE_NAME;
+
+                    if (-not (Get-Module -ListAvailable $module -ErrorAction SilentlyContinue)) {
+                        Install-Module -Scope AllUsers -Force $module @args;
+                    }
+                };
 
                 if (-not $Arguments.NativeOnly) {
                     & $installAction -AcceptLicense;
@@ -41,7 +55,7 @@ $null = New-Module {
                 & $Installer -Action ([InstallerAction]::Configure) @PSBoundParameters;
             };
 
-            configurator = {
+            configurator = ($NoProfile.IsPresent) ? { } : {
                 param(
                     [hashtable] $Arguments
                 )

scripts/Common/Software/PowerShell/Profile.ps1

@@ -75,9 +75,11 @@ $null = New-Module {
 
             Push-Location ~;
 
-            $profiles = $profiles |
+            $profiles = @(
-                ForEach-Object { [System.IO.Path]::GetRelativePath((Get-Location), $_) } |
+                $profiles |
-                ForEach-Object { "$HomeDir/$_" };
+                    ForEach-Object { [System.IO.Path]::GetRelativePath((Get-Location), $_) } |
+                    ForEach-Object { "$HomeDir/$_" }
+            );
 
             Pop-Location;
         }

scripts/Common/Software/Terminal-Icons/Manage.ps1

@@ -9,7 +9,7 @@ param (
 $parameters = Get-ModuleInstallerComponents "Terminal-Icons";
 
 foreach ($key in $PSBoundParameters.Keys) {
-    $parameters.Add($key, $PSBoundParameters.TryGetValue($key));
+    $parameters.Add($key, $PSBoundParameters[$key]);
 }
 
 Start-SoftwareInstaller @parameters;

scripts/Common/Software/aliae/Constants.ps1

@@ -0,0 +1,15 @@
+<#
+    .SYNOPSIS
+    Gets a powershell expression which points to the global `aliae` configuration.
+#>
+function Get-GlobalConfigExpression {
+    return "`"$($IsWindows ? "`$env:ProgramData" : "/etc")/aliae/aliae.yml`"";
+}
+
+<#
+    .SYNOPSIS
+    Gets the path to the global `aliae` configuration.
+#>
+function Get-GlobalConfigPath {
+    return & ([scriptblock]::Create((Get-GlobalConfigExpression)));
+}

scripts/Common/Software/aliae/Main.ps1

@@ -0,0 +1,50 @@
+param(
+    $Action,
+    [hashtable] $Arguments
+)
+
+. "$PSScriptRoot/Constants.ps1";
+. "$PSScriptRoot/../PowerShell/Profile.ps1";
+. "$PSScriptRoot/../../Scripts/Software.ps1";
+
+Start-SoftwareInstaller @PSBoundParameters `
+    -Configurator {
+        . "$PSScriptRoot/Constants.ps1";
+        $pathExpression = Get-GlobalConfigExpression;
+        $path = Get-GlobalConfigPath;
+        $null = New-Item -Force -ItemType Directory (Split-Path -Parent $path);
+        Copy-Item -Force "$PSScriptRoot/aliae.yml" $path;
+
+        Add-PowerShellProfileStatement `
+            -System `
+            -Category "aliae" `
+            -Script (
+                @(
+                    {
+                        #aliae
+                    },
+                    "`$globalPath = $pathExpression",
+                    {
+                        $userPath = & {
+                            if ($env:ALIAE_CONFIG) {
+                                $env:ALIAE_CONFIG;
+                            } else {
+                                "~/.aliae.yaml";
+                            }
+                        };
+
+                        if (Test-Path $globalPath) {
+                            $null = & ([scriptblock]::Create((aliae init pwsh --config $globalPath))) *>&1;
+                        }
+
+                        if (Test-Path $userPath) {
+                            $null = & ([scriptblock]::Create((aliae init pwsh))) *>&1;
+                        }
+
+                        aliae completion powershell | Out-String | Invoke-Expression;
+                    }
+                ) -join [System.Environment]::NewLine)
+    } `
+    -UserConfigurator {
+        Copy-Item -Force "$PSScriptRoot/aliae.yml" ~/.aliae.yml;
+    };

scripts/Common/Software/aliae/Manage.ps1

@@ -0,0 +1,98 @@
+$null = New-Module {
+    . "$PSScriptRoot/Constants.ps1";
+
+    <#
+        .SYNOPSIS
+        Adds an alias to an existing `aliae` configuration.
+
+        .PARAMETER Name
+        The name of the alias to add.
+
+        .PARAMETER Value
+        The script the alias should point to.
+
+        .PARAMETER User
+        The user to add the alias to.
+    #>
+    function Add-Alias {
+        param(
+            [string] $Name,
+            [string] $Value,
+            [string] $User
+        )
+
+        Edit-Config `
+            -Variables @{
+                Name = "$Name";
+                Value = "$Value";
+            } `
+            ".alias |= [((. // [])[] | select(.name != env.Name))] + [{ name: env.Name, value: env.Value }]" `
+            -User $User;
+    }
+
+    <#
+        .SYNOPSIS
+        Adds an environment variable to an existing `aliae` configuration.
+
+        .PARAMETER Name
+        The name of the variable to add.
+
+        .PARAMETER Value
+        The value of the variable.
+    #>
+    function Add-EnvironmentVariable {
+        param(
+            [string] $Name,
+            [string] $Value,
+            [string] $User
+        )
+
+        Edit-Config `
+            -Variables @{
+                Name = "$Name";
+                Value = "$Value";
+            } `
+            ".env |= [((. // [])[] | select(.name != env.Name))] + [{ name: env.Name, value: env.Value }]" `
+            -User $User;
+    }
+
+    <#
+        .SYNOPSIS
+        Edits the underlying `aliae` configuration.
+
+        .PARAMETER Script
+        The yq script to run over the configuration.
+
+        .PARAMETER User
+        The user to edit the configuration for.
+    #>
+    function Edit-Config {
+        param(
+            [string] $Script,
+            [hashtable] $Variables,
+            [string] $User
+        )
+
+        if ($User) {
+            $path = "$($IsWindows ? "~" : "$(sudo -u $User bash -c "realpath ~")")/.aliae.yaml";
+        } else {
+            $path = Get-GlobalConfigPath;
+        }
+
+        Start-Job {
+            $file = New-TemporaryFile;
+            $variables = $using:Variables;
+
+            foreach ($key in $variables.Keys) {
+                Set-Item "Env:\$key" $variables[$key];
+            }
+
+            sudo -u $using:User cp $using:path $file;
+            yq -yi $using:Script $file;
+            sudo -u $using:User cp $file $using:path;
+            Remove-Item $file;
+        } | Receive-Job -Wait;
+    }
+
+    Export-ModuleMember -Function Add-Alias,Add-EnvironmentVariable;
+};

scripts/Common/Software/aliae/aliae.yml

@@ -1,22 +1,4 @@
-alias:
+alias: []
-  - name: totsch
+env: []
-    value: git
-env:
-  - name: POSH_THEME
-    value: '{{ if eq .OS "windows" }}{{ .Home }}/Nextcloud/.omp{{ else }}/usr/local/share/oh-my-posh/themes{{ end }}/manuel.omp.json'
 path: []
-script:
+script: []
-  - value: |
-      # Profile Files
-      $profileRoot = Split-Path -Parent $PROFILE;
-      $profilePaths = @(
-          "$profileRoot/conf.d/*.ps1",
-          "{{ if eq .OS "windows"  }}$env:ProgramData{{ else }}/etc{{ end }}/powershell/conf.d/*.ps1"
-      );
-
-      foreach ($profilePath in $profilePaths) {
-          if (Test-Path $profilePath) {
-              Get-Item $profilePath | ForEach-Object { . $_; };
-          }
-      }
-    if: match .Shell "pwsh"

scripts/Common/Software/aliae/main.fish

@@ -10,28 +10,35 @@ begin
     function configureSW -V dir
         source "$dir/../bash/profile.fish"
         source "$dir/../fish/profile.fish"
-        set -l file /etc/aliae/aliae.yml
+        set -l file (pwsh -CommandWithArgs '. $args[0]; Get-GlobalConfigPath' "$dir/Constants.ps1");
-        echo "export ALIAE_CONFIG=$(string escape "$file")" | sudo tee /etc/profile.d/aliae.sh > /dev/null
         sudo install -Dm644 "$dir/aliae.yml" "$file"
 
         begin
             printf %s\n \
-                "# aliae" \
+                "if [ -f $(string escape $file) ]" \
-                'eval "$(aliae init bash)"' \
+                'then' \
+                "  eval \"\$(aliae init bash --config $(string escape $file))\"" \
+                'fi' \
+                '' \
+                'if [ -n "$ALIAE_CONFIG" ] && [ -f "$ALIAE_CONFIG" ] || [ -f ~/.aliae.yaml ]' \
+                'then' \
+                '  eval "$(aliae init bash)"' \
+                'fi' \
+                '' \
                 'eval "$(aliae completion bash)"'
         end | installBashProfile "aliae" "aliae"
 
-        begin
-            printf %s\n "" \
-                "# aliae" \
-                'eval "$(aliae init bash)"' \
-                'eval "$(aliae completion bash)"'
-        end | sudo tee /etc/skel/.bashrc > /dev/null
-
         if type -q fish
             begin
                 printf %s\n \
-                    "aliae init fish | source" \
+                    "if [ -f $(string escape $file) ]" \
+                    "  eval \"\$(aliae init bash --config $(string escape $file))\"" \
+                    'end' \
+                    '' \
+                    'if [ -n "$ALIAE_CONFIG" ] && [ -f "$ALIAE_CONFIG" ] || [ -f ~/.aliae.yaml ]' \
+                    '  aliae init fish | source' \
+                    'end' \
+                    '' \
                     "aliae completion fish | source"
             end | installFishProfile "aliae" "aliae"
         end

scripts/Common/Software/git/Manage.ps1

@@ -0,0 +1,126 @@
+param (
+    $Action,
+    [hashtable] $Arguments
+)
+
+. "$PSScriptRoot/../../Scripts/Software.ps1";
+. "$PSScriptRoot/../../Scripts/System.ps1";
+. "$PSScriptRoot/../../Types/InstallerAction.ps1";
+
+$null = New-Module {
+    param(
+        [hashtable] $Parameters
+    )
+
+    $configure = {
+        param(
+            [string] $User
+        )
+
+        $root = "valhalla";
+
+        if ($User) {
+            $root = "$root$($IsWindows ? ".windows" : '').users.$User";
+            $sudoArgs = @("-u", $User);
+            $configArgs = @("--global");
+        } else {
+            $sudoArgs = @();
+            $configArgs = @("--system");
+        }
+
+        <#
+            .SYNOPSIS
+            Gets the specified git configuration.
+
+            .PARAMETER Name
+            THe name of the configuration to get.
+        #>
+        function Get-GitConfig {
+            param(
+                [string] $Name
+            )
+
+            Get-Config "$root.git.$Name";
+        }
+
+        <#
+            .SYNOPSIS
+            Sets a configuration option in git.
+        #>
+        function Set-GitConfig {
+            sudo @sudoArgs git config @configArgs $args;
+        }
+
+        if ((-not $IsWindows) -or $User) {
+            $branch = Get-GitConfig "defaultBranch";
+            
+            if ($branch) {
+                Set-GitConfig "init.defaultBranch" $branch;
+            }
+        }
+
+        if ($User) {
+            $displayName = Get-UserConfig "displayName";
+            $mailAddress = Get-UserConfig "mailAddress";
+
+            if ($displayName) {
+                Set-GitConfig "user.name" $displayName;
+            }
+
+            if ($mailAddress) {
+                Set-GitConfig "user.email" $mailAddress;
+            }
+        }
+
+        # Git Flow
+        . {
+            $dir = New-TemporaryDirectory;
+            $key = "flow";
+            $mainBranch = Get-GitConfig "$key.mainBranch";
+            $devBranch = Get-GitConfig "$key.devBranch";
+
+            & {
+                git -C "$dir" init;
+                git -C "$dir" config user.name "PortValhalla";
+                git -C "$dir" config user.email "no-reply@valhal.la";
+                git -C "$dir" commit --allow-empty -m "Initial commit";
+                git -C "$dir" branch master;
+                git -C "$dir" branch dev;
+                git -C "$dir" flow init --defaults;
+            } | Out-Null;
+
+            if ($mainBranch) {
+                git -C "$dir" branch $mainBranch | Out-Null;;
+                sudo @sudoArgs git -C "$dir" flow config set @configArgs master $mainBranch;
+            }
+
+            if ($devBranch) {
+                git -C "$dir" branch $devBranch | Out-Null;
+                sudo @sudoArgs git -C "$dir" flow config set @configArgs develop $devBranch;
+            }
+
+            Remove-Item -Recurse -Force $dir;
+        };
+
+        # Aliases
+        [PSCustomObject] $aliases = Get-GitConfig "aliases";
+
+        if ($aliases) {
+            foreach ($alias in ($aliases | Get-Member -MemberType Properties)) {
+                Set-GitConfig "alias.$($alias.Name)" $aliases.$($alias.Name);
+            }
+        }
+    };
+
+    Start-SoftwareInstaller @Parameters `
+        -Configurator {
+            & $configure @PSBoundParameters;
+        } `
+        -UserConfigurator {
+            param(
+                [hashtable] $Arguments
+            )
+
+            & $configure -User $Arguments.Name;
+        };
+} $PSBoundParameters;

scripts/Common/Software/posh-git/Manage.ps1

@@ -9,7 +9,7 @@ param (
 $parameters = Get-ModuleInstallerComponents "posh-git";
 
 foreach ($key in $PSBoundParameters.Keys) {
-    $parameters.Add($key, $PSBoundParameters.TryGetValue($key));
+    $parameters.Add($key, $PSBoundParameters[$key]);
 }
 
 Start-SoftwareInstaller @parameters;

scripts/Common/Software/vscode/Main.ps1

@@ -0,0 +1,26 @@
+param(
+    $Action,
+    [hashtable] $Arguments
+)
+
+. "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
+. "$PSScriptRoot/../../../Common/Scripts/SoftwareManagement.ps1";
+
+Start-SoftwareInstaller @PSBoundParameters `
+    -UserConfigurator {
+        param(
+            $Arguments
+        )
+
+        $bins = @("codium", "codium-insiders", "code", "code-insiders");
+        $extensions = @("zokugun.sync-settings", "zokugun.vsix-manager");
+        $user = $Arguments.Name;
+
+        foreach ($bin in $bins) {
+            if (Test-Command "$bin") {
+                foreach ($extension in $extensions) {
+                    sudo -u "$user" "$bin" --install-extension "$extension";
+                }
+            }
+        }
+    };

scripts/Common/Software/vscode/main.fish

@@ -2,19 +2,9 @@
 begin
     set -l dir (status dirname)
     source "$dir/../../Scripts/software.fish"
-    source "$dir/../../../Common/Software/aliae/main.fish"
 
-    function userConfig -a name
+    function userConfig -V dir -a name
-        set -l bins codium codium-insiders code code-insiders
+        pwsh "$dir/Main.ps1" ConfigureUser;
-        set -l extensions zokugun.{sync-settings,vsix-manager}
-
-        for bin in $bins
-            if type -q "$bin"
-                for extension in $extensions
-                    sudo -u "$name" "$bin" --install-extension "$extension"
-                end
-            end
-        end
     end
 
     runInstaller $argv

scripts/Common/Types/InstallerAction.ps1

@@ -1,5 +1,7 @@
 enum InstallerAction {
+    Backup
     Install
     Configure
+    BackupUser
     ConfigureUser
 }

scripts/Common/Types/OneShotTask.ps1

@@ -0,0 +1,4 @@
+enum OneShotTask {
+    InitializeMSAccount
+    DisableUAC
+}

scripts/Windows/Collections/Generic.ps1

@@ -1,16 +1,16 @@
 #!/bin/pwsh
 . "$PSScriptRoot/../Software/Firefox/Install.ps1";
-. "$PSScriptRoot/../Software/git/Manage.ps1";
+. "$PSScriptRoot/../Software/git/Install.ps1";
 . "$PSScriptRoot/../Software/LGHub/Install.ps1";
-. "$PSScriptRoot/../Software/ManiaPlanet/Manage.ps1";
+. "$PSScriptRoot/../Software/ManiaPlanet/Install.ps1";
-. "$PSScriptRoot/../Software/osu!/Manage.ps1";
+. "$PSScriptRoot/../Software/osu!/Install.ps1";
-. "$PSScriptRoot/../Software/osu!lazer/Manage.ps1";
+. "$PSScriptRoot/../Software/osu!lazer/Install.ps1";
 . "$PSScriptRoot/../Software/PuTTY/Install.ps1";
-. "$PSScriptRoot/../Software/RetroArch/Manage.ps1";
+. "$PSScriptRoot/../Software/RetroArch/Install.ps1";
-. "$PSScriptRoot/../Software/reWASD/Manage.ps1";
+. "$PSScriptRoot/../Software/reWASD/Install.ps1";
-. "$PSScriptRoot/../Software/TrackMania Nations Forever/Manage.ps1";
+. "$PSScriptRoot/../Software/TrackMania Nations Forever/Install.ps1";
-. "$PSScriptRoot/../Software/TrackMania United Forever/Manage.ps1";
+. "$PSScriptRoot/../Software/TrackMania United Forever/Install.ps1";
-. "$PSScriptRoot/../Software/VisualStudio/Manage.ps1";
+. "$PSScriptRoot/../Software/VisualStudio/Install.ps1";
 . "$PSScriptRoot/../../Common/Scripts/Context.ps1";
 . "$PSScriptRoot/../../Common/Scripts/SoftwareManagement.ps1";
 

scripts/Windows/Collections/Personal.ps1

@@ -1,17 +1,17 @@
 #!/bin/pwsh
 . "$PSScriptRoot/Generic.ps1";
 . "$PSScriptRoot/../Software/Firefox/Install.ps1";
-. "$PSScriptRoot/../Software/git/Manage.ps1";
+. "$PSScriptRoot/../Software/git/Install.ps1";
 . "$PSScriptRoot/../Software/LGHub/Install.ps1";
-. "$PSScriptRoot/../Software/ManiaPlanet/Manage.ps1";
+. "$PSScriptRoot/../Software/ManiaPlanet/Install.ps1";
-. "$PSScriptRoot/../Software/osu!/Manage.ps1";
+. "$PSScriptRoot/../Software/osu!/Install.ps1";
-. "$PSScriptRoot/../Software/osu!lazer/Manage.ps1";
+. "$PSScriptRoot/../Software/osu!lazer/Install.ps1";
 . "$PSScriptRoot/../Software/PuTTY/Install.ps1";
-. "$PSScriptRoot/../Software/RetroArch/Manage.ps1";
+. "$PSScriptRoot/../Software/RetroArch/Install.ps1";
-. "$PSScriptRoot/../Software/reWASD/Manage.ps1";
+. "$PSScriptRoot/../Software/reWASD/Install.ps1";
-. "$PSScriptRoot/../Software/TrackMania Nations Forever/Manage.ps1";
+. "$PSScriptRoot/../Software/TrackMania Nations Forever/Install.ps1";
-. "$PSScriptRoot/../Software/TrackMania United Forever/Manage.ps1";
+. "$PSScriptRoot/../Software/TrackMania United Forever/Install.ps1";
-. "$PSScriptRoot/../Software/VisualStudio/Manage.ps1";
+. "$PSScriptRoot/../Software/VisualStudio/Install.ps1";
 . "$PSScriptRoot/../../Common/Scripts/Context.ps1";
 . "$PSScriptRoot/../../Common/Scripts/SoftwareManagement.ps1";
 

scripts/Windows/Drivers/Predator Z301C/Manage.ps1

@@ -4,7 +4,7 @@ param(
 )
 
 . "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
-. "$PSScriptRoot/../../Scripts/System.ps1";
+. "$PSScriptRoot/../../../Common/Scripts/System.ps1";
 
 Start-SoftwareInstaller @PSBoundParameters `
     -Installer {

scripts/Windows/Drivers/Tobii EyeX/Manage.ps1

@@ -3,7 +3,9 @@ param(
     [hashtable] $Arguments
 )
 
-$null = New-Module {
+& {
+    param($parameters);
+
     . "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
     $softwarePath = "$PSScriptRoot/../../Software";
 
@@ -12,17 +14,17 @@ $null = New-Module {
         "$softwarePath/TobiiGameHub/Manage.ps1"
     );
 
-    Start-SoftwareInstaller @PSBoundParameters `
+    Start-SoftwareInstaller @parameters `
         -Installer {
             Install-SetupPackage -Source "https://files.update.tech.tobii.com/Tobii_Eye_Tracking_Core_v2.16.8.214_x86.exe";
 
             foreach ($script in $appScripts) {
-                . $script @PSBoundParameters;
+                . $script @parameters;
             }
         } `
         -UserConfigurator {
             foreach ($script in $appScripts) {
-                . $script @PSBoundParameters;
+                . $script @parameters;
             }
         };
-};
+} $PSBoundParameters;

scripts/Windows/OS/Install.ps1

@@ -1,344 +0,0 @@
-#!/bin/pwsh
-. "$PSScriptRoot/../../../scripts/Windows/Scripts/Prerequisites.ps1";
-. "$PSScriptRoot/../../Common/Scripts/Context.ps1";
-. "$PSScriptRoot/../Software/Firefox/Install.ps1";
-. "$PSScriptRoot/Manage.ps1";
-. "$PSScriptRoot/User/Install.ps1";
-
-$null = New-Module {
-    . "$PSScriptRoot/../Scripts/Hooks.ps1";
-    . "$PSScriptRoot/../Scripts/PowerManagement.ps1";
-    . "$PSScriptRoot/../Scripts/Update.ps1";
-    . "$PSScriptRoot/../../Common/Scripts/Config.ps1";
-    . "$PSScriptRoot/../../Common/Scripts/Operations.ps1";
-    . "$PSScriptRoot/../../Common/Scripts/Software.ps1";
-    . "$PSScriptRoot/../../Common/Scripts/SoftwareManagement.ps1";
-    . "$PSScriptRoot/../../Common/Types/InstallerAction.ps1";
-
-    <#
-        .SYNOPSIS
-        Finishes the installation of a running Windows machine.
-    #>
-    function Start-WindowsInstallation {
-        Start-Operation {
-            Start-InstallationLoop;
-        };
-    }
-    
-    <#
-        .SYNOPSIS
-        Starts the installation loop.
-    #>
-    function Start-InstallationLoop {
-        while (-not (Get-IsFinished)) {
-            if ($null -eq (Get-Stage)) {
-                Set-Stage ([SetupStage]::Initialize);
-            } elseif ((Get-Stage) -eq ([SetupStage]::Initialize)) {
-                if (-not ((Test-Command "choco") -and (Test-Command "refreshenv"))) {
-                    Invoke-Hook "Install-Chocolatey" -Fallback {
-                        # Install chocolatey
-                        [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072;
-                        Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'));
-                        Import-Module $env:ChocolateyInstall/helpers/chocolateyProfile.psm1;
-                        refreshenv;
-                    };
-    
-                    continue;
-                }
-    
-                if (-not (Test-ChocoPackage "powershell-core")) {
-                    Invoke-Hook "Install-PowerShellCore" -Fallback {
-                        choco install -y powershell-core --install-arguments='"ADD_FILE_CONTEXT_MENU_RUNPOWERSHELL=1 ADD_EXPLORER_CONTEXT_MENU_OPENPOWERSHELL=1 REGISTER_MANIFEST=1 USER_MU=1 ENABLE_MU=1"';
-                    };
-    
-                    Restart-Intermediate;
-                    return;
-                }
-    
-                if (Test-Path $env:PWSH_PATH) {
-                    attrib "-R" "$env:PWSH_PATH\*" /S /D;
-                    Remove-Item -Recurse -Force $env:PWSH_PATH;
-                    continue;
-                }
-    
-                Invoke-Hook "Install-PSModules" -Fallback {
-                    Install-Module -AcceptLicense -Force PSWindowsUpdate;
-                    Install-Module -AcceptLicense -Force PSScriptAnalyzer;
-                };
-    
-                if (-not (Test-Winget)) {
-                    . "$PSScriptRoot/../Software/winget/Manage.ps1";
-                    continue;
-                }
-
-                if (-not (Test-PSPackage Selenium.WebDriver)) {
-                    Install-Module -AcceptLicense -Force NuGet;
-                    Import-Module NuGet;
-                    $null = Install-Package -Force Selenium.WebDriver -RequiredVersion 4.10.0 -SkipDependencies;
-                    continue;
-                }
-
-                Install-ChocoPackage selenium-gecko-driver firefox;
-    
-                if (-not (& { wsl --status; $?; })) {
-                    wsl --install --no-launch;
-                    Restart-Intermediate;
-                    return;
-                } else {
-                    ubuntu install --root;
-                    wsl -- sh `<`(curl -L https://nixos.org/nix/install`) --daemon --yes;
-                    wsl --shutdown;
-                }
-    
-                if (wsl --shell-type login type -t nix) {
-                    Set-Stage ([SetupStage]::Configure);
-                }
-            } else {
-                $null = Import-Module PSWindowsUpdate;
-    
-                Invoke-Hook "Invoke-WindowsUpdate" -Fallback {
-                    Update-WindowsInstallation;
-                };
-    
-                if ((Get-WURebootStatus -Silent)) {
-                    Restart-Intermediate;
-                    return;
-                }
-
-                <#
-                    .SYNOPSIS
-                    Deploys an action for each software.
-
-                    .PARAMETER Action
-                    The action to execute by default.
-                #>
-                function Deploy-SoftwareAction {
-                    param(
-                        [InstallerAction] $Action
-                    )
-
-                    $arguments = [hashtable]@{ };
-
-                    if ($Action) {
-                        $arguments.Add("action", $Action);
-                    }
-
-                    # Drivers
-                    $null = New-Module {
-                        $driverPath = "$PSScriptRoot/../Drivers";
-                        $mbPath = "$driverPath/ROG Zenith Extreme Alpha";
-    
-                        foreach ($component in (Get-Config "valhalla.hardware.components")) {
-    
-                            switch ($component) {
-                                ("ROG Zenith Extreme Alpha") {
-                                    . "$mbPath/MarvellEthernet/Manage.ps1" @arguments;
-                                    . "$mbPath/IntelWiFi/Manage.ps1" @arguments;
-                                    . "$mbPath/IntelBluetooth/Manage.ps1" @arguments;
-                                    . "$mbPath/AMDChipsetX399/Manage.ps1" @arguments;
-                                    . "$driverPath/AMDChipsetX399/Manage.ps1" @arguments;
-                                }
-                                ("Predator Z301C") {
-                                    . "$driverPath/Predator Z301C/Manage.ps1" @arguments;
-                                }
-                            }
-                        }
-
-                        if (-not $Action -or ($Action -eq ([InstallerAction]::Install))) {
-                            if (Get-Config "valhalla.hardware.amdCPU") {
-                                Install-ChocoPackage amd-ryzen-master;
-                                # ToDo: backup Ryzen energy saving plan
-                            }
-
-                            if (Get-Config "valhalla.hardware.nvidiaGPU") {
-                                Install-ChocoPackage geforce-game-ready-driver;
-                                Remove-DesktopIcon "*Geforce*";
-                            }
-
-                            if (Get-Config "valhalla.hardware.corsairLighting") {
-                                Install-ChocoPackage icue;
-                            }
-
-                            if (Get-Config "valhalla.hardware.elgatoWave") {
-                                if (-not (Test-ChocoPackage wavelink)) {
-                                    Install-ChocoPackage wavelink -ArgumentList '--install-arguments="/norestart"';
-                                    Remove-DesktopIcon "*Wave Link*";
-                                    Restart-Intermediate;
-                                    exit;
-                                }
-                            }
-                        }
-
-                        if (Get-Config "valhalla.hardware.eyeX") {
-                            . "$driverPath/Tobii EyeX/Manage.ps1" @arguments;
-                        }
-                    };
-
-                    $null = New-Module {
-                        # Windows Config
-                        $softwarePath = "$PSScriptRoot/../Software";
-                        $commonSoftware = "$PSScriptRoot/../../Common/Software";
-                        . "$softwarePath/Windows/Manage.ps1" @arguments;
-
-                        if (Test-Collection "essential") {
-                            # Essentials
-                            . "$softwarePath/OpenSSH/Manage.ps1" @arguments;
-                            . "$softwarePath/PowerShell/Manage.ps1" @arguments;
-                            . "$softwarePath/chocolatey/Manage.ps1" @arguments;
-                            . "$commonSoftware/posh-git/Manage.ps1" @arguments;
-                            . "$commonSoftware/Terminal-Icons/Manage.ps1" @arguments;
-                            . "$commonSoftware/Oh My Posh/Manage.ps1" @arguments;
-                        }
-    
-                        if (Test-Collection "common") {
-                            # Common Software
-                            . "$softwarePath/WinSCP/Manage.ps1" @arguments;
-                            . "$softwarePath/Thunderbird/Manage.ps1" @arguments;
-                        }
-
-                        if (Test-Collection "desktopExperience") {
-                            # Internet Access
-                            . "$softwarePath/Firefox/Manage.ps1" @arguments;
-
-                            if (Test-Collection "fileSync") {
-                                . "$softwarePath/Nextcloud/Manage.ps1" @arguments;
-                            }
-                        }
-                    };
-                }
-    
-                switch (Get-Stage) {
-                    ([SetupStage]::Configure) {
-                        if (Get-Config "valhalla.windows.dualboot.enable") {
-                            # Fix synchronization between Linux and Windows clocks.
-                            Set-ItemProperty "HKLM:\SYSTEM\CurrentControlSet\Control\TimeZoneInformation" -Name "RealTimeIsUniversal" -Value 1 -Type "DWord";
-    
-                            # Force time resynchronization
-                            $service = Get-Service W32Time;
-                            $stopped = ($service.Status -eq "Stopped");
-                            Start-Service $service;
-                            w32tm /resync /force;
-    
-                            if ($stopped) {
-                                Stop-Service $service;
-                            }
-                        }
-
-                        Set-Stage ([SetupStage]::Install);
-                    }
-                    ([SetupStage]::Install) {
-                        Write-Host "Entering install phase";
-                        Deploy-SoftwareAction;
-                        Set-IsFinished $true;
-                    }
-                }
-            }
-        }
-    }
-    
-    function Invoke-WindowsInstallation([Context] $context) {
-        $Global:InformationPreference = "Continue";
-        $Global:ErrorActionPreference = "Inquire";
-        $context.UserNames ??= @("Manuel");
-        Start-OldWindowsInstallationScript $context;
-    }
-    
-    function Start-OldWindowsInstallationScript([Context] $context) {
-        . "$PSScriptRoot/Upgrade.ps1";
-        $finished = $false;
-        Remove-Item Env:\POSH_THEME -ErrorAction SilentlyContinue;
-        $configPath = "$PSScriptRoot/../Config";
-        $softwarePath = "$PSScriptRoot/../Software";
-        $initialConfigStage = "InitialConfiguration";
-        $prerequisitesStage = "InstallationPrerequisites";
-        $driverStage = "DriverInstallation";
-        $softwareStage = "MachineWideSoftwareInstallation";
-        $userStage = "CreatingUser";
-        $restorationStage = "Restoring";
-    
-    
-        while (-not $finished) {
-            switch ($context.GetStage()) {
-                { (-not $_) -or ($_ -eq $initialConfigStage) } {
-                    $context.SetStage($initialConfigStage);
-            
-                    if ((Get-Command Initialize-Configuration -ErrorAction SilentlyContinue)) {
-                        Write-Information "Configuration initialization function was found. Running...";
-                        Initialize-Configuration $context;
-                    }
-            
-                    $null = Enable-WindowsOptionalFeature -Online -All -FeatureName "NetFx3";
-            
-                    . "$configPath/Windows/Install.ps1" $context;
-                    . "$configPath/Explorer/Install.ps1" $context;
-                    . "$configPath/OpenSSH/Install.ps1" $context;
-                    . "$configPath/chocolatey/Install.ps1";
-            
-                    $context.RemoveDesktopIcon("*Microsoft Edge*");
-                    $context.SetStage($prerequisitesStage);
-                    break;
-                }
-                # Always install updates
-                default {
-                    Write-Host "Starting Installation and Restoration of Windows";
-                    Update-WindowsInstallation $context;
-                }
-                $prerequisitesStage {
-                    Write-Host "Installing prerequisites for installing software";
-            
-                    if (-not $(Get-Command winget)) {
-                        choco install -y winget;
-                    }
-            
-                    Install-Module -AcceptLicense -Force "NuGet";
-                    Import-Module NuGet;
-            
-                    Install-Firefox $context;
-                    choco install -y selenium-gecko-driver;
-                    $null = Install-Package -Force Selenium.WebDriver -RequiredVersion 4.10.0 -SkipDependencies;
-            
-                    winget install --accept-source-agreements --accept-package-agreements -e --id AutoHotkey.AutoHotkey;
-            
-                    $context.SetStage($driverStage);
-                    break;
-                }
-                $driverStage {
-                    Write-Host "Installing drivers";
-            
-                    if ((Get-Command Install-PortValhallaDrivers -ErrorAction SilentlyContinue)) {
-                        Write-Information "Driver installation function was found. Starting installation";
-                        Install-PortValhallaDrivers $context;
-                    }
-            
-                    Write-Information "Finished installing drivers";
-                    $context.SetStage($softwareStage);
-                    $context.Reboot();
-                    exit;
-                }
-                $softwareStage {
-                    Write-Host "Setting up software with default app associations";
-                    . "$softwarePath/WinSCP/Install.ps1" $context;
-                    . "$softwarePath/Thunderbird/Install.ps1" $context;
-        
-                    Write-Host "Installing default settings for new users";
-                    . "$softwarePath/aliae/Install.ps1" $context;
-                    . "$softwarePath/posh-git/Install.ps1";
-                    . "$softwarePath/Terminal-Icons/Install.ps1";
-                    . "$softwarePath/Oh My Posh/Install.ps1" $context;
-                    $context.SetStage($userStage);
-                    break;
-                }
-                $userStage {
-                    Install-PersonalUsers $context;
-                    $context.SetStage($restorationStage);
-                    break;
-                }
-                $restorationStage {
-                    Restore-WindowsInstallation $context;
-                    $finished = $true;
-                    break;
-                }
-            }
-        }
-    }
-};

scripts/Windows/OS/Legacy.ps1

@@ -0,0 +1,63 @@
+#!/bin/pwsh
+. "$PSScriptRoot/../Scripts/PersonalFiles.ps1";
+. "$PSScriptRoot/../Software/Firefox/Install.ps1";
+. "$PSScriptRoot/../Software/Nextcloud/Install.ps1";
+. "$PSScriptRoot/../Collections/Personal.ps1";
+. "$PSScriptRoot/../../Common/Scripts/Context.ps1";
+
+function Backup-WindowsInstallation([Context] $context) {
+    Write-Information "Backing up Windows";
+    $Global:InformationPreference = "Continue";
+    $Global:ErrorActionPreference = "Inquire";
+    . "$PSScriptRoot/../../../scripts/Windows/Scripts/Prerequisites.ps1";
+    $backupRoot = $context.BackupRoot();
+    Backup-PersonalFiles $context;
+    Backup-PersonalApps $context;
+    $context.Backup($backupRoot, "$backupRoot.7z", @("-sdel"), $false);
+    $context.Cleanup();
+    Write-Host "Never forget to store the backup somewhere safe!";
+    Write-Host "I mean... what kind of a dumbass would ever forget to do so, right?";
+}
+
+function Restore-WindowsInstallation([Context] $context) {
+    Write-Host "Restoring Windows";
+    choco feature enable -n useEnhancedExitCodes;
+
+    function Read-Path()
+    {
+        $backupPath = Read-Host -Prompt "Please enter the path to the archive to load the backup from.";
+
+        if ($backupPath -and (-not (Test-Path -PathType Leaf $backupPath)))
+        {
+            Write-Host "No file could be found at the specified path.";
+            return Read-Path;
+        }
+        else
+        {
+            return $backupPath;
+        }
+    }
+
+    Install-Firefox $context;
+    Restore-Nextcloud $context;
+
+    Write-Information "Determining Backup Archive Path";
+    $backupPath = Read-Path;
+    $context.BackupName ??= "PortValhalla";
+    $context.RootDir = $context.GetTempDirectory();
+
+    if ($backupPath)
+    {
+        $context.Restore($backupPath, $context.BackupRoot());
+    }
+
+    Copy-UserInternationalSettingsToSystem -WelcomeScreen $True -NewUser $False;
+    Restore-PersonalFiles $context;
+
+    if ((Get-Command Restore-Apps -ErrorAction SilentlyContinue)) {
+        Restore-Apps $context;
+    }
+
+    Remove-Item -Recurse $context.RootDir;
+    $context.Cleanup();
+}

scripts/Windows/OS/Manage.ps1

@@ -1,63 +1,244 @@
 #!/bin/pwsh
-. "$PSScriptRoot/../Scripts/PersonalFiles.ps1";
+using namespace System.Security.Principal;
-. "$PSScriptRoot/../Software/Firefox/Install.ps1";
+
-. "$PSScriptRoot/../Software/Nextcloud/Install.ps1";
+. "$PSScriptRoot/../../../scripts/Windows/Scripts/Prerequisites.ps1";
-. "$PSScriptRoot/../Collections/Personal.ps1";
+. "$PSScriptRoot/../../../scripts/Windows/Scripts/WSL.ps1";
 . "$PSScriptRoot/../../Common/Scripts/Context.ps1";
+. "$PSScriptRoot/../Scripts/Security.ps1";
+. "$PSScriptRoot/../Software/Firefox/Install.ps1";
+. "$PSScriptRoot/Legacy.ps1";
+. "$PSScriptRoot/User/Install.ps1";
 
-function Backup-WindowsInstallation([Context] $context) {
+$null = New-Module {
-    Write-Information "Backing up Windows";
+    . "$PSScriptRoot/../Scripts/Deployment.ps1";
-    $Global:InformationPreference = "Continue";
+    . "$PSScriptRoot/../Scripts/Hooks.ps1";
-    $Global:ErrorActionPreference = "Inquire";
+    . "$PSScriptRoot/../Scripts/PowerManagement.ps1";
-    . "$PSScriptRoot/../../../scripts/Windows/Scripts/Prerequisites.ps1";
+    . "$PSScriptRoot/../Scripts/Registry.ps1";
-    $backupRoot = $context.BackupRoot();
+    . "$PSScriptRoot/../Scripts/Security.ps1";
-    Backup-PersonalFiles $context;
+    . "$PSScriptRoot/../Scripts/Update.ps1";
-    Backup-PersonalApps $context;
+    . "$PSScriptRoot/../Scripts/Users.ps1";
-    $context.Backup($backupRoot, "$backupRoot.7z", @("-sdel"), $false);
+    . "$PSScriptRoot/../Types/WindowsInstallerAction.ps1";
-    $context.Cleanup();
+    . "$PSScriptRoot/../../Common/Scripts/Config.ps1";
-    Write-Host "Never forget to store the backup somewhere safe!";
+    . "$PSScriptRoot/../../Common/Scripts/Operations.ps1";
-    Write-Host "I mean... what kind of a dumbass would ever forget to do so, right?";
+    . "$PSScriptRoot/../../Common/Scripts/Software.ps1";
-}
+    . "$PSScriptRoot/../../Common/Scripts/SoftwareManagement.ps1";
+    . "$PSScriptRoot/../../Common/Types/InstallerAction.ps1";
 
-function Restore-WindowsInstallation([Context] $context) {
+    <#
-    Write-Host "Restoring Windows";
+        .SYNOPSIS
-    choco feature enable -n useEnhancedExitCodes;
+        Finishes the installation of a running Windows machine.
+    #>
+    function Start-WindowsInstallation {
+        Start-Operation -NoImplicitCleanup {
+            Start-InstallationLoop ([WindowsInstallerAction]::Install);
+        };
+    }
+    
+    <#
+        .SYNOPSIS
+        Starts the installation loop.
+    #>
+    function Start-InstallationLoop {
+        param(
+            [WindowsInstallerAction] $Action
+        )
 
-    function Read-Path()
+        while ((Get-Stage) -ne ([WindowsInstallerStage]::Completed)) {
-    {
+            switch (Get-Stage) {
-        $backupPath = Read-Host -Prompt "Please enter the path to the archive to load the backup from.";
+                ($null) {
+                    Set-Stage ([WindowsInstallerStage]::Initialize);
+                    break;
+                }
+                ([WindowsInstallerStage]::Initialize) {
+                    $env:BACKUP_ARCHIVE = pwsh -Command Write-Host (
+                        Read-Host (
+                            & {
+                                switch ($Action) {
+                                    ([WindowsInstallerAction]::Backup) {
+                                        "Please select the path you wish to store your backup at"
+                                    }
+                                    ([WindowsInstallerAction]::Install) {
+                                        "Please select an archive you wish to restore from, if you wish to restore from a backup"
+                                    }
+                                }
+                            }));
 
-        if ($backupPath -and (-not (Test-Path -PathType Leaf $backupPath)))
+                    Set-Stage ([WindowsInstallerStage]::Run);
-        {
+                    break;
-            Write-Host "No file could be found at the specified path.";
+                }
-            return Read-Path;
+                ([WindowsInstallerStage]::Run) {
-        }
+                    switch ($Action) {
-        else
+                        ([WindowsInstallerAction]::Install) {
-        {
+                            while (-not (Get-IsFinished)) {
-            return $backupPath;
+                                if (Test-Admin) {
+                                    $null = Import-Module PSWindowsUpdate;
+
+                                    Invoke-Hook "Invoke-WindowsUpdate" -Fallback {
+                                        Update-WindowsInstallation;
+                                    };
+
+                                    if ((Get-WURebootStatus -Silent)) {
+                                        Restart-Intermediate;
+                                        return;
+                                    }
+                                }
+
+                                switch (Get-SetupStage) {
+                                    ($null) {
+                                        Set-SetupStage ([SetupStage]::Configure);
+                                        break;
+                                    }
+                                    ([SetupStage]::Configure) {
+                                        if (Get-Config "valhalla.windows.dualboot.enable") {
+                                            if (-not (Test-Qemu)) {
+                                                # Fix synchronization between Linux and Windows clocks.
+                                                Set-ItemProperty "HKLM:\SYSTEM\CurrentControlSet\Control\TimeZoneInformation" -Name "RealTimeIsUniversal" -Value 1 -Type "DWord";
+                                            }
+
+                                            # Force time resynchronization
+                                            $timeZoneOption = "Start";
+                                            $timeZoneKey = "HKLM:\SYSTEM\CurrentControlSet\Services\tzautoupdate";
+                                            $service = Get-Service W32Time;
+                                            $autoUpdate = (Get-Item $timeZoneKey).GetValue($timeZoneOption);
+                                            $stopped = ($service.Status -eq "Stopped");
+
+                                            $setUpdate = { param([int] $Value) Set-ItemProperty $timeZoneKey -Name $timeZoneOption $Value };
+                                            & $setUpdate 3;
+                                            Start-Service $service;
+                                            w32tm /resync /force;
+                                            & $setUpdate $autoUpdate;
+
+                                            if ($stopped) {
+                                                Stop-Service $service;
+                                            }
+                                        }
+
+                                        Set-SetupStage ([SetupStage]::Install);
+                                    }
+                                    ([SetupStage]::Install) {
+                                        Write-Host "Entering install phase";
+                                        Deploy-SoftwareAction;
+                                        Set-SetupStage ([SetupStage]::CreateUser);
+                                    }
+                                    ([SetupStage]::CreateUser) {
+                                        Install-ValhallaUsers;
+                                        Set-IsFinished $true;
+                                    }
+                                }
+                            }
+                        }
+                    }
+
+                    Set-Stage ([WindowsInstallerStage]::Completed);
+                    break;
+                }
+            }
         }
     }
-
+    
-    Install-Firefox $context;
+    function Invoke-WindowsInstallation([Context] $context) {
-    Restore-Nextcloud $context;
+        $Global:InformationPreference = "Continue";
-
+        $Global:ErrorActionPreference = "Inquire";
-    Write-Information "Determining Backup Archive Path";
+        $context.UserNames ??= @("Manuel");
-    $backupPath = Read-Path;
+        Start-OldWindowsInstallationScript $context;
-    $context.BackupName ??= "PortValhalla";
-    $context.RootDir = $context.GetTempDirectory();
-
-    if ($backupPath)
-    {
-        $context.Restore($backupPath, $context.BackupRoot());
     }
-
+    
-    Copy-UserInternationalSettingsToSystem -WelcomeScreen $True -NewUser $False;
+    function Start-OldWindowsInstallationScript([Context] $context) {
-    Restore-PersonalFiles $context;
+        . "$PSScriptRoot/Upgrade.ps1";
-
+        $finished = $false;
-    if ((Get-Command Restore-Apps -ErrorAction SilentlyContinue)) {
+        Remove-Item Env:\POSH_THEME -ErrorAction SilentlyContinue;
-        Restore-Apps $context;
+        $configPath = "$PSScriptRoot/../Config";
+        $softwarePath = "$PSScriptRoot/../Software";
+        $initialConfigStage = "InitialConfiguration";
+        $prerequisitesStage = "InstallationPrerequisites";
+        $driverStage = "DriverInstallation";
+        $softwareStage = "MachineWideSoftwareInstallation";
+        $userStage = "CreatingUser";
+        $restorationStage = "Restoring";
+    
+    
+        while (-not $finished) {
+            switch ($context.GetStage()) {
+                { (-not $_) -or ($_ -eq $initialConfigStage) } {
+                    $context.SetStage($initialConfigStage);
+            
+                    if ((Get-Command Initialize-Configuration -ErrorAction SilentlyContinue)) {
+                        Write-Information "Configuration initialization function was found. Running...";
+                        Initialize-Configuration $context;
+                    }
+            
+                    $null = Enable-WindowsOptionalFeature -Online -All -FeatureName "NetFx3";
+            
+                    . "$configPath/Windows/Install.ps1" $context;
+                    . "$configPath/Explorer/Install.ps1" $context;
+                    . "$configPath/OpenSSH/Install.ps1" $context;
+                    . "$configPath/chocolatey/Install.ps1";
+            
+                    $context.RemoveDesktopIcon("*Microsoft Edge*");
+                    $context.SetStage($prerequisitesStage);
+                    break;
+                }
+                # Always install updates
+                default {
+                    Write-Host "Starting Installation and Restoration of Windows";
+                    Update-WindowsInstallation $context;
+                }
+                $prerequisitesStage {
+                    Write-Host "Installing prerequisites for installing software";
+            
+                    if (-not $(Get-Command winget)) {
+                        choco install -y winget;
+                    }
+            
+                    Install-Module -AcceptLicense -Force "NuGet";
+                    Import-Module NuGet;
+            
+                    Install-Firefox $context;
+                    choco install -y selenium-gecko-driver;
+                    $null = Install-Package -Force Selenium.WebDriver -RequiredVersion 4.10.0 -SkipDependencies;
+            
+                    winget install --accept-source-agreements --accept-package-agreements -e --id AutoHotkey.AutoHotkey;
+            
+                    $context.SetStage($driverStage);
+                    break;
+                }
+                $driverStage {
+                    Write-Host "Installing drivers";
+            
+                    if ((Get-Command Install-PortValhallaDrivers -ErrorAction SilentlyContinue)) {
+                        Write-Information "Driver installation function was found. Starting installation";
+                        Install-PortValhallaDrivers $context;
+                    }
+            
+                    Write-Information "Finished installing drivers";
+                    $context.SetStage($softwareStage);
+                    $context.Reboot();
+                    exit;
+                }
+                $softwareStage {
+                    Write-Host "Setting up software with default app associations";
+                    . "$softwarePath/WinSCP/Install.ps1" $context;
+                    . "$softwarePath/Thunderbird/Install.ps1" $context;
+        
+                    Write-Host "Installing default settings for new users";
+                    . "$softwarePath/aliae/Install.ps1" $context;
+                    . "$softwarePath/posh-git/Install.ps1";
+                    . "$softwarePath/Terminal-Icons/Install.ps1";
+                    . "$softwarePath/Oh My Posh/Install.ps1" $context;
+                    $context.SetStage($userStage);
+                    break;
+                }
+                $userStage {
+                    Install-PersonalUsers $context;
+                    $context.SetStage($restorationStage);
+                    break;
+                }
+                $restorationStage {
+                    Restore-WindowsInstallation $context;
+                    $finished = $true;
+                    break;
+                }
+            }
+        }
     }
-
+};
-    Remove-Item -Recurse $context.RootDir;
-    $context.Cleanup();
-}

scripts/Windows/OS/Setup.ps1

@@ -186,6 +186,20 @@ function Start-Setup {
         Move-PartitionRange -Disk $Disk -1 -1 ($To + 1)
     }
 
+    function Add-StartupCommand {
+        param(
+            [string] $Script,
+            [string] $Description
+        )
+
+        $installationCommand = $oobeSettings.SelectSingleNode("./ua:FirstLogonCommands/ua:SynchronousCommand[last()]", $namespace);
+        $newCommand = $installationCommand.ParentNode.AppendChild($installationCommand.CloneNode($true));
+        $newCommand.SelectSingleNode("./ua:CommandLine", $namespace).InnerText = $Script;
+        $orderElement = $newCommand.SelectSingleNode("./ua:Order", $namespace);
+        $orderElement.InnerText = ([int]($orderElement.InnerText) + 1);
+        $newCommand.SelectSingleNode("./ua:Description", $namespace).InnerText = $Description;
+    }
+
     # Collect necessary variables
     $winpePass = Get-PassSettings "windowsPE";
     $setupConfig = Get-Component $winpePass "Microsoft-Windows-Setup";
@@ -210,22 +224,18 @@ function Start-Setup {
     foreach ($xpath in @("./ua:AutoLogon/ua:Username",
                          "./ua:UserAccounts/ua:LocalAccounts/ua:LocalAccount/ua:Name",
                          "./ua:UserAccounts/ua:LocalAccounts/ua:LocalAccount/ua:DisplayName")) {
-        $oobeSettings.SelectSingleNode($xpath, $namespace).InnerText = $valhallaConfig.setupUser;
+        $oobeSettings.SelectSingleNode($xpath, $namespace).InnerText = $valhallaConfig.setupUser.name;
     }
 
-    $installationCommand = $oobeSettings.SelectSingleNode("./ua:FirstLogonCommands/ua:SynchronousCommand[last()]", $namespace);
+    Add-StartupCommand `
-    $newCommand = $installationCommand.ParentNode.AppendChild($installationCommand.CloneNode($true));
+            -Script (
-
+                "powershell -Command " +
-    $newCommand.SelectSingleNode("./ua:CommandLine", $namespace).InnerText = `
+                ($env:DEBUG ? "`$env:DEBUG = $([int]$env:DEBUG);" : "") +
-        "powershell -Command " + `
+                "`$env:PWSH_PATH = $(Get-PathInjection $env:PWSH_PATH);" +
-        "`$env:PWSH_PATH = $(Get-PathInjection $env:PWSH_PATH);" + `
+                "`$env:INSTALLER_SCRIPT = $(Get-ScriptPathInjection $env:SETUP_SCRIPT_NAME);" +
-        "`$env:INSTALLER_SCRIPT = $(Get-ScriptPathInjection $env:SETUP_SCRIPT_NAME);" + `
+                "`$env:CONFIG_MODULE = $(Get-ScriptPathInjection $env:CONFIG_MODULE);" +
-        "`$env:CONFIG_MODULE = $(Get-ScriptPathInjection $env:CONFIG_MODULE);" + `
+                "& (Join-Path `$env:PWSH_PATH pwsh) `$env:INSTALLER_SCRIPT;") `
-        "& (Join-Path `$env:PWSH_PATH pwsh) `$env:INSTALLER_SCRIPT;";
+            -Description "Install PowerShell Core and git and run setup script";
-    
-    $orderElement = $newCommand.SelectSingleNode("./ua:Order", $namespace);
-    $orderElement.InnerText = ([int]($orderElement.InnerText) + 1);
-    $newCommand.SelectSingleNode("./ua:Description", $namespace).InnerText = "Install PowerShell Core and git and run setup script";
 
     if ($valhallaConfig.dualboot.enable) {
         $diskSize = [long](ConvertFrom-Csv (wmic diskdrive where "Index=$(Get-InstallDisk)" get Size | ForEach-Object { "$_".Trim(); })).Size;

scripts/Windows/Resources/Autounattend.template.xml

@@ -206,12 +206,6 @@
                 </SynchronousCommand> -->
                 <SynchronousCommand wcm:action="add">
                     <Order>1</Order>
-                    <RequiresUserInput>true</RequiresUserInput>
-                    <CommandLine>cmd /C wmic useraccount where name="Admin" set PasswordExpires=false</CommandLine>
-                    <Description>Password Never Expires</Description>
-                </SynchronousCommand>
-                <SynchronousCommand wcm:action="add">
-                    <Order>2</Order>
                     <RequiresUserInput>false</RequiresUserInput>
                     <CommandLine>powershell -Command "Set-ExecutionPolicy -Force Bypass"</CommandLine>
                     <Description>Allow PowerShell scripts from anywhere.</Description>

scripts/Windows/Scripts/AppAssociations.ps1

@@ -1,8 +1,9 @@
 using namespace System.Xml;
 
 $null = New-Module {
+    $associationElementName = "Association";
     $rootSelector = "/DefaultAssociations";
-    $associationSelector = "./Association";
+    $associationSelector = "./$associationElementName";
 
     <#
         .SYNOPSIS
@@ -32,7 +33,9 @@ $null = New-Module {
     function Get-DefaultAppAssociations {
         [OutputType([xml])]
         param()
-        [xml]::new().LoadXml(((DISM /Online /Get-DefaultAppAssociations) | Select-Object -Skip 6 | Select-Object -SkipLast 2 | Out-String));
+        $result = [xml]::new();
+        $result.LoadXml(((DISM /Online /Get-DefaultAppAssociations) | Select-Object -Skip 6 | Select-Object -SkipLast 2 | Out-String));
+        $result;
     }
 
     <#
@@ -62,7 +65,12 @@ $null = New-Module {
         if ($candidates.Count -eq 1) {
             $association = $candidates[0];
         } else {
-            $association = ([System.Xml.XmlNode]($document.SelectNodes((& $getSelector)) | Select-Object -Last 1)[0]).CloneNode($true);
+            $association = $document.SelectSingleNode($rootSelector).AppendChild($document.CreateElement($associationElementName));
+
+            foreach ($attributeName in @("Identifier", "ProgId", "ApplicationName")) {
+                $null = $association.Attributes.Append($document.CreateAttribute($attributeName));
+            }
+
             $association.Identifier = $Identifier;
         }
 
@@ -87,7 +95,7 @@ $null = New-Module {
         $associations = $root.SelectNodes((& $getSelector));
 
         # Reorder associations by their Identifier
-        $associations | ForEach-Object { $root.RemoveChild($_); } | Sort-Object -Property "Identifier" | ForEach-Object { $root.AppendChild($_); };
+        $null = $associations | ForEach-Object { $root.RemoveChild($_) } | Sort-Object -Property "Identifier" | ForEach-Object { $root.AppendChild($_); };
 
         $configFile = New-TemporaryFile;
         $writerSettings = [XmlWriterSettings]::new();
@@ -96,7 +104,7 @@ $null = New-Module {
         $writer = [XmlWriter]::Create($configFile.FullName, $writerSettings);
         $document.Save($writer);
         $writer.Dispose();
-        DISM /Online "/Import-DefaultAppAssociations:$($configFile.FullName)";
+        $null = DISM /Online "/Import-DefaultAppAssociations:$($configFile.FullName)";
         Remove-Item $configFile;
     }
 }

scripts/Windows/Scripts/Deployment.ps1

@@ -0,0 +1,293 @@
+. "$PSScriptRoot/../../Common/Scripts/Software.ps1";
+. "$PSScriptRoot/../../Common/Scripts/SoftwareManagement.ps1";
+. "$PSScriptRoot/../../Common/Types/InstallerAction.ps1";
+
+<#
+    .SYNOPSIS
+    Deploys an action for each software selected for installation.
+
+    .PARAMETER
+    The action to execute.
+#>
+function Deploy-SoftwareAction {
+    param(
+        [System.Nullable[InstallerAction]] $Action = $null
+    )
+
+    [bool] $install = $false;
+    $arguments = [hashtable]@{ };
+
+    if ($null -ne $Action) {
+        $install = ($Action -eq ([InstallerAction]::Install));
+        $null = $arguments.Add("action", $Action);
+    } else {
+        $install = $true;
+    }
+
+    # Drivers
+    & {
+        $driverPath = "$PSScriptRoot/../Drivers";
+        $mbPath = "$driverPath/ROG Zenith Extreme Alpha";
+
+        if ($install) {
+            if (Get-Config "valhalla.hardware.elgatoWave") {
+                if (-not (Test-ChocoPackage wavelink)) {
+                    Install-ChocoPackage wavelink -ArgumentList '--install-arguments="/norestart"';
+                    Remove-DesktopIcon "*Wave Link*";
+                    Restart-Intermediate;
+                    exit;
+                }
+            }
+        }
+
+        foreach ($component in (Get-Config "valhalla.hardware.components")) {
+            switcH ($component) {
+                ("ROG Zenith Extreme Alpha") {
+                    & "$mbPath/MarvellEthernet/Manage.ps1" @arguments;
+                    & "$mbPath/IntelWiFi/Manage.ps1" @arguments;
+                    & "$mbPath/IntelBluetooth/Manage.ps1" @arguments;
+                    & "$mbPath/AMDChipsetX399/Manage.ps1" @arguments;
+                    & "$driverPath/AMDChipsetX399/Manage.ps1" @arguments;
+                }
+                ("Predator Z301C") {
+                    & "$driverPath/Predator Z301C/Manage.ps1" @arguments;
+                }
+            }
+        }
+
+        if ($install) {
+            if (Get-Config "valhalla.hardware.amdCPU") {
+                Install-ChocoPackage amd-ryzen-master;
+                # ToDo: backup Ryzen energy saving plan
+            }
+
+            if (Get-Config "valhalla.hardware.nvidiaGPU") {
+                Install-ChocoPackage geforce-game-ready-driver;
+                Remove-DesktopIcon "*Geforce*";
+            }
+
+            if (Get-Config "valhalla.hardware.corsairDevice") {
+                Install-ChocoPackage icue;
+            }
+        }
+
+        if (Get-Config "valhalla.hardware.eyeX") {
+            & "$driverPath/Tobii EyeX/Manage.ps1" @arguments;
+        }
+    };
+
+    & {
+        $softwarePath = "$PSScriptRoot/../Software";
+        $commonSoftware = "$PSScriptRoot/../../Common/Software";
+
+        # Windows Config
+        & "$softwarePath/Windows/Manage.ps1" @arguments;
+
+        if (Get-Config "valhalla.hardware.logitechG") {
+            & "$softwarePath/LGHub/Manage.ps1" @arguments;
+        }
+
+        # Essentials
+        if (Test-Collection "essential") {
+            & "$softwarePath/aliae/Main.ps1" @arguments;
+            & "$softwarePath/OpenSSH/Manage.ps1" @arguments;
+            & "$softwarePath/PowerShell/Manage.ps1" @arguments;
+            & "$softwarePath/chocolatey/Manage.ps1" @arguments;
+            & "$softwarePath/zoxide/Manage.ps1" @arguments;
+            & "$commonSoftware/posh-git/Manage.ps1" @arguments;
+            & "$commonSoftware/Terminal-Icons/Manage.ps1" @arguments;
+            & "$softwarePath/Oh My Posh/Manage.ps1" @arguments;
+
+            if (Get-Config "valhalla.windows.dualboot") {
+                & "$softwarePath/Ext4Fsd/Main.ps1" @arguments;
+            }
+
+            if ($install) {
+                Install-ChocoPackage `
+                    procexp `
+                    procmon `
+                    ;
+
+                Install-WingetPackage `
+                    KDE.KDEConnect `
+                    ;
+            }
+        }
+
+        # Common Software
+        if (Test-Collection "common") {
+            & "$softwarePath/WinSCP/Manage.ps1" @arguments;
+            & "$softwarePath/Thunderbird/Manage.ps1" @arguments;
+            & "$softwarePath/PuTTY/Manage.ps1" @arguments;
+
+            if ($install) {
+                Install-ChocoPackage `
+                    7zip `
+                    chocolateygui `
+                    DefaultProgramsEditor `
+                    bitwarden `
+                    keepass `
+                    ;
+
+                Install-WingetPackage `
+                    SomePythonThings.WingetUIStore `
+                    ;
+
+                Remove-DesktopIcon "UniGetUI*";
+            }
+        }
+
+        if (Test-Collection "desktopExperience") {
+            if ($install) {
+                # Fonts
+                Install-ChocoPackage nerd-fonts-CascadiaCode;
+
+                # Internet Access
+                Install-WingetPackage Brave.Brave kamranahmedse.pennywise;
+                Remove-DesktopIcon "*Brave*";
+                Remove-TaskbarItem "*Brave*";
+                Remove-DesktopIcon "Pennywise*";
+
+                # Tools
+                Install-SetupPackage -Source "https://github.com/mRemoteNG/mRemoteNG/releases/download/2023.03.03-v1.77.3-nb/mRemoteNG-Installer-1.77.3.nb-1784.msi" -ArgumentList "/Quiet";
+                Remove-DesktopIcon "mRemoteNG*";
+
+                Install-ChocoPackage `
+                    gimp `
+                    gpu-z `
+                    windirstat `
+                    winmerge `
+                    handbrake `
+                    hwmonitor `
+                    qbittorrent `
+                    imgburn `
+                    inkscape `
+                    krita `
+                    MetaX `
+                    obs-studio `
+                    ;
+
+                Remove-DesktopIcon "GIMP*";
+                Remove-DesktopIcon "GPU-Z*";
+                Remove-DesktopIcon "WinDirStat*";
+                Remove-DesktopIcon "*HWMonior*";
+                Remove-DesktopIcon "ImgBurn*";
+                Remove-DesktopIcon "InkScape*";
+                Remove-DesktopIcon "Krita*";
+                Remove-DesktopIcon "MetaX*";
+                Remove-DesktopIcon "OBS Studio*";
+
+                Install-WingetPackage `
+                    AntSoftware.AntRenamer `
+                    AppWork.JDownloader `
+                    ;
+
+                Remove-DesktopIcon "JDownloader*";
+            }
+
+            # ToDo: Consider hiding behind own config?
+            & "$softwarePath/Ubiquiti UniFi Controller/Manage.ps1" @arguments;
+
+            # Internet Access
+            & "$softwarePath/Firefox/Manage.ps1" @arguments;
+            & "$softwarePath/MSEdgeRedirect/Manage.ps1" @arguments;
+
+            if (Test-Collection "fileSync") {
+                & "$softwarePath/Nextcloud/Main.ps1" @arguments;
+            }
+        }
+
+        if (Test-Collection "socialMedia") {
+            if ($install) {
+                Install-ChocoPackage `
+                    signal `
+                    threema-desktop `
+                    element-desktop `
+                    teamspeak `
+                    ;
+
+                Remove-DesktopIcon "*Element*";
+                Remove-DesktopIcon "*TeamSpeak*";
+
+                Install-WingetPackage Discord.Discord;
+                Remove-DesktopIcon "*Discord*";
+            }
+        }
+
+        if (Test-Collection "media") {
+            if ($install) {
+                Install-ChocoPackage `
+                    k-litecodecpackmega `
+                    vlc `
+                    ;
+
+                Remove-DesktopIcon "VLC*";
+                # When installing Jellyfin Media Player after iCUE, Jellyfin will try to reboot automatically
+                Install-ChocoPackage jellyfin-media-player -ArgumentList "--install-args","/norestart";
+                Remove-DesktopIcon "Jellyfin Media Player*";
+                Install-WingetPackage Ytmdesktop.Ytmdesktop;
+                Remove-DesktopIcon "Youtube Music*";
+            }
+        }
+
+        if (Test-Collection "coding") {
+            if ($install) {
+                & "$softwarePath/vscode/Main.ps1" @arguments;
+
+                Install-ChocoPackage `
+                    gh `
+                    github-desktop `
+                    ida-free `
+                    HxD `
+                    docker-desktop `
+                    imhex `
+                    dotpeek `
+                    ;
+
+                Remove-DesktopIcon "IDA *";
+                Remove-DesktopIcon "GitHub*";
+                Remove-DesktopIcon "Docker*";
+            }
+
+            & "$softwarePath/VisualStudio/Manage.ps1" @arguments;
+
+            # Node.js
+            & "$softwarePath/NVS/Manage.ps1" @arguments;
+        }
+
+        # Gaming
+        if (Test-Collection "gaming") {
+            if ($install) {
+                Install-ChocoPackage `
+                    goggalaxy `
+                    epicgameslauncher `
+                    rayman-controlpanel `
+                    ppsspp `
+                    ;
+
+                Remove-DesktopIcon "*Epic Games*";
+                Remove-DesktopIcon "*PPSSPP *-Bit*";
+
+                Install-ChocoPackage `
+                    steam `
+                    ubisoft-connect `
+                    -ArgumentList "--ignore-checksums" `
+                    ;
+
+                Remove-DesktopIcon "*Steam*";
+                Remove-DesktopIcon "*Ubisoft Connect*";
+
+                Install-WingetPackage ElectronicArts.EADesktop;
+                Remove-DesktopIcon "EA.*";
+            }
+
+            & "$softwarePath/TrackMania Nations Forever/Manage.ps1" @arguments;
+            & "$softwarePath/TrackMania United Forever/Manage.ps1" @arguments;
+            & "$softwarePath/ManiaPlanet/Manage.ps1" @arguments;
+            & "$softwarePath/osu!/Manage.ps1" @arguments;
+            & "$softwarePath/osu!lazer/Manage.ps1" @arguments;
+            & "$softwarePath/RetroArch/Manage.ps1" @arguments;
+            & "$softwarePath/reWASD/Manage.ps1" @arguments;
+        }
+    };
+}

scripts/Windows/Scripts/PowerManagement.ps1

@@ -1,17 +1,62 @@
 using namespace Microsoft.Win32;
 
 $null = New-Module {
+    . "$PSScriptRoot/../Scripts/Registry.ps1";
+    . "$PSScriptRoot/../../Common/Scripts/Config.ps1";
     . "$PSScriptRoot/../../Common/Scripts/Scripting.ps1";
     [RegistryKey] $key = $null;
-    $runOncePath = "HKLM:\Software\Microsoft\Windows\CurrentVersion\RunOnce";
+    $runOncePath = "Software\Microsoft\Windows\CurrentVersion\RunOnce";
+    $systemRunOncePath = "HKLM:\$runOncePath";
+    $logonPath = "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon"
     $runOnceName = "PortValhalla";
+    $autologinOption = "AutoAdminLogon";
+    $domainOption = "DefaultDomainName";
+    $userOption = "DefaultUserName";
+    $passwordOption = "DefaultPassword";
 
     <#
         .SYNOPSIS
         Gets the reghistry key containing the `RunOnce` commands.
     #>
     function Get-RunOnceKey {
-        Get-Item $runOncePath;
+        param(
+            [RegistryKey] $UserKey
+        )
+
+        [string] $path = $null;
+
+        if ($UserKey) {
+            $path = Join-Path ($UserKey.PSPath) $runOncePath;
+        } else {
+            $path = $systemRunOncePath;
+        }
+
+        if (-not (Test-Path $path)) {
+            New-Item $path;
+        } else {
+            Get-Item $path;
+        }
+    }
+
+    <#
+        .SYNOPSIS
+        Generates a script for executing the installer.
+    #>
+    function Get-StartupScript {
+        "pwsh -Command " + (Get-StartupCommand);
+    }
+
+    <#
+        .SYNOPSIS
+        Generates a command for running the installer using `pwsh`.
+    #>
+    function Get-StartupCommand {
+        ($env:PWSH_PATH ? "`$env:PWSH_PATH = $(ConvertTo-Injection $env:PWSH_PATH);" : "") +
+        ($env:DEBUG ? "`$env:DEBUG = $([int]$env:DEBUG);" : "") +
+        ($env:BACKUP_ARCHIVE ? "`$env:BACKUP_ARCHIVE = $(ConvertTo-Injection (Resolve-Path $env:BACKUP_ARCHIVE));" : "") +
+        "`$env:INSTALLER_SCRIPT = $(ConvertTo-Injection (Resolve-Path $env:INSTALLER_SCRIPT));" +
+        "`$env:CONFIG_MODULE = $(ConvertTo-Injection (Resolve-Path $env:CONFIG_MODULE));" +
+        "& `$env:INSTALLER_SCRIPT;";
     }
 
     <#
@@ -23,28 +68,123 @@ $null = New-Module {
     #>
     function Register-Setup {
         param(
+            [Parameter(ParameterSetName="System")]
+            [switch] $System,
+            [Parameter(ParameterSetName="DefaultUser", Mandatory)]
+            [switch] $DefaultUser,
+            [Parameter(ParameterSetName="User", Mandatory)]
+            [switch] $User,
+            [Parameter(ParameterSetName="User")]
+            [Parameter(ParameterSetName="SpecificUser", Mandatory)]
             [RegistryKey] $UserKey
         )
 
-        $key = Get-RunOnceKey $UserKey;
+        if ($DefaultUser.IsPresent) {
+            Edit-DefaultUserKey {
+                param(
+                    [RegistryKey] $Key
+                )
 
-        Set-ItemProperty -Path $key.PSPath -Name $runOnceName -Type "ExpandString" -Value (
+                Register-Setup -UserKey $Key;
-            "pwsh -Command " +
+            }
-            "`$env:PWSH_PATH = $(ConvertTo-Injection $env:PWSH_PATH);" +
-            "`$env:INSTALLER_SCRIPT = $(ConvertTo-Injection $env:INSTALLER_SCRIPT);" +
-            "`$env:CONFIG_MODULE = $(ConvertTo-Injection $env:CONFIG_MODULE);" +
-            "& `$env:INSTALLER_SCRIPT;"
-        );
 
+            return;
+        }
+
+        if ($User.IsPresent -or $UserKey) {
+            if (-not $UserKey) {
+                $UserKey = Get-Item "HKCU:\";
+            }
+
+            $key = Get-RunOnceKey $UserKey;
+        } else {
+            $key = Get-RunOnceKey;
+        }
+
+        Set-ItemProperty -Path $key.PSPath -Name $runOnceName -Type "ExpandString" -Value (Get-StartupScript);
         $key.Handle.Close();
     }
 
+    <#
+        .SYNOPSIS
+        Clears leftovers from past registrations.
+    #>
+    function Clear-SetupRegistration {
+        Edit-DefaultUserKey {
+            param(
+                [RegistryKey] $Key
+            )
+
+            $runOnceKey = Get-RunOnceKey $Key;
+            Remove-Item $runOnceKey.PSPath;
+        }
+    }
+
+    <#
+        .SYNOPSIS
+        Sets the user to login automatically on boot.
+
+        .PARAMETER Name
+        The name of the user to login automatically.
+    #>
+    function Set-AutologinUser {
+        param(
+            [string] $Name
+        )
+
+        Set-ItemProperty $logonPath -Name $autologinOption "1";
+
+        if (-not $Name) {
+            $Name = Get-SetupUser;
+        }
+
+        $options = @{
+            $domainOption = "";
+            $userOption = $Name;
+            $passwordOption = "";
+        };
+
+        foreach ($key in $options.Keys) {
+            Set-ItemProperty $logonPath -Name $key -Value $options[$key];
+        }
+    }
+
+    <#
+        .SYNOPSIS
+        Disables the automatic login.
+    #>
+    function Disable-Autologin {
+        Set-ItemProperty $logonPath -Name $autologinOption "0";
+
+        foreach ($key in @($domainOption, $userOption, $passwordOption)) {
+            Remove-ItemProperty $logonPath -Name $key -ErrorAction SilentlyContinue;
+        }
+    }
+
     <#
         .SYNOPSIS
         Reboots the machine intermediately and restarts the setup after the next login.
     #>
     function Restart-Intermediate {
-        Register-Setup;
+        param(
-        Restart-Computer;
+            [Parameter(ParameterSetName="None")]
+            [switch] $NoRegister,
+            [Parameter(ParameterSetName="Default", Mandatory)]
+            [switch] $DefaultUser,
+            [Parameter(ParameterSetName="Current", Mandatory)]
+            [switch] $CurrentUser
+        )
+
+        if (-not $NoRegister.IsPresent) {
+            if ($DefaultUser.IsPresent) {
+                Register-Setup -DefaultUser;
+            } elseif ($CurrentUser.IsPresent) {
+                Register-Setup -User;
+            } else {
+                Register-Setup;
+            }
+        }
+
+        Restart-Computer -Force;
     }
 }

scripts/Windows/Scripts/Registry.ps1

@@ -1,6 +1,8 @@
 using namespace Microsoft.Win32;
 
 $null = New-Module {
+    $wuPolicyPath = "HKLM:\SOFTWARE\Policies\Microsoft\Windows\WindowsUpdate";
+
     function Edit-DefaultUserKey {
         param(
             [scriptblock] $Action
@@ -16,4 +18,62 @@ $null = New-Module {
         [System.GC]::Collect();
         & reg unload $regRootPath;
     }
+
+    <#
+        .SYNOPSIS
+        Sets a message to show on the login screen.
+
+        .PARAMETER Caption
+        The title of the message.
+
+        .PARAMETER Message
+        The text of the message.
+    #>
+    function Set-BootMessage {
+        param(
+            [string] $Caption,
+            [string] $Message
+        )
+
+        $options = @{
+            legalnoticecaption = $Caption;
+            legalnoticetext = $Message;
+        };
+
+        foreach ($key in $options.Keys) {
+            Set-ItemProperty "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System" `
+                -Name $key `
+                -Type "String" `
+                -Value ($options[$key]);
+        }
+    }
+
+    <#
+        .SYNOPSIS
+        Disables the boot message.
+    #>
+    function Disable-BootMessage {
+        Set-BootMessage;
+    }
+
+    <#
+        .SYNOPSIS
+        Disables automatic reboots by Windows Update.
+    #>
+    function Disable-WindowsUpdateAutoRestart {
+        $path = "$wuPolicyPath\AU";
+        $null = New-Item -Force $path -ErrorAction SilentlyContinue;
+
+        Set-ItemProperty $path `
+            -Name NoAutoRebootWithLoggedOnUsers `
+            -Value 1;
+    }
+
+    <#
+        .SYNOPSIS
+        Resets the automatic reboot state.
+    #>
+    function Reset-WindowsUpdateAutoRestart {
+        Remove-Item -Recurse "$wuPolicyPath";
+    }
 }

scripts/Windows/Scripts/Restoration.ps1

@@ -0,0 +1,171 @@
+using namespace System.Collections.Generic;
+. "$PSScriptRoot/../../Common/Scripts/System.ps1";
+
+$null = New-Module {
+    $pathResolver = {
+        param(
+            [string] $User,
+            [string] $Path
+        )
+
+        [string] $result = $null;
+
+        if ($User) {
+            $result = "Users/$User";
+        } else {
+            $result = "System";
+        }
+
+        if (-not $Path) {
+            $Path = "Files";
+        }
+
+        $result = Join-Path $result $Path;
+        return $result;
+    };
+
+    <#
+        .SYNOPSIS
+        Gets the name of the variable holding the path to the backup archive of the current machine.
+    #>
+    function Get-ArchiveVariableName {
+        return "BACKUP_ARCHIVE";
+    }
+
+    <#
+        .SYNOPSIS
+        Gets the path to the backup archive of the current machine.
+    #>
+    function Get-ValhallaBackupArchive {
+        (Get-Item "Env:\$(Get-ArchiveVariableName)").Value;
+    }
+
+    <#
+        .SYNOPSIS
+        Sets the path to the backup archive of the current machine.
+
+        .PARAMETER Path
+        The path to set.
+    #>
+    function Set-ValhallaBackupArchive {
+        param(
+            [string] $Path
+        )
+
+        Set-Item "Env:\$(Get-ArchiveVariableName)" $Path;
+    }
+
+    <#
+        .SYNOPSIS
+        Adds files to the backup archive.
+
+        .PARAMETER User
+        The user to add the files to.
+
+        .PARAMETER Source
+        The file or directory to add to the backup archive.
+
+        .PARAMETER Path
+        The path to the location to store the file or directory at.
+
+        .PARAMETER ArgumentList
+        The arguments to pass to the `7z` command.
+    #>
+    function Add-BackupArtifacts {
+        param(
+            [string] $User,
+            [string] $Source,
+            [string] $Path,
+            [string[]] $Include,
+            [string[]] $Exclude
+        )
+
+        if ($env:BACKUP_ARCHIVE) {
+            [List[string]] $argumentList = @();
+            $dir = New-TemporaryDirectory;
+            $targetPath = & $pathResolver @PSBoundParameters;
+            $fullPath = Join-Path $dir $targetPath;
+            $null = New-Item -ItemType Directory -Force (Split-Path -Parent $fullPath);
+
+            if (Test-Path -PathType Container $Source) {
+                $null = New-Item -ItemType Junction $fullPath -Target $Source;
+            } elseif (Test-Path -PathType Leaf $Source) {
+                Copy-Item $Source $fullPath;
+            }
+
+            $options = @(
+                @("i", $Include),
+                @("x", $Exclude)
+            );
+
+            foreach ($option in $options) {
+                $indicator = $option[0];
+                $list = $option[1];
+    
+                foreach ($pattern in $list) {
+                    $argumentList.Add("-$indicator!`"$(Join-Path $targetPath $pattern)`"");
+                }
+            }
+
+            Start-Process `
+                -NoNewWindow `
+                -Wait `
+                -WorkingDirectory $dir `
+                -FilePath 7z `
+                -ArgumentList (
+                    @(
+                        "a",
+                        (Get-ValhallaBackupArchive),
+                        "-xr!desktop.ini",
+                        "-xr!thumbs.db",
+                        "-xr!Thumbs.db"
+                    ) + $argumentList);
+
+            Remove-Item -Recurse -Force $dir;
+        }
+    }
+
+    <#
+        .SYNOPSIS
+        Extracts the specified backup artifacts to the specified target path.
+
+        .PARAMETER User
+        The user to restore the files for.
+
+        .PARAMETER Path
+        The path to restore the files from.
+
+        .PARAMETER Target
+        The path to restore the files to.
+
+        .PARAMETER ArgumentList
+        The arguments to pass to `7z`.
+    #>
+    function Expand-BackupArtifacts {
+        param(
+            [string] $User,
+            [string] $Path,
+            [string] $Target,
+            [Parameter(ValueFromRemainingArguments)]
+            [string[]] $ArgumentList
+        )
+
+        if ($env:BACKUP_ARCHIVE) {
+            $dir = New-TemporaryDirectory;
+            $sourcePath = & $pathResolver @PSBoundParameters;
+            $filePath = Join-Path $dir $sourcePath;
+            7z x "-o$dir" (Get-ValhallaBackupArchive) $sourcePath @ArgumentList;
+
+            if (Test-Path $filePath) {
+                if (Test-Path -PathType Container $filePath) {
+                    $null = New-Item -ItemType Directory $Target -Force;
+                    $filePath = "$filePath/*";
+                }
+
+                Copy-Item -Recurse $filePath $Target -Force;
+            }
+
+            Remove-Item -Recurse -Force $dir;
+        }
+    }
+};

scripts/Windows/Scripts/Security.ps1

@@ -0,0 +1,70 @@
+using namespace System.Security.AccessControl;
+using namespace System.Security.Principal;
+
+$null = New-Module {
+    $uacOption = "EnableLUA";
+    $systemPolicyPath = "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System";
+
+    $uacSetter = {
+        param(
+            [bool] $Value
+        )
+
+        Set-ItemProperty -Path $systemPolicyPath -Name $uacOption -Value ([int]$Value);
+    }
+
+    <#
+        .SYNOPSIS
+        Determines whether UAC is enabled.
+    #>
+    function Get-UACStatus {
+        [bool](Get-ItemProperty -Path $systemPolicyPath -Name $uacOption);
+    }
+
+    <#
+        .SYNOPSIS
+        Enables UAC.
+    #>
+    function Enable-UAC {
+        & $uacSetter $true;
+    }
+
+    <#
+        .SYNOPSIS
+        Disables UAC.
+    #>
+    function Disable-UAC {
+        & $uacSetter $false;
+    }
+
+    <#
+        .SYNOPSIS
+        Sets read/write permissions for users at the specified path.
+
+        .PARAMETER Path
+        The path to allow access to users.
+    #>
+    function Set-UserPermissions {
+        param(
+            [string] $Path
+        )
+
+        $acl = Get-Acl $Path;
+
+        $acl.AddAccessRule(
+            [FileSystemAccessRule]::new(
+                [SecurityIdentifier]::new([WellKnownSidType]::BuiltinUsersSid, $null),
+                [FileSystemRights]::FullControl,
+                (& {
+                    if (Test-Path -PathType Container $Path) {
+                        [InheritanceFlags]::ObjectInherit -bor [InheritanceFlags]::ContainerInherit
+                    } else {
+                        0
+                    }
+                }),
+                [PropagationFlags]::InheritOnly,
+                [AccessControlType]::Allow));
+
+        Set-Acl $Path $acl;
+    }
+};

scripts/Windows/Scripts/Update.ps1

@@ -7,12 +7,14 @@ function Update-WindowsInstallation {
         Runs the Windows update loop.
     #>
     function Start-UpdateLoop {
-        Write-Host "Preparing for Windows Update";
         $null = Import-Module PSWindowsUpdate;
+        $hasUpdates = $false;
+        Write-Host "Searching for updates…";
     
         while (((Get-WindowsUpdate -IgnoreReboot).Count -gt 0)) {
             Write-Host "There are updates available.";
             Write-Host "Installing updates";
+            $hasUpdates = $true;
     
             try {
                 $null = Install-WindowsUpdate -AcceptAll -IgnoreReboot -ErrorAction "SilentlyContinue";
@@ -20,14 +22,18 @@ function Update-WindowsInstallation {
             catch { }
     
             if ((Get-WURebootStatus -Silent)) {
-                Write-Information "A Reboot is Required!";
+                Write-Host "A Reboot is Required!";
-                Write-Information "Windows will reboot now and the installation will be continued automatically.";
+                Write-Host "Windows will reboot now and the installation will be continued automatically.";
                 return;
             } else {
-                Write-Information "Updating Windows finished successfully!";
+                Write-Host "Updating Windows finished successfully!";
                 return;
             }
         }
+
+        if (-not $hasUpdates) {
+            Write-Host "There are no updates available.";
+        }
     }
 
     Start-UpdateLoop;

scripts/Windows/Scripts/Users.ps1

@@ -0,0 +1,262 @@
+using namespace System.Management.Automation.Host;
+using namespace System.Security.Principal;
+
+$null = New-Module {
+    . "$PSScriptRoot/../Scripts/Deployment.ps1";
+    . "$PSScriptRoot/../../Common/Scripts/Config.ps1";
+    . "$PSScriptRoot/../../Common/Scripts/Operations.ps1";
+    $loggedInUserOption = "LoggedInUser";
+
+    <#
+        .SYNOPSIS
+        Installs all pending users to the system.
+    #>
+    function Install-ValhallaUsers {
+        $users = @(Get-Users);
+        $i = Get-CurrentUser;
+
+        for (; $i -lt $users.Count; $i++) {
+            Set-CurrentUser $i;
+            $name = $users[$i];
+
+            if (Test-Admin) {
+                Disable-BootMessage;
+            }
+
+            while ((Get-UserStage) -ne ([UserStage]::Completed)) {
+                switch (Get-UserStage) {
+                    ($null) {
+                        Set-UserStage ([UserStage]::Create);
+                        break;
+                    }
+                    ([UserStage]::Create) {
+                        $msAccount = Get-UserConfig -UserName $name "microsoftAccount";
+
+                        if ($env:UserName -ne $name) {
+                            $userInfo = @{
+                                name = $name;
+                                msAccount = $msAccount;
+                            };
+
+                            New-ValhallaUser @userInfo;
+
+                            if ($msAccount) {
+                                logoff;
+                            } else {
+                                Restart-Intermediate;
+                            }
+
+                            exit;
+                        } else {
+                            if ($msAccount) {
+                                if (-not (Test-Admin)) {
+                                    Invoke-OneShot DisableUAC;
+                                    Restart-Intermediate -NoRegister;
+                                    exit;
+                                }
+
+                                Clear-SetupRegistration;
+                                Disable-OneShotListener;
+                            }
+
+                            Set-UserStage ([UserStage]::Configure);
+                        }
+                    }
+                    ([UserStage]::Configure) {
+                        $displayName = Get-UserConfig -UserName $name "displayName";
+
+                        $userInfo = @{
+                            name = $name;
+                        };
+
+                        if ($displayName) {
+                            $userInfo.fullName = $displayName;
+                        }
+
+                        $adminGroup = @{
+                            SID = [SecurityIdentifier]::new([WellKnownSidType]::BuiltinAdministratorsSid, $null);
+                        };
+
+                        Set-LocalUser @userInfo;
+                        Deploy-SoftwareAction -Action ConfigureUser;
+                        Remove-LocalGroupMember -Member "$name" @adminGroup -ErrorAction SilentlyContinue;
+
+                        foreach ($group in Get-UserConfig "groups") {
+                            Add-LocalGroupMember -Member "$name" -Name "$group";
+                        }
+
+                        Set-UserStage ([UserStage]::Cleanup);
+                    }
+                    ([UserStage]::Cleanup) {
+                        $user = Get-SetupUser;
+                        Disable-LocalUser $name;
+                        Enable-LocalUser $user;
+                        Set-AutologinUser $user;
+                        Unregister-WslDistribution;
+                        Set-UserStage ([UserStage]::Completed);
+                        Restart-Intermediate;
+                    }
+                }
+            }
+        }
+
+        foreach ($user in $users) {
+            Enable-LocalUser $user;
+        }
+    }
+
+    <#
+        .SYNOPSIS
+        Creates a new user for the PortValhalla setup.
+
+        .PARAMETER Name
+        The name of the user to create.
+
+        .PARAMETER MSAccount
+        A value indicating whether the user should be created as a Microsoft Account.
+    #>
+    function New-ValhallaUser {
+        param(
+            [string] $Name,
+            [switch] $MSAccount
+        )
+
+        function Add-MicrosoftAccount {
+            param(
+                [string] $Name
+            )
+
+            $newUser = & {
+                while ($true) {
+                    $currentUsers = Get-LocalUser | ForEach-Object { $_.Name };
+
+                    Write-Host (
+                        @(
+                            "So… Windows is too dumb to create users which are bound to a Microsoft Account.",
+                            "Thus, you have to do it by yourself.",
+                            "So sorry…") -join "`n");
+
+                    Write-Host "Create a user for ``$Name`` manually… (because Windows is too stupid)";
+                    $null = Read-Host "Hit enter once you're done";
+
+                    $newUsers = @(Get-LocalUser | Where-Object { -not ($currentUsers -contains $_.Name) });
+
+                    if ($newUsers.Count) {
+                        if ($newUsers.Count -eq 1) {
+                            $newUser = $newUsers[0];
+        
+                            Write-Host "Found new user ``$newUser``";
+        
+                            if (
+                                $Host.UI.PromptForChoice(
+                                    "Confirm",
+                                    "Is ``$newUser`` your user?",
+                                    [ChoiceDescription[]]@(
+                                        [ChoiceDescription]::new("&No", "``$newUser`` is not your user"),
+                                        [ChoiceDescription]::new("&Yes", "``$newUser`` is your user")),
+                                    0) -eq 1) {
+                                return $newUser;
+                            }
+                        } else {
+                            $result = $Host.UI.PromptForChoice(
+                                "Select your User",
+                                "Which one is your user?",
+                                [ChoiceDescription[]](
+                                    & {
+                                        [ChoiceDescription]::new("&None", "None of these users is yours");
+
+                                        for ($i = 0; $i -lt $newUsers.Count; $i++) {
+                                            $name = "$($newUsers[$i])";
+                                            [ChoiceDescription]::new("&$($i + 1) - ``$name``", "Your user is ``$name``");
+                                        }
+                                    }), 0);
+                            
+                            if ($result -gt 0) {
+                                return $newUsers[$result - 1];
+                            }
+                        }
+                    } else {
+                        Write-Host "";
+                        Write-Host "Unable to determine the new user";
+                        Write-Host "Retrying…";
+                    }
+                }
+            };
+
+            Set-MSAccountName ([string]$newUser);
+        }
+
+        if ($MSAccount) {
+            if (Test-Admin) {
+                Write-Host "Preparing environment for creating MS Account";
+                Register-Setup -DefaultUser;
+                Enable-OneShotListener;
+                Enable-UAC;
+
+                # Reset Windows activation status
+                # Otherwise the login won't work - Windows is fricking frustrating.
+                slmgr /upk;
+                slmgr /cpky;
+                slmgr /rearm;
+                Restart-Intermediate -CurrentUser;
+                exit;
+            }
+        }
+
+        Write-Host "Creating personal user ``$Name``…";
+
+        if ($MSAccount) {
+            Add-MicrosoftAccount $Name;
+            Set-SetupOption $loggedInUserOption $env:UserName;
+            Invoke-OneShot ([OneShotTask]::InitializeMSAccount);
+        } else {
+            New-LocalUser -NoPassword @userArguments;
+            Initialize-UserCreation;
+        }
+    }
+
+    <#
+        .SYNOPSIS
+        Prepares the first login for initializing the current user under configuration.
+    #>
+    function Initialize-UserCreation {
+        $name = (@(Get-Users))[(Get-CurrentUser)];
+        $msAccount = Get-UserConfig -UserName $name "microsoftAccount";
+
+        Write-Host "Initializing user ``$name``…";
+
+        $userArguments = @{
+            name = $name;
+        };
+
+        $adminGroup = @{
+            SID = [SecurityIdentifier]::new([WellKnownSidType]::BuiltinAdministratorsSid, $null);
+        };
+
+        if ($msAccount) {
+            $accountName = Get-MSAccountName;
+            Write-Host "Renaming ``$accountName`` to ``$name``…"
+            Rename-LocalUser $accountName $name;
+        }
+
+        Set-LocalUser @userArguments;
+
+        if ($msAccount) {
+            Disable-LocalUser (Get-SetupOption $loggedInUserOption);
+        } else {
+            Disable-LocalUser $env:UserName;
+        }
+
+        Add-LocalGroupMember `
+            @adminGroup `
+            $name `
+            -ErrorAction SilentlyContinue;
+
+        if ($msAccount) {
+            Disable-Autologin;
+            Set-BootMessage -Caption "Please Log In" -Message "Please log in using your new Microsoft Account ``$name``.";
+        } else {
+            Set-AutologinUser "$name";
+        }
+    }
+};

scripts/Windows/Scripts/WSL.ps1

@@ -0,0 +1,120 @@
+. "$PSScriptRoot/../Scripts/Security.ps1";
+
+<#
+    .SYNOPSIS
+    Gets the name of the WSL distribution used for managing the configuration.
+#>
+function Get-WslDistributionName {
+    return "ValhallaUbuntu";
+}
+
+<#
+    .SYNOPSIS
+    Gets the path to the directory containing the WSL distribution.
+#>
+function Get-WslDistributionPath {
+    return "$env:ProgramData/PortValhalla/$(Get-WslDistributionName)";
+}
+
+<#
+    .SYNOPSIS
+    Gets the path to the virtual hard disk of the WSL distribution.
+#>
+function Get-WslDistributionDisk {
+    return "$(Get-WslDistributionPath)/ext4.vhdx";
+}
+
+<#
+    .SYNOPSIS
+    Checks whether `wsl` is installed properly.
+#>
+function Test-Wsl {
+    & { $null = wsl --status; $?; };
+}
+
+<#
+    .SYNOPSIS
+    Checks whether any WSL distributions are installed for the current user.
+#>
+function Test-WslDistributions {
+    & { $null = wsl -l; $?; };
+}
+
+<#
+    .SYNOPSIS
+    Checks whether the managed distribution is installed.
+#>
+function Test-WslDistribution {
+    & { $null = wsl -d (Get-WslDistributionName) -e true; $?; };
+}
+
+<#
+    .SYNOPSIS
+    Installs `wsl` on the system.
+#>
+function Install-Wsl {
+    wsl --install --no-launch;
+}
+
+<#
+    .SYNOPSIS
+    Installs a Ubuntu distribution to a shared directory.
+#>
+function Install-WslDistribution {
+    $dir = Get-WslDistributionPath;
+    $root = Split-Path -Parent $dir;
+    $ubuntuPattern = "*Ubuntu*";
+    $registryPath = "HKCU:/Software/Microsoft/Windows/CurrentVersion/Lxss";
+    $key = Get-Item $registryPath;
+
+    if (Get-AppxPackage $ubuntuPattern) {
+        Install-Wsl;
+    }
+
+    if ($key) {
+        $key = $key | Rename-Item -NewName "$(Split-Path -Leaf $key)_" -PassThru;
+    }
+
+    if (-not (Test-Path $root)) {
+        $null = New-Item -ItemType Directory $root;
+    }
+
+    Copy-Item -Recurse -Force (Get-AppxPackage $ubuntuPattern).InstallLocation $dir;
+    Set-UserPermissions $dir;
+    & "$dir\ubuntu.exe" install --root;
+    wsl --shutdown;
+    Remove-Item -Recurse -Force $registryPath;
+
+    if ($key) {
+        Move-Item $key.PSPath $registryPath;
+    }
+}
+
+<#
+    .SYNOPSIS
+    Uninstalls the managed WSL distribution.
+#>
+function Uninstall-WslDistribution {
+    wsl --unregister (Get-WslDistributionName);
+}
+
+<#
+    .SYNOPSIS
+    Registers the managed WSL distribution.
+#>
+function Register-WslDistribution {
+    wsl --import-in-place (Get-WslDistributionName) (Get-WslDistributionDisk);
+    wsl --set-default (Get-WslDistributionName);
+}
+
+<#
+    .SYNOPSIS
+    Unregisters the managed WSL distribution.
+#>
+function Unregister-WslDistribution {
+    $wslDisk = Get-WslDistributionDisk;
+    wsl --shutdown;
+    $tempDisk = Rename-Item -Force $wslDisk "ext4_.vhdx" -PassThru;
+    Uninstall-WslDistribution;
+    Move-Item $tempDisk $wslDisk;
+}

scripts/Windows/Software/Ext4Fsd/Main.ps1

@@ -0,0 +1,12 @@
+param (
+    $Action,
+    [hashtable] $Arguments
+)
+
+. "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
+. "$PSScriptRoot/../../../Common/Types/InstallerAction.ps1";
+
+Start-SoftwareInstaller @PSBoundParameters `
+    -Installer {
+        Install-SetupPackage "https://github.com/bobranten/Ext4Fsd/releases/download/v0.71/Ext2Fsd-0.71-setup.exe";
+    };

scripts/Windows/Software/Firefox/Manage.ps1

@@ -13,7 +13,6 @@ Start-SoftwareInstaller @PSBoundParameters `
         )
 
         Install-ChocoPackage firefox;
-        & $Installer -Action ([InstallerAction]::Configure)
     } `
     -Configurator {
         Write-Host "Making Firefox the default browser…";
@@ -34,10 +33,12 @@ Start-SoftwareInstaller @PSBoundParameters `
         );
 
         foreach ($extension in $extensions) {
-            Set-DefaultAppAssociation -Identifier $extensions -ProgId "${appName}HTML$progIdSuffix" -ApplicationName $appName;
+            Set-DefaultAppAssociation -Identifier $extension -ProgId "${appName}HTML$progIdSuffix" -ApplicationName $appName;
         }
 
         foreach ($scheme in $schemes) {
             Set-DefaultAppAssociation -Identifier $scheme -ProgId "${appName}URL$progIdSuffix" -ApplicationName $appName;
         }
+
+        Remove-TaskbarItem "*Firefox*";
     };

scripts/Windows/Software/LGHub/Manage.ps1

@@ -0,0 +1,85 @@
+param(
+    $Action,
+    [hashtable] $Arguments
+)
+
+& {
+    param ($Parameters)
+    . "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
+    . "$PSScriptRoot/../../Scripts/Restoration.ps1";
+    $configPath = "$env:LocalAppData/LGHUB";
+
+    <#
+        .SYNOPSIS
+        Stops the running Logitech G Hub instance.
+    #>
+    function Stop-LGHub {
+        [OutputType([string])]
+        param()
+
+        $hubName = "lghub_system_tray.exe";
+
+        $candidates = Get-Process | Where-Object { $_.Path -and ((Split-Path -Leaf $_.Path) -eq $hubName) };
+
+        if ($candidates.Count -gt 0) {
+            $lghubPath = $()[0].Path;
+        } else {
+            $lghubPath = $null;
+        }
+
+        $mainProcesses = Get-Process | Where-Object {
+            $_.Path -and
+            (@("lghub.exe", "lghub_agent.exe", "lghub_updater.exe", $hubName) -contains (Split-Path -Leaf $_.Path)) -and
+            (($_.Parent.ProcessName -eq "explorer") -or ($null -eq $_.Parent))
+        };
+
+        $null = $mainProcesses | ForEach-Object { $_.Kill($true) };
+        return $lghubPath;
+    }
+
+    <#
+        .SYNOPSIS
+        Edits the Logitech G Hub configuration.
+    #>
+    function Edit-LGHubConfig {
+        param(
+            [scriptblock] $Action
+        )
+
+        Write-Host "Stopping Logitech G Hub";
+        $path = Stop-LGHub;
+        & $Action;
+
+        if ($path) {
+            Write-Host "Restarting Logitech G Hub";
+            Start-Process $path;
+        }
+    }
+
+    Start-SoftwareInstaller @Parameters `
+        -Installer {
+            Install-ChocoPackage lghub;
+            Remove-DesktopIcon "*G HUB*";
+        } `
+        -UserBackup {
+            param(
+                [hashtable] $Arguments
+            )
+
+            Edit-LGHubConfig {
+                Add-BackupArtifacts -User $Arguments.Name -Source $configPath -Path "LGHub" `
+                    -Include @("settings.db", "icon_cache")
+            };
+        } `
+        -UserConfigurator {
+            param(
+                [hashtable] $Arguments
+            )
+
+            Edit-LGHubConfig {
+                Expand-BackupArtifacts -User $Arguments.Name -Path "LGHub" -Target $configPath;
+            };
+        };
+} $PSBoundParameters;
+
+# ToDo: Add restoration

scripts/Windows/Software/MSEdgeRedirect/Manage.ps1

@@ -0,0 +1,34 @@
+param(
+    $Action,
+    [hashtable] $Arguments
+)
+
+. "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
+
+Start-SoftwareInstaller @PSBoundParameters `
+    -Installer {
+        param(
+            [scriptblock] $Installer
+        )
+
+        Install-ChocoPackage MSEdgeRedirect;
+    } `
+    -Configurator {
+        $configPath = "HKLM:\SOFTWARE\Robert Maehl Software\MSEdgeRedirect";
+
+        [hashtable] $options = @{
+            NoBing = 1;
+            NoImgs = 1;
+            NoNews = 1;
+            NoPDFs = 1;
+            Search = "StartPage";
+            Images = "Custom";
+            ImagePath = "https://startpage.com/sp/search?cat=images&query=";
+            News = "Google";
+            PDFApp = "C:\Program Files\Mozilla Firefox\firefox.exe";
+        };
+
+        foreach ($key in $options.Keys) {
+            Set-ItemProperty $configPath -Name $key -Value ($options[$key]);
+        }
+    };

scripts/Windows/Software/ManiaPlanet/Install.ps1

@@ -0,0 +1,20 @@
+#!/bin/pwsh
+. "$PSScriptRoot/../../../Common/Scripts/Context.ps1";
+
+$null = New-Module {
+    $path = "$HOME/Documents/ManiaPlanet";
+    $softwareName = "ManiaPlanet";
+
+    function Backup-ManiaPlanet([Context] $context) {
+        Write-Information "Backing up ManiaPlanet";
+        $context.Backup($path, $context.SoftwareArchive($softwareName), @("-i@`"$PSScriptRoot/include.txt`""));
+    }
+
+    function Restore-ManiaPlanet([Context] $context) {
+        Write-Host "Restoring ManiaPlanet";
+        Write-Information "Installing ManiaPlanet";
+        winget install --accept-source-agreements --accept-package-agreements -e --id Nadeo.ManiaPlanet;
+        Write-Information "Restoring files";
+        $context.Restore($context.SoftwareArchive($softwareName), $path);
+    }
+}

scripts/Windows/Software/ManiaPlanet/Manage.ps1

@@ -1,20 +1,46 @@
-#!/bin/pwsh
+param(
-. "$PSScriptRoot/../../../Common/Scripts/Context.ps1";
+    $Action,
+    [hashtable] $Arguments
+)
 
-$null = New-Module {
+& {
+    param($Parameters)
+    . "$PSScriptRoot/../../Scripts/Restoration.ps1";
+    . "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
+    . "$PSScriptRoot/../../../Common/Scripts/System.ps1";
     $path = "$HOME/Documents/ManiaPlanet";
-    $softwareName = "ManiaPlanet";
 
-    function Backup-ManiaPlanet([Context] $context) {
+    Start-SoftwareInstaller @Parameters `
-        Write-Information "Backing up ManiaPlanet";
+        -Installer {
-        $context.Backup($path, $context.SoftwareArchive($softwareName), @("-i@`"$PSScriptRoot/include.txt`""));
+            Install-WingetPackage Nadeo.ManiaPlanet;
-    }
+            Remove-DesktopIcon "ManiaPlanet*";
+        } `
+        -UserBackup {
+            param(
+                [hashtable] $Arguments
+            )
 
-    function Restore-ManiaPlanet([Context] $context) {
+            Add-BackupArtifacts -User $Arguments.Name -Source $path -Path "ManiaPlanet" `
-        Write-Host "Restoring ManiaPlanet";
+                -Include @(
-        Write-Information "Installing ManiaPlanet";
+                    "Actions",
-        winget install --accept-source-agreements --accept-package-agreements -e --id Nadeo.ManiaPlanet;
+                    "Blocks",
-        Write-Information "Restoring files";
+                    "Items",
-        $context.Restore($context.SoftwareArchive($softwareName), $path);
+                    "Maps",
-    }
+                    "Media",
-}
+                    "Modules",
+                    "Packs",
+                    "Replays",
+                    "Scripts",
+                    "Skins"
+                );
+        } `
+        -UserConfigurator {
+            param(
+                [hashtable] $Arguments
+            )
+
+            Expand-BackupArtifacts -User $Arguments.Name -Path "ManiaPlanet" -Target $path;
+        } | Out-Host;
+} $PSBoundParameters;
+
+# ToDo: Add restoration

scripts/Windows/Software/NVS/Manage.ps1

@@ -0,0 +1,29 @@
+using namespace System.Security.AccessControl;
+using namespace System.Security.Principal;
+
+param(
+    $Action,
+    [hashtable] $Arguments
+)
+
+. "$PSScriptRoot/../../Scripts/Security.ps1";
+. "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
+. "$PSScriptRoot/../../../Common/Types/InstallerAction.ps1";
+
+Start-SoftwareInstaller @PSBoundParameters `
+    -Installer {
+        param(
+            [scriptblock] $Installer
+        )
+
+        $env:NVS_HOME = "$env:ProgramData\nvs";
+        git clone "https://github.com/jasongin/nvs.git" $env:NVS_HOME;
+        & "$env:NVS_HOME\nvs.cmd" install;
+
+        refreshenv;
+        Set-UserPermissions $env:NVS_HOME;
+    } `
+    -Configurator {
+        nvs add latest;
+        nvs link latest;
+    };

scripts/Windows/Software/Nextcloud/Main.ps1

@@ -0,0 +1,125 @@
+param(
+    $Action,
+    [hashtable] $Arguments
+)
+
+. "$PSScriptRoot/../../Scripts/PowerManagement.ps1";
+. "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
+
+& {
+    param($Parameters)
+
+    <#
+        .SYNOPSIS
+        Gets the path to the Nextcloud configuration file.
+    #>
+    function Get-ConfigFile {
+        return "$env:APPDATA/Nextcloud/nextcloud.cfg";
+    }
+
+    <#
+        .SYNOPSIS
+        Adds a new nextcloud sync to the current user.
+    #>
+    function Add-NextcloudSync {
+        param(
+            [string] $RemotePath,
+            [string] $LocalPath,
+            [switch] $VirtualFiles
+        )
+
+        Write-Host "Adding a Nextcloud sync";
+        Write-Host "$RemotePath <=> $LocalPath";
+        $configName = "Folders";
+        $virtualName = "WithPlaceholders";
+        $LocalPath = $LocalPath.Replace("\", "/");
+        $RemotePath = $RemotePath.Replace("\", "/");
+        $oldContent = Get-Content (Get-ConfigFile);
+        $additionalSettings = @();
+        $pattern = "^\d+\\$configName(?:$virtualName)?\\(\d+)";
+
+        $folderID = (
+            $oldContent | `
+                Where-Object { $_ -match "$pattern" } | `
+                ForEach-Object { $_ -replace "$pattern.*$","`$1" } | `
+                Sort-Object -Unique | `
+                Measure-Object -Maximum).Maximum + 1;
+
+        if ($VirtualFiles.IsPresent) {
+            $configName += $virtualName;
+            $additionalSettings = @("0\$configName\$folderID\virtualFilesMode=wincfapi");
+        }
+
+        $newSettings = (
+            @(
+                "0\$configName\$folderID\localPath=$LocalPath",
+                "0\$configName\$folderID\targetPath=$RemotePath"
+            ) + $additionalSettings
+        ) -join "`n";
+
+        & {
+            $accountSectionEntered = $false;
+            $accountSectionLeft = $false;
+
+            for ($i = 0; $i -lt $oldContent.Count; $i++) {
+                $line = $oldContent[$i];
+
+                if ($line -eq "[Accounts]") {
+                    $accountSectionEntered = $true;
+                }
+
+                if ($line -eq "" -and $accountSectionEntered) {
+                    $accountSectionLeft = $true;
+                    $newSettings;
+                }
+
+                $line;
+
+                if (
+                    (-not $accountSectionLeft) -and
+                    ($i -eq ($oldContent.Count - 1))) {
+                    $newSettings;
+                }
+            }
+        } | Set-Content (Get-ConfigFile);
+    }
+
+
+    Start-SoftwareInstaller @Parameters `
+    -Installer {
+        Install-ChocoPackage nextcloud-client -ArgumentList "-y","--params='/KeepUpdateCheck'";
+    } `
+    -UserConfigurator {
+        param($Arguments)
+        $user = $Arguments.Name;
+
+        & {
+            $syncs = Get-UserConfig -UserName $user "nextcloud.folderSyncs";
+            $configExists = { (Test-Path (Get-ConfigFile) ) };
+
+            if ($syncs.Count -gt 0) {
+                if (-not (& $configExists)) {
+                    while (-not (& $configExists)) {
+                        Read-Host "Please log in to the Nextcloud app and hit enter to continue";
+    
+                        if (-not (& $configExists)) {
+                            Write-Error -ErrorAction Continue "The login seems to have failed. Please try again.";
+                        }
+                    }
+                }
+
+                Write-Host "Stopping Nextcloud process";
+                $nextcloudProcess = Get-Process nextcloud;
+                $nextcloudPath = [string]$nextcloudProcess[0].Path;
+                $nextcloudProcess | Stop-Process -Force;
+
+                foreach ($sync in $syncs) {
+                    Add-NextcloudSync -LocalPath $sync.localPath -RemotePath $sync.remotePath -VirtualFiles:$sync.virtualFiles;
+                }
+
+                Write-Host "Restarting Nextcloud";
+                Start-Process $nextcloudPath;
+            }
+        };
+    };
+} $PSBoundParameters;

scripts/Windows/Software/Nextcloud/Manage.ps1

@@ -1,58 +0,0 @@
-param(
-    $Action,
-    [hashtable] $Arguments
-)
-
-. "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
-
-Start-SoftwareInstaller @PSBoundParameters `
-    -Installer {
-        Install-ChocoPackage nextcloud-client -ArgumentList "-y","--params='/KeepUpdateCheck'";
-    } `
-    -Configurator {
-        Write-Host "Making Firefox the default browser…";
-        $progIdSuffix = "-308046B0AF4A39CB";
-        $appName = "Firefox";
-
-        $extensions = @(
-            ".htm",
-            ".html",
-            ".svg",
-            ".xht",
-            ".xhtml"
-        );
-
-        $schemes = @(
-            "http",
-            "https"
-        );
-
-        foreach ($extension in $extensions) {
-            Set-DefaultAppAssociation -Identifier $extensions -ProgId "${appName}HTML$progIdSuffix" -ApplicationName $appName;
-        }
-
-        foreach ($scheme in $schemes) {
-            Set-DefaultAppAssociation -Identifier $scheme -ProgId "${appName}URL$progIdSuffix" -ApplicationName $appName;
-        }
-    } `
-    -UserConfigurator {
-        if (-not (Test-Path $context.GetNextcloudConfigFile())) {
-            Write-Information "Setting up Nextcloud configuration";
-
-            Write-Information "Ensuring all Let's Encrypt certificates are cached";
-            $null = Invoke-WebRequest https://valid-isrgrootx1.letsencrypt.org/;
-
-            while (-not (Test-Path $context.GetNextcloudConfigFile())) {
-                Write-Host "Nextcloud has been installed!";
-                Read-Host "Please log in in the Nextcloud app and hit enter to continue";
-
-                if (-not (Test-Path $context.GetNextcloudConfigFile())) {
-                    Write-Error "The login seems to have failed. Please try again.";
-                }
-            }
-
-            $context.Reboot();
-            exit;
-        }
-    };
-

scripts/Windows/Software/Oh My Posh/Manage.ps1

@@ -6,16 +6,18 @@ param (
 . "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
 . "$PSScriptRoot/../../../Common/Types/InstallerAction.ps1";
 
-Start-SoftwareInstaller @PSBoundParameters `
+& {
-    -Installer {
+    param($Parameters)
-        param(
+    $base = "$PSScriptRoot/../../../Common/Software/Oh My Posh/Manage.ps1";
-            [scriptblock] $Installer
-        )
 
-        Install-WingetPackage JanDeDobbeleer.OhMyPosh;
+    Start-SoftwareInstaller @Parameters `
-        & $Installer -Action ([InstallerAction]::Configure);
+        -Installer {
-    } `
+            Install-WingetPackage JanDeDobbeleer.OhMyPosh -ArgumentList "--scope","machine";
-    -Configurator {
+        } `
-        . "$PSScriptRoot/../../../Common/Software/Oh My Posh/Manage.ps1" `
+        -Configurator {
-            -Action ([InstallerAction]::Configure);
+            . $base -Action ([InstallerAction]::Configure);
-    };
+        } `
+        -UserConfigurator {
+            . $base -Action ([InstallerAction]::ConfigureUser);
+        };
+} $PSBoundParameters;

scripts/Windows/Software/OpenSSH/Manage.ps1

@@ -8,13 +8,6 @@ param(
 . "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
 
 Start-SoftwareInstaller @PSBoundParameters `
-    -Installer {
-        param(
-            [scriptblock] $Installer
-        )
-
-        & $Installer -Action ([InstallerAction]::Configure)
-    } `
     -Configurator {
         Set-Service ssh-agent -StartupType AutomaticDelayedStart;
     };

scripts/Windows/Software/PinnedItem/Manage.ps1

@@ -0,0 +1,35 @@
+param (
+    $Action,
+    [hashtable] $Arguments
+)
+
+. "$PSScriptRoot/../../../Common/Software/PowerShell/Module.ps1";
+. "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
+
+$parameters = Get-ModuleInstallerComponents "PinnedItem" -NativeOnly -NoProfile;
+
+foreach ($key in $PSBoundParameters.Keys) {
+    $parameters.Add($key, $PSBoundParameters.TryGetValue($key));
+}
+
+$arguments = $parameters.arguments;
+$arguments.Add("Installer", $parameters.installer);
+
+Start-SoftwareInstaller @parameters -Installer {
+    param(
+        [scriptblock] $Installer,
+        [hashtable] $Arguments
+    )
+
+    $module = $Arguments.Name;
+    & $Arguments.Installer @PSBoundParameters;
+
+    if (-not (& { powershell -NoProfile -Command "Import-Module $module; exit ([bool]`$Error)" 2> $null; $?; })) {
+        $feature = "NetFx3";
+    
+        if ((Get-WindowsOptionalFeature -Online -FeatureName $feature).State -ne "Enabled") {
+            Write-Host "Enabling ``$feature`` feature…";
+            choco install --source windowsFeatures  -y $feature;
+        }
+    }
+}

scripts/Windows/Software/PowerShell/Manage.ps1

@@ -7,13 +7,6 @@ param (
 . "$PSScriptRoot/../../../Common/Types/InstallerAction.ps1";
 
 Start-SoftwareInstaller @PSBoundParameters `
-    -Installer {
-        param(
-            [scriptblock] $Installer
-        )
-
-        & $Installer -Action ([InstallerAction]::Configure);
-    } `
     -Configurator {
         . "$PSScriptRoot/../../../Common/Software/PowerShell/Manage.ps1" `
             -Action ([InstallerAction]::Configure);

scripts/Windows/Software/PuTTY/Manage.ps1

@@ -0,0 +1,33 @@
+using namespace Microsoft.Win32;
+
+param(
+    $Action,
+    [hashtable] $Arguments
+)
+
+. "$PSScriptRoot/../../Scripts/AppAssociations.ps1";
+. "$PSScriptRoot/../../Scripts/Restoration.ps1";
+. "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
+. "$PSScriptRoot/../../../Common/Scripts/System.ps1";
+
+Start-SoftwareInstaller @PSBoundParameters `
+    -Installer {
+        Install-ChocoPackage putty;
+    } `
+    -UserBackup {
+        param([hashtable] $Arguments)
+        $dir = New-TemporaryDirectory;
+        $fileName = Join-Path "$dir" PuTTY.reg;
+        & reg export "HKCU\Software\SimonTatham\PuTTY" $fileName /y;
+        Add-BackupArtifacts -User $Arguments.Name -Source $fileName -Path "PuTTY/PuTTY.reg";
+        Remove-Item -Recurse -Force $dir;
+    } `
+    -UserConfigurator {
+        param([hashtable] $Arguments)
+        $dir = New-TemporaryDirectory;
+        $fileName = Join-Path "$dir" PuTTY.reg;
+        Expand-BackupArtifacts -User $Arguments.Name -Path "PuTTY/PuTTY.reg" -Target $fileName;
+        & reg import $fileName;
+        Remove-Item -Recurse -Force $dir;
+    };
+# ToDo: Add restoration

scripts/Windows/Software/RetroArch/Install.ps1

@@ -0,0 +1,35 @@
+#!/bin/pwsh
+. "$PSScriptRoot/../../Scripts/KnownFolders.ps1";
+. "$PSScriptRoot/../../../Common/Scripts/Context.ps1";
+
+$null = New-Module {
+    Import-Module "$env:ChocolateyInstall/helpers/chocolateyInstaller.psm1";
+    $path = "C:/tools/RetroArch-Win64";
+    $softwareName = "RetroArch";
+
+    function Backup-RetroArch([Context] $context) {
+        Write-Host "Backing up RetroArch";
+        $context.Backup($path, $context.SoftwareArchive($softwareName), @("-i@`"$PSScriptRoot/include.txt`""));
+    }
+
+    function Restore-RetroArch([Context] $context) {
+        Write-Host "Restoring RetroArch";
+        Write-Information "Installing RetroArch";
+        choco install -y --ignore-checksums retroarch;
+        Write-Information "Restoring files";
+        $context.Restore($context.SoftwareArchive($softwareName), $path);
+
+        Write-Information "Adding cloud sync folders";
+
+        $context.AddNextcloudSync(
+            "$path\saves",
+            "/Saved Games/RetroArch/Saves");
+
+        $context.AddNextcloudSync(
+            "$path\system",
+            "/Saved Games/RetroArch/System");
+
+        Write-Information "Creating a Start Menu Icon";
+        Install-ChocolateyShortcut -ShortcutFilePath "$((Get-KnownFolder "Common Programs").Path)/RetroArch.lnk" -TargetPath ((Get-Item "$path\retroarch.exe").FullName);
+    }
+}

scripts/Windows/Software/RetroArch/Manage.ps1

@@ -1,35 +1,38 @@
-#!/bin/pwsh
+param(
-. "$PSScriptRoot/../../Scripts/KnownFolders.ps1";
+    $Action,
-. "$PSScriptRoot/../../../Common/Scripts/Context.ps1";
+    [hashtable] $Arguments
+)
+
 
 $null = New-Module {
-    Import-Module "$env:ChocolateyInstall/helpers/chocolateyInstaller.psm1";
+    param($Parameters)
+    . "$PSScriptRoot/../../Scripts/Restoration.ps1";
+    . "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
+    . "$PSScriptRoot/../../../Common/Scripts/System.ps1";
     $path = "C:/tools/RetroArch-Win64";
-    $softwareName = "RetroArch";
 
-    function Backup-RetroArch([Context] $context) {
+    Start-SoftwareInstaller @Parameters `
-        Write-Host "Backing up RetroArch";
+        -Backup {
-        $context.Backup($path, $context.SoftwareArchive($softwareName), @("-i@`"$PSScriptRoot/include.txt`""));
+            Add-BackupArtifacts -Path "RetroArch" -Source $path `
-    }
+                -Include @(
+                    "config",
+                    "cores",
+                    "downloads",
+                    "playlists",
+                    "recordings",
+                    "screenshots",
+                    "content_history.lpl",
+                    "content_*_history.lpl",
+                    "retroarch.cfg"
+                );
+        } `
+        -Installer {
+            Install-ChocoPackage retroarch;
+        } `
+        -Configurator {
+            Add-StartMenuIcon "RetroArch" "C:\tools\RetroArch-Win64\retroarch.exe";
+            Expand-BackupArtifacts -Path "RetroArch" -Target $path;
+        } | Out-Host;
+} $PSBoundParameters;
 
-    function Restore-RetroArch([Context] $context) {
+# ToDo: Add restoration
-        Write-Host "Restoring RetroArch";
-        Write-Information "Installing RetroArch";
-        choco install -y --ignore-checksums retroarch;
-        Write-Information "Restoring files";
-        $context.Restore($context.SoftwareArchive($softwareName), $path);
-
-        Write-Information "Adding cloud sync folders";
-
-        $context.AddNextcloudSync(
-            "$path\saves",
-            "/Saved Games/RetroArch/Saves");
-
-        $context.AddNextcloudSync(
-            "$path\system",
-            "/Saved Games/RetroArch/System");
-
-        Write-Information "Creating a Start Menu Icon";
-        Install-ChocolateyShortcut -ShortcutFilePath "$((Get-KnownFolder "Common Programs").Path)/RetroArch.lnk" -TargetPath ((Get-Item "$path\retroarch.exe").FullName);
-    }
-}

scripts/Windows/Software/Thunderbird/Manage.ps1

@@ -5,7 +5,7 @@ param(
     [hashtable] $Arguments
 )
 
-. "$PSScriptRoot/../../../Common/Scripts/AppAssociations.ps1";
+. "$PSScriptRoot/../../Scripts/AppAssociations.ps1";
 . "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
 
 Start-SoftwareInstaller @PSBoundParameters `
@@ -15,7 +15,6 @@ Start-SoftwareInstaller @PSBoundParameters `
         )
 
         Install-ChocoPackage thunderbird -ArgumentList "--params",'"/NoTaskbarShortcut /NoDesktopShortcut"'
-        & $Installer -Action ([InstallerAction]::Configure)
     } `
     -Configurator {
         Write-Host "Making Thunderbird the default mail program…";

scripts/Windows/Software/TrackMania Nations Forever/Install.ps1

@@ -0,0 +1,31 @@
+#!/bin/pwsh
+. "$PSScriptRoot/../../../Common/Scripts/Context.ps1";
+
+$null = New-Module {
+    $path = "$HOME/Documents/TmForever";
+    $softwareName = "TmNationsForever";
+
+    function Backup-TmNations([Context] $context) {
+        Write-Host "Backing up TrackMania Nations Forever";
+        $context.Backup($path, $context.SoftwareArchive($softwareName), @("-i@`"$PSScriptRoot/include.txt`""));
+    }
+
+    function Restore-TmNations([Context] $context) {
+        $features = @("DirectPlay", "NetFx3");
+        Write-Host "Restoring TrackMania Nations Forever";
+
+        foreach ($feature in $features) {
+            if ((Get-WindowsOptionalFeature -Online -FeatureName $feature).State -ne "Enabled") {
+                Write-Information "Enabling the ``$feature`` feature";
+                $null = Enable-WindowsOptionalFeature -Online -All -FeatureName $feature;
+            }
+        }
+
+        Write-Information "Installing TrackMania Nations Forever";
+        winget install --accept-source-agreements --accept-package-agreements -e --id Nadeo.TrackManiaNationsForever;
+        Write-Information "Removing Desktop Icon";
+        $context.RemoveDesktopIcon("*TmNationsForever*");
+        Write-Information "Restoring Files";
+        $context.Restore($context.SoftwareArchive($softwareName), $path);
+    }
+}

scripts/Windows/Software/TrackMania Nations Forever/Manage.ps1

@@ -1,31 +1,44 @@
-#!/bin/pwsh
+param(
-. "$PSScriptRoot/../../../Common/Scripts/Context.ps1";
+    $Action,
+    [hashtable] $Arguments
+)
 
-$null = New-Module {
+
+& {
+    param($Parameters)
+    . "$PSScriptRoot/../../Scripts/Restoration.ps1";
+    . "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
     $path = "$HOME/Documents/TmForever";
-    $softwareName = "TmNationsForever";
 
-    function Backup-TmNations([Context] $context) {
+    Start-SoftwareInstaller @Parameters `
-        Write-Host "Backing up TrackMania Nations Forever";
+        -Installer {
-        $context.Backup($path, $context.SoftwareArchive($softwareName), @("-i@`"$PSScriptRoot/include.txt`""));
+            foreach ($feature in @("DirectPlay", "NetFx3")) {
-    }
+                if ((Get-WindowsOptionalFeature -Online -FeatureName $feature).State -ne "Enabled") {
-
+                    Write-Information "Enabling the ``$feature`` feature…";
-    function Restore-TmNations([Context] $context) {
+                    choco install --source windowsFeatures  -y $feature;
-        $features = @("DirectPlay", "NetFx3");
+                }
-        Write-Host "Restoring TrackMania Nations Forever";
-
-        foreach ($feature in $features) {
-            if ((Get-WindowsOptionalFeature -Online -FeatureName $feature).State -ne "Enabled") {
-                Write-Information "Enabling the ``$feature`` feature";
-                $null = Enable-WindowsOptionalFeature -Online -All -FeatureName $feature;
             }
-        }
 
-        Write-Information "Installing TrackMania Nations Forever";
+            Install-WingetPackage Nadeo.TrackManiaNationsForever;
-        winget install --accept-source-agreements --accept-package-agreements -e --id Nadeo.TrackManiaNationsForever;
+            Remove-DesktopIcon "*TmNationsForever*";
-        Write-Information "Removing Desktop Icon";
+        } `
-        $context.RemoveDesktopIcon("*TmNationsForever*");
+        -UserBackup {
-        Write-Information "Restoring Files";
+            param([hashtable] $Arguments)
-        $context.Restore($context.SoftwareArchive($softwareName), $path);
+            $name = $Arguments.Name;
-    }
+            Add-BackupArtifacts -User $name -Source $path -Path "TmNationsForever" `
-}
+                -Include @(
+                    "ChallengeMusics",
+                    "MediaTracker",
+                    "MenuMusics",
+                    "Painter",
+                    "Scores",
+                    "Skins",
+                    "Tracks"
+                );
+        } `
+        -UserConfigurator {
+            param([hashtable] $Arguments)
+            $name = $Arguments.Name;
+            Expand-BackupArtifacts -User $name -Path "TmNationsForever" -Target $path;
+        } | Out-Host;
+} $PSBoundParameters;

scripts/Windows/Software/TrackMania United Forever/Install.ps1

@@ -0,0 +1,40 @@
+#!/bin/pwsh
+. "$PSScriptRoot/../../../Common/Scripts/Context.ps1";
+
+$null = New-Module {
+    $path = "$HOME/Documents/TrackMania";
+    $softwareName = "TmUnitedForever";
+
+    function Backup-TmUnited([Context] $context) {
+        Write-Host "Backing up TrackMania United Forever";
+        $context.Backup($path, $context.SoftwareArchive($softwareName), @("-i@`"$PSScriptRoot/include.txt`""));
+    }
+
+    function Restore-TmUnited([Context] $context) {
+        $setupFile = "TmUnitedForever.exe";
+        $features = @("DirectPlay", "NetFx3");
+        Write-Host "Restoring TrackMania United Forever";
+
+        foreach ($feature in $features) {
+            if ((Get-WindowsOptionalFeature -Online -FeatureName $feature).State -ne "Enabled") {
+                Write-Information "Enabling the ``$feature`` feature";
+                $null = Enable-WindowsOptionalFeature -Online -All -FeatureName $feature;
+            }
+        }
+
+        $tempDir = $context.GetTempDirectory();
+        Push-Location $tempDir;
+        Write-Information "Downloading TrackMania United Forever setup";
+        Invoke-WebRequest "http://files.trackmaniaforever.com/tmunitedforever_setup.exe" -OutFile "$setupFile";
+
+        Write-Information "Installing TrackMania United Forever";
+        Start-Process -Wait -FilePath $setupFile -ArgumentList @("/Silent");
+        Write-Information "Removing desktop icon";
+        $context.RemoveDesktopIcon("*TmUnitedForever*");
+        Write-Information "Restoring files";
+        $context.Restore($context.SoftwareArchive($softwareName), $path);
+        Pop-Location;
+
+        Remove-Item -Recurse $tempDir;
+    }
+}

scripts/Windows/Software/TrackMania United Forever/Manage.ps1

@@ -1,40 +1,53 @@
-#!/bin/pwsh
+param(
-. "$PSScriptRoot/../../../Common/Scripts/Context.ps1";
+    $Action,
+    [hashtable] $Arguments
+)
 
-$null = New-Module {
+
+& {
+    param($Parameters)
+    . "$PSScriptRoot/../../Scripts/Restoration.ps1";
+    . "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
+    . "$PSScriptRoot/../../../Common/Scripts/System.ps1";
     $path = "$HOME/Documents/TrackMania";
-    $softwareName = "TmUnitedForever";
 
-    function Backup-TmUnited([Context] $context) {
+    Start-SoftwareInstaller @Parameters `
-        Write-Host "Backing up TrackMania United Forever";
+    -Installer {
-        $context.Backup($path, $context.SoftwareArchive($softwareName), @("-i@`"$PSScriptRoot/include.txt`""));
+        $file = "TmUnitedForever.exe";
-    }
+        $dir = New-TemporaryDirectory;
 
-    function Restore-TmUnited([Context] $context) {
+        foreach ($feature in @("DirectPlay", "NetFx3")) {
-        $setupFile = "TmUnitedForever.exe";
-        $features = @("DirectPlay", "NetFx3");
-        Write-Host "Restoring TrackMania United Forever";
-
-        foreach ($feature in $features) {
             if ((Get-WindowsOptionalFeature -Online -FeatureName $feature).State -ne "Enabled") {
-                Write-Information "Enabling the ``$feature`` feature";
+                Write-Information "Enabling the ``$feature`` feature…";
-                $null = Enable-WindowsOptionalFeature -Online -All -FeatureName $feature;
+                choco install --source windowsFeatures  -y $feature;
             }
         }
 
-        $tempDir = $context.GetTempDirectory();
+        $null = Push-Location $dir;
-        Push-Location $tempDir;
+        Write-Host "Downloading TrackMania United Forever…";
-        Write-Information "Downloading TrackMania United Forever setup";
+        Invoke-WebRequest "http://files.trackmaniaforever.com/tmunitedforever_setup.exe" -OutFile "$file";
-        Invoke-WebRequest "http://files.trackmaniaforever.com/tmunitedforever_setup.exe" -OutFile "$setupFile";
 
-        Write-Information "Installing TrackMania United Forever";
+        Write-Host "Starting installation…";
-        Start-Process -Wait -FilePath $setupFile -ArgumentList @("/Silent");
+        Start-Process -Wait -FilePath $file -ArgumentList "/Silent";
-        Write-Information "Removing desktop icon";
+        Remove-DesktopIcon "*TmUnitedForever*";
-        $context.RemoveDesktopIcon("*TmUnitedForever*");
+        $null = Pop-Location;
-        Write-Information "Restoring files";
-        $context.Restore($context.SoftwareArchive($softwareName), $path);
-        Pop-Location;
 
-        Remove-Item -Recurse $tempDir;
+        Remove-Item -Recurse $dir;
-    }
+    } `
-}
+    -UserBackup {
+        param([hashtable] $Arguments)
+        Add-BackupArtifacts -User $Arguments.Name -Source $path -Path "TmUnitedForever" `
+            -Include @(
+                "ChallengeMusics",
+                "MediaTracker",
+                "MenuMusics",
+                "Scores",
+                "Skins",
+                "Tracks"
+            );
+    } `
+    -UserConfigurator {
+        param([hashtable] $Arguments)
+        Expand-BackupArtifacts -User $Arguments.Name -Path "TmUnitedForever" -Target $path;
+    } | Out-Host;
+} $PSBoundParameters;

scripts/Windows/Software/Ubiquiti UniFi Controller/Manage.ps1

@@ -0,0 +1,27 @@
+param(
+    $Action,
+    [hashtable] $Arguments
+)
+
+. "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
+. "$PSScriptRoot/../../../Common/Scripts/System.ps1";
+
+Start-SoftwareInstaller @PSBoundParameters `
+    -Installer {
+        Write-Information "Downgrading AutoHotkey…";
+        $id = "AutoHotkey.AutoHotkey";
+        $uninstall = { winget uninstall --accept-source-agreements -e --id "$id"; };
+        & $uninstall;
+        Install-WingetPackage $id -ArgumentList "--version","1.1.37.00";
+        Install-ChocoPackage temurin11jre;
+
+        Write-Host "Installing UniFi Controller…";
+        Install-ChocoPackage ubiquiti-unifi-controller -ArgumentList "--ignore-dependencies";
+
+        Write-Information "Upgrading AutoHotkey…";
+        & $uninstall;
+        Install-WingetPackage $id;
+        Remove-DesktopIcon "UniFi*";
+    };
+
+# ToDo: Add restoration

scripts/Windows/Software/VisualStudio/Install.ps1

@@ -0,0 +1,57 @@
+#!/bin/pwsh
+. "$PSScriptRoot/../../Scripts/KnownFolders.ps1";
+. "$PSScriptRoot/../../../Common/Scripts/Context.ps1";
+
+$null = New-Module {
+    $programs32Path = $(Get-KnownFolder "ProgramFilesX86").Path;
+    $vsInstaller = "$programs32Path/Microsoft Visual Studio/Installer/vs_installer.exe";
+
+    [System.Tuple[string, string, string][]]$versions = @(
+        [System.Tuple]::Create("visualstudio2019enterprise", "VisualStudio.16.Release", "Microsoft.VisualStudio.Product.Enterprise"),
+        [System.Tuple]::Create("visualstudio2019community", "VisualStudio.16.Release", "Microsoft.VisualStudio.Product.Community"),
+        [System.Tuple]::Create("visualstudio2022enterprise", "VisualStudio.17.Release", "Microsoft.VisualStudio.Product.Enterprise"),
+        [System.Tuple]::Create("visualstudio2022community", "VisualStudio.17.Release", "Microsoft.VisualStudio.Product.Community"));
+
+    function Get-ConfigPath([Context] $context, [string] $packageName) {
+        return Join-Path $($context.BackupRoot()) "Visual Studio" $packageName ".vsconfig";
+    }
+
+    function Backup-VisualStudio([Context] $context) {
+        Write-Host "Backing up Visual Studio";
+
+        foreach ($version in $versions) {
+            if ((choco list -e $version[0])) {
+                Write-Information "Backing up $($version[1]): $($version[2])";
+    
+                $configPath = Get-ConfigPath $context $version[0];
+                $null = New-Item -Force -ItemType Directory "$(Split-Path -Parent $configPath)";
+    
+                Start-Process -FilePath "$vsInstaller" `
+                    -Wait `
+                    -ArgumentList @(
+                        "export",
+                        "--channelId", "$($version[1])",
+                        "--productId", "$($version[2])",
+                        "--config", "`"$configPath`"",
+                        "--quiet");
+            }
+        }
+    }
+
+    function Restore-VisualStudio([Context] $context) {
+        Write-Host "Restoring Visual Studio";
+
+        foreach ($version in $versions) {
+            $configFileName = Get-ConfigPath $context $version[0];
+
+            if (Test-Path $configFileName) {
+                Write-Information "Restoring $($version[1]): $($version[2])";
+                $arguments = "--config `"$configFileName`"";
+
+                choco install -y $version[0] --params "$arguments";
+                $context.RemoveDesktopIcon("CocosCreator*");
+                $context.RemoveDesktopIcon("Unity Hub*");
+            }
+        }
+    }
+}

scripts/Windows/Software/VisualStudio/Manage.ps1

@@ -1,57 +1,82 @@
-#!/bin/pwsh
+param(
-. "$PSScriptRoot/../../Scripts/KnownFolders.ps1";
+    $Action,
-. "$PSScriptRoot/../../../Common/Scripts/Context.ps1";
+    [hashtable] $Arguments
+)
 
-$null = New-Module {
+& {
-    $programs32Path = $(Get-KnownFolder "ProgramFilesX86").Path;
+    param($parameters)
-    $vsInstaller = "$programs32Path/Microsoft Visual Studio/Installer/vs_installer.exe";
 
-    [System.Tuple[string, string, string][]]$versions = @(
+    . "$PSScriptRoot/../../Scripts/Restoration.ps1";
+    . "$PSScriptRoot/../../../Common/Scripts/SoftwareManagement.ps1";
+    . "$PSScriptRoot/../../../Common/Scripts/BrowserAutomation.ps1";
+    . "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
+    . "$PSScriptRoot/../../../Common/Scripts/System.ps1";
+
+    [System.Tuple[string, string, string][]] $versions = @(
         [System.Tuple]::Create("visualstudio2019enterprise", "VisualStudio.16.Release", "Microsoft.VisualStudio.Product.Enterprise"),
         [System.Tuple]::Create("visualstudio2019community", "VisualStudio.16.Release", "Microsoft.VisualStudio.Product.Community"),
         [System.Tuple]::Create("visualstudio2022enterprise", "VisualStudio.17.Release", "Microsoft.VisualStudio.Product.Enterprise"),
-        [System.Tuple]::Create("visualstudio2022community", "VisualStudio.17.Release", "Microsoft.VisualStudio.Product.Community"));
+        [System.Tuple]::Create("visualstudio2022community", "VisualStudio.17.Release", "Microsoft.VisualStudio.Product.Community")
+    );
 
-    function Get-ConfigPath([Context] $context, [string] $packageName) {
+    <#
-        return Join-Path $($context.BackupRoot()) "Visual Studio" $packageName ".vsconfig";
+        .SYNOPSIS
+        Gets the path to the Visual Studio Installer.
+    #>
+    function Get-InstallerPath {
+        return "$((Get-KnownFolder ProgramFilesX86).Path)/Microsoft Visual Studio/Installer/vs_installer.exe";
     }
 
-    function Backup-VisualStudio([Context] $context) {
+    <#
-        Write-Host "Backing up Visual Studio";
+        .SYNOPSIS
+        Gets the path to the configuration file in the backup archive.
 
-        foreach ($version in $versions) {
+        .PARAMETER PackageName
-            if ((choco list -e $version[0])) {
+        The name of the package to get the configuration for.
-                Write-Information "Backing up $($version[1]): $($version[2])";
+    #>
+    function Get-ConfigPath {
+        param(
+            [string] $PackageName
+        )
+
+        return Join-Path "Visual Studio" "$PackageName.vsconfig";
+    }
     
-                $configPath = Get-ConfigPath $context $version[0];
+    Start-SoftwareInstaller @parameters `
-                $null = New-Item -Force -ItemType Directory "$(Split-Path -Parent $configPath)";
+        -Backup {
-    
+            foreach ($version in $versions) {
-                Start-Process -FilePath "$vsInstaller" `
+                if (Test-ChocoPackage $version[0]) {
-                    -Wait `
+                    Write-Host "Backing up ``$($version[0])…";
-                    -ArgumentList @(
+                    $configFile = New-TemporaryFile;
-                        "export",
+
-                        "--channelId", "$($version[1])",
+                    Start-Process -FilePath (Get-InstallerPath) -Wait `
-                        "--productId", "$($version[2])",
+                        -ArgumentList @(
-                        "--config", "`"$configPath`"",
+                            "export",
-                        "--quiet");
+                            "--channelId", $version[1],
+                            "--productId", $version[2],
+                            "--config", $configFile,
+                            "--quiet"
+                        );
+
+                    Add-BackupArtifacts -Source $configFile -Path (Get-ConfigPath $version[0]);
+                    Remove-Item $configFile;
+                }
             }
-        }
+        } `
-    }
+        -Installer {
+            foreach ($version in $versions) {
+                $packageName = $version[0];
+                $file = New-TemporaryFile;
+                Remove-Item $file;
+                Expand-BackupArtifacts -Path (Get-ConfigPath $packageName) -Target $file;
 
-    function Restore-VisualStudio([Context] $context) {
+                if (Test-Path $file) {
-        Write-Host "Restoring Visual Studio";
+                    Write-Host "Restoring ``$packageName``…";
-
+                    Install-ChocoPackage $packageName -ArgumentList "--params","--config `"$file`"";
-        foreach ($version in $versions) {
+                }
-            $configFileName = Get-ConfigPath $context $version[0];
-
-            if (Test-Path $configFileName) {
-                Write-Information "Restoring $($version[1]): $($version[2])";
-                $arguments = "--config `"$configFileName`"";
-
-                choco install -y $version[0] --params "$arguments";
-                $context.RemoveDesktopIcon("CocosCreator*");
-                $context.RemoveDesktopIcon("Unity Hub*");
             }
-        }
+
-    }
+            Remove-DesktopIcon "CocosCreator*";
-}
+            Remove-DesktopIcon "Unity Hub*";
+        };
+} $PSBoundParameters;

scripts/Windows/Software/WinSCP/Manage.ps1

@@ -7,16 +7,11 @@ param(
 
 . "$PSScriptRoot/../../Scripts/AppAssociations.ps1";
 . "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
-. "$PSScriptRoot/../../Scripts/System.ps1";
+. "$PSScriptRoot/../../../Common/Scripts/System.ps1";
 
 Start-SoftwareInstaller @PSBoundParameters `
     -Installer {
-        param(
-            [scriptblock] $Installer
-        )
-
         Install-ChocoPackage winscp;
-        & $Installer -Action ([InstallerAction]::Configure)
     } `
     -Configurator {
         Remove-DesktopIcon "WinSCP*";

scripts/Windows/Software/Windows/Home.exclude.txt

@@ -0,0 +1,37 @@
+Pictures/Feedback
+Documents/BeamNG.drive
+Documents/Default.rdp
+Documents/den4b/ReNamer
+Documents/Dolphin Emulator
+Documents/eFisc
+Documents/IISExpress
+Documents/KINGDOM HEARTS HD 1.5+2.5 ReMIX
+Documents/ManiaPlanet
+Documents/MetaX
+Documents/MuseScore3
+Documents/My Web Sites
+Documents/OneNote-Notizbücher
+Documents/PCSX2
+Documents/PowerShell
+Documents/PPSSPP
+Documents/PS Vita
+Documents/PSV Packages
+Documents/PSV Updates
+Documents/Repositories
+Documents/Rise of the Tomb Raider
+Documents/S2
+Documents/SEGA
+Documents/SEGA Mega Drive Classics
+Documents/SQL Server Management Studio
+Documents/Square Enix
+Documents/TI-Nspire CX
+Documents/TmForever
+Documents/TrackMania
+Documents/UltraVNC
+Documents/Visual Studio 2017
+Documents/Visual Studio 2019
+Documents/Visual Studio 2022
+Documents/Viwizard M4V Converter
+Documents/WindowsPowerShell
+Documents/Zoom
+Music/iTunes

scripts/Windows/Software/Windows/Manage.ps1

@@ -5,19 +5,40 @@ param(
     [hashtable] $Arguments
 )
 
-. "$PSScriptRoot/../../Scripts/Registry.ps1";
-. "$PSScriptRoot/../../Scripts/Config.ps1";
-. "$PSScriptRoot/../../Scripts/System.ps1";
 . "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
 . "$PSScriptRoot/../../../Common/Types/InstallerAction.ps1";
 
-Start-SoftwareInstaller @PSBoundParameters `
+$null = New-Module {
-    -Installer {
+    param($Parameters)
-        param(
-            [scriptblock] $Installer
-        )
 
-        & $Installer -Action ([InstallerAction]::Configure)
+    . "$PSScriptRoot/../../Scripts/Registry.ps1";
+    . "$PSScriptRoot/../../Scripts/Restoration.ps1";
+    . "$PSScriptRoot/../../../Common/Scripts/Config.ps1";
+    . "$PSScriptRoot/../../../Common/Scripts/System.ps1";
+
+    $userFolders = @(
+        "Pictures",
+        "Documents",
+        "Downloads",
+        "Music",
+        "Videos"
+    );
+
+    $userExclusions = @(
+        "Documents/Eigene*",
+        "Documents/My Games",
+        "Documents/My Music",
+        "Documents/My Pictures",
+        "Documents/My Videos"
+    );
+
+    [string[]] $homeExclusions = Get-Content "$PSScriptRoot/Home.exclude.txt";
+
+    Start-SoftwareInstaller @Parameters `
+    -Backup {
+        Add-BackupArtifacts -Source "$env:PUBLIC" -Path "Public" `
+            -Include ($userFolders) `
+            -Exclude ($userExclusions + @("Documents/Hyper-V", "Documents/reWASD"));
     } `
     -Configurator {
         $dir = New-TemporaryDirectory;
@@ -61,7 +82,7 @@ Start-SoftwareInstaller @PSBoundParameters `
                 )
 
                 $path = "$($Key.PSPath)\Software\Microsoft\Lighting";
-                $null = New-Item $path;
+                $null = New-Item $path -ErrorAction SilentlyContinue;
                 Set-ItemProperty $path -Name "AmbientLightingEnabled" -Value 0 -Type "DWord";
             };
         }
@@ -143,4 +164,20 @@ Start-SoftwareInstaller @PSBoundParameters `
 
         Pop-Location;
         Remove-Item -Recurse $dir;
+        Expand-BackupArtifacts -Path "Public" -Target $env:PUBLIC;
+    } `
+    -UserBackup {
+        param(
+            [hashtable] $Arguments
+        )
+
+        Add-BackupArtifacts -User $Arguments.Name -Source $HOME -Path "Home" -Include ($userFolders) -Exclude ($userExclusions + $homeExclusions);
+    } `
+    -UserConfigurator {
+        param(
+            [hashtable] $Arguments
+        )
+
+        Expand-BackupArtifacts -User $Arguments.Name -Path "Home" -Target $HOME;
     };
+} $PSBoundParameters;

scripts/Windows/Software/aliae/Main.ps1

@@ -0,0 +1,23 @@
+param (
+    $Action,
+    [hashtable] $Arguments
+)
+
+. "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
+. "$PSScriptRoot/../../../Common/Types/InstallerAction.ps1";
+
+& {
+    param($Parameters)
+    $base = "$PSScriptRoot/../../../Common/Software/aliae/Manage.ps1";
+
+    Start-SoftwareInstaller @Parameters `
+    -Installer {
+        Install-WingetPackage JanDeDobbeleer.Aliae;
+    } `
+    -Configurator {
+        . $base -Action ([InstallerAction]::Configure);
+    } `
+    -UserConfigurator {
+        . $base -Action ([InstallerAction]::ConfigureUser);
+    };
+} $PSBoundParameters;

scripts/Windows/Software/chocolatey/Manage.ps1

@@ -8,13 +8,6 @@ param(
 . "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
 
 Start-SoftwareInstaller @PSBoundParameters `
-    -Installer {
-        param(
-            [scriptblock] $Installer
-        )
-
-        & $Installer -Action ([InstallerAction]::Configure)
-    } `
     -Configurator {
         [string] $backup = $null;
         $nativeProfile = powershell -c '$PROFILE';

scripts/Windows/Software/git/Install.ps1

@@ -0,0 +1,15 @@
+#!/bin/pwsh
+. "$PSScriptRoot/../../Scripts/BashScript.ps1";
+. "$PSScriptRoot/../../../Common/Scripts/Context.ps1";
+
+$null = New-Module {
+    function Backup-Git([Context] $context) {}
+
+    function Restore-Git([Context] $context) {
+        Write-Host "Restoring git";
+
+        Start-BashScript @(
+            "bash `"$PSScriptRoot/../../../Common/Config/git/install.sh`"",
+            "rm ~/.bashrc");
+    }
+}

scripts/Windows/Software/git/Manage.ps1

@@ -1,15 +1,39 @@
-#!/bin/pwsh
+param (
-. "$PSScriptRoot/../../Scripts/BashScript.ps1";
+    $Action,
-. "$PSScriptRoot/../../../Common/Scripts/Context.ps1";
+    [hashtable] $Arguments
+)
 
-$null = New-Module {
+. "$PSScriptRoot/../../../Common/Types/InstallerAction.ps1";
-    function Backup-Git([Context] $context) {}
+. "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
+. "$PSScriptRoot/../../../Common/Scripts/Config.ps1";
 
-    function Restore-Git([Context] $context) {
+& {
-        Write-Host "Restoring git";
+    param(
+        [hashtable] $Parameters
+    )
 
-        Start-BashScript @(
+    . "$PSScriptRoot/../../../Common/Types/InstallerAction.ps1";
-            "bash `"$PSScriptRoot/../../../Common/Config/git/install.sh`"",
+    $base = "$PSScriptRoot/../../../Common/Software/git/Manage.ps1";
-            "rm ~/.bashrc");
+
-    }
+    Start-SoftwareInstaller @Parameters `
-}
+        -Installer {
+            $params = "/WindowsTerminalProfile";
+            $defaultBranch = Get-Config "valhalla.git.defaultBranch";
+
+            if ($defaultBranch) {
+                $params += " /DefaultBranchName:`"$defaultBranch`"";
+            }
+
+            Install-ChocoPackage git -ArgumentList "--params",$params;
+        } `
+        -Configurator {
+            & $base ([InstallerAction]::Configure);
+        } `
+        -UserConfigurator {
+            param(
+                $Arguments
+            )
+
+            & $base ([InstallerAction]::ConfigureUser) @PSBoundParameterrs;
+        };
+} $PSBoundParameters;

scripts/Windows/Software/osu!/Install.ps1

@@ -0,0 +1,36 @@
+#!/bin/pwsh
+. "$PSScriptRoot/../../Scripts/KnownFolders.ps1";
+. "$PSScriptRoot/../../../Common/Scripts/Context.ps1";
+
+$null = New-Module {
+    $path = "$((Get-KnownFolder -SpecialFolder ProgramFilesX86).Path)/osu!";
+    $softwareName = "osu!";
+    $genericConfigName = "osu!.User.cfg";
+
+    function Backup-Osu([Context] $context) {
+        Write-Host "Backing up osu!";
+        $archive = $context.SoftwareArchive($softwareName);
+        Write-Information "Backing up important files";
+        $context.Backup($path, $archive, @("-i@`"$PSScriptRoot/include.txt`""));
+        Write-Information "Renaming user configuration to $genericConfigName";
+        & 7z rn "$archive" "osu!.$env:USERNAME.cfg" $genericConfigName;
+    }
+
+    function Restore-Osu([Context] $context) {
+        Write-Host "Restoring osu!";
+        Write-Information "Installing osu!";
+        choco install -y osu;
+        $context.RemoveDesktopIcon("*osu*");
+        Write-Information "Restoring files";
+        $context.Restore($context.SoftwareArchive($softwareName), $path, @("-aos"));
+        $configName = "osu!.$env:USERNAME.cfg";
+        Write-Information "Renaming user configuration to $configName";
+        Push-Location $path;
+
+        if ((Test-Path $genericConfigName)) {
+            Rename-Item $genericConfigName $configName;
+        }
+
+        Pop-Location;
+    }
+}

scripts/Windows/Software/osu!/Manage.ps1

@@ -1,36 +1,49 @@
-#!/bin/pwsh
+param(
-. "$PSScriptRoot/../../Scripts/KnownFolders.ps1";
+    $Action,
-. "$PSScriptRoot/../../../Common/Scripts/Context.ps1";
+    [hashtable] $Arguments
+)
+
+. "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
 
 $null = New-Module {
-    $path = "$((Get-KnownFolder -SpecialFolder ProgramFilesX86).Path)/osu!";
+    param($Parameters)
-    $softwareName = "osu!";
+    . "$PSScriptRoot/../../Scripts/Restoration.ps1";
-    $genericConfigName = "osu!.User.cfg";
+    Export-ModuleMember -Function @();
 
-    function Backup-Osu([Context] $context) {
+    <#
-        Write-Host "Backing up osu!";
+        .SYNOPSIS
-        $archive = $context.SoftwareArchive($softwareName);
+        Gets the path to the installation directory of osu!.
-        Write-Information "Backing up important files";
+    #>
-        $context.Backup($path, $archive, @("-i@`"$PSScriptRoot/include.txt`""));
+    function Get-InstallPath {
-        Write-Information "Renaming user configuration to $genericConfigName";
+        return "$((Get-KnownFolder -SpecialFolder ProgramFilesX86).Path)/osu!";
-        & 7z rn "$archive" "osu!.$env:USERNAME.cfg" $genericConfigName;
     }
 
-    function Restore-Osu([Context] $context) {
+    Start-SoftwareInstaller @Parameters `
-        Write-Host "Restoring osu!";
+        -Installer {
-        Write-Information "Installing osu!";
+            Install-ChocoPackage osu;
-        choco install -y osu;
+            Remove-DesktopIcon "*osu*";
-        $context.RemoveDesktopIcon("*osu*");
+        } `
-        Write-Information "Restoring files";
+        -Backup {
-        $context.Restore($context.SoftwareArchive($softwareName), $path, @("-aos"));
+            Add-BackupArtifacts -Source (Get-InstallPath) -Path "osu!" `
-        $configName = "osu!.$env:USERNAME.cfg";
+                -Include @(
-        Write-Information "Renaming user configuration to $configName";
+                    "Screenshots",
-        Push-Location $path;
+                    "Skins",
-
+                    "Songs",
-        if ((Test-Path $genericConfigName)) {
+                    "osu!.cfg",
-            Rename-Item $genericConfigName $configName;
+                    "scores.db"
-        }
+                );
-
+        } `
-        Pop-Location;
+        -Configurator {
-    }
+            Expand-BackupArtifacts -Path "osu!" -Target (Get-InstallPath);
-}
+        } `
+        -UserBackup {
+            param([hashtable] $Arguments)
+            $name = $Arguments.Name;
+            Add-BackupArtifacts -Source "$(Get-InstallPath)/osu!.$name.cfg" -User $name -Path "osu!/osu!.cfg";
+        } `
+        -UserConfigurator {
+            param([hashtable] $Arguments)
+            $name = $Arguments.Name;
+            Expand-BackupArtifacts -User $name -Path "osu!/osu!.cfg" -Target "$(Get-InstallPath)/osu!.$name.cfg";
+        };
+} $PSBoundParameters;

scripts/Windows/Software/osu!lazer/Install.ps1

@@ -0,0 +1,37 @@
+#!/bin/pwsh
+. "$PSScriptRoot/../../../Common/Scripts/Context.ps1";
+
+$null = New-Module {
+    $path = "$env:APPDATA/osu";
+    $softwareName = "osu!lazer";
+
+    function Backup-OsuLazer([Context] $context) {
+        Write-Host "Backing up osu!lazer";
+        $context.Backup($path, $context.SoftwareArchive($softwareName), @("-i@`"$PSScriptRoot/include.txt`"", "-i!*.realm", "-i!*.db"));
+    }
+
+    function Restore-OsuLazer([Context] $context) {
+        Write-Host "Restoring osu!lazer";
+        Write-Information "Restoring files";
+        $context.Restore($context.SoftwareArchive($softwareName), $path);
+        Write-Information "Installing osu!lazer";
+
+        $installerName = "osu!lazer.exe";
+        $processName = "osu!";
+        $tempDir = $context.GetTempDirectory();
+        Push-Location $tempDir;
+        Invoke-WebRequest "https://github.com/ppy/osu/releases/latest/download/install.exe" -OutFile $installerName;
+        Start-Process -FilePath $installerName;
+
+        while (-not (Get-Process -ErrorAction "SilentlyContinue" $processName)) {
+            Start-Sleep 1;
+        }
+
+        Start-Sleep 10;
+        Get-Process $processName | Stop-Process -Force;
+
+        $context.RemoveDesktopIcon("*osu*");
+        Pop-Location;
+        Remove-Item -Recurse $tempDir;
+    }
+}

scripts/Windows/Software/osu!lazer/Manage.ps1

@@ -1,37 +1,32 @@
-#!/bin/pwsh
+param(
-. "$PSScriptRoot/../../../Common/Scripts/Context.ps1";
+    $Action,
+    [hashtable] $Arguments
+)
 
-$null = New-Module {
+& {
-    $path = "$env:APPDATA/osu";
+    param($Parameters)
-    $softwareName = "osu!lazer";
+    . "$PSScriptRoot/../../Scripts/Restoration.ps1";
+    . "$PSScriptRoot/../../../Common/Scripts/Software.ps1";
+    . "$PSScriptRoot/../../../Common/Scripts/System.ps1";
+    $path = "$env:AppData/osu";
 
-    function Backup-OsuLazer([Context] $context) {
+    Start-SoftwareInstaller @Parameters `
-        Write-Host "Backing up osu!lazer";
+        -UserBackup {
-        $context.Backup($path, $context.SoftwareArchive($softwareName), @("-i@`"$PSScriptRoot/include.txt`"", "-i!*.realm", "-i!*.db"));
+            param([hashtable] $Arguments)
-    }
+            Add-BackupArtifacts -User $Arguments.Name -Source $path -Path "osu!lazer" `
-
+                -Include @(
-    function Restore-OsuLazer([Context] $context) {
+                    "files",
-        Write-Host "Restoring osu!lazer";
+                    "rulesets",
-        Write-Information "Restoring files";
+                    "screenshots",
-        $context.Restore($context.SoftwareArchive($softwareName), $path);
+                    "framework.ini",
-        Write-Information "Installing osu!lazer";
+                    "game.ini",
-
+                    "input.json"
-        $installerName = "osu!lazer.exe";
+                );
-        $processName = "osu!";
+        } `
-        $tempDir = $context.GetTempDirectory();
+        -UserConfigurator {
-        Push-Location $tempDir;
+            param([hashtable] $Arguments)
-        Invoke-WebRequest "https://github.com/ppy/osu/releases/latest/download/install.exe" -OutFile $installerName;
+            Install-WingetPackage "ppy.osu" -ArgumentList "--scope","user";
-        Start-Process -FilePath $installerName;
+            Remove-DesktopIcon "*osu*";
-
+            Expand-BackupArtifacts -User $Arguments.Name -Path "osu!lazer" -Target $path;
-        while (-not (Get-Process -ErrorAction "SilentlyContinue" $processName)) {
+        };
-            Start-Sleep 1;
+} $PSBoundParameters;
-        }
-
-        Start-Sleep 10;
-        Get-Process $processName | Stop-Process -Force;
-
-        $context.RemoveDesktopIcon("*osu*");
-        Pop-Location;
-        Remove-Item -Recurse $tempDir;
-    }
-}

scripts/Windows/Software/reWASD/Install.ps1

@@ -0,0 +1,31 @@
+#!/bin/pwsh
+$null = New-Module {
+    . "$PSScriptRoot/../../../Common/Scripts/BrowserAutomation.ps1";
+    . "$PSScriptRoot/../../../Common/Scripts/Context.ps1";
+
+    $path = "$env:PUBLIC/Documents/reWASD";
+    $softwareName = "reWASD";
+
+    function Backup-reWASD([Context] $context) {
+        Write-Host "Backing up reWASD";
+        $context.Backup($path, $context.SoftwareArchive($softwareName), @("-x@`"$PSScriptRoot/exclude.txt`""));
+    }
+
+    function Restore-reWASD([Context] $context) {
+        Write-Host "Restoring reWASD";
+        $tempDir = $context.GetTempDirectory();
+
+        Write-Information "Downloading reWASD";
+        $file = Start-BrowserDownload $context "https://rewasd.com/" 'a.btn-default[href="#"]' $tempDir;
+
+        Write-Information "Installing reWASD";
+        Start-Process -Wait -FilePath $file.FullName -ArgumentList "/S";
+
+        Write-Information "Restoring files";
+        $context.Restore($context.SoftwareArchive($softwareName), $path, @("-aos"));
+
+        Write-Information "Removing desktop icon";
+        $context.RemoveDesktopIcon("*reWASD*");
+        Remove-Item -Recurse $tempDir;
+    }
+}