# Sophia Script for Windows **The most powerful PowerShell module for fine-tuning Windows on GitHub** Made with

of Windows.

This page is also available in other languages

## About Sophia Script `Sophia Script for Windows` is the most powerful PowerShell module for fine-tuning `Windows` and automating the routine tasks on `GitHub`. It offers more than 150 unique tweaks, and shows how Windows can be configured without making any harm to it. > [!IMPORTANT] > Every tweak in the preset file has its' corresponding function to restore the default settings. Running the script is best done on a fresh install because running it on wrong tweaked system may result in errors occurring. > [!WARNING] > It's allowed to be logged in as one admin user only during application startup. > > `Sophia Script for Windows` may not work on a homebrew Windows. ## Table of Contents * [How to download](#how-to-download) * [Download via PowerShell](#download-via-powershell) * [Download via Chocolatey](#download-via-chocolatey) * [Download via WinGet](#download-via-winget) * [From release page](#from-release-page) * [How to use](#how-to-use) * [How to run the specific function(s)](#how-to-run-the-specific-functions) * [Wrapper](#wrapper) * [How to revert changes](#how-to-revert-changes) * [Donations](#donations) * [System Requirements](#system-requirements) * [Key features](#key-features) * [Screenshots](#screenshots) * [Videos](#videos) * [How to translate](#how-to-translate) * [Media](#media) * [SophiApp 2](#sophiapp-2-c--winui-3) ## How to download ### Download via PowerShell The command will download and expand the latest Sophia Script archive (`without running`) according which Windows and PowerShell versions it is run on. If you run it on, e.g., Windows 11 via PowerShell 5.1, it will download Sophia Script for `Windows 11 PowerShell 5.1`. ```powershell iwr script.sophia.team -useb | iex ``` The command will download and expand the latest Sophia Script archive (`without running`) from the `last commit available` according which Windows and PowerShell versions it is run on. ```powershell iwr sl.sophia.team -useb | iex ``` ### Download via Chocolatey The command will download and expand the latest Sophia Script archive (`without running`) according which Windows it is run on. If you run it on Windows 11, it will download Sophia Script for `Windows 11`. For `PowerShell 5.1` by default is not otherwise specified. ```powershell choco install sophia --force -y ``` Download `Sophia Script for Windows` for `PowerShell 7`. ```powershell choco install sophia --params "/PS7" --force -y ``` ```powershell # Uninstall Sophia Script # Then remove downloaded folder manually choco uninstall sophia --force -y ``` ### Download via WinGet The command downloads only `Windows 11 (PowerShell 5.1)` archive to your `Downloads` folder unlike the `Chocolatey` [script](#download-via-chocolatey) and expands it. ```powershell $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 ``` ```powershell # Uninstall Sophia Script winget uninstall --id TeamSophia.SophiaScript --force ``` ### From release page Download [archive](https://github.com/farag2/Sophia-Script-for-Windows/releases/latest) according to your Windows and PowerShell versions. ## How to use * Download archive 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 the whole path to `Sophia.ps1` * On `Windows 10` press and hold the Shift key, right click on `Sophia.ps1`, and click on `Copy as path`; * On `Windows 11` right click on `Sophia.ps1` and click on `Copy as path`. * Open `Windows PowerShell` * On `Windows 10` click `File` in the File Explorer, hover over `Open Windows PowerShell`, and select `Open Windows PowerShell as Administrator` [(how-to with screenshots)](https://www.howtogeek.com/662611/9-ways-to-open-powershell-in-windows-10/) * On `Windows 11` right-click on the Windows icon and open `Windows Terminal (Admin)`; * Set execution policy to be able to run scripts only in the current PowerShell session; ```powershell Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force ``` * Type `.\Sophia.ps1`and press Enter; ```powershell .\Sophia.ps1 ``` ### Windows 11 ### Windows 10 ### How to run the specific function(s) * Do all steps from [How to use](#how-to-use) section and stop at setting execution policy in `PowerShell`; * [Dot source](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_operators#dot-sourcing-operator-) the `Import-TabCompletion.ps1` file first: ```powershell # With a dot at the beginning . .\Import-TabCompletion.ps1 ``` * Now you can do like this (the quotation marks required) ```powershell Sophia -Functions Sophia -Functions temp Sophia -Functions unin Sophia -Functions uwp Sophia -Functions "DiagTrackService -Disable", "DiagnosticDataLevel -Minimal", UninstallUWPApps UninstallUWPApps, "PinToStart -UnpinAll" ``` Or use an old-style format without the TAB functions autocomplete (the quotation marks required) ```powershell .\Sophia.ps1 -Functions CreateRestorePoint, "ScheduledTasks -Disable", "WindowsCapabilities -Uninstall" ``` ## Wrapper ![Image](https://github.com/farag2/Sophia-Script-for-Windows/raw/master/img/Wrapper.png) @BenchTweakGaming * Download the [latest](https://github.com/farag2/Sophia-Script-for-Windows/releases/latest) Wrapper version; * Expand archive; * Run `SophiaScriptWrapper.exe` and import `Sophia.ps1`; * `Sophia.ps1` has to be in `Sophia Script` folder; * The Wrapper has a real time UI rendering; * Configure every function; * Open the `Console Output` tab and press `Run PowerShell`. ## How to revert changes * Do all steps from [How to use](#how-to-use) section and stop at setting execution policy in `PowerShell`; * [Dot source](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_operators#dot-sourcing-operator-) the `Import-TabCompletion.ps1` file first: ```powershell # With a dot at the beginning . .\Import-TabCompletion.ps1 ``` * Call functions from `Sophia.ps1` you want to revert like this. ```powershell Sophia -Functions "DiagTrackService -Enable", UninstallUWPApps ``` ## Donations [![ko-fi](https://www.ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/farag)⠀⠀⠀

