How tweaks work
Every tweak is built from three files:| File | Purpose |
|---|---|
meta.json | Defines the tweak’s name, description, category, risk level, and other properties |
apply.ps1 | Contains the PowerShell commands that make the change |
unapply.ps1 | Reverses the change (present only for reversible tweaks) |
apply.ps1. When you toggle it off, it runs unapply.ps1.
Some tweaks don’t have an
unapply.ps1. These show an Apply button instead of a toggle, because the change cannot be automatically reversed.Toggle vs. Apply button
Sparkle uses two controls depending on whether a tweak is reversible:- Toggle — The tweak has both
apply.ps1andunapply.ps1. You can turn it on and off at any time. The toggle reflects the current applied state. - Apply button — The tweak has only
apply.ps1. Clicking Apply runs the script once. There is no automatic way to undo the change.
Modal warnings
Some tweaks show a confirmation dialog before running. The modal displays the tweak name and a plain-language explanation of what will change. You must confirm before the script executes. This applies to both toggles and Apply buttons when the tweak’smodal property is set.
Categories
Tweaks are grouped into categories so you can quickly find what you need:General
Broad system tweaks and common settings.
Appearance
Visual changes like dark mode, taskbar layout, and clock format.
Performance
System optimizations that improve speed and responsiveness.
Privacy
Disabling telemetry, tracking, and data collection.
Gaming
Optimizations for FPS, game services, and GPU settings.
Network
TCP/IP tuning, DNS, and network latency improvements.
GPU
Graphics driver and hardware-accelerated scheduling settings.
Risk levels
Every tweak has a risk level so you know what to expect before applying it.| Risk | Meaning |
|---|---|
| Safe | Low risk. These changes are unlikely to cause problems. Most tweaks fall into this category. |
| Caution | May affect system behavior or certain apps. Review the tweak description before applying. |
| Risky | Can significantly change system behavior. Apply with care and create a restore point first. |
Searching and filtering tweaks
The Tweaks page provides two ways to narrow down the list:- Search bar — Type any part of a tweak’s name or description to filter results in real time. The counter in the top right shows how many tweaks match.
- Category buttons — Click a category pill to show only tweaks in that group. Select All to clear the filter.