Shadowed's Windows Tool Kit (WTK)

A modern Windows maintenance toolkit focused on repairs, optimization, diagnostics, privacy, security, and backup automation through a clean GUI.

---

Table of Contents

• Overview
• Categories and Features
• App Configuration
• How It Works
• Install and Run
• Build to EXE
• Automatic Backups
• Contributing & Feedback
• Important Warnings
• Credits
• License

---

Overview

Shadowed's WTK is a Windows 10/11 utility that groups advanced system actions into clear categories and runs them from a single interface.

Highlights

• Modern UI built with customtkinter
• Multi-language UI support
• Automatic app restart when language changes
• State persistence (settings.json) for config, section, window geometry, and latest outputs
• Developer console logging (CHANGE, INFO, WARN, ERROR)
• Automatic backup snapshots before sensitive system changes
• Portable EXE build via build_exe.bat

---

Categories and Features

1) System

• SFC/DISM/Windows Update repair workflows
• Enable blocked tools (gpedit, regedit, CMD)
• Store, RDP, Installer repair helpers
• Access to key admin consoles (msconfig, compmgmt, eventvwr)

2) Performance

• Temp/cache cleanup
• Power plan tuning (Balanced, High, Ultimate)
• Visual effects optimization
• SSD TRIM optimization
• Optional hibernation disable

3) Network

• Winsock/IP/IPv6/DNS reset
• IP renew, firewall reset, proxy reset
• DNS switchers (Google/Cloudflare)
• Diagnostics (ipconfig, netstat, ping)

4) Privacy

• Telemetry and tracking reduction
• Ads/activity/Cortana/location/camera/microphone controls
• Clipboard sync / WER / OneDrive related tweaks

5) Devices

• Audio/USB/Bluetooth/HID/spooler quick fixes
• Device and driver utility shortcuts

6) Diagnostics

• Full system diagnostic report generation
• TXT export

7) Security

• Defender quick scan and signature update
• Custom file/folder scan
• Firewall, active users, startup checks

8) Backup

• User files backup
• Registry export
• Restore point actions
• WinRE emergency script generation

9) Config

• Sounds, notifications, confirmation toggles
• Developer mode (visible console + logs)
• Interface language selector
• Restart options

10) Info

• Live hardware/software/network summary panel

---

App Configuration

The app persists data into settings.json:

• cfg: language, sounds, notifications, confirmations, dev mode
• ui: active section and window geometry
• results: latest diagnostics and info output

State is saved automatically on close and at key mutation points.

---

How It Works

1. UI loads the active section.
2. Actions are executed through an internal task runner.
3. Command outcomes are normalized as:
   • OK
   • WARN (expected Windows 10/11 differences, non-critical cases)
   • ERROR
4. Before sensitive operations, a backup snapshot is created.
5. Language changes can trigger save + safe app restart.

---

Install and Run

Requirements

• Windows 10 or Windows 11
• Python 3.10+ (for script mode)
• Administrator privileges recommended for advanced tasks

Run from source

pip install customtkinter pillow
python windows_toolkit.py

Basic usage

1. Run as Administrator (recommended).
2. Open a category.
3. Execute a task.
4. Review status/toasts and optional dev console logs.

---

Build to EXE

Use the included batch script:

build_exe.bat

What it does

• Verifies Python
• Installs required dependencies
• Generates version metadata + manifest
• Builds with PyInstaller
• Outputs dist\ShadowedWTK.exe
• Copies EXE to Desktop

Keep temp files (debug)

set KEEP_TEMP=1
build_exe.bat

---

Automatic Backups

Before sensitive system modifications, snapshots are created under:

• backups/WTK_YYYYmmdd_HHMMSS

Snapshot content includes:

• Action metadata and command list
• Relevant registry exports
• powercfg and bcdedit state dumps
• Current app settings copy
• Restore point creation attempt

---

Contributing & Feedback

If you encounter any issues or have ideas to improve Shadowed’s Windows Tool Kit, please let me know!

🐛 Report a Bug

If the tool crashes or something isn't working as expected:

1. Go to the Issues tab.
2. Click on New Issue.
3. Select the Bug Report template and fill in the details (OS version, steps to reproduce, etc.).

🚀 Suggest a Feature

Have an idea for a new Windows tweak or tool?

1. Open a New Issue.
2. Select the Feature Request template.
3. Describe how the new feature would work and why it would be useful.

❓ Support

If you just have a question about how to use the toolkit, feel free to use the Question / Support template in the Issues section.

---

Important Warnings

⚠️ WARNING: This tool can execute system-level operations that may alter Windows behavior.

⛔ RISK: Performance/privacy tweaks can disable services or features depending on Windows edition/build.

✅ BEST PRACTICE: Keep backups and create a restore point before applying broad changes.

Recommendations

• Prefer Administrator mode.
• Apply changes in small batches.
• Reboot when prompted by specific actions.
• Use Dev Mode logs for troubleshooting.

---

Credits

• Author: Shadowed
• Tech stack: Python, CustomTkinter, PIL, PyInstaller

---

License

Add a LICENSE file (MIT recommended) before public release.