farag2/Sophia-Script-for-Windows

🌐 English | Deutsche | Русский | Українська

Sophia Script for Windows

The most powerful PowerShell module for fine-tuning Windows on GitHub

Made with of Windows

Key features

• Sophia Script for Windows cares about your Windows stability and informs in case of finding a problem
• More than 150 unique functions to configure Windows using Microsoft's officially documented ways without making any harm to it
  • Every tweak has its corresponding function to restore default settings
• Fully open-source project
  • All archives are being built and uploaded using GitHub Actions
• Configure Windows AI
• Configure Windows privacy, security, personalization
• Available via Scoop, Chocolatey, and WinGet
• Arm64 support
• PowerShell 7 support
• Has no conflict with VAC
• Uninstall UWP apps displaying their localized packages names
  • Script generates installed UWP apps list dynamically
• Applied registry policies will be displayed in the Local Group Policy Editor snap-in (gpedit.msc)
• Enable DNS-over-HTTPS using
  • Cloudflare DNS
  • Google Public DNS
  • Quad9 DNS
  • Comss.one DNS
  • AdGuard DNS
  • OpenDNS
• Uninstall OneDrive
• Interactive prompts and popups
• TAB completion for functions and their arguments (using Import-TabCompletion.ps1)
• Change location of the user folders (without moving user files) using an interactive menu
  • Desktop
  • Documents
  • Downloads
  • Music
  • Pictures
  • Videos
• Install free (light and dark) Windows 11 Cursors Concept v2 cursors from Jepri Creations on-the-fly
  • Archive was downloaded to Cursors folder using DeviantArt API
• Set an app as default one for specific extension without How do you want to open this pop-up
• Export and import all Windows associations. You need to install all apps according to exported JSON file to restore all associations
• Install WSL Linux distribution with pop-up using friendly distro names
• Create scheduled tasks with a native toast notification
  • Create Windows Cleanup and Windows Cleanup Notification scheduled tasks for cleaning up Windows of unused files and Windows updates files
  • Create SoftwareDistribution scheduled task for cleaning up %SystemRoot%\SoftwareDistribution\Download
  • Create Temp scheduled task for cleaning up temp folders and files
    • %SystemDrive%\$WinREAgent
    • %SystemDrive%\$SysReset
    • %SystemDrive%\$Windows.~WS
    • %SystemDrive%\$GetCurrent
    • %SystemDrive%\ESD
    • %SystemDrive%\Intel
    • %SystemDrive%\PerfLogs
    • %SystemRoot%\ServiceProfiles\NetworkService\AppData\Local\Temp
    • %LOCALAPPDATA%\CrashDumps
    • %SystemDrive%\Recovery
    • %SystemRoot%\System32\config\systemprofile\AppData\Local\tw-*.tmp
• Install the latest provided Microsoft Visual C++ 2015–2026 x86/x64
• Install the latest provided .NET Desktop Runtime 8, 9, 10 x64
• Many more File Explorer and context menu tweaks

Table of Contents

• Key features
• How to download
• How to use
  • How to run the specific function(s)
• Wrapper
• System Requirements
• Screenshots
• How to translate
• Media
• SophiApp 2.0

How to download

From release page

Windows 10	Windows 11

Download via PowerShell

Download and expand to Downloads folder the latest Sophia Script for Windows version depending to your Windows and PowerShell versions you use.

iwr script.sophia.team -useb | iex

Download and expand to Downloads folder the latest Sophia Script for Windows version from the last commit depending to your Windows and PowerShell versions you use.

iwr sl.sophia.team -useb | iex

Chocolatey

Download and expand to Downloads folder latest Sophia Script for Windows version depending to your Windows version you use.

choco install sophia --force --yes

Download and expand to Downloads folder latest Sophia Script for Windows version for PowerShell 7 depending to your Windows version you use.

choco install sophia --params "/PS7" --force --yes

# Uninstall and then remove downloaded folder manually
choco uninstall sophia --force --yes

WinGet

Download and expand to Downloads folder latest Sophia Script for Windows version for Windows 11 and PowerShell 5.1 (SFX archive sophiascript.exe).

$DownloadsFolder = Get-ItemPropertyValue -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders" -Name "{374DE290-123F-4565-9164-39C4925E467B}"
winget install --id TeamSophia.SophiaScript --location $DownloadsFolder --accept-source-agreements --force

& "$DownloadsFolder\sophiascript.exe"; Start-Sleep -Seconds 3; Remove-Item -Path "$DownloadsFolder\sophiascript.exe" -Force

# Uninstall Sophia Script for Windows
winget uninstall --id TeamSophia.SophiaScript --force

Scoop

Download and expand to Downloads folder latest Sophia Script for Windows version for Windows 11 for PowerShell 5.1.

# scoop bucket rm extras
scoop bucket add extras
scoop install sophia-script --no-cache

# Uninstall Sophia Script for Windows
scoop uninstall sophia-script --purge

How to use

https://github.com/user-attachments/assets/5af5c234-5fb5-4e7e-a3d0-ae496a89e6ba

• Download archive for your system and expand it
• Look through the Sophia.ps1 file to configure functions that you want to be run
  • Place the # char before function if you don't want it to be run
  • Remove the # char before function if you want it to be run
• Copy path of downloaded Sophia Script for Windows folder
• Right click on Windows button, open Terminal (PowerShell) as admin, and paste copied path to folder

  cd path\to\folder

• Set execution policy to be able to run scripts only in the current PowerShell session

  Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force

• Type .\Sophia.ps1 and press Enter

How to run the specific function(s)

https://github.com/user-attachments/assets/d70150d6-af8c-4933-9ec5-b2cf3bb1dd34

• Do all steps from How to use section and stop at setting execution policy in PowerShell
• Dot source the Import-TabCompletion.ps1 file first:

# With a dot at the beginning
. .\Import-TabCompletion.ps1

• Сall any script function with name autocompletion using TAB

Sophia -Functions<TAB>
Sophia -Functions temp<TAB>
Sophia -Functions unin<TAB>
Sophia -Functions uwp<TAB>
Sophia -Functions "DiagTrackService -Disable", "DiagnosticDataLevel -Minimal", Uninstall-UWPApps

Uninstall-UWPApps, "PinToStart -UnpinAll"

Wrapper

Wrapper is a 3rd party closed-source wrapper for Sophia Script for Windows. It's fully maintained by @BenchTweakGaming.

Read more here

System Requirements

Screenshots

How to translate

• Run $PSUICulture in PowerShell to determine your UI language
• Create a folder with the UI language name (e.g. en-US)
• Place your localized SophiaScript.psd1 file into this folder

Media

SophiApp 2.0 (C# + WinUI 3)

SophiApp 2.0 is in ongoing development. 🚀