v1.0.39

- MAJOR UPDATE:
	- Added a native system to load Dark or Light modes and randomize wallpapers. Though `.theme` files can still be used, see config file
    - Renamed the script at.ps1 for consistency with my other short-named projects.
    - Added a wrapper script (`AutoTheme.ps1`) for compatibility with older tasks and existing shortcuts.
	- Fixed a problem with the script not recognizing it was running from Task Scheduler
	- Improved geolocation
	- Many minor fixes

Author: unalignedcoder

Config.ps1 at-config.ps1Config.ps1 renamed to at-config.ps1

@@ -1,17 +1,50 @@
-# ============= User variables =============
 
-	# Name of theme files
+# ============= Theme variables =============
+
+	<# If `$true`, the script will use `.theme` files to select light and dark themes, as well as
+	wallpaper slideshows and other personalizations. If `$false`, it will use its native system
+	to switch between dark and light modes, and implement a wallpaper slideshow accordingly. #>
+	$useThemeFiles = $true
+
+	<# Name of theme files
+	* Only relevant when `$useThemeFiles = $true` #>
 	$themeLight = "Name-of-Light.theme"
 	$themeDark = "Name-of-Dark.theme"
 
-	<# Complete path to the `.theme` files. You can use the default path to Windows themes
+	<# COMPLETE PATH to the `.theme` files. You can use the default path to Windows themes
 	(as proposed in the example below) or a custom path of your choice.
-	Consider that Windows will always copy your `.theme` files to LocalAppData.
-	You can use something like `$lightPath = Join-Path $PSScriptRoot $themeLight`
-	if your `.theme` files are located within the script folder. #>
+	You can use `$lightPath = Join-Path $PSScriptRoot $themeLight`
+	if your `.theme` files are located within the script folder.
+	* Only relevant when `$useThemeFiles = $true` #>
 	$lightPath = Join-Path (Join-Path $Env:LOCALAPPDATA "Microsoft\Windows\Themes") $themeLight
 	$darkPath =  Join-Path (Join-Path $Env:LOCALAPPDATA "Microsoft\Windows\Themes") $themeDark
 
+# ============= Wallpaper variables =============
+
+	<# If `$true`, the script will only switch between Dark and Light modes, ignoring wallpapers.
+	* Only relevant when `$useThemeFiles = $false` #>
+	$noWallpaperChange = $false
+
+	<# Randomize first wallpaper.
+	Even if `shuffle=1` is set in a `.theme` file, Windows will always use
+	the first wallpaper in alphabetic order as the first shown.
+	Setting this to $true offers more variety as soon as the theme is applied.
+	Be aware that, to this end, a randomly-picked wallpaper file
+	will be temporarily renamed with a "0_AutoTheme" string prepended to it.
+	* Only relevant when `$useThemeFiles = $true` #>
+	$randomFirst = $true
+
+	<# Paths to the folders for light and dark wallpapers.
+	If `$useThemeFiles = $true`, indicate here the same paths indicated in the `.theme` files.
+	If `$useThemeFiles = $false`, indicate paths to images or folders to be selected for Light and Dark modes. #>
+	$wallLightPath = "C:\Path\to\Light\wallpapers"
+	$wallDarkPath = "C:\Path\to\Dark\wallpapers"
+
+	# Show the wallpaper name in notification
+	$showWallName = $true
+
+# ============= Time variables =============
+
 	# Use fixed hours to switch Themes (keeps the script completely offline)
 	$useFixedHours = $false
 
@@ -20,53 +53,34 @@
 	$lightThemeTime = "07:00 AM"
 	$darkThemeTime = "07:00 PM"
 
-	<# Set to $true to always use a user-defined location.
-	Alernatively, the script will attempt to retrieve location from the system
+	<# Set to `$true` to always use a user-defined location.
+	If `$false`, the script will attempt to retrieve location from the system
 	or, failing that, from your ISP, which may not give accurate results. #>
 	$useUserLoc = $false
 
 	<# User-defined coordinates and timezone. You can obtain your coordinates from Google or similar services.
 	You can find a list of timezone identifiers at this url:
