< div align = "center" >
< img src = "https://raw.githubusercontent.com/farag2/Sophia-Script-for-Windows/refs/heads/master/img/Sophia.png" alt = "Sophia Script for Windows" width = '150' >
# Sophia Script for Windows
**Sophia Script for Windows is the most powerfull PowerShell module for fine-tuning Windows**
 [](https://community.chocolatey.org/packages/sophia) [](https://github.com/farag2/Sophia-Script-for-Windows)
[telegram-news-badge]: https://img.shields.io/badge/Sophia%20News-Telegram-blue?style=flat& logo=Telegram
[telegram-news]: https://t.me/sophianews
[telegram-group]: https://t.me/sophia_chat
[telegram-group-badge]: https://img.shields.io/endpoint?color=neon& label=Sophia%20Chat& style=flat& url=https%3A%2F%2Ftg.sumanjay.workers.dev%2Fsophia_chat
[discord-news-badge]: https://discordapp.com/api/guilds/1006179075263561779/widget.png?style=shield
[discord-link]: https://discord.gg/sSryhaEv79
[![Telegram][telegram-news-badge]][telegram-news]
[![Telegram][telegram-group-badge]][telegram-group]
[![Discord][discord-news-badge]][discord-link]
[](https://github.com/farag2/Sophia-Script-for-Windows/actions)
[](https://github.com/farag2/Sophia-Script-for-Windows/releases/latest)
[](./docs/README_uk-ua.md)
[](./docs/README_de-de.md)
< img src = "./img/SophiaScript.png" alt = "Sophia Script for Windows" width = '800' >
< / div >
## About Sophia Script
`Sophia Script for Windows` is the largest PowerShell module on `GitHub` for `Windows 10` & `Windows 11` for fine-tuning and automating the routine tasks. It offers more than 150 unique tweaks, and shows how Windows can be configured without making any harm to it.
Made with < img src = "https://raw.githubusercontent.com/farag2/Sophia-Script-for-Windows/master/img/heart.svg" height = "17px" / > of Windows.
## Table of Contents
* [How to use ](#how-to-use )
* [Download via PowerShell ](#download-via-powershell )
* [Manual method ](#manual-method )
* [Wrapper ](#wrapper )
* [How to run the specific function(s) ](#how-to-run-the-specific-functions )
* [Donations ](#donations )
* [System Requirements ](#system-requirements )
* [Key features ](#key-features )
* [Screenshots ](#screenshots )
* [Videos ](#videos )
* [How to translate ](#how-to-translate )
* [Media ](#media )
* [SophiApp ](#sophiapp-c--wpf )
## How to use
> [!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. Especially, if the homebrew image was created by OS makers being all thumbs who break Microsoft Defender and disable OS telemetry by purposely uprooting system components.
### Download via PowerShell
To download the latest `Sophia Script for Windows` version run as `Administrator`
```powershell
iwr script.sophia.team -useb | iex
```
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` .
### Manual method
* Download an [archive ](https://github.com/farag2/Sophia-Script-for-Windows/releases/latest ) according to your Windows and PowerShell versions;
* Expand archive;
* 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 < kbd > Shift</ kbd > 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 < kbd > Windows</ kbd > 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
```
### Windows 11
https://github.com/user-attachments/assets/2654b005-9577-4e56-ac9e-501d3e8a18bd
### Windows 10
https://github.com/user-attachments/assets/f5bda68f-9509-41dc-b3b1-1518aeaee36f
## Wrapper
* 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 run the specific function(s)
* Do all steps from [Manual method ](#manual-method ) section and stop at settings execution policy in `PowerShell` ;
* [Dot source ](https://docs.microsoft.com/ru-ru/powershell/module/microsoft.powershell.core/about/about_operators#dot-sourcing-operator ) the `Functions.ps1` file first:
```powershell
# With a dot at the beginning
. .\Functions.ps1
```
* Now you can do like this (the quotation marks required)
```powershell
Sophia -Functions< TAB >
Sophia -Functions temp< TAB >
Sophia -Functions unin< TAB >
Sophia -Functions uwp< TAB >
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"
```
## Donations
[](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-23h2]: https://support.microsoft.com/topic/windows-11-version-23h2-update-history-59875222-b990-4bd9-932f-91a5954de434
[Windows-11-24h2]: https://support.microsoft.com/topic/windows-11-version-24h2-update-history-0929c747-1815-4543-8461-0160d16f15e5
| Version | Marketing name | Build | Editions |
|:-----------------------------------------|--------------------:|:-------------------------------------:|:-------------------:|
| Windows 11 24H2 | 2024 Update | [Latest stable][Windows-11-24h2] | Home/Pro/Enterprise |
| Windows 11 23H2 | 2023 Update | [Latest stable][Windows-11-23h2] | Home/Pro/Enterprise |
| Windows 10 x64 22H2 | 2022 Update | [Latest stable][Windows-10] | Home/Pro/Enterprise |
| Windows 11 Enterprise LTSC 2024 | 2024 Update | [Latest stable][Windows-11-LTSC-2024] | Enterprise |
| Windows 10 x64 21H2 Enterprise LTSC 2021 | October 2021 Update | [Latest stable][Windows-10-LTSC-2021] | Enterprise |
| Windows 10 x64 1809 Enterprise LTSC 2019 | October 2018 Update | [Latest stable][Windows-10-LTSC-2019] | Enterprise |
## Key features
* 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 < kbd > TAB</ kbd > [completion ](#the-tab-autocomplete-read-more-here ) for functions and their arguments (if using the Functions.ps1 file);
* Change %TEMP% environment variable path to %SystemDrive%\Temp;
* 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 packages names;
* Generate installed UWP apps list dynamically
* Restore the default uninstalled UWP apps for current user displaying [localized ](#localized-uwp-packages-names ) packages names;
* The < kbd > TAB</ kbd > [autocompletion ](#the-tab-autocomplete-read-more-here ) for function and its' arguments by typing first letters;
* 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;
* Register app, calculate hash, and set as default 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 have to install all apps according to an exported JSON file to restore all associations;
* Install any supported Linux distrobution for WSL displaying friendly distro names with pop-up form written in [WPF ](#screenshots );
* Create a `Windows Cleanup` and `Windows Cleanup Notification` scheduled tasks for Windows cleaning up unused files and updates;
* A native toast notification will be displayed where you can choose to snooze, run the cleanup task or [dismiss ](#native-interactive-toasts-for-the-scheduled-tasks )
* Create tasks in the Task Scheduler to clear
* `%SystemRoot%\SoftwareDistribution\Download`
* `%TEMP%`
* Pin shortcuts to Start via pure PowerShell
* Three shortcuts are pre-configured to be pinned: Control Panel, "old style" Devices and Printers.
* Unpin all Start menu tiles;
* Turn on Controlled folder access and add protected folders using dialog menu;
* Add exclusion folder from Microsoft Defender Antivirus scanning using dialog menu;
* Add exclusion file from Microsoft Defender Antivirus scanning using dialog menu;
* Refresh desktop icons, environment variables and taskbar without restarting File Explorer;
* 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 <kbd>TAB</kbd> 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
 
### Localized Windows features names
 
### Download and install any supported Linux distribution in automatic mode
### Native interactive toasts for the scheduled tasks
### @BenchTweakGaming Sophia Script Wrapper
## Videos
[](https://www.youtube.com/watch?v=q_weQifFM58)
[](https://youtu.be/8E6OT_QcHaU?t=370) [](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 Sophia.psd1 file into this folder.
## Media
* [](https://discord.gg/sSryhaEv79)
* [Telegram discussion group ](https://t.me/sophia_chat )
* [Telegram channel ](https://t.me/sophianews )
* [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/ )
* [4sysops ](https://4sysops.com/archives/windows-10-sophia-script-powershell-functions-for-windows-10-fine-tuning-and-automating-routine-configuration-tasks/ )
* [gHacks Technology News ](https://www.ghacks.net/2020/09/27/windows-10-setup-script-has-a-new-name-and-is-now-easier-to-use/ )
* [Neowin: Tech News, Reviews & Betas ](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/ )
***
## SophiApp (C# + WPF)
[SophiApp ](https://github.com/Sophia-Community/SophiApp ) is the full GUI version of `Sophia Script for Windows` and ready for use. It is in ongoing improvements with version 2.0 in development 🚀
