Skip to content

LightZirconite/setup-script

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

75 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Windows Setup Script

Interactive Windows configuration script with automatic edition detection, software installation, and system optimization.

Installation

irm https://github.com/LightZirconite/setup-script/raw/main/setup-windows.ps1 | iex

Requirements

  • Windows 10 or Windows 11
  • PowerShell 5.1+
  • Administrator privileges
  • Internet connection
  • Winget (App Installer) recommended

Features

Automatic Detection

  • โœ… Automatically detects Windows edition (LTSC/IoT vs Standard)
  • โœ… Detects hardware (Steam Deck, HP, Unowhy, GPU types)
  • โœ… Enables edition-specific and hardware-specific options

Interactive Mode

  • โœ… Y/N questions with detailed descriptions
  • โœ… Collects ALL answers BEFORE installing anything
  • โœ… Robust error handling with colored output
  • โœ… Administrator privilege verification
  • โœ… Auto-launch applications after installation

Automatic Configuration

  • โœ… O&O ShutUp10++ automatically configured with recommended privacy settings
  • โœ… Silent background installation without user interaction

Installation Options

Office & Activation

  • Microsoft Office installation (via winget or direct download)
  • Windows/Office activation via Microsoft Activation Scripts

Software (winget)

  • Discord (stable, PTB, Canary)
  • Steam
  • Spotify
  • Termius
  • Visual Studio Code
  • Firefox
  • Python
  • Node.js

Remote Management & Connectivity

  • Mesh Agent (with -fullinstall parameter)
  • Remote Desktop (RDP) with optional NLA disable for easier remote access
  • KDE Connect (device connectivity)

Productivity & Voice Tools

  • SuperWhisper - Voice-to-Text AI tool for dictation
  • Microsoft PowerToys - Productivity utilities suite (FancyZones, ColorPicker, PowerRename, etc.)
  • EarTrumpet - Advanced volume control

UI Customization

Windows 11:

  • ExplorerPatcher - Restore Windows 10 taskbar and Start Menu

Windows 10:

  • TranslucentTB - Taskbar transparency and customization (better alternative to TaskbarX)
  • Firefox + Edge removal prompt - The script asks to install Firefox, then offers an option to remove Microsoft Edge. If chosen, it downloads the latest Remove-Edge.exe from ShadowWhisperer/Remove-MS-Edge releases and runs it after confirmation.

Configuration Modes

This script now uses a single, explicit selection flow: the installer asks each software/tool question individually (Manual Selection). The previous "Custom Light Mode" preset has been removed by user request to avoid automatic pre-selections.

Device-Specific Features

Steam Deck:

  • Steam Deck Tools (drivers and fan control)
  • Windows Defender Exclusion - Automatically excludes Steam Deck Tools folder to prevent false positives
  • GPU Driver Protection - Blocks Windows Update from breaking display drivers (AMD APU only)
  • Amernime Custom AMD Driver Guide - Prompt to open the latest Reddit tutorial for community AMD GPU drivers (Amernime) when Steam Deck is detected
  • Manual updates available from: https://help.steampowered.com/en/faqs/view/6121-ECCD-D643-BAA8

Other Devices:

  • Unowhy Tools (device-specific drivers)
  • HP Driver Detection
  • Dell/Lenovo BIOS updates

Driver Management

  • NVIDIA App - Automatic download of latest version with fallback
  • AMD Adrenalin - GPU drivers and control panel
  • Intel DSA - Driver & Support Assistant (non-blocking installation)
  • Intel Graphics Software - Modern GPU control panel

Essential Runtimes & Libraries

  • Visual C++ Redistributables (2015-2022) - Essential runtime libraries required by most applications

    • Standalone installation option (recommended for all Windows, especially LTSC)
    • Automatic fallback to direct Microsoft download if Winget fails
    • Required by: Adobe products, games, development tools, and many other applications
    • Also included in Gaming Stack (no duplication)
  • 7-Zip - Popular file compression and archiving tool

    • Supports multiple formats: .zip, .7z, .rar, .tar, .gz, .bz2, and many more
    • High compression ratio with 7z format
    • Automatic installation via Winget with GitHub fallback (always latest version)
    • Essential for file management and software installation
    • Context menu integration for quick access

LTSC/IoT Options

When LTSC/IoT edition is detected:

  • Enable Microsoft Store
  • Install Notepad
  • Install Windows Terminal
  • Install Calculator
  • Install Camera
  • Install Media Player
  • Install Photos
  • Enable Location Services: Activates Windows location for browser geolocation and Maps

System Updates

  • Update all software via winget

Network & Privacy

  • Cloudflare DNS: Configure DNS to 1.1.1.1 (IPv4 + IPv6) for faster and more secure internet
  • Advanced Telemetry Blocking: Aggressive privacy protection beyond O&O ShutUp10++
    • Blocks telemetry hosts
    • Disables diagnostic services
    • Registry tweaks for data collection