-	https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
-	(These values are only retrieved if $UseUserLoc = $true and $useFixedHours = $false.
-	Yet, better set them, as the script will fall back to them, if all else fails.) #>
+	https://en.wikipedia.org/wiki/List_of_tz_database_time_zones 
+	* Only relevant if `$useUserLoc = $true`#>
 	$userLat = "40.7128"
 	$userLng = "-74.0060"
 	$UserTzid = "America/New_York"
 
 	<# Add or remove minutes to Sunrise and Sunset times. This can help
-	to account for local peculiarities
-	. Values can be negative,
+	to account for local peculiarities. Values can be negative,
 	for example, -30 means the event triggers 30 minutes earlier. #>
 	$sunriseOffset = 0
 	$sunsetOffset = 0
 
-	<# Randomize first wallpaper.
-	Even if 'shuffle=1' is set in a `.theme` file, Windows will always use
-	the first wallpaper in alphabetic order as the first shown.
-	Setting this to $true offers more variety as soon as the theme is applied. 
-	Be aware that, to this end, a randomly-picked wallpaper file
-	will be temporarily renamed with a "0_AutoTheme" string prepended to it. #>
-	$randomFirst = $true
-
-	<# Paths to the folders for light and dark wallpapers.
-	(only needed if $randomFirst = true) 
-	Use the same ones indicated in your .theme files. #>
-	$wallLightPath = "C:\Path\to\Light\wallpapers"
-	$wallDarkPath = "C:\Path\to\Dark\wallpapers"
-
-	# Show the wallpaper name in notification
-	$showWallName = $true
-
 # ============= Extra apps variables =============
 
 	<# Sysinternals Process Explorer doesn't automatically change theme when
 	the system theme is changed. Use this variable if you want it to be restarted.
 	If you run Process Explorer as Admin, the script should also run as Admin for this to work.
 	You can use the $forceAsAdmin variable below for the purpose. #>
 	$restartProcexp = $false
-	# If true, Process Explorer will keep Admin rights (inheriting from this script).
-	# If false, it will be restarted as a standard user. All other apps are restarted as standard user.
+	# If `$true`, Process Explorer will keep Admin rights (inheriting from this script).
+	# If `$false`, it will be restarted as a standard user. All other apps are restarted as standard user.
 	$restartProcexpElevated = $true
 
 	<# Change TrueLaunchBar colors (will cause Explorer to be restarted)
@@ -78,11 +92,11 @@
 	$restartMusicBee = $false
 
 	<# Changes color in the T-Clock font, so that it adapts to the current theme.
-	Regarding this app, be aware that when T-Clock redraws the clock background based on accent color,
-	it may cause the taskbar to crash or flicker. Better avoid it. #>
+	When T-Clock redraws the clock background based on accent color,
+	it may cause the taskbar to crash or flicker. #>
 	$tClockPath = "C:\Path\to\T-Clock\Clock64.exe"
 	$updateTClockColor = $false
-	$restartTClockColor = $false
+	$restartTClockColor = $false # usually not needed
 
 # ============= Developer variables ==============
 
@@ -93,20 +107,20 @@
 	$lastRunInterval = "5"
 	$waitExplorer = "30"
 	$checkLastRun = $true
-	$maxLogEntries = "20"
+	$maxLogEntries = "5"
 
-	# Turn this off if you have surge issues when switching theme or wallpaper
+	# Try turning accent color off if you have surge issues when switching theme or wallpaper
 	$turnOffAccentColor = $false
 
 	$restartThemeService = $false
 	$forceAsAdmin = $false
 
-	$appLogo = Join-Path $PSScriptRoot "AutoTheme.png"
-	$logFile = Join-Path $PSScriptRoot "AutoTheme.log"
-	$lastRunFile = Join-Path $PSScriptRoot "ATLastRun.txt"
-	
-	# Console Visibility Settings when run from Task Scheduler
-	# "ch" 		  - Completely hidden (no flash) using conhost --headless
-	# "ps"        - Standard PowerShell window (may flash briefly)
-	# "wt"        - Opens in Windows Terminal (using existing window if open)
-	$terminalVisibility = "ch"
+	$appLogo = Join-Path $PSScriptRoot "at.png"
+	$logFile = Join-Path $PSScriptRoot "at.log"
+	$lastRunFile = Join-Path $PSScriptRoot "at-lastRun.txt"
+
+	<# Console Visibility Settings when run from Task Scheduler:
+	* "ch"- Completely hidden (no flash) using `conhost --headless`
+	* "ps"- Standard PowerShell window (may flash briefly)
+	* "wt"- Opens in Windows Terminal (using existing window if open) #>
+	$terminalVisibility = "ch"

