Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/flick9000/winscript/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks you through every step needed to go from a stock Windows installation to a debloated, privacy-hardened, and optimized system using Winscript. By the end you’ll have launched the app, selected your tweaks, run or downloaded a PowerShell script, and exported a reusable JSON config you can replay on any machine.
Winscript must be run from an administrator terminal. Open PowerShell or Windows Terminal by right-clicking and selecting Run as Administrator before using any of the commands below.
Before applying any tweaks, create a System Restore Point so you can roll back if something doesn’t behave as expected. Search for “Create a restore point” in the Start menu to open the System Properties dialog.

​
Launch Methods

Winscript offers three ways to get started. All three give you the same full-featured GUI — choose whichever fits your workflow. 
# Downloads and launches the latest portable exe directly from GitHub.
# No installation required — the file is cleaned up automatically on exit.
irm "https://winscript.cc/irm" | iex

​
Step-by-Step Guide

1

Check Prerequisites

Before you begin, make sure your system meets the following requirements:
  • Operating system: Windows 10 or Windows 11
  • Terminal: PowerShell or Windows Terminal opened as Administrator
  • Internet connection: Required for the IRM one-liner and the App Installer feature (Winget / Chocolatey installs)
No additional runtimes or dependencies are needed — Winscript ships as a self-contained .exe.
2

Launch via IRM One-Liner (Recommended)

The fastest way to start is the IRM one-liner. Open an administrator PowerShell window and run:
irm "https://winscript.cc/irm" | iex
The script will:
  1. Fetch the latest release metadata from the GitHub API
  2. Download winscript-portable.exe to your system temp folder
  3. Launch Winscript automatically
  4. Delete the temp file when you close the app
You’ll see the Winscript ASCII banner in the console while it runs, so you can confirm it started correctly.
3

Alternative: Install via Winget

If you prefer a persistent installation that you can launch from any terminal session, use Winget:
winget install winscript
After the install completes, launch Winscript from the Start menu or by typing winscript in any terminal. This method also makes it easy to update later with winget upgrade winscript.
4

Alternative: Download the Portable EXE

Prefer to manage the file yourself? Grab the portable build directly from GitHub Releases:
  1. Go to github.com/flick9000/winscript/releases
  2. Download winscript-portable.exe from the latest release
  3. Right-click the file and select Run as Administrator
No installer, no registry entries — just a single executable you can store on a USB drive or network share.
5

Select Your Tweaks in the GUI

Once Winscript is open, use the sidebar to navigate between sections:
SectionWhat you can do
DebloatRemove inbox apps, OneDrive, Copilot, Edge, Widgets, and more
PrivacyBlock sensitive permissions, disable syncing and tracking
TelemetryStop Microsoft and third-party data collection
PerformanceEnable Ultimate Performance plan, tune services and features
GamingApply latency and interference-reduction tweaks
App InstallerPick apps to bulk-install via Winget or Chocolatey
Unattended SetupBuild an autounattend.xml for automated Windows installs
Check the individual tweaks you want to apply. Hover over any item for a description of exactly what it changes.
6

Run or Download Your Script

When you’re happy with your selections, choose one of two output options at the bottom of the interface:
  • Run Script — Executes the generated PowerShell script immediately on the current machine. Changes take effect right away (some may require a reboot).
  • Download Script — Saves a .ps1 file to disk so you can inspect it, schedule it, or run it later on other machines.
Running the script requires an elevated PowerShell session. If you launched Winscript from a non-admin terminal, use the Download Script option and then run the saved .ps1 as Administrator.
7

Export Your Configuration for Reuse

After selecting your tweaks, save them as a reusable JSON config:
  1. Click the Export button in the Winscript toolbar
  2. Choose a save location (e.g. C:\Users\You\winscript-config.json)
  3. The file captures every toggle you’ve set
To restore the same selections on another machine — or to pick up where you left off — launch Winscript with the -i flag:
.\winscript.exe -i "C:\path\to\config.json"
This is especially useful for IT admins, home lab setups, or whenever you reinstall Windows and want your preferred tweaks applied consistently. See the Configuration page for the full breakdown of import/export, presets, and automation.

Build docs developers (and LLMs) love

Get started for freeTalk to us