Package Managers

  • Chocolatey: Optional installation as complement to Winget for more package availability

System Maintenance

  • System Cleanup: Post-installation cleanup
    • Clear temporary files
    • Clean WinSxS component store
    • Free disk space
  • Performance Benchmarking: Before/After performance metrics with detailed system snapshots

Dual Boot Support

  • Automatic Detection: Detects Linux partitions and GRUB bootloader
  • UTC Time Fix: Permanently fixes 1-hour time offset in dual boot configurations

What's New in v2.2.1

๐Ÿ—บ๏ธ LTSC/IoT Location Services

  • Location Services Activation: Enable Windows location services on LTSC/IoT editions
    • Fixes browser geolocation issues (websites can now request location)
    • Installs Windows Maps
    • Configures location permissions properly
    • Perfect for LTSC Windows 10 IoT systems

What's New in v2.2

๐ŸŒ Network & Privacy

  • Cloudflare DNS: One-click configuration for all network adapters (IPv4 + IPv6, keeps IPv6 enabled)
  • Advanced Telemetry Blocking: More aggressive than O&O ShutUp10++ with hosts file blocking and service disabling

๐Ÿ“ฆ Package Management

  • Chocolatey Integration: Complement Winget with additional packages (e.g., NVIDIA App)

๐Ÿงน System Maintenance

  • System Cleanup: Automated cleanup of temp files and WinSxS component store (no compression)
  • Performance Testing: Before/After benchmarks with JSON exports for comparison

๐Ÿ–ฅ๏ธ Dual Boot Enhancements

  • Auto-Detection: Automatically detects dual boot configurations
  • UTC Registry Fix: Proper solution instead of background service patch

What's New in v2.1

๐Ÿš€ Major Improvements

  • NVIDIA App: Fully automatic installation with version scraping (no more manual downloads!)
  • Auto-Launch: Applications now start automatically after installation (TranslucentTB, PowerToys, EarTrumpet, Rytunex)
  • Non-Blocking Installs: Interactive installers (Intel DSA) no longer block script execution

๐ŸŽฎ Steam Deck Support

  • Automatic GPU driver protection to prevent Windows Update from breaking display
  • Blocks AMD APU driver updates while allowing manual updates from Valve

๐ŸŒ Remote Access

  • RDP Configuration: Enable Remote Desktop with one click
  • NLA Disable Option: For easier Mesh Agent integration and unattended access

๐ŸŽจ UI Customization Pack

  • PowerToys: Microsoft's productivity utilities suite
  • EarTrumpet: Advanced audio control
  • ExplorerPatcher (Win11): Restore Windows 10 UI
  • TaskbarX (Win10): Center taskbar icons

๐ŸŽค Voice-to-Text

  • SuperWhisper: AI-powered dictation tool with automatic installation

๐Ÿ”ง Technical Improvements

  • Mesh Agent URL updated (id=3)
  • Generic app launcher function for consistent behavior
  • Better error handling and user feedback
  • Cleaner installation flow

Script Flow

1. Detection Phase

  • Detects Windows edition
  • Displays system information

2. Configuration Phase

  • Asks all questions (Y/N)
  • Each option includes a description
  • Collects all choices before proceeding

3. Installation Phase

  • Processes all selected installations
  • Shows progress for each step
  • Handles errors gracefully

4. Completion

  • Displays summary
  • Offers system restart

Technical Details

Office Installation

Winget Method:

  • Fast installation via Windows Package Manager
  • Automatic update integration

Direct Download:

  • Downloads from official Microsoft CDN
  • O365 ProPlus Retail edition
  • 64-bit, English (US)

Version Fetching

The script automatically fetches latest versions via GitHub API for:

  • Bulk Crap Uninstaller (advanced uninstaller, alternative: Geek Uninstaller for simpler use)
  • Lively Wallpaper
  • Steam Deck Tools
  • KDE Connect

Security

  • Administrator privilege verification
  • Comprehensive error handling
  • Automatic temporary file cleanup
  • Safe default choices

Color Coding

  • Cyan - Informational messages
  • Green - Success messages
  • Yellow - Warnings and prompts
  • Red - Error messages

Important Notes

  • Some installations require manual steps (Store apps)
  • Files App taskbar pinning is manual
  • Activation script opens in a new window
  • System restart recommended after installation
  • LTSC users must restart after enabling Store

Troubleshooting

Script won't run:

# Check execution policy
Get-ExecutionPolicy

# Allow execution
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process

Winget not found:

Download failures:

  • Check internet connection
  • Check firewall settings
  • Retry the script

Store apps won't install:

  • Ensure Microsoft Store is enabled (especially on LTSC)
  • Check Windows Update is working
  • Sign in with a Microsoft account

Version

Current Version: 1.0.0

License

This script is provided as-is for Windows system setup and configuration purposes.

About

Setup Win

Resources

Stars

Watchers

Forks

Contributors 2

  •  
  •