## System Requirements [Windows-10]: https://support.microsoft.com/topic/windows-10-update-history-8127c2c6-6edf-4fdf-8b9f-0f7be1ef3562 [Windows-10-LTSC-2019]: https://support.microsoft.com/topic/windows-10-and-windows-server-2019-update-history-725fc2e1-4443-6831-a5ca-51ff5cbcb059 [Windows-10-LTSC-2021]: https://support.microsoft.com/topic/windows-10-update-history-857b8ccb-71e4-49e5-b3f6-7073197d98fb [Windows-11-LTSC-2024]: https://support.microsoft.com/topic/windows-11-version-24h2-update-history-0929c747-1815-4543-8461-0160d16f15e5 [Windows-11-24h2]: https://support.microsoft.com/topic/windows-11-version-24h2-update-history-0929c747-1815-4543-8461-0160d16f15e5 | Version | Build | Edition | |:-----------------------------------------|:-------------------------------------:|:-------------------:| | Windows 11 24H2 | [Latest stable][Windows-11-24h2] | Home/Pro/Enterprise | | Windows 10 x64 22H2 | [Latest stable][Windows-10] | Home/Pro/Enterprise | | Windows 11 Enterprise LTSC 2024 | [Latest stable][Windows-11-LTSC-2024] | Enterprise | | Windows 10 x64 21H2 Enterprise LTSC 2021 | [Latest stable][Windows-10-LTSC-2021] | Enterprise | | Windows 10 x64 1809 Enterprise LTSC 2019 | [Latest stable][Windows-10-LTSC-2019] | Enterprise | ## Key features * All archives are being built via GitHub Actions [automatically](https://github.com/farag2/Sophia-Script-for-Windows/actions); * Set up Privacy & Telemetry; * Enable DNS-over-HTTPS for IPv4; * Turn off diagnostics tracking scheduled tasks with pop-up form written in [WPF](#screenshots); * Set up UI & Personalization; * Uninstall OneDrive "correctly"; * Interactive [prompts](#change-user-folders-location-programmatically-using-the-interactive-menu); * The TAB [completion](#the-tab-autocomplete-read-more-here) for functions and their arguments (if using the Import-TabCompletion.ps1 file); * Change location of the user folders programmatically (without moving user files) within interactive menu using arrows to select a drive * Desktop * Documents * Downloads * Music * Pictures * Videos * Install free (light and dark) "Windows 11 Cursors Concept v2" cursors from [Jepri Creations](https://www.deviantart.com/jepricreations/art/Windows-11-Cursors-Concept-v2-886489356) on-the-fly; * Uninstall UWP apps displaying thier localized packages names; * Script generates installed UWP apps list [dynamically](#localized-uwp-packages-names) * Disable Windows features displaying friendly packages names with pop-up form written in [WPF](#screenshots); * Uninstall Windows capabilities displaying friendly packages names with pop-up form written in [WPF](#screenshots); * Download and install the [HEVC Video Extensions from Device Manufacturer](https://apps.microsoft.com/detail/9N4WGH0Z6VHQ) to be able to open [HEVC](https://en.wikipedia.org/wiki/H.265) format; * Set an app as default one for specific extension without the "How do you want to open this" pop-up using special [function](https://github.com/DanysysTeam/PS-SFTA); * Export all Windows associations. Associations will be exported as Application_Associations.json file in script root folder; * Import exported JSON file after a clean installation. You need to install all apps according to exported JSON file to restore all associations; * Install any supported Linux distribution for WSL displaying friendly distro names with pop-up form written in [WPF](#screenshots); * Create scheduled tasks with a native toast notification, where you will be able to run or [dismiss](#native-interactive-toasts-for-the-scheduled-tasks) tasks; * Create scheduled tasks `Windows Cleanup` and `Windows Cleanup Notification` for cleaning up Windows of unused files and Windows updates files; * Create a scheduled task `SoftwareDistribution` for cleaning up `%SystemRoot%\SoftwareDistribution\Download`; * Create a scheduled task `Temp` for cleaning up `%TEMP%`. * Create tasks in the Task Scheduler to clear * `%SystemRoot%\SoftwareDistribution\Download` * `%TEMP%` * Install the latest provided Microsoft Visual C++ 2015–2022 x86/x64; * Install the latest provided .NET Desktop Runtime 8, 9 x86/x64; * Configure the Windows security; * Display all policy registry keys (even manually created ones) in the Local Group Policy Editor snap-in (gpedit.msc); * Many more File Explorer and context menu "deep" tweaks. ## Screenshots ### The TAB autocomplete. Read more [here](#how-to-run-the-specific-functions) https://user-images.githubusercontent.com/10544660/225270281-908abad1-d125-4cae-a19b-2cf80d5d2751.mp4 ### Change user folders location programmatically using the interactive menu https://user-images.githubusercontent.com/10544660/253818031-b7ce6bf1-d968-41ea-a5c0-27f6845de402.mp4 ### Localized UWP packages names ![Image](./img/uwpapps.png) ### Localized Windows features names ![Image](./img/optionalfeatures.png) ![Image](./img/windowsfeatures.png) ### Download and install any supported Linux distribution in automatic mode ![Image](./img/wsl.png) ### Native interactive toasts for the scheduled tasks ![Image](https://github.com/farag2/Sophia-Script-for-Windows/raw/master/img/Toasts.png) ## Videos [![YT](https://img.youtube.com/vi/q_weQifFM58/0.jpg)](https://www.youtube.com/watch?v=q_weQifFM58) [![YT](https://img.youtube.com/vi/8E6OT_QcHaU/1.jpg)](https://youtu.be/8E6OT_QcHaU?t=370) [![YT](https://img.youtube.com/vi/091SOihvx0k/1.jpg)](https://youtu.be/091SOihvx0k?t=490) ## How to translate * Get your OS UI culture by invoking `$PSUICulture` in PowerShell; * Create a folder with the UI culture name; * Place your localized SophiaScript.psd1 file into this folder. ## Media * [XDA](https://www.xda-developers.com/sophia-script-returns-control-windows-11) * [4sysops](https://4sysops.com/archives/windows-10-sophia-script-powershell-functions-for-windows-10-fine-tuning-and-automating-routine-configuration-tasks/) * [gHacks](https://www.ghacks.net/2020/09/27/windows-10-setup-script-has-a-new-name-and-is-now-easier-to-use/) * [Neowin](https://www.neowin.net/news/this-windows-10-setup-script-lets-you-fine-tune-around-150-functions-for-new-installs) * [Comss.ru](https://www.comss.ru/page.php?id=8019) * [Habr](https://habr.com/company/skillfactory/blog/553800) * [Deskmodder.de](https://www.deskmodder.de/blog/2021/08/07/sophia-script-for-windows-jetzt-fuer-windows-11-und-10/) * [PCsoleil Informatique](https://www.pcsoleil.fr/successeur-de-win10-initial-setup-script-sophia-script-comment-lutiliser/) * [Reddit (archived)](https://www.reddit.com/r/PowerShell/comments/go2n5v/powershell_script_setup_windows_10/) * PM [me](https://www.reddit.com/user/farag2/) * [Ru-Board](https://forum.ru-board.com/topic.cgi?forum=62&topic=30617#15) * [rutracker](https://rutracker.org/forum/viewtopic.php?t=5996011) * [My Digital Life](https://forums.mydigitallife.net/threads/powershell-windows-10-sophia-script.81675/) *** ## SophiApp 2 (C# + WinUI 3) [SophiApp 2.0](https://github.com/Sophia-Community/SophiApp) is in ongoing development. 🚀 ![Image](https://github.com/farag2/Sophia-Script-for-Windows/raw/master/img/0.gif) ![Image](https://github.com/farag2/Sophia-Script-for-Windows/raw/master/img/1.png)