Skip to content

adnoctem/winkit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

43 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

winkit

License Language PSGallery Version Testing GitHub Release GitHub Activity Semantic Release Renovate PreCommit

winkit is an open-source MIT-licensed collection of PowerShell scripts and modules written and maintained by the Ad Noctem Collective for the machine-level configuration, hardening, provisioning and maintenance of Windows systems. The repository targets both desktop Windows installations and Windows Server environments and supports PowerShell 5.0 and above, including Windows PowerShell 5.x as well as newer PowerShell releases. It is intended for repeatable system setup, workstation preparation, administrative automation and post-install configuration, especially where Windows machines need to be brought into a known and documented configuration state.

The scripts directory contains executable scripts intended to be run directly by an administrator, deployment process, bootstrap routine, scheduled task or other automation system. The lib directory contains reusable PowerShell module code shared by the scripts; it is currently imported locally by scripts inside scripts, with publication to the PowerShell Gallery planned for future reuse.

Functionally, winkit covers several major areas of Windows administration, including system appearance, Explorer behavior, Start menu and taskbar configuration, browser policies, privacy options, telemetry reduction, diagnostic reporting and notification settings. It also includes scripts for disabling or enabling selected Windows components such as OneDrive, Copilot, Game DVR, Remote Assistance, Windows Sandbox and Windows Subsystem for Linux.

For provisioning and maintenance workflows, the repository provides automation around PowerShell Core, WinGet, Visual C++ redistributables, Windows updates, system restore points, hostname changes, mapped drive restoration, file encoding conversion and cleanup operations. Additional scripts cover device and input behavior such as pointer acceleration, compact OS settings, application permission defaults, Python script path configuration and terminal experience defaults.

Network-adjacent and administrative utility scripts are included as well, such as routines for Group Policy backup, DNS zone updates, information retrieval and Wake-on-LAN packet generation. The scripts are intentionally separated by concern so that individual configuration steps can be reviewed, composed and executed independently depending on the target machine, deployment scenario or administrative policy.

For more information on PowerShell itself, refer to Microsoft's official PowerShell Documentation. Existing scripts may also serve as implementation examples for composing new automation routines or reusing the shared functionality provided by lib.

✨ TL;DR

# initialize the project (download dependencies)
.\winkit.ps1 init
# also: .\winkit.ps1 initialize | setup | bootstrap

# format all PowerShell source files
.\winkit.ps1 format
# also: .\winkit.ps1 fmt | fix

# check formatting without modifying (CI / pre-commit)
.\winkit.ps1 format -Check

# run PSScriptAnalyzer lint checks
.\winkit.ps1 lint
# also: .\winkit.ps1 check | analyze

# build distribution archives (ZIP + tar.gz)
.\winkit.ps1 build
# also: .\winkit.ps1 bundle | package

# ─── Example scripts ────────────────────────────────

# show comprehensive system information
.\scripts\Show-SystemInfo.ps1

# apply a system configuration profile
.\scripts\Configure-System.ps1

# remove Windows bloatware
.\scripts\Remove-Bloatware.ps1

# enable the Windows Sandbox feature
.\scripts\Enable-WindowsSandbox.ps1

# 'sudo' usage example, if not using sudo.ps1 (from microsoft/sudo)
sudo pwsh -File .\scripts\Install-WindowsUpdates.ps1 -Profile Recommended -DryRun

# display full parameter documentation
help .\scripts\Configure-Privacy.ps1

πŸ”ƒ Contributing

Contributions are welcome via GitHub's Pull Requests. Fork the repository and implement your changes within the forked repository, after that you may submit a Pull Request. Refer to our documentation for contributors for contributing guidelines, commit message formats and versioning tips.

πŸ“₯ Maintainers

This project is owned and maintained by Ad Noctem Collective refer to the AUTHORS or CODEOWNERS for more information. You may also use the linked contact details to reach out directly.

©️ Copyright

Assets provided by: Microsoft Corporation

About

πŸ“š An MIT-licensed library of PowerShell scripts built on a core PowerShell module

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Contributors