├── .editorconfig
├── Fido.ps1
├── LICENSE.txt
└── README.md


/.editorconfig:
--------------------------------------------------------------------------------
 1 | # indicate this is the root of the project
 2 | root = true
 3 | 
 4 | [*]
 5 | # Must use a BOM else Unicode strings will not display
 6 | charset = utf-8-bom
 7 | insert_final_newline = true
 8 | indent_style = tab
 9 | trim_trailing_whitespace = true
10 | 


--------------------------------------------------------------------------------
/Fido.ps1:
--------------------------------------------------------------------------------
   1 | #
   2 | # Fido v1.64 - ISO Downloader, for Microsoft Windows and UEFI Shell
   3 | # Copyright © 2019-2024 Pete Batard <pete@akeo.ie>
   4 | # Command line support: Copyright © 2021 flx5
   5 | # ConvertTo-ImageSource: Copyright © 2016 Chris Carter
   6 | #
   7 | # This program is free software: you can redistribute it and/or modify
   8 | # it under the terms of the GNU General Public License as published by
   9 | # the Free Software Foundation, either version 3 of the License, or
  10 | # (at your option) any later version.
  11 | #
  12 | # This program is distributed in the hope that it will be useful,
  13 | # but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 | # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 | # GNU General Public License for more details.
  16 | #
  17 | # You should have received a copy of the GNU General Public License
  18 | # along with this program.  If not, see <http://www.gnu.org/licenses/>.
  19 | #
  20 | 
  21 | # NB: You must have a BOM on your .ps1 if you want Powershell to actually
  22 | # realise it should use Unicode for the UI rather than ISO-8859-1.
  23 | 
  24 | #region Parameters
  25 | param(
  26 | 	# (Optional) The title to display on the application window.
  27 | 	[string]$AppTitle = "Fido - ISO Downloader",
  28 | 	# (Optional) '|' separated UI localization strings.
  29 | 	[string]$LocData,
  30 | 	# (Optional) Forced locale
  31 | 	[string]$Locale = "en-US",
  32 | 	# (Optional) Path to a file that should be used for the UI icon.
  33 | 	[string]$Icon,
  34 | 	# (Optional) Name of a pipe the download URL should be sent to.
  35 | 	# If not provided, a browser window is opened instead.
  36 | 	[string]$PipeName,
  37 | 	# (Optional) Specify Windows version (e.g. "Windows 10") [Toggles commandline mode]
  38 | 	[string]$Win,
  39 | 	# (Optional) Specify Windows release (e.g. "21H1") [Toggles commandline mode]
  40 | 	[string]$Rel,
  41 | 	# (Optional) Specify Windows edition (e.g. "Pro") [Toggles commandline mode]
  42 | 	[string]$Ed,
  43 | 	# (Optional) Specify Windows language [Toggles commandline mode]
  44 | 	[string]$Lang,
  45 | 	# (Optional) Specify Windows architecture [Toggles commandline mode]
  46 | 	[string]$Arch,
  47 | 	# (Optional) Only display the download URL [Toggles commandline mode]
  48 | 	[switch]$GetUrl = $false,
  49 | 	# (Optional) Specify the architecture of the underlying CPU.
  50 | 	# This avoids a VERY TIME CONSUMING call to WMI to autodetect the arch.
  51 | 	[string]$PlatformArch,
  52 | 	# (Optional) Increase verbosity
  53 | 	[switch]$Verbose = $false,
  54 | 	# (Optional) Produce debugging information
  55 | 	[switch]$Debug = $false
  56 | )
  57 | #endregion
  58 | 
  59 | try {
  60 | 	[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
  61 | } catch {}
  62 | 
  63 | $Cmd = $false
  64 | if ($Win -or $Rel -or $Ed -or $Lang -or $Arch -or $GetUrl) {
  65 | 	$Cmd = $true
  66 | }
  67 | 
  68 | # Return a decimal Windows version that we can then check for platform support.
  69 | # Note that because we don't want to have to support this script on anything
  70 | # other than Windows, this call returns 0.0 for PowerShell running on Linux/Mac.
  71 | function Get-Platform-Version()
  72 | {
  73 | 	$version = 0.0
  74 | 	$platform = [string][System.Environment]::OSVersion.Platform
  75 | 	# This will filter out non Windows platforms
  76 | 	if ($platform.StartsWith("Win")) {
  77 | 		# Craft a decimal numeric version of Windows
  78 | 		$version = [System.Environment]::OSVersion.Version.Major * 1.0 + [System.Environment]::OSVersion.Version.Minor * 0.1
  79 | 	}
  80 | 	return $version
  81 | }
  82 | 
  83 | $winver = Get-Platform-Version
  84 | 
  85 | # The default TLS for Windows 8.x doesn't work with Microsoft's servers so we must force it
  86 | if ($winver -lt 10.0) {
  87 | 	[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls -bor [Net.SecurityProtocolType]::Tls11 -bor [Net.SecurityProtocolType]::Tls12
  88 | }
  89 | 
  90 | #region Assembly Types
  91 | $Drawing_Assembly = "System.Drawing"
  92 | # PowerShell 7 altered the name of the Drawing assembly...
  93 | if ($host.version -ge "7.0") {
  94 | 	$Drawing_Assembly += ".Common"
  95 | }
  96 | 
  97 | $Signature = @{
  98 | 	Namespace            = "WinAPI"
  99 | 	Name                 = "Utils"
 100 | 	Language             = "CSharp"
 101 | 	UsingNamespace       = "System.Runtime", "System.IO", "System.Text", "System.Drawing", "System.Globalization"
 102 | 	ReferencedAssemblies = $Drawing_Assembly
 103 | 	ErrorAction          = "Stop"
 104 | 	WarningAction        = "Ignore"
 105 | 	IgnoreWarnings       = $true
 106 | 	MemberDefinition     = @"
 107 | 		[DllImport("shell32.dll", CharSet = CharSet.Auto, SetLastError = true, BestFitMapping = false, ThrowOnUnmappableChar = true)]
 108 | 		internal static extern int ExtractIconEx(string sFile, int iIndex, out IntPtr piLargeVersion, out IntPtr piSmallVersion, int amountIcons);
 109 | 
 110 | 		[DllImport("user32.dll")]
 111 | 		public static extern bool ShowWindow(IntPtr handle, int state);
 112 | 		// Extract an icon from a DLL
 113 | 		public static Icon ExtractIcon(string file, int number, bool largeIcon) {
 114 | 			IntPtr large, small;
 115 | 			ExtractIconEx(file, number, out large, out small, 1);
 116 | 			try {
 117 | 				return Icon.FromHandle(largeIcon ? large : small);
 118 | 			} catch {
 119 | 				return null;
 120 | 			}
 121 | 		}
 122 | "@
 123 | }
 124 | 
 125 | if (!$Cmd) {
 126 | 	Write-Host Please Wait...
 127 | 
 128 | 	if (!("WinAPI.Utils" -as [type]))
 129 | 	{
 130 | 		Add-Type @Signature
 131 | 	}
 132 | 	Add-Type -AssemblyName PresentationFramework
 133 | 
 134 | 	# Hide the powershell window: https://stackoverflow.com/a/27992426/1069307
 135 | 	[WinAPI.Utils]::ShowWindow(([System.Diagnostics.Process]::GetCurrentProcess() | Get-Process).MainWindowHandle, 0) | Out-Null
 136 | }
 137 | #endregion
 138 | 
 139 | #region Data
 140 | $WindowsVersions = @(
 141 | 	@(
 142 | 		@("Windows 11", "windows11"),
 143 | 		@(
 144 | 			"24H2 (Build 26100.1742 - 2024.10)",
 145 | 			# Thanks to Microsoft's hare-brained decision not to treat ARM64 as a CPU arch,
 146 | 			# like they did for x86 and x64, we have to handle multiple IDs for each release...
 147 | 			@("Windows 11 Home/Pro/Edu", @(3113, 3131)),
 148 | 			@("Windows 11 Home China ", @(3115, 3132)),
 149 | 			@("Windows 11 Pro China ", @(3114, 3133))
 150 | 		)
 151 | 	),
 152 | 	@(
 153 | 		@("Windows 10", "Windows10ISO"),
 154 | 		@(
 155 | 			"22H2 v1 (Build 19045.2965 - 2023.05)",
 156 | 			@("Windows 10 Home/Pro/Edu", 2618),
 157 | 			@("Windows 10 Home China ", 2378)
 158 | 		)
 159 | 	)
 160 | 	@(
 161 | 		@("UEFI Shell 2.2", "UEFI_SHELL 2.2"),
 162 | 		@(
 163 | 			"24H2 (edk2-stable202411)",
 164 | 			@("Release", 0),
 165 | 			@("Debug", 1)
 166 | 		),
 167 | 		@(
 168 | 			"24H1 (edk2-stable202405)",
 169 | 			@("Release", 0),
 170 | 			@("Debug", 1)
 171 | 		),
 172 | 		@(
 173 | 			"23H2 (edk2-stable202311)",
 174 | 			@("Release", 0),
 175 | 			@("Debug", 1)
 176 | 		),
 177 | 		@(
 178 | 			"23H1 (edk2-stable202305)",
 179 | 			@("Release", 0),
 180 | 			@("Debug", 1)
 181 | 		),
 182 | 		@(
 183 | 			"22H2 (edk2-stable202211)",
 184 | 			@("Release", 0),
 185 | 			@("Debug", 1)
 186 | 		),
 187 | 		@(
 188 | 			"22H1 (edk2-stable202205)",
 189 | 			@("Release", 0),
 190 | 			@("Debug", 1)
 191 | 		),
 192 | 		@(
 193 | 			"21H2 (edk2-stable202108)",
 194 | 			@("Release", 0),
 195 | 			@("Debug", 1)
 196 | 		),
 197 | 		@(
 198 | 			"21H1 (edk2-stable202105)",
 199 | 			@("Release", 0),
 200 | 			@("Debug", 1)
 201 | 		),
 202 | 		@(
 203 | 			"20H2 (edk2-stable202011)",
 204 | 			@("Release", 0),
 205 | 			@("Debug", 1)
 206 | 		)
 207 | 	),
 208 | 	@(
 209 | 		@("UEFI Shell 2.0", "UEFI_SHELL 2.0"),
 210 | 		@(
 211 | 			"4.632 [20100426]",
 212 | 			@("Release", 0)
 213 | 		)
 214 | 	)
 215 | )
 216 | #endregion
 217 | 
 218 | #region Functions
 219 | function Select-Language([string]$LangName)
 220 | {
 221 | 	# Use the system locale to try select the most appropriate language
 222 | 	[string]$SysLocale = [System.Globalization.CultureInfo]::CurrentUICulture.Name
 223 | 	if (($SysLocale.StartsWith("ar") -and $LangName -like "*Arabic*") -or `
 224 | 		($SysLocale -eq "pt-BR" -and $LangName -like "*Brazil*") -or `
 225 | 		($SysLocale.StartsWith("ar") -and $LangName -like "*Bulgar*") -or `
 226 | 		($SysLocale -eq "zh-CN" -and $LangName -like "*Chinese*" -and $LangName -like "*simp*") -or `
 227 | 		($SysLocale -eq "zh-TW" -and $LangName -like "*Chinese*" -and $LangName -like "*trad*") -or `
 228 | 		($SysLocale.StartsWith("hr") -and $LangName -like "*Croat*") -or `
 229 | 		($SysLocale.StartsWith("cz") -and $LangName -like "*Czech*") -or `
 230 | 		($SysLocale.StartsWith("da") -and $LangName -like "*Danish*") -or `
 231 | 		($SysLocale.StartsWith("nl") -and $LangName -like "*Dutch*") -or `
 232 | 		($SysLocale -eq "en-US" -and $LangName -eq "English") -or `
 233 | 		($SysLocale.StartsWith("en") -and $LangName -like "*English*" -and ($LangName -like "*inter*" -or $LangName -like "*ingdom*")) -or `
 234 | 		($SysLocale.StartsWith("et") -and $LangName -like "*Eston*") -or `
 235 | 		($SysLocale.StartsWith("fi") -and $LangName -like "*Finn*") -or `
 236 | 		($SysLocale -eq "fr-CA" -and $LangName -like "*French*" -and $LangName -like "*Canad*") -or `
 237 | 		($SysLocale.StartsWith("fr") -and $LangName -eq "French") -or `
 238 | 		($SysLocale.StartsWith("de") -and $LangName -like "*German*") -or `
 239 | 		($SysLocale.StartsWith("el") -and $LangName -like "*Greek*") -or `
 240 | 		($SysLocale.StartsWith("he") -and $LangName -like "*Hebrew*") -or `
 241 | 		($SysLocale.StartsWith("hu") -and $LangName -like "*Hungar*") -or `
 242 | 		($SysLocale.StartsWith("id") -and $LangName -like "*Indones*") -or `
 243 | 		($SysLocale.StartsWith("it") -and $LangName -like "*Italia*") -or `
 244 | 		($SysLocale.StartsWith("ja") -and $LangName -like "*Japan*") -or `
 245 | 		($SysLocale.StartsWith("ko") -and $LangName -like "*Korea*") -or `
 246 | 		($SysLocale.StartsWith("lv") -and $LangName -like "*Latvia*") -or `
 247 | 		($SysLocale.StartsWith("lt") -and $LangName -like "*Lithuania*") -or `
 248 | 		($SysLocale.StartsWith("ms") -and $LangName -like "*Malay*") -or `
 249 | 		($SysLocale.StartsWith("nb") -and $LangName -like "*Norw*") -or `
 250 | 		($SysLocale.StartsWith("fa") -and $LangName -like "*Persia*") -or `
 251 | 		($SysLocale.StartsWith("pl") -and $LangName -like "*Polish*") -or `
 252 | 		($SysLocale -eq "pt-PT" -and $LangName -eq "Portuguese") -or `
 253 | 		($SysLocale.StartsWith("ro") -and $LangName -like "*Romania*") -or `
 254 | 		($SysLocale.StartsWith("ru") -and $LangName -like "*Russia*") -or `
 255 | 		($SysLocale.StartsWith("sr") -and $LangName -like "*Serbia*") -or `
 256 | 		($SysLocale.StartsWith("sk") -and $LangName -like "*Slovak*") -or `
 257 | 		($SysLocale.StartsWith("sl") -and $LangName -like "*Slovenia*") -or `
 258 | 		($SysLocale -eq "es-ES" -and $LangName -eq "Spanish") -or `
 259 | 		($SysLocale.StartsWith("es") -and $Locale -ne "es-ES" -and $LangName -like "*Spanish*") -or `
 260 | 		($SysLocale.StartsWith("sv") -and $LangName -like "*Swed*") -or `
 261 | 		($SysLocale.StartsWith("th") -and $LangName -like "*Thai*") -or `
 262 | 		($SysLocale.StartsWith("tr") -and $LangName -like "*Turk*") -or `
 263 | 		($SysLocale.StartsWith("uk") -and $LangName -like "*Ukrain*") -or `
 264 | 		($SysLocale.StartsWith("vi") -and $LangName -like "*Vietnam*")) {
 265 | 		return $true
 266 | 	}
 267 | 	return $false
 268 | }
 269 | 
 270 | function Add-Entry([int]$pos, [string]$Name, [array]$Items, [string]$DisplayName)
 271 | {
 272 | 	$Title = New-Object System.Windows.Controls.TextBlock
 273 | 	$Title.FontSize = $WindowsVersionTitle.FontSize
 274 | 	$Title.Height = $WindowsVersionTitle.Height;
 275 | 	$Title.Width = $WindowsVersionTitle.Width;
 276 | 	$Title.HorizontalAlignment = "Left"
 277 | 	$Title.VerticalAlignment = "Top"
 278 | 	$Margin = $WindowsVersionTitle.Margin
 279 | 	$Margin.Top += $pos * $dh
 280 | 	$Title.Margin = $Margin
 281 | 	$Title.Text = Get-Translation($Name)
 282 | 	$XMLGrid.Children.Insert(2 * $Stage + 2, $Title)
 283 | 
 284 | 	$Combo = New-Object System.Windows.Controls.ComboBox
 285 | 	$Combo.FontSize = $WindowsVersion.FontSize
 286 | 	$Combo.Height = $WindowsVersion.Height;
 287 | 	$Combo.Width = $WindowsVersion.Width;
 288 | 	$Combo.HorizontalAlignment = "Left"
 289 | 	$Combo.VerticalAlignment = "Top"
 290 | 	$Margin = $WindowsVersion.Margin
 291 | 	$Margin.Top += $pos * $script:dh
 292 | 	$Combo.Margin = $Margin
 293 | 	$Combo.SelectedIndex = 0
 294 | 	if ($Items) {
 295 | 		$Combo.ItemsSource = $Items
 296 | 		if ($DisplayName) {
 297 | 			$Combo.DisplayMemberPath = $DisplayName
 298 | 		} else {
 299 | 			$Combo.DisplayMemberPath = $Name
 300 | 		}
 301 | 	}
 302 | 	$XMLGrid.Children.Insert(2 * $Stage + 3, $Combo)
 303 | 
 304 | 	$XMLForm.Height += $dh;
 305 | 	$Margin = $Continue.Margin
 306 | 	$Margin.Top += $dh
 307 | 	$Continue.Margin = $Margin
 308 | 	$Margin = $Back.Margin
 309 | 	$Margin.Top += $dh
 310 | 	$Back.Margin = $Margin
 311 | 
 312 | 	return $Combo
 313 | }
 314 | 
 315 | function Refresh-Control([object]$Control)
 316 | {
 317 | 	$Control.Dispatcher.Invoke("Render", [Windows.Input.InputEventHandler] { $Continue.UpdateLayout() }, $null, $null) | Out-Null
 318 | }
 319 | 
 320 | function Send-Message([string]$PipeName, [string]$Message)
 321 | {
 322 | 	[System.Text.Encoding]$Encoding = [System.Text.Encoding]::UTF8
 323 | 	$Pipe = New-Object -TypeName System.IO.Pipes.NamedPipeClientStream -ArgumentList ".", $PipeName, ([System.IO.Pipes.PipeDirection]::Out), ([System.IO.Pipes.PipeOptions]::None), ([System.Security.Principal.TokenImpersonationLevel]::Impersonation)
 324 | 	try {
 325 | 		$Pipe.Connect(1000)
 326 | 	} catch {
 327 | 		Write-Host $_.Exception.Message
 328 | 	}
 329 | 	$bRequest = $Encoding.GetBytes($Message)
 330 | 	$cbRequest = $bRequest.Length;
 331 | 	$Pipe.Write($bRequest, 0, $cbRequest);
 332 | 	$Pipe.Dispose()
 333 | }
 334 | 
 335 | # From https://www.powershellgallery.com/packages/IconForGUI/1.5.2
 336 | # Copyright © 2016 Chris Carter. All rights reserved.
 337 | # License: https://creativecommons.org/licenses/by-sa/4.0/
 338 | function ConvertTo-ImageSource
 339 | {
 340 | 	[CmdletBinding()]
 341 | 	Param(
 342 | 		[Parameter(Mandatory=$true,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true)]
 343 | 		[System.Drawing.Icon]$Icon
 344 | 	)
 345 | 
 346 | 	Process {
 347 | 		foreach ($i in $Icon) {
 348 | 			[System.Windows.Interop.Imaging]::CreateBitmapSourceFromHIcon(
 349 | 				$i.Handle,
 350 | 				(New-Object System.Windows.Int32Rect -Args 0,0,$i.Width, $i.Height),
 351 | 				[System.Windows.Media.Imaging.BitmapSizeOptions]::FromEmptyOptions()
 352 | 			)
 353 | 		}
 354 | 	}
 355 | }
 356 | 
 357 | # Translate a message string
 358 | function Get-Translation([string]$Text)
 359 | {
 360 | 	if (!($English -contains $Text)) {
 361 | 		Write-Host "Error: '$Text' is not a translatable string"
 362 | 		return "(Untranslated)"
 363 | 	}
 364 | 	if ($Localized) {
 365 | 		if ($Localized.Length -ne $English.Length) {
 366 | 			Write-Host "Error: '$Text' is not a translatable string"
 367 | 		}
 368 | 		for ($i = 0; $i -lt $English.Length; $i++) {
 369 | 			if ($English[$i] -eq $Text) {
 370 | 				if ($Localized[$i]) {
 371 | 					return $Localized[$i]
 372 | 				} else {
 373 | 					return $Text
 374 | 				}
 375 | 			}
 376 | 		}
 377 | 	}
 378 | 	return $Text
 379 | }
 380 | 
 381 | # Get the underlying *native* CPU architecture
 382 | function Get-Arch
 383 | {
 384 | 	$Arch = Get-CimInstance -ClassName Win32_Processor | Select-Object -ExpandProperty Architecture
 385 | 	switch($Arch) {
 386 | 	0  { return "x86" }
 387 | 	1  { return "MIPS" }
 388 | 	2  { return "Alpha" }
 389 | 	3  { return "PowerPC" }
 390 | 	5  { return "ARM32" }
 391 | 	6  { return "IA64" }
 392 | 	9  { return "x64" }
 393 | 	12 { return "ARM64" }
 394 | 	default { return "Unknown"}
 395 | 	}
 396 | }
 397 | 
 398 | # Convert a Microsoft arch type code to a formal architecture name
 399 | function Get-Arch-From-Type([int]$Type)
 400 | {
 401 | 	switch($Type) {
 402 | 	0 { return "x86" }
 403 | 	1 { return "x64" }
 404 | 	2 { return "ARM64" }
 405 | 	default { return "Unknown"}
 406 | 	}
 407 | }
 408 | 
 409 | function Error([string]$ErrorMessage)
 410 | {
 411 | 	Write-Host Error: $ErrorMessage
 412 | 	if (!$Cmd) {
 413 | 		$XMLForm.Title = $(Get-Translation("Error")) + ": " + $ErrorMessage
 414 | 		Refresh-Control($XMLForm)
 415 | 		$XMLGrid.Children[2 * $script:Stage + 1].IsEnabled = $true
 416 | 		$UserInput = [System.Windows.MessageBox]::Show($XMLForm.Title,  $(Get-Translation("Error")), "OK", "Error")
 417 | 		$script:ExitCode = $script:Stage--
 418 | 	} else {
 419 | 		$script:ExitCode = 2
 420 | 	}
 421 | }
 422 | #endregion
 423 | 
 424 | #region Form
 425 | [xml]$XAML = @"
 426 | <Window xmlns = "http://schemas.microsoft.com/winfx/2006/xaml/presentation" Height = "162" Width = "384" ResizeMode = "NoResize">
 427 | 	<Grid Name = "XMLGrid">
 428 | 		<Button Name = "Continue" FontSize = "16" Height = "26" Width = "160" HorizontalAlignment = "Left" VerticalAlignment = "Top" Margin = "14,78,0,0"/>
 429 | 		<Button Name = "Back" FontSize = "16" Height = "26" Width = "160" HorizontalAlignment = "Left" VerticalAlignment = "Top" Margin = "194,78,0,0"/>
 430 | 		<TextBlock Name = "WindowsVersionTitle" FontSize = "16" Width="340" HorizontalAlignment="Left" VerticalAlignment="Top" Margin="16,8,0,0"/>
 431 | 		<ComboBox Name = "WindowsVersion" FontSize = "14" Height = "24" Width = "340" HorizontalAlignment = "Left" VerticalAlignment="Top" Margin = "14,34,0,0" SelectedIndex = "0"/>
 432 | 		<CheckBox Name = "Check" FontSize = "14" Width = "340" HorizontalAlignment = "Left" VerticalAlignment="Top" Margin = "14,0,0,0" Visibility="Collapsed" />
 433 | 	</Grid>
 434 | </Window>
 435 | "@
 436 | #endregion
 437 | 
 438 | #region Globals
 439 | $ErrorActionPreference = "Stop"
 440 | $DefaultTimeout = 30
 441 | $dh = 58
 442 | $Stage = 0
 443 | $SelectedIndex = 0
 444 | $ltrm = "‎"
 445 | if ($Cmd) {
 446 | 	$ltrm = ""
 447 | }
 448 | $MaxStage = 4
 449 | # Can't reuse the same sessionId for x64 and ARM64. The Microsoft servers
 450 | # are purposefully designed to ever process one specific download request
 451 | # that matches the last SKUs retrieved.
 452 | $SessionId = @($null) * 2
 453 | $ExitCode = 100
 454 | $Locale = $Locale
 455 | $OrgId = "y6jn8c31"
 456 | $ProfileId = "606624d44113"
 457 | $Verbosity = 1
 458 | if ($Debug) {
 459 | 	$Verbosity = 5
 460 | } elseif ($Verbose) {
 461 | 	$Verbosity = 2
 462 | } elseif ($Cmd -and $GetUrl) {
 463 | 	$Verbosity = 0
 464 | }
 465 | if (!$PlatformArch) {
 466 | 	$PlatformArch = Get-Arch
 467 | }
 468 | #endregion
 469 | 
 470 | # Localization
 471 | $EnglishMessages = "en-US|Version|Release|Edition|Language|Architecture|Download|Continue|Back|Close|Cancel|Error|Please wait...|" +
 472 | 	"Download using a browser|Download of Windows ISOs is unavailable due to Microsoft having altered their website to prevent it.|" +
 473 | 	"PowerShell 3.0 or later is required to run this script.|Do you want to go online and download it?|" +
 474 | 	"This feature is not available on this platform."
 475 | [string[]]$English = $EnglishMessages.Split('|')
 476 | [string[]]$Localized = $null
 477 | if ($LocData -and !$LocData.StartsWith("en-US")) {
 478 | 	$Localized = $LocData.Split('|')
 479 | 	# Adjust the $Localized array if we have more or fewer strings than in $EnglishMessages
 480 | 	if ($Localized.Length -lt $English.Length) {
 481 | 		while ($Localized.Length -ne $English.Length) {
 482 | 			$Localized += $English[$Localized.Length]
 483 | 		}
 484 | 	} elseif ($Localized.Length -gt $English.Length) {
 485 | 		$Localized = $LocData.Split('|')[0..($English.Length - 1)]
 486 | 	}
 487 | 	$Locale = $Localized[0]
 488 | }
 489 | $QueryLocale = $Locale
 490 | 
 491 | # Convert a size in bytes to a human readable string
 492 | function Size-To-Human-Readable([uint64]$size)
 493 | {
 494 | 	$suffix = "bytes", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"
 495 | 	$i = 0
 496 | 	while ($size -gt 1kb) {
 497 | 		$size = $size / 1kb
 498 | 		$i++
 499 | 	}
 500 | 	"{0:N1} {1}" -f $size, $suffix[$i]
 501 | }
 502 | 
 503 | # Check if the locale we want is available - Fall back to en-US otherwise
 504 | function Check-Locale
 505 | {
 506 | 	try {
 507 | 		$url = "https://www.microsoft.com/" + $QueryLocale + "/software-download/"
 508 | 		if ($Verbosity -ge 2) {
 509 | 			Write-Host Querying $url
 510 | 		}
 511 | 		Invoke-WebRequest -UseBasicParsing -TimeoutSec $DefaultTimeout -MaximumRedirection 0 $url | Out-Null
 512 | 	} catch {
 513 | 		# Of course PowerShell 7 had to BREAK $_.Exception.Status on timeouts...
 514 | 		if ($_.Exception.Status -eq "Timeout" -or $_.Exception.GetType().Name -eq "TaskCanceledException") {
 515 | 			Write-Host Operation Timed out
 516 | 		}
 517 | 		$script:QueryLocale = "en-US"
 518 | 	}
 519 | }
 520 | 
 521 | function Get-Code-715-123130-Message
 522 | {
 523 | 	try {
 524 | 		$url = "https://www.microsoft.com/" + $QueryLocale + "/software-download/windows11"
 525 | 		if ($Verbosity -ge 2) {
 526 | 			Write-Host Querying $url
 527 | 		}
 528 | 		$r = Invoke-WebRequest -UseBasicParsing -TimeoutSec $DefaultTimeout -MaximumRedirection 0 $url
 529 | 		# Microsoft's handling of UTF-8 content is soooooooo *UTTERLY BROKEN*!!!
 530 | 		$r = [System.Text.Encoding]::UTF8.GetString($r.RawContentStream.ToArray())
 531 | 		# PowerShell 7 forces us to parse the HTML ourselves
 532 | 		$r = $r -replace "`n" -replace "`r"
 533 | 		$pattern = '.*<input id="msg-01" type="hidden" value="(.*?)"/>.*'
 534 | 		$msg = [regex]::Match($r, $pattern).Groups[1].Value
 535 | 		$msg = $msg -replace "&lt;", "<" -replace "<[^>]+>" -replace "\s+", " "
 536 | 		if (($msg -eq $null) -or !($msg -match "715-123130")) {
 537 | 			throw
 538 | 		}
 539 | 	} catch {
 540 | 		$msg  = "Your IP address has been banned by Microsoft for issuing too many ISO download requests or for "
 541 | 		$msg += "belonging to a region of the world where sanctions currently apply. Please try again later.`r`n"
 542 | 		$msg += "If you believe this ban to be in error, you can try contacting Microsoft by referring to "
 543 | 		$msg += "message code 715-123130 and session ID "
 544 | 	}
 545 | 	return $msg
 546 | }
 547 | 
 548 | # Return an array of releases (e.g. 20H2, 21H1, ...) for the selected Windows version
 549 | function Get-Windows-Releases([int]$SelectedVersion)
 550 | {
 551 | 	$i = 0
 552 | 	$releases = @()
 553 | 	foreach ($version in $WindowsVersions[$SelectedVersion]) {
 554 | 		if (($i -ne 0) -and ($version -is [array])) {
 555 | 			$releases += @(New-Object PsObject -Property @{ Release = $ltrm + $version[0].Replace(")", ")" + $ltrm); Index = $i })
 556 | 		}
 557 | 		$i++
 558 | 	}
 559 | 	return $releases
 560 | }
 561 | 
 562 | # Return an array of editions (e.g. Home, Pro, etc) for the selected Windows release
 563 | function Get-Windows-Editions([int]$SelectedVersion, [int]$SelectedRelease)
 564 | {
 565 | 	$editions = @()
 566 | 	foreach ($release in $WindowsVersions[$SelectedVersion][$SelectedRelease])
 567 | 	{
 568 | 		if ($release -is [array]) {
 569 | 			if (!($release[0].Contains("China")) -or ($Locale.StartsWith("zh"))) {
 570 | 				$editions += @(New-Object PsObject -Property @{ Edition = $release[0]; Id = $release[1] })
 571 | 			}
 572 | 		}
 573 | 	}
 574 | 	return $editions
 575 | }
 576 | 
 577 | # Return an array of languages for the selected edition
 578 | function Get-Windows-Languages([int]$SelectedVersion, [object]$SelectedEdition)
 579 | {
 580 | 	$langs = @()
 581 | 	if ($WindowsVersions[$SelectedVersion][0][1].StartsWith("UEFI_SHELL")) {
 582 | 		$langs += @(New-Object PsObject -Property @{ DisplayName = "English (US)"; Name = "en-us"; Data = @($null) })
 583 | 	} else {
 584 | 		$languages = [ordered]@{}
 585 | 		$SessionIndex = 0
 586 | 		foreach ($EditionId in $SelectedEdition) {
 587 | 			$SessionId[$SessionIndex] = [guid]::NewGuid()
 588 | 			# Microsoft download protection now requires the sessionId to be whitelisted through vlscppe.microsoft.com/tags
 589 | 			$url = "https://vlscppe.microsoft.com/tags"
 590 | 			$url += "?org_id=" + $OrgId
 591 | 			$url += "&session_id=" + $SessionId[$SessionIndex]
 592 | 			if ($Verbosity -ge 2) {
 593 | 				Write-Host Querying $url
 594 | 			}
 595 | 			try {
 596 | 				Invoke-WebRequest -UseBasicParsing -TimeoutSec $DefaultTimeout -MaximumRedirection 0 $url | Out-Null
 597 | 			} catch {
 598 | 				Error($_.Exception.Message)
 599 | 				return @()
 600 | 			}
 601 | 			$url = "https://www.microsoft.com/software-download-connector/api/getskuinformationbyproductedition"
 602 | 			$url += "?profile=" + $ProfileId
 603 | 			$url += "&productEditionId=" + $EditionId
 604 | 			$url += "&SKU=undefined"
 605 | 			$url += "&friendlyFileName=undefined"
 606 | 			$url += "&Locale=" + $QueryLocale
 607 | 			$url += "&sessionID=" + $SessionId[$SessionIndex]
 608 | 			if ($Verbosity -ge 2) {
 609 | 				Write-Host Querying $url
 610 | 			}
 611 | 			try {
 612 | 				$r = Invoke-RestMethod -UseBasicParsing -TimeoutSec $DefaultTimeout -SessionVariable "Session" $url
 613 | 				if ($r -eq $null) {
 614 | 					throw "Could not retrieve languages from server"
 615 | 				}
 616 | 				if ($Verbosity -ge 5) {
 617 | 					Write-Host "=============================================================================="
 618 | 					Write-Host ($r | ConvertTo-Json)
 619 | 					Write-Host "=============================================================================="
 620 | 				}
 621 | 				if ($r.Errors) {
 622 | 					throw $r.Errors[0].Value
 623 | 				}
 624 | 				foreach ($Sku in $r.Skus) {
 625 | 					if (!$languages.Contains($Sku.Language)) {
 626 | 						$languages[$Sku.Language] = @{ DisplayName = $Sku.LocalizedLanguage; Data = @() }
 627 | 					}
 628 | 					$languages[$Sku.Language].Data += @{ SessionIndex = $SessionIndex; SkuId = $Sku.Id }
 629 | 				}
 630 | 				if ($languages.Length -eq 0) {
 631 | 					throw "Could not parse languages"
 632 | 				}
 633 | 			} catch {
 634 | 				Error($_.Exception.Message)
 635 | 				return @()
 636 | 			}
 637 | 			$SessionIndex++
 638 | 		}
 639 | 		# Need to convert to an array since PowerShell treats them differently from hashtable
 640 | 		$i = 0
 641 | 		$script:SelectedIndex = 0
 642 | 		foreach($language in $languages.Keys) {
 643 | 			$langs += @(New-Object PsObject -Property @{ DisplayName = $languages[$language].DisplayName; Name = $language; Data = $languages[$language].Data })
 644 | 			if (Select-Language($language)) {
 645 | 				$script:SelectedIndex = $i
 646 | 			}
 647 | 			$i++
 648 | 		}
 649 | 	}
 650 | 	return $langs
 651 | }
 652 | 
 653 | # Return an array of download links for each supported arch
 654 | function Get-Windows-Download-Links([int]$SelectedVersion, [int]$SelectedRelease, [object]$SelectedEdition, [PSCustomObject]$SelectedLanguage)
 655 | {
 656 | 	$links = @()
 657 | 	if ($WindowsVersions[$SelectedVersion][0][1].StartsWith("UEFI_SHELL")) {
 658 | 		$tag = $WindowsVersions[$SelectedVersion][$SelectedRelease][0].Split(' ')[0]
 659 | 		$shell_version = $WindowsVersions[$SelectedVersion][0][1].Split(' ')[1]
 660 | 		$url = "https://github.com/pbatard/UEFI-Shell/releases/download/" + $tag
 661 | 		$link = $url + "/UEFI-Shell-" + $shell_version + "-" + $tag
 662 | 		if ($SelectedEdition -eq 0) {
 663 | 			$link += "-RELEASE.iso"
 664 | 		} else {
 665 | 			$link += "-DEBUG.iso"
 666 | 		}
 667 | 		try {
 668 | 			# Read the supported archs from the release URL
 669 | 			$url += "/Version.xml"
 670 | 			$xml = New-Object System.Xml.XmlDocument
 671 | 			if ($Verbosity -ge 2) {
 672 | 				Write-Host Querying $url
 673 | 			}
 674 | 			$xml.Load($url)
 675 | 			$sep = ""
 676 | 			$archs = ""
 677 | 			foreach($arch in $xml.release.supported_archs.arch) {
 678 | 				$archs += $sep + $arch
 679 | 				$sep = ", "
 680 | 			}
 681 | 			$links += @(New-Object PsObject -Property @{ Arch = $archs; Url = $link })
 682 | 		} catch {
 683 | 			Error($_.Exception.Message)
 684 | 			return @()
 685 | 		}
 686 | 	} else {
 687 | 		foreach ($Entry in $SelectedLanguage.Data) {
 688 | 			$url = "https://www.microsoft.com/software-download-connector/api/GetProductDownloadLinksBySku"
 689 | 			$url += "?profile=" + $ProfileId
 690 | 			$url += "&productEditionId=undefined"
 691 | 			$url += "&SKU=" + $Entry.SkuId
 692 | 			$url += "&friendlyFileName=undefined"
 693 | 			$url += "&Locale=" + $QueryLocale
 694 | 			$url += "&sessionID=" + $SessionId[$Entry.SessionIndex]
 695 | 			if ($Verbosity -ge 2) {
 696 | 				Write-Host Querying $url
 697 | 			}
 698 | 			try {
 699 | 				# Must add a referer for this request, else Microsoft's servers may deny it
 700 | 				$ref = "https://www.microsoft.com/software-download/windows11"
 701 | 				$r = Invoke-RestMethod -Headers @{ "Referer" = $ref } -UseBasicParsing -TimeoutSec $DefaultTimeout -SessionVariable "Session" $url
 702 | 				if ($r -eq $null) {
 703 | 					throw "Could not retrieve architectures from server"
 704 | 				}
 705 | 				if ($Verbosity -ge 5) {
 706 | 					Write-Host "=============================================================================="
 707 | 					Write-Host ($r | ConvertTo-Json)
 708 | 					Write-Host "=============================================================================="
 709 | 				}
 710 | 				if ($r.Errors) {
 711 | 					if ( $r.Errors[0].Type -eq 9) {
 712 | 						$msg = Get-Code-715-123130-Message
 713 | 						throw $msg + $SessionId[$Entry.SessionIndex] + "."
 714 | 					} else {
 715 | 						throw $r.Errors[0].Value
 716 | 					}
 717 | 				}
 718 | 				foreach ($ProductDownloadOption in $r.ProductDownloadOptions) {
 719 | 					$links += @(New-Object PsObject -Property @{ Arch = (Get-Arch-From-Type $ProductDownloadOption.DownloadType); Url = $ProductDownloadOption.Uri })
 720 | 				}
 721 | 				if ($links.Length -eq 0) {
 722 | 					throw "Could not retrieve ISO download links"
 723 | 				}
 724 | 			} catch {
 725 | 				Error($_.Exception.Message)
 726 | 				return @()
 727 | 			}
 728 | 			$SessionIndex++
 729 | 		}
 730 | 		$i = 0
 731 | 		$script:SelectedIndex = 0
 732 | 		foreach($link in $links) {
 733 | 			if ($link.Arch -eq $PlatformArch) {
 734 | 				$script:SelectedIndex = $i
 735 | 			}
 736 | 			$i++
 737 | 		}
 738 | 	}
 739 | 	return $links
 740 | }
 741 | 
 742 | # Process the download URL by either sending it through the pipe or by opening the browser
 743 | function Process-Download-Link([string]$Url)
 744 | {
 745 | 	try {
 746 | 		if ($PipeName -and !$Check.IsChecked) {
 747 | 			Send-Message -PipeName $PipeName -Message $Url
 748 | 		} else {
 749 | 			if ($Cmd) {
 750 | 				$pattern = '.*\/(.*\.iso).*'
 751 | 				$File = [regex]::Match($Url, $pattern).Groups[1].Value
 752 | 				# PowerShell implicit conversions are iffy, so we need to force them...
 753 | 				$str_size = (Invoke-WebRequest -UseBasicParsing -TimeoutSec $DefaultTimeout -Uri $Url -Method Head).Headers.'Content-Length'
 754 | 				$tmp_size = [uint64]::Parse($str_size)
 755 | 				$Size = Size-To-Human-Readable $tmp_size
 756 | 				Write-Host "Downloading '$File' ($Size)..."
 757 | 				Start-BitsTransfer -Source $Url -Destination $File
 758 | 			} else {
 759 | 				Write-Host Download Link: $Url
 760 | 				Start-Process -FilePath $Url
 761 | 			}
 762 | 		}
 763 | 	} catch {
 764 | 		Error($_.Exception.Message)
 765 | 		return 404
 766 | 	}
 767 | 	return 0
 768 | }
 769 | 
 770 | if ($Cmd) {
 771 | 	$winVersionId = $null
 772 | 	$winReleaseId = $null
 773 | 	$winEditionId = $null
 774 | 	$winLanguageId = $null
 775 | 	$winLanguageName = $null
 776 | 	$winLink = $null
 777 | 
 778 | 	# Windows 7 and non Windows platforms are too much of a liability
 779 | 	if ($winver -le 6.1) {
 780 | 		Error(Get-Translation("This feature is not available on this platform."))
 781 | 		exit 403
 782 | 	}
 783 | 
 784 | 	$i = 0
 785 | 	$Selected = ""
 786 | 	if ($Win -eq "List") {
 787 | 		Write-Host "Please select a Windows Version (-Win):"
 788 | 	}
 789 | 	foreach($version in $WindowsVersions) {
 790 | 		if ($Win -eq "List") {
 791 | 			Write-Host " -" $version[0][0]
 792 | 		} elseif ($version[0][0] -match $Win) {
 793 | 			$Selected += $version[0][0]
 794 | 			$winVersionId = $i
 795 | 			break;
 796 | 		}
 797 | 		$i++
 798 | 	}
 799 | 	if ($winVersionId -eq $null) {
 800 | 		if ($Win -ne "List") {
 801 | 			Write-Host "Invalid Windows version provided."
 802 | 			Write-Host "Use '-Win List' for a list of available Windows versions."
 803 | 		}
 804 | 		exit 1
 805 | 	}
 806 | 
 807 | 	# Windows Version selection
 808 | 	$releases = Get-Windows-Releases $winVersionId
 809 | 	if ($Rel -eq "List") {
 810 | 		Write-Host "Please select a Windows Release (-Rel) for ${Selected} (or use 'Latest' for most recent):"
 811 | 	}
 812 | 	foreach ($release in $releases) {
 813 | 		if ($Rel -eq "List") {
 814 | 			Write-Host " -" $release.Release
 815 | 		} elseif (!$Rel -or $release.Release.StartsWith($Rel) -or $Rel -eq "Latest") {
 816 | 			if (!$Rel -and $Verbosity -ge 1) {
 817 | 				Write-Host "No release specified (-Rel). Defaulting to '$($release.Release)'."
 818 | 			}
 819 | 			$Selected += " " + $release.Release
 820 | 			$winReleaseId = $release.Index
 821 | 			break;
 822 | 		}
 823 | 	}
 824 | 	if ($winReleaseId -eq $null) {
 825 | 		if ($Rel -ne "List") {
 826 | 			Write-Host "Invalid Windows release provided."
 827 | 			Write-Host "Use '-Rel List' for a list of available $Selected releases or '-Rel Latest' for latest."
 828 | 		}
 829 | 		exit 1
 830 | 	}
 831 | 
 832 | 	# Windows Release selection => Populate Product Edition
 833 | 	$editions = Get-Windows-Editions $winVersionId $winReleaseId
 834 | 	if ($Ed -eq "List") {
 835 | 		Write-Host "Please select a Windows Edition (-Ed) for ${Selected}:"
 836 | 	}
 837 | 	foreach($edition in $editions) {
 838 | 		if ($Ed -eq "List") {
 839 | 			Write-Host " -" $edition.Edition
 840 | 		} elseif (!$Ed -or $edition.Edition -match $Ed) {
 841 | 			if (!$Ed -and $Verbosity -ge 1) {
 842 | 				Write-Host "No edition specified (-Ed). Defaulting to '$($edition.Edition)'."
 843 | 			}
 844 | 			$Selected += "," + $edition.Edition -replace "Windows [0-9\.]*"
 845 | 			$winEditionId = $edition.Id
 846 | 			break;
 847 | 		}
 848 | 	}
 849 | 	if ($winEditionId -eq $null) {
 850 | 		if ($Ed -ne "List") {
 851 | 			Write-Host "Invalid Windows edition provided."
 852 | 			Write-Host "Use '-Ed List' for a list of available editions or remove the -Ed parameter to use default."
 853 | 		}
 854 | 		exit 1
 855 | 	}
 856 | 
 857 | 	# Product Edition selection => Request and populate Languages
 858 | 	$languages = Get-Windows-Languages $winVersionId $winEditionId
 859 | 	if (!$languages) {
 860 | 		exit 3
 861 | 	}
 862 | 	if ($Lang -eq "List") {
 863 | 		Write-Host "Please select a Language (-Lang) for ${Selected}:"
 864 | 	} elseif ($Lang) {
 865 | 		# Escape parentheses so that they aren't interpreted as regex
 866 | 		$Lang = $Lang.replace('(', '\(')
 867 | 		$Lang = $Lang.replace(')', '\)')
 868 | 	}
 869 | 	$i = 0
 870 | 	$winLanguage = $null
 871 | 	foreach ($language in $languages) {
 872 | 		if ($Lang -eq "List") {
 873 | 			Write-Host " -" $language.Name
 874 | 		} elseif ((!$Lang -and $script:SelectedIndex -eq $i) -or ($Lang -and $language.Name -match $Lang)) {
 875 | 			if (!$Lang -and $Verbosity -ge 1) {
 876 | 				Write-Host "No language specified (-Lang). Defaulting to '$($language.Name)'."
 877 | 			}
 878 | 			$Selected += ", " + $language.Name
 879 | 			$winLanguage = $language
 880 | 			break;
 881 | 		}
 882 | 		$i++
 883 | 	}
 884 | 	if ($winLanguage -eq $null) {
 885 | 		if ($Lang -ne "List") {
 886 | 			Write-Host "Invalid Windows language provided."
 887 | 			Write-Host "Use '-Lang List' for a list of available languages or remove the option to use system default."
 888 | 		}
 889 | 		exit 1
 890 | 	}
 891 | 
 892 | 	# Language selection => Request and populate Arch download links
 893 | 	$links = Get-Windows-Download-Links $winVersionId $winReleaseId $winEditionId $winLanguage
 894 | 	if (!$links) {
 895 | 		exit 3
 896 | 	}
 897 | 	if ($Arch -eq "List") {
 898 | 		Write-Host "Please select an Architecture (-Arch) for ${Selected}:"
 899 | 	}
 900 | 	$i = 0
 901 | 	foreach ($link in $links) {
 902 | 		if ($Arch -eq "List") {
 903 | 			Write-Host " -" $link.Arch
 904 | 		} elseif ((!$Arch -and $script:SelectedIndex -eq $i) -or ($Arch -and $link.Arch -match $Arch)) {
 905 | 			if (!$Arch -and $Verbosity -ge 1) {
 906 | 				Write-Host "No architecture specified (-Arch). Defaulting to '$($link.Arch)'."
 907 | 			}
 908 | 			$Selected += ", [" + $link.Arch + "]"
 909 | 			$winLink = $link
 910 | 			break;
 911 | 		}
 912 | 		$i++
 913 | 	}
 914 | 	if ($winLink -eq $null) {
 915 | 		if ($Arch -ne "List") {
 916 | 			Write-Host "Invalid Windows architecture provided."
 917 | 			Write-Host "Use '-Arch List' for a list of available architectures or remove the option to use system default."
 918 | 		}
 919 | 		exit 1
 920 | 	}
 921 | 
 922 | 	# Arch selection => Return selected download link
 923 | 	if ($GetUrl) {
 924 | 		return $winLink.Url
 925 | 		$ExitCode = 0
 926 | 	} else {
 927 | 		Write-Host "Selected: $Selected"
 928 | 		$ExitCode = Process-Download-Link $winLink.Url
 929 | 	}
 930 | 
 931 | 	# Clean up & exit
 932 | 	exit $ExitCode
 933 | }
 934 | 
 935 | # Form creation
 936 | $XMLForm = [Windows.Markup.XamlReader]::Load((New-Object System.Xml.XmlNodeReader $XAML))
 937 | $XAML.SelectNodes("//*[@Name]") | ForEach-Object { Set-Variable -Name ($_.Name) -Value $XMLForm.FindName($_.Name) -Scope Script }
 938 | $XMLForm.Title = $AppTitle
 939 | if ($Icon) {
 940 | 	$XMLForm.Icon = $Icon
 941 | } else {
 942 | 	$XMLForm.Icon = [WinAPI.Utils]::ExtractIcon("imageres.dll", -5205, $true) | ConvertTo-ImageSource
 943 | }
 944 | if ($Locale.StartsWith("ar") -or $Locale.StartsWith("fa") -or $Locale.StartsWith("he")) {
 945 | 	$XMLForm.FlowDirection = "RightToLeft"
 946 | }
 947 | $WindowsVersionTitle.Text = Get-Translation("Version")
 948 | $Continue.Content = Get-Translation("Continue")
 949 | $Back.Content = Get-Translation("Close")
 950 | 
 951 | # Windows 7 and non Windows platforms are too much of a liability
 952 | if ($winver -le 6.1) {
 953 | 	Error(Get-Translation("This feature is not available on this platform."))
 954 | 	exit 403
 955 | }
 956 | 
 957 | # Populate the Windows versions
 958 | $i = 0
 959 | $versions = @()
 960 | foreach($version in $WindowsVersions) {
 961 | 	$versions += @(New-Object PsObject -Property @{ Version = $version[0][0]; PageType = $version[0][1]; Index = $i })
 962 | 	$i++
 963 | }
 964 | $WindowsVersion.ItemsSource = $versions
 965 | $WindowsVersion.DisplayMemberPath = "Version"
 966 | 
 967 | # Button Action
 968 | $Continue.add_click({
 969 | 	$script:Stage++
 970 | 	$XMLGrid.Children[2 * $Stage + 1].IsEnabled = $false
 971 | 	$Continue.IsEnabled = $false
 972 | 	$Back.IsEnabled = $false
 973 | 	Refresh-Control($Continue)
 974 | 	Refresh-Control($Back)
 975 | 
 976 | 	switch ($Stage) {
 977 | 
 978 | 		1 { # Windows Version selection
 979 | 			$XMLForm.Title = Get-Translation($English[12])
 980 | 			Refresh-Control($XMLForm)
 981 | 			if ($WindowsVersion.SelectedValue.Version.StartsWith("Windows")) {
 982 | 				Check-Locale
 983 | 			}
 984 | 			$releases = Get-Windows-Releases $WindowsVersion.SelectedValue.Index
 985 | 			$script:WindowsRelease = Add-Entry $Stage "Release" $releases
 986 | 			$Back.Content = Get-Translation($English[8])
 987 | 			$XMLForm.Title = $AppTitle
 988 | 		}
 989 | 
 990 | 		2 { # Windows Release selection => Populate Product Edition
 991 | 			$editions = Get-Windows-Editions $WindowsVersion.SelectedValue.Index $WindowsRelease.SelectedValue.Index
 992 | 			$script:ProductEdition = Add-Entry $Stage "Edition" $editions
 993 | 		}
 994 | 
 995 | 		3 { # Product Edition selection => Request and populate languages
 996 | 			$XMLForm.Title = Get-Translation($English[12])
 997 | 			Refresh-Control($XMLForm)
 998 | 			$languages = Get-Windows-Languages $WindowsVersion.SelectedValue.Index $ProductEdition.SelectedValue.Id
 999 | 			if ($languages.Length -eq 0) {
1000 | 				break
1001 | 			}
1002 | 			$script:Language = Add-Entry $Stage "Language" $languages "DisplayName"
1003 | 			$Language.SelectedIndex = $script:SelectedIndex
1004 | 			$XMLForm.Title = $AppTitle
1005 | 		}
1006 | 
1007 | 		4 { # Language selection => Request and populate Arch download links
1008 | 			$XMLForm.Title = Get-Translation($English[12])
1009 | 			Refresh-Control($XMLForm)
1010 | 			$links = Get-Windows-Download-Links $WindowsVersion.SelectedValue.Index $WindowsRelease.SelectedValue.Index $ProductEdition.SelectedValue.Id $Language.SelectedValue
1011 | 			if ($links.Length -eq 0) {
1012 | 				break
1013 | 			}
1014 | 			$script:Architecture = Add-Entry $Stage "Architecture" $links "Arch"
1015 | 			if ($PipeName) {
1016 | 				$XMLForm.Height += $dh / 2;
1017 | 				$Margin = $Continue.Margin
1018 | 				$top = $Margin.Top
1019 | 				$Margin.Top += $dh /2
1020 | 				$Continue.Margin = $Margin
1021 | 				$Margin = $Back.Margin
1022 | 				$Margin.Top += $dh / 2
1023 | 				$Back.Margin = $Margin
1024 | 				$Margin = $Check.Margin
1025 | 				$Margin.Top = $top - 2
1026 | 				$Check.Margin = $Margin
1027 | 				$Check.Content = Get-Translation($English[13])
1028 | 				$Check.Visibility = "Visible"
1029 | 			}
1030 | 			$Architecture.SelectedIndex = $script:SelectedIndex
1031 | 			$Continue.Content = Get-Translation("Download")
1032 | 			$XMLForm.Title = $AppTitle
1033 | 		}
1034 | 
1035 | 		5 { # Arch selection => Return selected download link
1036 | 			$script:ExitCode = Process-Download-Link $Architecture.SelectedValue.Url
1037 | 			$XMLForm.Close()
1038 | 		}
1039 | 	}
1040 | 	$Continue.IsEnabled = $true
1041 | 	if ($Stage -ge 0) {
1042 | 		$Back.IsEnabled = $true
1043 | 	}
1044 | })
1045 | 
1046 | $Back.add_click({
1047 | 	if ($Stage -eq 0) {
1048 | 		$XMLForm.Close()
1049 | 	} else {
1050 | 		$XMLGrid.Children.RemoveAt(2 * $Stage + 3)
1051 | 		$XMLGrid.Children.RemoveAt(2 * $Stage + 2)
1052 | 		$XMLGrid.Children[2 * $Stage + 1].IsEnabled = $true
1053 | 		$dh2 = $dh
1054 | 		if ($Stage -eq 4 -and $PipeName) {
1055 | 			$Check.Visibility = "Collapsed"
1056 | 			$dh2 += $dh / 2
1057 | 		}
1058 | 		$XMLForm.Height -= $dh2;
1059 | 		$Margin = $Continue.Margin
1060 | 		$Margin.Top -= $dh2
1061 | 		$Continue.Margin = $Margin
1062 | 		$Margin = $Back.Margin
1063 | 		$Margin.Top -= $dh2
1064 | 		$Back.Margin = $Margin
1065 | 		$script:Stage = $Stage - 1
1066 | 		$XMLForm.Title = $AppTitle
1067 | 		if ($Stage -eq 0) {
1068 | 			$Back.Content = Get-Translation("Close")
1069 | 		} else {
1070 | 			$Continue.Content = Get-Translation("Continue")
1071 | 			Refresh-Control($Continue)
1072 | 		}
1073 | 	}
1074 | })
1075 | 
1076 | # Display the dialog
1077 | $XMLForm.Add_Loaded({$XMLForm.Activate()})
1078 | $XMLForm.ShowDialog() | Out-Null
1079 | 
1080 | # Clean up & exit
1081 | exit $ExitCode
1082 | 
1083 | # SIG # Begin signature block
1084 | # MIItPAYJKoZIhvcNAQcCoIItLTCCLSkCAQExDzANBglghkgBZQMEAgEFADB5Bgor
1085 | # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
1086 | # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBW4641oExc2Li+
1087 | # R8MjLng+Yc3oW9s9v92HpNoDMS9k3aCCEkAwggVvMIIEV6ADAgECAhBI/JO0YFWU
1088 | # jTanyYqJ1pQWMA0GCSqGSIb3DQEBDAUAMHsxCzAJBgNVBAYTAkdCMRswGQYDVQQI
1089 | # DBJHcmVhdGVyIE1hbmNoZXN0ZXIxEDAOBgNVBAcMB1NhbGZvcmQxGjAYBgNVBAoM
1090 | # EUNvbW9kbyBDQSBMaW1pdGVkMSEwHwYDVQQDDBhBQUEgQ2VydGlmaWNhdGUgU2Vy
1091 | # dmljZXMwHhcNMjEwNTI1MDAwMDAwWhcNMjgxMjMxMjM1OTU5WjBWMQswCQYDVQQG
1092 | # EwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMS0wKwYDVQQDEyRTZWN0aWdv
1093 | # IFB1YmxpYyBDb2RlIFNpZ25pbmcgUm9vdCBSNDYwggIiMA0GCSqGSIb3DQEBAQUA
1094 | # A4ICDwAwggIKAoICAQCN55QSIgQkdC7/FiMCkoq2rjaFrEfUI5ErPtx94jGgUW+s
1095 | # hJHjUoq14pbe0IdjJImK/+8Skzt9u7aKvb0Ffyeba2XTpQxpsbxJOZrxbW6q5KCD
1096 | # J9qaDStQ6Utbs7hkNqR+Sj2pcaths3OzPAsM79szV+W+NDfjlxtd/R8SPYIDdub7
1097 | # P2bSlDFp+m2zNKzBenjcklDyZMeqLQSrw2rq4C+np9xu1+j/2iGrQL+57g2extme
1098 | # me/G3h+pDHazJyCh1rr9gOcB0u/rgimVcI3/uxXP/tEPNqIuTzKQdEZrRzUTdwUz
1099 | # T2MuuC3hv2WnBGsY2HH6zAjybYmZELGt2z4s5KoYsMYHAXVn3m3pY2MeNn9pib6q
1100 | # RT5uWl+PoVvLnTCGMOgDs0DGDQ84zWeoU4j6uDBl+m/H5x2xg3RpPqzEaDux5mcz
1101 | # mrYI4IAFSEDu9oJkRqj1c7AGlfJsZZ+/VVscnFcax3hGfHCqlBuCF6yH6bbJDoEc
1102 | # QNYWFyn8XJwYK+pF9e+91WdPKF4F7pBMeufG9ND8+s0+MkYTIDaKBOq3qgdGnA2T
1103 | # OglmmVhcKaO5DKYwODzQRjY1fJy67sPV+Qp2+n4FG0DKkjXp1XrRtX8ArqmQqsV/
1104 | # AZwQsRb8zG4Y3G9i/qZQp7h7uJ0VP/4gDHXIIloTlRmQAOka1cKG8eOO7F/05QID
1105 | # AQABo4IBEjCCAQ4wHwYDVR0jBBgwFoAUoBEKIz6W8Qfs4q8p74Klf9AwpLQwHQYD
1106 | # VR0OBBYEFDLrkpr/NZZILyhAQnAgNpFcF4XmMA4GA1UdDwEB/wQEAwIBhjAPBgNV
1107 | # HRMBAf8EBTADAQH/MBMGA1UdJQQMMAoGCCsGAQUFBwMDMBsGA1UdIAQUMBIwBgYE
1108 | # VR0gADAIBgZngQwBBAEwQwYDVR0fBDwwOjA4oDagNIYyaHR0cDovL2NybC5jb21v
1109 | # ZG9jYS5jb20vQUFBQ2VydGlmaWNhdGVTZXJ2aWNlcy5jcmwwNAYIKwYBBQUHAQEE
1110 | # KDAmMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5jb21vZG9jYS5jb20wDQYJKoZI
1111 | # hvcNAQEMBQADggEBABK/oe+LdJqYRLhpRrWrJAoMpIpnuDqBv0WKfVIHqI0fTiGF
1112 | # OaNrXi0ghr8QuK55O1PNtPvYRL4G2VxjZ9RAFodEhnIq1jIV9RKDwvnhXRFAZ/ZC
1113 | # J3LFI+ICOBpMIOLbAffNRk8monxmwFE2tokCVMf8WPtsAO7+mKYulaEMUykfb9gZ
1114 | # pk+e96wJ6l2CxouvgKe9gUhShDHaMuwV5KZMPWw5c9QLhTkg4IUaaOGnSDip0TYl
1115 | # d8GNGRbFiExmfS9jzpjoad+sPKhdnckcW67Y8y90z7h+9teDnRGWYpquRRPaf9xH
1116 | # +9/DUp/mBlXpnYzyOmJRvOwkDynUWICE5EV7WtgwggYcMIIEBKADAgECAhAz1wio
1117 | # kUBTGeKlu9M5ua1uMA0GCSqGSIb3DQEBDAUAMFYxCzAJBgNVBAYTAkdCMRgwFgYD
1118 | # VQQKEw9TZWN0aWdvIExpbWl0ZWQxLTArBgNVBAMTJFNlY3RpZ28gUHVibGljIENv
1119 | # ZGUgU2lnbmluZyBSb290IFI0NjAeFw0yMTAzMjIwMDAwMDBaFw0zNjAzMjEyMzU5
1120 | # NTlaMFcxCzAJBgNVBAYTAkdCMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQxLjAs
1121 | # BgNVBAMTJVNlY3RpZ28gUHVibGljIENvZGUgU2lnbmluZyBDQSBFViBSMzYwggGi
1122 | # MA0GCSqGSIb3DQEBAQUAA4IBjwAwggGKAoIBgQC70f4et0JbePWQp64sg/GNIdMw
1123 | # hoV739PN2RZLrIXFuwHP4owoEXIEdiyBxasSekBKxRDogRQ5G19PB/YwMDB/NSXl
1124 | # wHM9QAmU6Kj46zkLVdW2DIseJ/jePiLBv+9l7nPuZd0o3bsffZsyf7eZVReqskmo
1125 | # PBBqOsMhspmoQ9c7gqgZYbU+alpduLyeE9AKnvVbj2k4aOqlH1vKI+4L7bzQHkND
1126 | # brBTjMJzKkQxbr6PuMYC9ruCBBV5DFIg6JgncWHvL+T4AvszWbX0w1Xn3/YIIq62
1127 | # 0QlZ7AGfc4m3Q0/V8tm9VlkJ3bcX9sR0gLqHRqwG29sEDdVOuu6MCTQZlRvmcBME
1128 | # Jd+PuNeEM4xspgzraLqVT3xE6NRpjSV5wyHxNXf4T7YSVZXQVugYAtXueciGoWnx
1129 | # G06UE2oHYvDQa5mll1CeHDOhHu5hiwVoHI717iaQg9b+cYWnmvINFD42tRKtd3V6
1130 | # zOdGNmqQU8vGlHHeBzoh+dYyZ+CcblSGoGSgg8sCAwEAAaOCAWMwggFfMB8GA1Ud
1131 | # IwQYMBaAFDLrkpr/NZZILyhAQnAgNpFcF4XmMB0GA1UdDgQWBBSBMpJBKyjNRsjE
1132 | # osYqORLsSKk/FDAOBgNVHQ8BAf8EBAMCAYYwEgYDVR0TAQH/BAgwBgEB/wIBADAT
1133 | # BgNVHSUEDDAKBggrBgEFBQcDAzAaBgNVHSAEEzARMAYGBFUdIAAwBwYFZ4EMAQMw
1134 | # SwYDVR0fBEQwQjBAoD6gPIY6aHR0cDovL2NybC5zZWN0aWdvLmNvbS9TZWN0aWdv
1135 | # UHVibGljQ29kZVNpZ25pbmdSb290UjQ2LmNybDB7BggrBgEFBQcBAQRvMG0wRgYI
1136 | # KwYBBQUHMAKGOmh0dHA6Ly9jcnQuc2VjdGlnby5jb20vU2VjdGlnb1B1YmxpY0Nv
1137 | # ZGVTaWduaW5nUm9vdFI0Ni5wN2MwIwYIKwYBBQUHMAGGF2h0dHA6Ly9vY3NwLnNl
1138 | # Y3RpZ28uY29tMA0GCSqGSIb3DQEBDAUAA4ICAQBfNqz7+fZyWhS38Asd3tj9lwHS
1139 | # /QHumS2G6Pa38Dn/1oFKWqdCSgotFZ3mlP3FaUqy10vxFhJM9r6QZmWLLXTUqwj3
1140 | # ahEDCHd8vmnhsNufJIkD1t5cpOCy1rTP4zjVuW3MJ9bOZBHoEHJ20/ng6SyJ6UnT
1141 | # s5eWBgrh9grIQZqRXYHYNneYyoBBl6j4kT9jn6rNVFRLgOr1F2bTlHH9nv1HMePp
1142 | # GoYd074g0j+xUl+yk72MlQmYco+VAfSYQ6VK+xQmqp02v3Kw/Ny9hA3s7TSoXpUr
1143 | # OBZjBXXZ9jEuFWvilLIq0nQ1tZiao/74Ky+2F0snbFrmuXZe2obdq2TWauqDGIgb
1144 | # MYL1iLOUJcAhLwhpAuNMu0wqETDrgXkG4UGVKtQg9guT5Hx2DJ0dJmtfhAH2KpnN
1145 | # r97H8OQYok6bLyoMZqaSdSa+2UA1E2+upjcaeuitHFFjBypWBmztfhj24+xkc6Zt
1146 | # CDaLrw+ZrnVrFyvCTWrDUUZBVumPwo3/E3Gb2u2e05+r5UWmEsUUWlJBl6MGAAjF
1147 | # 5hzqJ4I8O9vmRsTvLQA1E802fZ3lqicIBczOwDYOSxlP0GOabb/FKVMxItt1UHeG
1148 | # 0PL4au5rBhs+hSMrl8h+eplBDN1Yfw6owxI9OjWb4J0sjBeBVESoeh2YnZZ/WVim
1149 | # VGX/UUIL+Efrz/jlvzCCBqkwggURoAMCAQICEDfFCjwdoANxxw3HxiaQL+UwDQYJ
1150 | # KoZIhvcNAQELBQAwVzELMAkGA1UEBhMCR0IxGDAWBgNVBAoTD1NlY3RpZ28gTGlt
1151 | # aXRlZDEuMCwGA1UEAxMlU2VjdGlnbyBQdWJsaWMgQ29kZSBTaWduaW5nIENBIEVW
1152 | # IFIzNjAeFw0yNDA4MjgwMDAwMDBaFw0yNzA4MjgyMzU5NTlaMIGTMQ8wDQYDVQQF
1153 | # EwY0MDc5NTAxEzARBgsrBgEEAYI3PAIBAxMCSUUxGDAWBgNVBA8TD0J1c2luZXNz
1154 | # IEVudGl0eTELMAkGA1UEBhMCSUUxEDAOBgNVBAgMB0RvbmVnYWwxGDAWBgNVBAoM
1155 | # D0FrZW8gQ29uc3VsdGluZzEYMBYGA1UEAwwPQWtlbyBDb25zdWx0aW5nMIICIjAN
1156 | # BgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAqpN7vevPy6Ir46imPS9uMM86vroQ
1157 | # e9gcAMNYKW+RXzSJfi79vZOzABoVPZ72rSwODApd89w95Z5FqGjwhaIu04lCHt6H
1158 | # mOL+TR9xdo2WWFWXGh7yC5jmvMofk54A6h7klEd2u3f4aTjy9sVr1uUmjA9KA1o8
1159 | # HBgid5+HL57I9XprTRXGtTHAzHJyX1FEEGGKv9CtxEUaIr1/mIFpsNLZN2NfOoIu
1160 | # PPpxMypcXISDecJApvKxhqBte5SMhKa5zlI5omyizesQJZoRGjVfe83Ntb7kykFS
1161 | # Du1hmJMbtV0mM8yrhoUy+QAKp2ZhctkbPmWDNVLDK51GnfOgfmgaMQvm9RZQeh1N
1162 | # OT+fbUxHakG14kdARprNWJbBsJX5kLvzzTL4xbz+hPRT4jUkRZgQ9eDz1+a5Qa4Q
1163 | # FJtosRbwaJNuX9YQyrda1Jy2yJEVXanaRS8R0WM6wcYL47KMmxhz37HGr5zek9I+
1164 | # rfQ+/Qt+imZ/q1cYEuvx9owSVbpZAV1/g5z3AwH4ue+msMlY3bxwBfeEPHFnNdxh
1165 | # Dg7jlggohX79KL5e85FQs3iQpwXvGDlUjvS6KG+Rv3DokvZS9WSWB4REHmC/Cywu
1166 | # LQh3VF1Ezko3HMOG+nQptBNJ2Vk9JRq8mh317Tzv9dsoVWS6Vv1O2nyGbWZfjkn3
1167 | # ayT+S5SopUo/PcECAwEAAaOCAbIwggGuMB8GA1UdIwQYMBaAFIEykkErKM1GyMSi
1168 | # xio5EuxIqT8UMB0GA1UdDgQWBBRU0FFbeE+nxVuayZAwm7BZrYKDHzAOBgNVHQ8B
1169 | # Af8EBAMCB4AwDAYDVR0TAQH/BAIwADATBgNVHSUEDDAKBggrBgEFBQcDAzBJBgNV
1170 | # HSAEQjBAMDUGDCsGAQQBsjEBAgEGATAlMCMGCCsGAQUFBwIBFhdodHRwczovL3Nl
1171 | # Y3RpZ28uY29tL0NQUzAHBgVngQwBAzBLBgNVHR8ERDBCMECgPqA8hjpodHRwOi8v
1172 | # Y3JsLnNlY3RpZ28uY29tL1NlY3RpZ29QdWJsaWNDb2RlU2lnbmluZ0NBRVZSMzYu
1173 | # Y3JsMHsGCCsGAQUFBwEBBG8wbTBGBggrBgEFBQcwAoY6aHR0cDovL2NydC5zZWN0
1174 | # aWdvLmNvbS9TZWN0aWdvUHVibGljQ29kZVNpZ25pbmdDQUVWUjM2LmNydDAjBggr
1175 | # BgEFBQcwAYYXaHR0cDovL29jc3Auc2VjdGlnby5jb20wJAYDVR0RBB0wG6AZBggr
1176 | # BgEFBQcIA6ANMAsMCUlFLTQwNzk1MDANBgkqhkiG9w0BAQsFAAOCAYEAs2WyIJRC
1177 | # l+lgha7wuLYXCdbZbx4K02SyteLCXXRYuQ/+o7kX2P3BQuqNZXBQ4y+xbuOTqNOY
1178 | # R6VK7QrLvYaiMJky5qZY3lQfdsvuGkZmg1XvY1BPXre6B1/HkatGmnqtFUcBBeW4
1179 | # wtHOglq96eLHXzXCvS+1xO9wvv7GGB53i+7ePq7ROr717p/V1OUntl5y8nzxyhRI
1180 | # ucs6gBX0gbBQljLC16DwZ20NlNhYfi1SF7pSfnWZH/bojOPta3fCmIx7r8tjDu5m
1181 | # 4a6KRpYwLMYE9/ZBEBP7JpfiMt42q+QF6fyS8xauGiOGBOZW4ch7Wh+GBoe3JZUu
1182 | # UPC4wZDC9LeRKz/otodtloaTEnW9YE9gPmfRttMWaNsQTg6y5sc74qLoVY0RSqcW
1183 | # B2KScXAjuVHVkJJcOoPSuLoTjOhK3Ug4XbQmRypdteoizdTSnONGmW84RJyXquzi
1184 | # rIjw9CnLTggrZiYi9EZTo7URWNaARqLbSFpu0VMkdOBpWdXq5F6x6jslMYIaUjCC
1185 | # Gk4CAQEwazBXMQswCQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVk
1186 | # MS4wLAYDVQQDEyVTZWN0aWdvIFB1YmxpYyBDb2RlIFNpZ25pbmcgQ0EgRVYgUjM2
1187 | # AhA3xQo8HaADcccNx8YmkC/lMA0GCWCGSAFlAwQCAQUAoHwwEAYKKwYBBAGCNwIB
1188 | # DDECMAAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO
1189 | # MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIEQXpKnZ+mzHqQT6pR2XLo1J
1190 | # CTx/O5OYvM95ZSSvMip1MA0GCSqGSIb3DQEBAQUABIICAKDIHzxw40Hcx4XIYMgK
1191 | # 1pHGdXQq/pFmUUAfe/wdTM2oT77nSXdCzaGyu1fPke7mJ5a/wndpAd6xky1B/ZlX
1192 | # 3MqULIkOXAylzQmPWvyt1taN37GCvZgZegNx7GNSSTaiCA+VB8VUHsf1kihYyGhD
1193 | # X1/8MpJfhBp1CUQtNonicUQrDosdn1H/owJAq9h4rb/1y/I2hOTgIZnaVqgFTU35
1194 | # KBy4qzZzyS4MiHBg+FCEWm4AhyIzk66jUFDPzixvmtsgGzoBjkBKPCvgomk6bUun
1195 | # hwlHU3B3KjkC/wEOydJlx1rUFvZTfZ0f0ptkVp76HtNJR3ZFtqF9lvEIfvP4fZRm
1196 | # y6Zw7eT2XU8lCDKsQmQ82DJ0K7KJCwGwD1YJKMliAP47mYfHYBqMmJ4cLaHgrVB9
1197 | # EhIUNW/l/h1vyT9VqXnoiZqQlluhXCDn4mJBgwPasfOIOvCsU5wN8ZRfJgH/aWGr
1198 | # 1SasQhFSzzYbIzxXQ+PqVVqqf7cH0v50+9+3pdPWzNsSFwCWyeXf1T1OEtj+L3o5
1199 | # dqYDekFTZT8ZNX2npAmULY/3OHvx3nVVHNtL9YcMkar86EFQemFmICykD1O9BIf/
1200 | # 5MBIi8OdZMscikkn754Lee0lKf6j3BUa9DNKo56bd8DmVkENfVrBUsTcuYjntI/c
1201 | # 5cTqLbVHmjEw74iiN8K+KZQ3oYIXOjCCFzYGCisGAQQBgjcDAwExghcmMIIXIgYJ
1202 | # KoZIhvcNAQcCoIIXEzCCFw8CAQMxDzANBglghkgBZQMEAgEFADB4BgsqhkiG9w0B
1203 | # CRABBKBpBGcwZQIBAQYJYIZIAYb9bAcBMDEwDQYJYIZIAWUDBAIBBQAEIDuJjw0C
1204 | # /S4qlcbKUAofED0hE2uVhSUMkT9inqk0tvwnAhEA2KxVC3z0nr/9UDUnSx3iiBgP
1205 | # MjAyNDExMjQyMjI1MTNaoIITAzCCBrwwggSkoAMCAQICEAuuZrxaun+Vh8b56QTj
1206 | # MwQwDQYJKoZIhvcNAQELBQAwYzELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lD
1207 | # ZXJ0LCBJbmMuMTswOQYDVQQDEzJEaWdpQ2VydCBUcnVzdGVkIEc0IFJTQTQwOTYg
1208 | # U0hBMjU2IFRpbWVTdGFtcGluZyBDQTAeFw0yNDA5MjYwMDAwMDBaFw0zNTExMjUy
1209 | # MzU5NTlaMEIxCzAJBgNVBAYTAlVTMREwDwYDVQQKEwhEaWdpQ2VydDEgMB4GA1UE
1210 | # AxMXRGlnaUNlcnQgVGltZXN0YW1wIDIwMjQwggIiMA0GCSqGSIb3DQEBAQUAA4IC
1211 | # DwAwggIKAoICAQC+anOf9pUhq5Ywultt5lmjtej9kR8YxIg7apnjpcH9CjAgQxK+
1212 | # CMR0Rne/i+utMeV5bUlYYSuuM4vQngvQepVHVzNLO9RDnEXvPghCaft0djvKKO+h
1213 | # Du6ObS7rJcXa/UKvNminKQPTv/1+kBPgHGlP28mgmoCw/xi6FG9+Un1h4eN6zh92
1214 | # 6SxMe6We2r1Z6VFZj75MU/HNmtsgtFjKfITLutLWUdAoWle+jYZ49+wxGE1/UXjW
1215 | # fISDmHuI5e/6+NfQrxGFSKx+rDdNMsePW6FLrphfYtk/FLihp/feun0eV+pIF496
1216 | # OVh4R1TvjQYpAztJpVIfdNsEvxHofBf1BWkadc+Up0Th8EifkEEWdX4rA/FE1Q0r
1217 | # qViTbLVZIqi6viEk3RIySho1XyHLIAOJfXG5PEppc3XYeBH7xa6VTZ3rOHNeiYnY
1218 | # +V4j1XbJ+Z9dI8ZhqcaDHOoj5KGg4YuiYx3eYm33aebsyF6eD9MF5IDbPgjvwmnA
1219 | # alNEeJPvIeoGJXaeBQjIK13SlnzODdLtuThALhGtyconcVuPI8AaiCaiJnfdzUcb
1220 | # 3dWnqUnjXkRFwLtsVAxFvGqsxUA2Jq/WTjbnNjIUzIs3ITVC6VBKAOlb2u29Vwgf
1221 | # ta8b2ypi6n2PzP0nVepsFk8nlcuWfyZLzBaZ0MucEdeBiXL+nUOGhCjl+QIDAQAB
1222 | # o4IBizCCAYcwDgYDVR0PAQH/BAQDAgeAMAwGA1UdEwEB/wQCMAAwFgYDVR0lAQH/
1223 | # BAwwCgYIKwYBBQUHAwgwIAYDVR0gBBkwFzAIBgZngQwBBAIwCwYJYIZIAYb9bAcB
1224 | # MB8GA1UdIwQYMBaAFLoW2W1NhS9zKXaaL3WMaiCPnshvMB0GA1UdDgQWBBSfVywD
1225 | # dw4oFZBmpWNe7k+SH3agWzBaBgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsMy5k
1226 | # aWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkRzRSU0E0MDk2U0hBMjU2VGltZVN0
1227 | # YW1waW5nQ0EuY3JsMIGQBggrBgEFBQcBAQSBgzCBgDAkBggrBgEFBQcwAYYYaHR0
1228 | # cDovL29jc3AuZGlnaWNlcnQuY29tMFgGCCsGAQUFBzAChkxodHRwOi8vY2FjZXJ0
1229 | # cy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkRzRSU0E0MDk2U0hBMjU2VGlt
1230 | # ZVN0YW1waW5nQ0EuY3J0MA0GCSqGSIb3DQEBCwUAA4ICAQA9rR4fdplb4ziEEkfZ
1231 | # Q5H2EdubTggd0ShPz9Pce4FLJl6reNKLkZd5Y/vEIqFWKt4oKcKz7wZmXa5VgW9B
1232 | # 76k9NJxUl4JlKwyjUkKhk3aYx7D8vi2mpU1tKlY71AYXB8wTLrQeh83pXnWwwsxc
1233 | # 1Mt+FWqz57yFq6laICtKjPICYYf/qgxACHTvypGHrC8k1TqCeHk6u4I/VBQC9VK7
1234 | # iSpU5wlWjNlHlFFv/M93748YTeoXU/fFa9hWJQkuzG2+B7+bMDvmgF8VlJt1qQcl
1235 | # 7YFUMYgZU1WM6nyw23vT6QSgwX5Pq2m0xQ2V6FJHu8z4LXe/371k5QrN9FQBhLLI
1236 | # SZi2yemW0P8ZZfx4zvSWzVXpAb9k4Hpvpi6bUe8iK6WonUSV6yPlMwerwJZP/Gtb
1237 | # u3CKldMnn+LmmRTkTXpFIEB06nXZrDwhCGED+8RsWQSIXZpuG4WLFQOhtloDRWGo
1238 | # Cwwc6ZpPddOFkM2LlTbMcqFSzm4cd0boGhBq7vkqI1uHRz6Fq1IX7TaRQuR+0BGO
1239 | # zISkcqwXu7nMpFu3mgrlgbAW+BzikRVQ3K2YHcGkiKjA4gi4OA/kz1YCsdhIBHXq
1240 | # BzR0/Zd2QwQ/l4Gxftt/8wY3grcc/nS//TVkej9nmUYu83BDtccHHXKibMs/yXHh
1241 | # DXNkoPIdynhVAku7aRZOwqw6pDCCBq4wggSWoAMCAQICEAc2N7ckVHzYR6z9KGYq
1242 | # XlswDQYJKoZIhvcNAQELBQAwYjELMAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lD
1243 | # ZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTEhMB8GA1UEAxMYRGln
1244 | # aUNlcnQgVHJ1c3RlZCBSb290IEc0MB4XDTIyMDMyMzAwMDAwMFoXDTM3MDMyMjIz
1245 | # NTk1OVowYzELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMTsw
1246 | # OQYDVQQDEzJEaWdpQ2VydCBUcnVzdGVkIEc0IFJTQTQwOTYgU0hBMjU2IFRpbWVT
1247 | # dGFtcGluZyBDQTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMaGNQZJ
1248 | # s8E9cklRVcclA8TykTepl1Gh1tKD0Z5Mom2gsMyD+Vr2EaFEFUJfpIjzaPp985yJ
1249 | # C3+dH54PMx9QEwsmc5Zt+FeoAn39Q7SE2hHxc7Gz7iuAhIoiGN/r2j3EF3+rGSs+
1250 | # QtxnjupRPfDWVtTnKC3r07G1decfBmWNlCnT2exp39mQh0YAe9tEQYncfGpXevA3
1251 | # eZ9drMvohGS0UvJ2R/dhgxndX7RUCyFobjchu0CsX7LeSn3O9TkSZ+8OpWNs5KbF
1252 | # Hc02DVzV5huowWR0QKfAcsW6Th+xtVhNef7Xj3OTrCw54qVI1vCwMROpVymWJy71
1253 | # h6aPTnYVVSZwmCZ/oBpHIEPjQ2OAe3VuJyWQmDo4EbP29p7mO1vsgd4iFNmCKseS
1254 | # v6De4z6ic/rnH1pslPJSlRErWHRAKKtzQ87fSqEcazjFKfPKqpZzQmiftkaznTqj
1255 | # 1QPgv/CiPMpC3BhIfxQ0z9JMq++bPf4OuGQq+nUoJEHtQr8FnGZJUlD0UfM2SU2L
1256 | # INIsVzV5K6jzRWC8I41Y99xh3pP+OcD5sjClTNfpmEpYPtMDiP6zj9NeS3YSUZPJ
1257 | # jAw7W4oiqMEmCPkUEBIDfV8ju2TjY+Cm4T72wnSyPx4JduyrXUZ14mCjWAkBKAAO
1258 | # hFTuzuldyF4wEr1GnrXTdrnSDmuZDNIztM2xAgMBAAGjggFdMIIBWTASBgNVHRMB
1259 | # Af8ECDAGAQH/AgEAMB0GA1UdDgQWBBS6FtltTYUvcyl2mi91jGogj57IbzAfBgNV
1260 | # HSMEGDAWgBTs1+OC0nFdZEzfLmc/57qYrhwPTzAOBgNVHQ8BAf8EBAMCAYYwEwYD
1261 | # VR0lBAwwCgYIKwYBBQUHAwgwdwYIKwYBBQUHAQEEazBpMCQGCCsGAQUFBzABhhho
1262 | # dHRwOi8vb2NzcC5kaWdpY2VydC5jb20wQQYIKwYBBQUHMAKGNWh0dHA6Ly9jYWNl
1263 | # cnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFRydXN0ZWRSb290RzQuY3J0MEMGA1Ud
1264 | # HwQ8MDowOKA2oDSGMmh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFRy
1265 | # dXN0ZWRSb290RzQuY3JsMCAGA1UdIAQZMBcwCAYGZ4EMAQQCMAsGCWCGSAGG/WwH
1266 | # ATANBgkqhkiG9w0BAQsFAAOCAgEAfVmOwJO2b5ipRCIBfmbW2CFC4bAYLhBNE88w
1267 | # U86/GPvHUF3iSyn7cIoNqilp/GnBzx0H6T5gyNgL5Vxb122H+oQgJTQxZ822EpZv
1268 | # xFBMYh0MCIKoFr2pVs8Vc40BIiXOlWk/R3f7cnQU1/+rT4osequFzUNf7WC2qk+R
1269 | # Zp4snuCKrOX9jLxkJodskr2dfNBwCnzvqLx1T7pa96kQsl3p/yhUifDVinF2ZdrM
1270 | # 8HKjI/rAJ4JErpknG6skHibBt94q6/aesXmZgaNWhqsKRcnfxI2g55j7+6adcq/E
1271 | # x8HBanHZxhOACcS2n82HhyS7T6NJuXdmkfFynOlLAlKnN36TU6w7HQhJD5TNOXrd
1272 | # /yVjmScsPT9rp/Fmw0HNT7ZAmyEhQNC3EyTN3B14OuSereU0cZLXJmvkOHOrpgFP
1273 | # vT87eK1MrfvElXvtCl8zOYdBeHo46Zzh3SP9HSjTx/no8Zhf+yvYfvJGnXUsHics
1274 | # JttvFXseGYs2uJPU5vIXmVnKcPA3v5gA3yAWTyf7YGcWoWa63VXAOimGsJigK+2V
1275 | # Qbc61RWYMbRiCQ8KvYHZE/6/pNHzV9m8BPqC3jLfBInwAM1dwvnQI38AC+R2AibZ
1276 | # 8GV2QqYphwlHK+Z/GqSFD/yYlvZVVCsfgPrA8g4r5db7qS9EFUrnEw4d2zc4GqEr
1277 | # 9u3WfPwwggWNMIIEdaADAgECAhAOmxiO+dAt5+/bUOIIQBhaMA0GCSqGSIb3DQEB
1278 | # DAUAMGUxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNV
1279 | # BAsTEHd3dy5kaWdpY2VydC5jb20xJDAiBgNVBAMTG0RpZ2lDZXJ0IEFzc3VyZWQg
1280 | # SUQgUm9vdCBDQTAeFw0yMjA4MDEwMDAwMDBaFw0zMTExMDkyMzU5NTlaMGIxCzAJ
1281 | # BgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5k
1282 | # aWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lDZXJ0IFRydXN0ZWQgUm9vdCBHNDCC
1283 | # AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAL/mkHNo3rvkXUo8MCIwaTPs
1284 | # wqclLskhPfKK2FnC4SmnPVirdprNrnsbhA3EMB/zG6Q4FutWxpdtHauyefLKEdLk
1285 | # X9YFPFIPUh/GnhWlfr6fqVcWWVVyr2iTcMKyunWZanMylNEQRBAu34LzB4TmdDtt
1286 | # ceItDBvuINXJIB1jKS3O7F5OyJP4IWGbNOsFxl7sWxq868nPzaw0QF+xembud8hI
1287 | # qGZXV59UWI4MK7dPpzDZVu7Ke13jrclPXuU15zHL2pNe3I6PgNq2kZhAkHnDeMe2
1288 | # scS1ahg4AxCN2NQ3pC4FfYj1gj4QkXCrVYJBMtfbBHMqbpEBfCFM1LyuGwN1XXhm
1289 | # 2ToxRJozQL8I11pJpMLmqaBn3aQnvKFPObURWBf3JFxGj2T3wWmIdph2PVldQnaH
1290 | # iZdpekjw4KISG2aadMreSx7nDmOu5tTvkpI6nj3cAORFJYm2mkQZK37AlLTSYW3r
1291 | # M9nF30sEAMx9HJXDj/chsrIRt7t/8tWMcCxBYKqxYxhElRp2Yn72gLD76GSmM9GJ
1292 | # B+G9t+ZDpBi4pncB4Q+UDCEdslQpJYls5Q5SUUd0viastkF13nqsX40/ybzTQRES
1293 | # W+UQUOsxxcpyFiIJ33xMdT9j7CFfxCBRa2+xq4aLT8LWRV+dIPyhHsXAj6Kxfgom
1294 | # mfXkaS+YHS312amyHeUbAgMBAAGjggE6MIIBNjAPBgNVHRMBAf8EBTADAQH/MB0G
1295 | # A1UdDgQWBBTs1+OC0nFdZEzfLmc/57qYrhwPTzAfBgNVHSMEGDAWgBRF66Kv9JLL
1296 | # gjEtUYunpyGd823IDzAOBgNVHQ8BAf8EBAMCAYYweQYIKwYBBQUHAQEEbTBrMCQG
1297 | # CCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wQwYIKwYBBQUHMAKG
1298 | # N2h0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJv
1299 | # b3RDQS5jcnQwRQYDVR0fBD4wPDA6oDigNoY0aHR0cDovL2NybDMuZGlnaWNlcnQu
1300 | # Y29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENBLmNybDARBgNVHSAECjAIMAYGBFUd
1301 | # IAAwDQYJKoZIhvcNAQEMBQADggEBAHCgv0NcVec4X6CjdBs9thbX979XB72arKGH
1302 | # LOyFXqkauyL4hxppVCLtpIh3bb0aFPQTSnovLbc47/T/gLn4offyct4kvFIDyE7Q
1303 | # Kt76LVbP+fT3rDB6mouyXtTP0UNEm0Mh65ZyoUi0mcudT6cGAxN3J0TU53/oWajw
1304 | # vy8LpunyNDzs9wPHh6jSTEAZNUZqaVSwuKFWjuyk1T3osdz9HNj0d1pcVIxv76FQ
1305 | # Pfx2CWiEn2/K2yCNNWAcAgPLILCsWKAOQGPFmCLBsln1VWvPJ6tsds5vIy30fnFq
1306 | # I2si/xK4VC0nftg62fC2h5b9W9FcrBjDTZ9ztwGpn1eqXijiuZQxggN2MIIDcgIB
1307 | # ATB3MGMxCzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjE7MDkG
1308 | # A1UEAxMyRGlnaUNlcnQgVHJ1c3RlZCBHNCBSU0E0MDk2IFNIQTI1NiBUaW1lU3Rh
1309 | # bXBpbmcgQ0ECEAuuZrxaun+Vh8b56QTjMwQwDQYJYIZIAWUDBAIBBQCggdEwGgYJ
1310 | # KoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMBwGCSqGSIb3DQEJBTEPFw0yNDExMjQy
1311 | # MjI1MTNaMCsGCyqGSIb3DQEJEAIMMRwwGjAYMBYEFNvThe5i29I+e+T2cUhQhyTV
1312 | # hltFMC8GCSqGSIb3DQEJBDEiBCDo4CLpbNKqBx9KM0bBeErpQGYTusNqmfcls8we
1313 | # ULQC+jA3BgsqhkiG9w0BCRACLzEoMCYwJDAiBCB2dp+o8mMvH0MLOiMwrtZWdf7X
1314 | # c9sF1mW5BZOYQ4+a2zANBgkqhkiG9w0BAQEFAASCAgA+71TZvJSRS/R+RIBINFye
1315 | # 0NsNr4ODwMISXyNCaVmkkSx0ZrwysauyT4TjFfEHhEHTYdFi1+QHxfQjHmGI52GY
1316 | # HdTN50C/Icy9YSmRssFnqxcv1fjw57ORyqNY8U40KSaWEs/sWHab+rCd2fnlVeGY
1317 | # t+IyajmkYO98DECC+8JBHDpW/FG+k+avx/YRoHyjfXJFL4KPY/u3w+IdEf1YluM2
1318 | # eBKK1cC3PAZJZwp9JCzpura5nqoNblZVHm0umahLRmg7IQP1rBxHnYAHzywXxWzb
1319 | # 94ufKc+xrKdnsVrvd/Yb5Wmq/rf2XKFJs0i19c2LOhUoNm/u9JzMr9SCoqDTmm4b
1320 | # jV7Xmll458jxVHNXw9c3pvykePan6CnODMep9sP297uxvHbgrwugWqGihDs0BMu9
1321 | # nocghVhhhL5zQ4WyJS0hEaMv7EaZOArJAzZUjqXBohYuPjMcpZhvVojNepCKyRHQ
1322 | # YOT4KIQ1AKpMuHGSMyfezRCjaoKewg40Xnj2L6o9yPGW3TUg0LXih4efzSw9zlST
1323 | # Q/mxi0d+HQ+lwEHDCxPmbsRJbJMBjveAuce2sepT8DydpkhltMCImzRBJwSWoCzv
1324 | # pykblSwPL8j51/YfMleZIRkNojUyetKIVj346BWKcDLKFVN7rVcekQ40wfeNZGT4
1325 | # PBooDJtw2GKgsSkAX1niNw==
1326 | # SIG # End signature block
1327 | 


--------------------------------------------------------------------------------
/LICENSE.txt:
--------------------------------------------------------------------------------
  1 |                     GNU GENERAL PUBLIC LICENSE
  2 |                        Version 3, 29 June 2007
  3 | 
  4 |  Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
  5 |  Everyone is permitted to copy and distribute verbatim copies
  6 |  of this license document, but changing it is not allowed.
  7 | 
  8 |                             Preamble
  9 | 
 10 |   The GNU General Public License is a free, copyleft license for
 11 | software and other kinds of works.
 12 | 
 13 |   The licenses for most software and other practical works are designed
 14 | to take away your freedom to share and change the works.  By contrast,
 15 | the GNU General Public License is intended to guarantee your freedom to
 16 | share and change all versions of a program--to make sure it remains free
 17 | software for all its users.  We, the Free Software Foundation, use the
 18 | GNU General Public License for most of our software; it applies also to
 19 | any other work released this way by its authors.  You can apply it to
 20 | your programs, too.
 21 | 
 22 |   When we speak of free software, we are referring to freedom, not
 23 | price.  Our General Public Licenses are designed to make sure that you
 24 | have the freedom to distribute copies of free software (and charge for
 25 | them if you wish), that you receive source code or can get it if you
 26 | want it, that you can change the software or use pieces of it in new
 27 | free programs, and that you know you can do these things.
 28 | 
 29 |   To protect your rights, we need to prevent others from denying you
 30 | these rights or asking you to surrender the rights.  Therefore, you have
 31 | certain responsibilities if you distribute copies of the software, or if
 32 | you modify it: responsibilities to respect the freedom of others.
 33 | 
 34 |   For example, if you distribute copies of such a program, whether
 35 | gratis or for a fee, you must pass on to the recipients the same
 36 | freedoms that you received.  You must make sure that they, too, receive
 37 | or can get the source code.  And you must show them these terms so they
 38 | know their rights.
 39 | 
 40 |   Developers that use the GNU GPL protect your rights with two steps:
 41 | (1) assert copyright on the software, and (2) offer you this License
 42 | giving you legal permission to copy, distribute and/or modify it.
 43 | 
 44 |   For the developers' and authors' protection, the GPL clearly explains
 45 | that there is no warranty for this free software.  For both users' and
 46 | authors' sake, the GPL requires that modified versions be marked as
 47 | changed, so that their problems will not be attributed erroneously to
 48 | authors of previous versions.
 49 | 
 50 |   Some devices are designed to deny users access to install or run
 51 | modified versions of the software inside them, although the manufacturer
 52 | can do so.  This is fundamentally incompatible with the aim of
 53 | protecting users' freedom to change the software.  The systematic
 54 | pattern of such abuse occurs in the area of products for individuals to
 55 | use, which is precisely where it is most unacceptable.  Therefore, we
 56 | have designed this version of the GPL to prohibit the practice for those
 57 | products.  If such problems arise substantially in other domains, we
 58 | stand ready to extend this provision to those domains in future versions
 59 | of the GPL, as needed to protect the freedom of users.
 60 | 
 61 |   Finally, every program is threatened constantly by software patents.
 62 | States should not allow patents to restrict development and use of
 63 | software on general-purpose computers, but in those that do, we wish to
 64 | avoid the special danger that patents applied to a free program could
 65 | make it effectively proprietary.  To prevent this, the GPL assures that
 66 | patents cannot be used to render the program non-free.
 67 | 
 68 |   The precise terms and conditions for copying, distribution and
 69 | modification follow.
 70 | 
 71 |                        TERMS AND CONDITIONS
 72 | 
 73 |   0. Definitions.
 74 | 
 75 |   "This License" refers to version 3 of the GNU General Public License.
 76 | 
 77 |   "Copyright" also means copyright-like laws that apply to other kinds of
 78 | works, such as semiconductor masks.
 79 | 
 80 |   "The Program" refers to any copyrightable work licensed under this
 81 | License.  Each licensee is addressed as "you".  "Licensees" and
 82 | "recipients" may be individuals or organizations.
 83 | 
 84 |   To "modify" a work means to copy from or adapt all or part of the work
 85 | in a fashion requiring copyright permission, other than the making of an
 86 | exact copy.  The resulting work is called a "modified version" of the
 87 | earlier work or a work "based on" the earlier work.
 88 | 
 89 |   A "covered work" means either the unmodified Program or a work based
 90 | on the Program.
 91 | 
 92 |   To "propagate" a work means to do anything with it that, without
 93 | permission, would make you directly or secondarily liable for
 94 | infringement under applicable copyright law, except executing it on a
 95 | computer or modifying a private copy.  Propagation includes copying,
 96 | distribution (with or without modification), making available to the
 97 | public, and in some countries other activities as well.
 98 | 
 99 |   To "convey" a work means any kind of propagation that enables other
100 | parties to make or receive copies.  Mere interaction with a user through
101 | a computer network, with no transfer of a copy, is not conveying.
102 | 
103 |   An interactive user interface displays "Appropriate Legal Notices"
104 | to the extent that it includes a convenient and prominently visible
105 | feature that (1) displays an appropriate copyright notice, and (2)
106 | tells the user that there is no warranty for the work (except to the
107 | extent that warranties are provided), that licensees may convey the
108 | work under this License, and how to view a copy of this License.  If
109 | the interface presents a list of user commands or options, such as a
110 | menu, a prominent item in the list meets this criterion.
111 | 
112 |   1. Source Code.
113 | 
114 |   The "source code" for a work means the preferred form of the work
115 | for making modifications to it.  "Object code" means any non-source
116 | form of a work.
117 | 
118 |   A "Standard Interface" means an interface that either is an official
119 | standard defined by a recognized standards body, or, in the case of
120 | interfaces specified for a particular programming language, one that
121 | is widely used among developers working in that language.
122 | 
123 |   The "System Libraries" of an executable work include anything, other
124 | than the work as a whole, that (a) is included in the normal form of
125 | packaging a Major Component, but which is not part of that Major
126 | Component, and (b) serves only to enable use of the work with that
127 | Major Component, or to implement a Standard Interface for which an
128 | implementation is available to the public in source code form.  A
129 | "Major Component", in this context, means a major essential component
130 | (kernel, window system, and so on) of the specific operating system
131 | (if any) on which the executable work runs, or a compiler used to
132 | produce the work, or an object code interpreter used to run it.
133 | 
134 |   The "Corresponding Source" for a work in object code form means all
135 | the source code needed to generate, install, and (for an executable
136 | work) run the object code and to modify the work, including scripts to
137 | control those activities.  However, it does not include the work's
138 | System Libraries, or general-purpose tools or generally available free
139 | programs which are used unmodified in performing those activities but
140 | which are not part of the work.  For example, Corresponding Source
141 | includes interface definition files associated with source files for
142 | the work, and the source code for shared libraries and dynamically
143 | linked subprograms that the work is specifically designed to require,
144 | such as by intimate data communication or control flow between those
145 | subprograms and other parts of the work.
146 | 
147 |   The Corresponding Source need not include anything that users
148 | can regenerate automatically from other parts of the Corresponding
149 | Source.
150 | 
151 |   The Corresponding Source for a work in source code form is that
152 | same work.
153 | 
154 |   2. Basic Permissions.
155 | 
156 |   All rights granted under this License are granted for the term of
157 | copyright on the Program, and are irrevocable provided the stated
158 | conditions are met.  This License explicitly affirms your unlimited
159 | permission to run the unmodified Program.  The output from running a
160 | covered work is covered by this License only if the output, given its
161 | content, constitutes a covered work.  This License acknowledges your
162 | rights of fair use or other equivalent, as provided by copyright law.
163 | 
164 |   You may make, run and propagate covered works that you do not
165 | convey, without conditions so long as your license otherwise remains
166 | in force.  You may convey covered works to others for the sole purpose
167 | of having them make modifications exclusively for you, or provide you
168 | with facilities for running those works, provided that you comply with
169 | the terms of this License in conveying all material for which you do
170 | not control copyright.  Those thus making or running the covered works
171 | for you must do so exclusively on your behalf, under your direction
172 | and control, on terms that prohibit them from making any copies of
173 | your copyrighted material outside their relationship with you.
174 | 
175 |   Conveying under any other circumstances is permitted solely under
176 | the conditions stated below.  Sublicensing is not allowed; section 10
177 | makes it unnecessary.
178 | 
179 |   3. Protecting Users' Legal Rights From Anti-Circumvention Law.
180 | 
181 |   No covered work shall be deemed part of an effective technological
182 | measure under any applicable law fulfilling obligations under article
183 | 11 of the WIPO copyright treaty adopted on 20 December 1996, or
184 | similar laws prohibiting or restricting circumvention of such
185 | measures.
186 | 
187 |   When you convey a covered work, you waive any legal power to forbid
188 | circumvention of technological measures to the extent such circumvention
189 | is effected by exercising rights under this License with respect to
190 | the covered work, and you disclaim any intention to limit operation or
191 | modification of the work as a means of enforcing, against the work's
192 | users, your or third parties' legal rights to forbid circumvention of
193 | technological measures.
194 | 
195 |   4. Conveying Verbatim Copies.
196 | 
197 |   You may convey verbatim copies of the Program's source code as you
198 | receive it, in any medium, provided that you conspicuously and
199 | appropriately publish on each copy an appropriate copyright notice;
200 | keep intact all notices stating that this License and any
201 | non-permissive terms added in accord with section 7 apply to the code;
202 | keep intact all notices of the absence of any warranty; and give all
203 | recipients a copy of this License along with the Program.
204 | 
205 |   You may charge any price or no price for each copy that you convey,
206 | and you may offer support or warranty protection for a fee.
207 | 
208 |   5. Conveying Modified Source Versions.
209 | 
210 |   You may convey a work based on the Program, or the modifications to
211 | produce it from the Program, in the form of source code under the
212 | terms of section 4, provided that you also meet all of these conditions:
213 | 
214 |     a) The work must carry prominent notices stating that you modified
215 |     it, and giving a relevant date.
216 | 
217 |     b) The work must carry prominent notices stating that it is
218 |     released under this License and any conditions added under section
219 |     7.  This requirement modifies the requirement in section 4 to
220 |     "keep intact all notices".
221 | 
222 |     c) You must license the entire work, as a whole, under this
223 |     License to anyone who comes into possession of a copy.  This
224 |     License will therefore apply, along with any applicable section 7
225 |     additional terms, to the whole of the work, and all its parts,
226 |     regardless of how they are packaged.  This License gives no
227 |     permission to license the work in any other way, but it does not
228 |     invalidate such permission if you have separately received it.
229 | 
230 |     d) If the work has interactive user interfaces, each must display
231 |     Appropriate Legal Notices; however, if the Program has interactive
232 |     interfaces that do not display Appropriate Legal Notices, your
233 |     work need not make them do so.
234 | 
235 |   A compilation of a covered work with other separate and independent
236 | works, which are not by their nature extensions of the covered work,
237 | and which are not combined with it such as to form a larger program,
238 | in or on a volume of a storage or distribution medium, is called an
239 | "aggregate" if the compilation and its resulting copyright are not
240 | used to limit the access or legal rights of the compilation's users
241 | beyond what the individual works permit.  Inclusion of a covered work
242 | in an aggregate does not cause this License to apply to the other
243 | parts of the aggregate.
244 | 
245 |   6. Conveying Non-Source Forms.
246 | 
247 |   You may convey a covered work in object code form under the terms
248 | of sections 4 and 5, provided that you also convey the
249 | machine-readable Corresponding Source under the terms of this License,
250 | in one of these ways:
251 | 
252 |     a) Convey the object code in, or embodied in, a physical product
253 |     (including a physical distribution medium), accompanied by the
254 |     Corresponding Source fixed on a durable physical medium
255 |     customarily used for software interchange.
256 | 
257 |     b) Convey the object code in, or embodied in, a physical product
258 |     (including a physical distribution medium), accompanied by a
259 |     written offer, valid for at least three years and valid for as
260 |     long as you offer spare parts or customer support for that product
261 |     model, to give anyone who possesses the object code either (1) a
262 |     copy of the Corresponding Source for all the software in the
263 |     product that is covered by this License, on a durable physical
264 |     medium customarily used for software interchange, for a price no
265 |     more than your reasonable cost of physically performing this
266 |     conveying of source, or (2) access to copy the
267 |     Corresponding Source from a network server at no charge.
268 | 
269 |     c) Convey individual copies of the object code with a copy of the
270 |     written offer to provide the Corresponding Source.  This
271 |     alternative is allowed only occasionally and noncommercially, and
272 |     only if you received the object code with such an offer, in accord
273 |     with subsection 6b.
274 | 
275 |     d) Convey the object code by offering access from a designated
276 |     place (gratis or for a charge), and offer equivalent access to the
277 |     Corresponding Source in the same way through the same place at no
278 |     further charge.  You need not require recipients to copy the
279 |     Corresponding Source along with the object code.  If the place to
280 |     copy the object code is a network server, the Corresponding Source
281 |     may be on a different server (operated by you or a third party)
282 |     that supports equivalent copying facilities, provided you maintain
283 |     clear directions next to the object code saying where to find the
284 |     Corresponding Source.  Regardless of what server hosts the
285 |     Corresponding Source, you remain obligated to ensure that it is
286 |     available for as long as needed to satisfy these requirements.
287 | 
288 |     e) Convey the object code using peer-to-peer transmission, provided
289 |     you inform other peers where the object code and Corresponding
290 |     Source of the work are being offered to the general public at no
291 |     charge under subsection 6d.
292 | 
293 |   A separable portion of the object code, whose source code is excluded
294 | from the Corresponding Source as a System Library, need not be
295 | included in conveying the object code work.
296 | 
297 |   A "User Product" is either (1) a "consumer product", which means any
298 | tangible personal property which is normally used for personal, family,
299 | or household purposes, or (2) anything designed or sold for incorporation
300 | into a dwelling.  In determining whether a product is a consumer product,
301 | doubtful cases shall be resolved in favor of coverage.  For a particular
302 | product received by a particular user, "normally used" refers to a
303 | typical or common use of that class of product, regardless of the status
304 | of the particular user or of the way in which the particular user
305 | actually uses, or expects or is expected to use, the product.  A product
306 | is a consumer product regardless of whether the product has substantial
307 | commercial, industrial or non-consumer uses, unless such uses represent
308 | the only significant mode of use of the product.
309 | 
310 |   "Installation Information" for a User Product means any methods,
311 | procedures, authorization keys, or other information required to install
312 | and execute modified versions of a covered work in that User Product from
313 | a modified version of its Corresponding Source.  The information must
314 | suffice to ensure that the continued functioning of the modified object
315 | code is in no case prevented or interfered with solely because
316 | modification has been made.
317 | 
318 |   If you convey an object code work under this section in, or with, or
319 | specifically for use in, a User Product, and the conveying occurs as
320 | part of a transaction in which the right of possession and use of the
321 | User Product is transferred to the recipient in perpetuity or for a
322 | fixed term (regardless of how the transaction is characterized), the
323 | Corresponding Source conveyed under this section must be accompanied
324 | by the Installation Information.  But this requirement does not apply
325 | if neither you nor any third party retains the ability to install
326 | modified object code on the User Product (for example, the work has
327 | been installed in ROM).
328 | 
329 |   The requirement to provide Installation Information does not include a
330 | requirement to continue to provide support service, warranty, or updates
331 | for a work that has been modified or installed by the recipient, or for
332 | the User Product in which it has been modified or installed.  Access to a
333 | network may be denied when the modification itself materially and
334 | adversely affects the operation of the network or violates the rules and
335 | protocols for communication across the network.
336 | 
337 |   Corresponding Source conveyed, and Installation Information provided,
338 | in accord with this section must be in a format that is publicly
339 | documented (and with an implementation available to the public in
340 | source code form), and must require no special password or key for
341 | unpacking, reading or copying.
342 | 
343 |   7. Additional Terms.
344 | 
345 |   "Additional permissions" are terms that supplement the terms of this
346 | License by making exceptions from one or more of its conditions.
347 | Additional permissions that are applicable to the entire Program shall
348 | be treated as though they were included in this License, to the extent
349 | that they are valid under applicable law.  If additional permissions
350 | apply only to part of the Program, that part may be used separately
351 | under those permissions, but the entire Program remains governed by
352 | this License without regard to the additional permissions.
353 | 
354 |   When you convey a copy of a covered work, you may at your option
355 | remove any additional permissions from that copy, or from any part of
356 | it.  (Additional permissions may be written to require their own
357 | removal in certain cases when you modify the work.)  You may place
358 | additional permissions on material, added by you to a covered work,
359 | for which you have or can give appropriate copyright permission.
360 | 
361 |   Notwithstanding any other provision of this License, for material you
362 | add to a covered work, you may (if authorized by the copyright holders of
363 | that material) supplement the terms of this License with terms:
364 | 
365 |     a) Disclaiming warranty or limiting liability differently from the
366 |     terms of sections 15 and 16 of this License; or
367 | 
368 |     b) Requiring preservation of specified reasonable legal notices or
369 |     author attributions in that material or in the Appropriate Legal
370 |     Notices displayed by works containing it; or
371 | 
372 |     c) Prohibiting misrepresentation of the origin of that material, or
373 |     requiring that modified versions of such material be marked in
374 |     reasonable ways as different from the original version; or
375 | 
376 |     d) Limiting the use for publicity purposes of names of licensors or
377 |     authors of the material; or
378 | 
379 |     e) Declining to grant rights under trademark law for use of some
380 |     trade names, trademarks, or service marks; or
381 | 
382 |     f) Requiring indemnification of licensors and authors of that
383 |     material by anyone who conveys the material (or modified versions of
384 |     it) with contractual assumptions of liability to the recipient, for
385 |     any liability that these contractual assumptions directly impose on
386 |     those licensors and authors.
387 | 
388 |   All other non-permissive additional terms are considered "further
389 | restrictions" within the meaning of section 10.  If the Program as you
390 | received it, or any part of it, contains a notice stating that it is
391 | governed by this License along with a term that is a further
392 | restriction, you may remove that term.  If a license document contains
393 | a further restriction but permits relicensing or conveying under this
394 | License, you may add to a covered work material governed by the terms
395 | of that license document, provided that the further restriction does
396 | not survive such relicensing or conveying.
397 | 
398 |   If you add terms to a covered work in accord with this section, you
399 | must place, in the relevant source files, a statement of the
400 | additional terms that apply to those files, or a notice indicating
401 | where to find the applicable terms.
402 | 
403 |   Additional terms, permissive or non-permissive, may be stated in the
404 | form of a separately written license, or stated as exceptions;
405 | the above requirements apply either way.
406 | 
407 |   8. Termination.
408 | 
409 |   You may not propagate or modify a covered work except as expressly
410 | provided under this License.  Any attempt otherwise to propagate or
411 | modify it is void, and will automatically terminate your rights under
412 | this License (including any patent licenses granted under the third
413 | paragraph of section 11).
414 | 
415 |   However, if you cease all violation of this License, then your
416 | license from a particular copyright holder is reinstated (a)
417 | provisionally, unless and until the copyright holder explicitly and
418 | finally terminates your license, and (b) permanently, if the copyright
419 | holder fails to notify you of the violation by some reasonable means
420 | prior to 60 days after the cessation.
421 | 
422 |   Moreover, your license from a particular copyright holder is
423 | reinstated permanently if the copyright holder notifies you of the
424 | violation by some reasonable means, this is the first time you have
425 | received notice of violation of this License (for any work) from that
426 | copyright holder, and you cure the violation prior to 30 days after
427 | your receipt of the notice.
428 | 
429 |   Termination of your rights under this section does not terminate the
430 | licenses of parties who have received copies or rights from you under
431 | this License.  If your rights have been terminated and not permanently
432 | reinstated, you do not qualify to receive new licenses for the same
433 | material under section 10.
434 | 
435 |   9. Acceptance Not Required for Having Copies.
436 | 
437 |   You are not required to accept this License in order to receive or
438 | run a copy of the Program.  Ancillary propagation of a covered work
439 | occurring solely as a consequence of using peer-to-peer transmission
440 | to receive a copy likewise does not require acceptance.  However,
441 | nothing other than this License grants you permission to propagate or
442 | modify any covered work.  These actions infringe copyright if you do
443 | not accept this License.  Therefore, by modifying or propagating a
444 | covered work, you indicate your acceptance of this License to do so.
445 | 
446 |   10. Automatic Licensing of Downstream Recipients.
447 | 
448 |   Each time you convey a covered work, the recipient automatically
449 | receives a license from the original licensors, to run, modify and
450 | propagate that work, subject to this License.  You are not responsible
451 | for enforcing compliance by third parties with this License.
452 | 
453 |   An "entity transaction" is a transaction transferring control of an
454 | organization, or substantially all assets of one, or subdividing an
455 | organization, or merging organizations.  If propagation of a covered
456 | work results from an entity transaction, each party to that
457 | transaction who receives a copy of the work also receives whatever
458 | licenses to the work the party's predecessor in interest had or could
459 | give under the previous paragraph, plus a right to possession of the
460 | Corresponding Source of the work from the predecessor in interest, if
461 | the predecessor has it or can get it with reasonable efforts.
462 | 
463 |   You may not impose any further restrictions on the exercise of the
464 | rights granted or affirmed under this License.  For example, you may
465 | not impose a license fee, royalty, or other charge for exercise of
466 | rights granted under this License, and you may not initiate litigation
467 | (including a cross-claim or counterclaim in a lawsuit) alleging that
468 | any patent claim is infringed by making, using, selling, offering for
469 | sale, or importing the Program or any portion of it.
470 | 
471 |   11. Patents.
472 | 
473 |   A "contributor" is a copyright holder who authorizes use under this
474 | License of the Program or a work on which the Program is based.  The
475 | work thus licensed is called the contributor's "contributor version".
476 | 
477 |   A contributor's "essential patent claims" are all patent claims
478 | owned or controlled by the contributor, whether already acquired or
479 | hereafter acquired, that would be infringed by some manner, permitted
480 | by this License, of making, using, or selling its contributor version,
481 | but do not include claims that would be infringed only as a
482 | consequence of further modification of the contributor version.  For
483 | purposes of this definition, "control" includes the right to grant
484 | patent sublicenses in a manner consistent with the requirements of
485 | this License.
486 | 
487 |   Each contributor grants you a non-exclusive, worldwide, royalty-free
488 | patent license under the contributor's essential patent claims, to
489 | make, use, sell, offer for sale, import and otherwise run, modify and
490 | propagate the contents of its contributor version.
491 | 
492 |   In the following three paragraphs, a "patent license" is any express
493 | agreement or commitment, however denominated, not to enforce a patent
494 | (such as an express permission to practice a patent or covenant not to
495 | sue for patent infringement).  To "grant" such a patent license to a
496 | party means to make such an agreement or commitment not to enforce a
497 | patent against the party.
498 | 
499 |   If you convey a covered work, knowingly relying on a patent license,
500 | and the Corresponding Source of the work is not available for anyone
501 | to copy, free of charge and under the terms of this License, through a
502 | publicly available network server or other readily accessible means,
503 | then you must either (1) cause the Corresponding Source to be so
504 | available, or (2) arrange to deprive yourself of the benefit of the
505 | patent license for this particular work, or (3) arrange, in a manner
506 | consistent with the requirements of this License, to extend the patent
507 | license to downstream recipients.  "Knowingly relying" means you have
508 | actual knowledge that, but for the patent license, your conveying the
509 | covered work in a country, or your recipient's use of the covered work
510 | in a country, would infringe one or more identifiable patents in that
511 | country that you have reason to believe are valid.
512 | 
513 |   If, pursuant to or in connection with a single transaction or
514 | arrangement, you convey, or propagate by procuring conveyance of, a
515 | covered work, and grant a patent license to some of the parties
516 | receiving the covered work authorizing them to use, propagate, modify
517 | or convey a specific copy of the covered work, then the patent license
518 | you grant is automatically extended to all recipients of the covered
519 | work and works based on it.
520 | 
521 |   A patent license is "discriminatory" if it does not include within
522 | the scope of its coverage, prohibits the exercise of, or is
523 | conditioned on the non-exercise of one or more of the rights that are
524 | specifically granted under this License.  You may not convey a covered
525 | work if you are a party to an arrangement with a third party that is
526 | in the business of distributing software, under which you make payment
527 | to the third party based on the extent of your activity of conveying
528 | the work, and under which the third party grants, to any of the
529 | parties who would receive the covered work from you, a discriminatory
530 | patent license (a) in connection with copies of the covered work
531 | conveyed by you (or copies made from those copies), or (b) primarily
532 | for and in connection with specific products or compilations that
533 | contain the covered work, unless you entered into that arrangement,
534 | or that patent license was granted, prior to 28 March 2007.
535 | 
536 |   Nothing in this License shall be construed as excluding or limiting
537 | any implied license or other defenses to infringement that may
538 | otherwise be available to you under applicable patent law.
539 | 
540 |   12. No Surrender of Others' Freedom.
541 | 
542 |   If conditions are imposed on you (whether by court order, agreement or
543 | otherwise) that contradict the conditions of this License, they do not
544 | excuse you from the conditions of this License.  If you cannot convey a
545 | covered work so as to satisfy simultaneously your obligations under this
546 | License and any other pertinent obligations, then as a consequence you may
547 | not convey it at all.  For example, if you agree to terms that obligate you
548 | to collect a royalty for further conveying from those to whom you convey
549 | the Program, the only way you could satisfy both those terms and this
550 | License would be to refrain entirely from conveying the Program.
551 | 
552 |   13. Use with the GNU Affero General Public License.
553 | 
554 |   Notwithstanding any other provision of this License, you have
555 | permission to link or combine any covered work with a work licensed
556 | under version 3 of the GNU Affero General Public License into a single
557 | combined work, and to convey the resulting work.  The terms of this
558 | License will continue to apply to the part which is the covered work,
559 | but the special requirements of the GNU Affero General Public License,
560 | section 13, concerning interaction through a network will apply to the
561 | combination as such.
562 | 
563 |   14. Revised Versions of this License.
564 | 
565 |   The Free Software Foundation may publish revised and/or new versions of
566 | the GNU General Public License from time to time.  Such new versions will
567 | be similar in spirit to the present version, but may differ in detail to
568 | address new problems or concerns.
569 | 
570 |   Each version is given a distinguishing version number.  If the
571 | Program specifies that a certain numbered version of the GNU General
572 | Public License "or any later version" applies to it, you have the
573 | option of following the terms and conditions either of that numbered
574 | version or of any later version published by the Free Software
575 | Foundation.  If the Program does not specify a version number of the
576 | GNU General Public License, you may choose any version ever published
577 | by the Free Software Foundation.
578 | 
579 |   If the Program specifies that a proxy can decide which future
580 | versions of the GNU General Public License can be used, that proxy's
581 | public statement of acceptance of a version permanently authorizes you
582 | to choose that version for the Program.
583 | 
584 |   Later license versions may give you additional or different
585 | permissions.  However, no additional obligations are imposed on any
586 | author or copyright holder as a result of your choosing to follow a
587 | later version.
588 | 
589 |   15. Disclaimer of Warranty.
590 | 
591 |   THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
592 | APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
593 | HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
594 | OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
595 | THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
596 | PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
597 | IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
598 | ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
599 | 
600 |   16. Limitation of Liability.
601 | 
602 |   IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
603 | WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
604 | THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
605 | GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
606 | USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
607 | DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
608 | PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
609 | EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
610 | SUCH DAMAGES.
611 | 
612 |   17. Interpretation of Sections 15 and 16.
613 | 
614 |   If the disclaimer of warranty and limitation of liability provided
615 | above cannot be given local legal effect according to their terms,
616 | reviewing courts shall apply local law that most closely approximates
617 | an absolute waiver of all civil liability in connection with the
618 | Program, unless a warranty or assumption of liability accompanies a
619 | copy of the Program in return for a fee.
620 | 
621 |                      END OF TERMS AND CONDITIONS
622 | 
623 |             How to Apply These Terms to Your New Programs
624 | 
625 |   If you develop a new program, and you want it to be of the greatest
626 | possible use to the public, the best way to achieve this is to make it
627 | free software which everyone can redistribute and change under these terms.
628 | 
629 |   To do so, attach the following notices to the program.  It is safest
630 | to attach them to the start of each source file to most effectively
631 | state the exclusion of warranty; and each file should have at least
632 | the "copyright" line and a pointer to where the full notice is found.
633 | 
634 |     <one line to give the program's name and a brief idea of what it does.>
635 |     Copyright (C) <year>  <name of author>
636 | 
637 |     This program is free software: you can redistribute it and/or modify
638 |     it under the terms of the GNU General Public License as published by
639 |     the Free Software Foundation, either version 3 of the License, or
640 |     (at your option) any later version.
641 | 
642 |     This program is distributed in the hope that it will be useful,
643 |     but WITHOUT ANY WARRANTY; without even the implied warranty of
644 |     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
645 |     GNU General Public License for more details.
646 | 
647 |     You should have received a copy of the GNU General Public License
648 |     along with this program.  If not, see <http://www.gnu.org/licenses/>.
649 | 
650 | Also add information on how to contact you by electronic and paper mail.
651 | 
652 |   If the program does terminal interaction, make it output a short
653 | notice like this when it starts in an interactive mode:
654 | 
655 |     <program>  Copyright (C) <year>  <name of author>
656 |     This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
657 |     This is free software, and you are welcome to redistribute it
658 |     under certain conditions; type `show c' for details.
659 | 
660 | The hypothetical commands `show w' and `show c' should show the appropriate
661 | parts of the General Public License.  Of course, your program's commands
662 | might be different; for a GUI interface, you would use an "about box".
663 | 
664 |   You should also get your employer (if you work as a programmer) or school,
665 | if any, to sign a "copyright disclaimer" for the program, if necessary.
666 | For more information on this, and how to apply and follow the GNU GPL, see
667 | <http://www.gnu.org/licenses/>.
668 | 
669 |   The GNU General Public License does not permit incorporating your program
670 | into proprietary programs.  If your program is a subroutine library, you
671 | may consider it more useful to permit linking proprietary applications with
672 | the library.  If this is what you want to do, use the GNU Lesser General
673 | Public License instead of this License.  But first, please read
674 | <http://www.gnu.org/philosophy/why-not-lgpl.html>.
675 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | Fido: A PowerShell script to download Windows and UEFI Shell ISOs
  2 | =================================================================
  3 | 
  4 | [![Licence](https://img.shields.io/badge/license-GPLv3-blue.svg?style=flat-square)](https://www.gnu.org/licenses/gpl-3.0.en.html)
  5 | [![Github stats](https://img.shields.io/github/downloads/pbatard/Fido/total.svg?style=flat-square)](https://github.com/pbatard/Fido/releases)
  6 | 
  7 | Description
  8 | -----------
  9 | 
 10 | Fido is a PowerShell script that is primarily designed to be used in [Rufus](https://github.com/pbatard/rufus), but that
 11 | can also be used in standalone fashion, and whose purpose is to automate access to the official Microsoft Windows retail
 12 | ISO download links as well as provide convenient access to [bootable UEFI Shell images](https://github.com/pbatard/UEFI-Shell).
 13 | 
 14 | This script exists because, while Microsoft does make retail ISO download links freely and publicly available (at least
 15 | for Windows 8 through Windows 11), up until recent releases, most of these links were only available after forcing users
 16 | to jump through a lot of unwarranted hoops that created an exceedingly counterproductive, if not downright unfriendly,
 17 | consumer experience, that greatly detracted from what people really want (direct access to ISO downloads).
 18 | 
 19 | As to the reason one might want to download Windows __retail__ ISOs, as opposed to the ISOs that are generated by
 20 | Microsoft's own Media Creation Tool (MCT), this is because using official retail ISOs is currently the only way to
 21 | assert with absolute certainty that the OS content has not been altered. Indeed, because there only exists a single
 22 | master for each of them, Microsoft retail ISOs are the only ones you can obtain an official SHA-1 for (from MSDN, if you
 23 | have access to it, or from sites [such as this one](https://msdn.rg-adguard.net/public.php)) allowing you to be 100%
 24 | sure that the image you are using has not been corrupted and is safe to use.
 25 | 
 26 | This, in turn, offers assurance that the content __YOU__ are using to install your OS, which it is indeed critical to
 27 | validate beforehand if you have the slightest concern about security, does match, bit for bit, the one that Microsoft
 28 | released.
 29 | 
 30 | On the other hand, regardless of the manner in which Microsoft's Media Creation Tool produces its content, because no
 31 | two MCT ISOs are ever the same (due to MCT always regenerating the ISO content on the fly) it is currently impossible to
 32 | validate with absolute certainty whether any ISO that was generated by the MCT is safe to use. Especially, unlike what
 33 | is the case for retail ISOs, it is impossible to tell whether an MCT ISO may have been corrupted after generation.
 34 | 
 35 | Hence the need to provide users with a much easier and less restrictive way to access official retail ISOs...
 36 | 
 37 | License
 38 | -------
 39 | 
 40 | [GNU General Public License version 3.0](https://www.gnu.org/licenses/gpl-3.0) or later.
 41 | 
 42 | How it works
 43 | ------------
 44 | 
 45 | The script basically performs the same operation as one might perform when visiting the following URL (that is, in the
 46 | case of Windows 10, provided that you have also changed your `User-Agent` browser string, since, the Microsoft web
 47 | servers detect that you are using a version of Windows that is the same as the one you are trying to download, they
 48 | may redirect you __away__ from the page that allows you to obtain a direct ISO download link):
 49 | 
 50 | https://www.microsoft.com/en-us/software-download
 51 | 
 52 | After checking basic access to the Microsoft software downloads website the script first queries the web API from the
 53 | Microsoft servers, to request the language selection available for the version of Windows selected, and then requests
 54 | the actual download links, for all the architectures available for that language + version.
 55 | 
 56 | Requirements
 57 | ------------
 58 | 
 59 | Windows 8 or later with PowerShell. Windows 7 is __not__ supported.
 60 | 
 61 | Commandline mode
 62 | ----------------
 63 | 
 64 | Fido supports commandline mode whereas, whenever one of the following options is provided, a GUI is not instantiated
 65 | and you can instead generate the ISO download from within a PowerShell console or script.
 66 | 
 67 | Note however that, as of 2023.05, Microsoft has removed access to older releases of Windows ISOs and as a result, the
 68 | list of releases that can be downloaded from Fido has had to be reduced to only the latest for each version.
 69 | 
 70 | The options are:
 71 | - `Win`: Specify Windows version (e.g. _"Windows 10"_). Abbreviated version should work as well (e.g `-Win 10`) as long
 72 |    as it is unique enough. If this option isn't specified, the most recent version of Windows is automatically selected.
 73 |    You can obtain a list of supported versions by specifying `-Win List`.
 74 | - `Rel`: Specify Windows release (e.g. _"21H1"_). If this option isn't specified, the most recent release for the chosen
 75 |    version of Windows is automatically selected. You can also use `-Rel Latest` to force the most recent to be used.
 76 |    You can obtain a list of supported versions by specifying `-Rel List`.
 77 | - `Ed`: Specify Windows edition (e.g. _"Pro/Home"_). Abbreviated editions should work as well (e.g `-Ed Pro`) as long
 78 |    as it is unique enough. If this option isn't specified, the most recent version of Windows is automatically selected.
 79 |    You can obtain a list of supported versions by specifying `-Ed List`.
 80 | - `Lang`: Specify Windows language (e.g. _"Arabic"_). Abbreviated or part of a language (e.g. `-Lang Int` for
 81 |    `English International`) should work as long as it's unique enough. If this option isn't specified, the script attempts
 82 |    to select the same language as the system locale.
 83 |    You can obtain a list of supported languages by specifying `-Lang List`.
 84 | - `Arch`: Specify Windows architecture (e.g. _"x64"_). If this option isn't specified, the script attempts to use the same
 85 |    architecture as the one from the current system.
 86 | - `GetUrl`: By default, the script attempts to automatically launch the download. But when using the `-GetUrl` switch,
 87 |    the script only displays the download URL, which can then be piped into another command or into a file.
 88 | 
 89 | Examples of a commandline download:
 90 | 
 91 | ```
 92 | PS C:\Projects\Fido> .\Fido.ps1 -Win 10
 93 | No release specified (-Rel). Defaulting to '21H1 (Build 19043.985 - 2021.05)'.
 94 | No edition specified (-Ed). Defaulting to 'Windows 10 Home/Pro'.
 95 | No language specified (-Lang). Defaulting to 'English International'.
 96 | No architecture specified (-Arch). Defaulting to 'x64'.
 97 | Selected: Windows 10 21H1 (Build 19043.985 - 2021.05), Home/Pro, English International, x64
 98 | Downloading 'Win10_21H1_EnglishInternational_x64.iso' (5.0 GB)...
 99 | PS C:\Projects\Fido> .\Fido.ps1 -Win 10 -Rel List
100 | Please select a Windows Release (-Rel) for Windows 10 (or use 'Latest' for most recent):
101 |  - 21H1 (Build 19043.985 - 2021.05)
102 |  - 20H2 (Build 19042.631 - 2020.12)
103 |  - 20H2 (Build 19042.508 - 2020.10)
104 |  - 20H1 (Build 19041.264 - 2020.05)
105 |  - 19H2 (Build 18363.418 - 2019.11)
106 |  - 19H1 (Build 18362.356 - 2019.09)
107 |  - 19H1 (Build 18362.30 - 2019.05)
108 |  - 1809 R2 (Build 17763.107 - 2018.10)
109 |  - 1809 R1 (Build 17763.1 - 2018.09)
110 |  - 1803 (Build 17134.1 - 2018.04)
111 |  - 1709 (Build 16299.15 - 2017.09)
112 |  - 1703 [Redstone 2] (Build 15063.0 - 2017.03)
113 |  - 1607 [Redstone 1] (Build 14393.0 - 2016.07)
114 |  - 1511 R3 [Threshold 2] (Build 10586.164 - 2016.04)
115 |  - 1511 R2 [Threshold 2] (Build 10586.104 - 2016.02)
116 |  - 1511 R1 [Threshold 2] (Build 10586.0 - 2015.11)
117 |  - 1507 [Threshold 1] (Build 10240.16384 - 2015.07)
118 | PS C:\Projects\Fido> .\Fido.ps1 -Win 10 -Rel 20H2 -Ed Edu -Lang Fre -Arch x86 -GetUrl
119 | https://software-download.microsoft.com/db/Win10_Edu_20H2_v2_French_x32.iso?t=c48b32d3-4cf3-46f3-a8ad-6dd9568ff4eb&e=1629113408&h=659cdd60399584c5dc1d267957924fbd
120 | ```
121 | 
122 | Additional Notes
123 | ----------------
124 | 
125 | Because of its intended usage with Rufus, this script is not designed to cover every possible retail ISO downloads.
126 | Instead we mostly chose the ones that the general public is likely to request. For instance, we currently have no plan
127 | to add support for LTSB/LTSC Windows ISOs downloads.
128 | 
129 | If you are interested in such downloads, then you are kindly invited to visit the relevant download pages from Microsoft
130 | such as [this one](https://www.microsoft.com/evalcenter/evaluate-windows-10-enterprise) for LTSC versions.
131 | 


--------------------------------------------------------------------------------