Setup.ps1 at-setup.ps1Setup.ps1 renamed to at-setup.ps1

@@ -90,17 +90,17 @@
         LogThis "This script requires administrative privileges. Requesting elevation..." -Level Warning
         # -NoProfile to ensure a clean environment during elevation
         $proc = Start-Process -FilePath "powershell.exe" `
-                      -ArgumentList "-NoProfile -ExecutionPolicy Bypass -File `"$PSCommandPath`"" `
-                      -Verb RunAs -PassThru
+                    -ArgumentList "-NoProfile -ExecutionPolicy Bypass -File `"$PSCommandPath`"" `
+                    -Verb RunAs -PassThru
         # Exit the non-elevated instance
         Exit 0
     }
 
-    # Define the path to the AutoTheme.ps1 script and task XML file
-    $AutoThemeScript = Join-Path -Path $PSScriptRoot -ChildPath "AutoTheme.ps1"
+    # Define the path to the at.ps1 script and task XML file
+    $AutoThemeScript = Join-Path -Path $PSScriptRoot -ChildPath "at.ps1"
     $TaskName = "Auto Theme"
 
-    # Check if AutoTheme.ps1 exists
+    # Check if at.ps1 exists
     if (!(Test-Path $AutoThemeScript)) {
         LogThis "Required script file '$AutoThemeScript' not found. Exiting setup..." -Level Error
         Pause

AutoTheme.png at.pngAutoTheme.png renamed to at.png

@@ -13,15 +13,15 @@
 	Alternatively, it can stay completely offline operating on fixed hours provided by the user.
 	When ran as the command `./at.ps1` from terminal or desktop shortcut, the script will only toggle between themes.
 	IMPORTANT: Edit `Config.ps1` to configure this script. The file contains all necessary explanations.
-	OPTIONALLY: Run `./Setup.ps1` to create the main Scheduled Task, or create one manually in Task Scheduler.
+	OPTIONALLY: Run `./setup.ps1` to create the main Scheduled Task, or create one manually in Task Scheduler.
 	For more information, refer to the README file.
 
 .LINK
 	https://github.com/unalignedcoder/auto-theme/
 
 .NOTES
 	- MAJOR UPDATE: 
-	- Added a native system to load Dark or Light modes and randomize wallpapers. `.theme` files can still be used, see config file
+	- Added a native system to load Dark or Light modes and randomize wallpapers. Though `.theme` files can still be used, see config file
     - Renamed the script "at.ps1" for consistency with my other "short-named" projects.
     - Added a "wrapper" script (`AutoTheme.ps1`) for compatibility with older tasks and existing shortcuts.
 	- Fixed a problem with the script not recognizing it was running from Task Scheduler
@@ -32,11 +32,11 @@
 # ============= Script Version ==============
 
 	# This is automatically updated
-	$scriptVersion = "1.0.38"
+	$scriptVersion = "1.0.39"
 
 # ============= Config file ==============
 
-	$ConfigPath = Join-Path $PSScriptRoot "Config.ps1"
+	$ConfigPath = Join-Path $PSScriptRoot "config.ps1"
 
 # ============= Win32 API Definitions ==============
 
@@ -881,9 +881,7 @@ if (-not ([System.Management.Automation.PSTypeName]'WinAPI').Type) {
         if (-Not ($IsAdmin)) {
 
             Write-Host "This script requires administrative privileges. Requesting elevation..." -ForegroundColor Yellow
-            Start-Process -FilePath "powershell.exe" `
-                          -ArgumentList "-NoProfile -ExecutionPolicy Bypass -File `"$PSCommandPath`"" `
-                          -Verb RunAs
+            Start-Process -FilePath "powershell.exe" -ArgumentList "-NoProfile -ExecutionPolicy Bypass -File `"$PSCommandPath`"" -Verb RunAs
             Exit 0
         }
     }
@@ -1634,3 +1632,4 @@ if (-not ([System.Management.Automation.PSTypeName]'WinAPI').Type) {
 	}
 
 
+