## 1. Project Overview & Quickstart (ChrisTitusTech/winutil)

# Chris Titus Tech's Windows Utility

[](https://github.com/ChrisTitusTech/winutil/releases/latest)

[](https://discord.gg/RUbZUZyByQ)

A curated compilation of Windows system tasks streamline **installs**, debloat with **tweaks**, troubleshoot with **config**, and configure **Windows updates**. Run it fresh on every new Windows install.




---

## Quick Start

> **WinUtil must be run as Administrator** Because it performs system-wide changes.

Open PowerShell or Terminal as admin, then run:

**Stable Branch (recommended)**
```ps1
irm https://christitus.com/win | iex
```

**Development Branch**
```ps1
irm https://christitus.com/windev | iex
```

### How to open an admin terminal

- **Start menu:** Right-click Start → *Windows PowerShell (Admin)* or *Terminal (Admin)*
- **Search:** Press the `Windows key`, and type `PowerShell` or `Terminal`, then `Ctrl + Shift + Enter`

---

## Automation / Presets

Apply a predefined configuration without manual selection:

```powershell
& ([ScriptBlock]::Create((irm https://christitus.com/win))) -Preset Standard
```

| Preset | Description |
|--------|-------------|
| `Standard` | Balanced defaults for most users |
| `Minimal` | Minimal changes to suit every user |
| `Advanced` | Deep tweaks for power users |

To view exactly what each preset does, see:
https://github.com/ChrisTitusTech/winutil/blob/main/config/preset.json

---

## Build & Develop

See https://github.com/ChrisTitusTech/winutil/blob/main/.github/CONTRIBUTING.md

---

## Resources

- [Official Documentation](https://winutil.christitus.com/)
- [YouTube Tutorial](https://www.youtube.com/watch?v=6UQZ5oQg8XA)
- [ChrisTitus.com Article](https://christitus.com/windows-tool/)
- [Known Issues](https://winutil.christitus.com/knownissues/)
- [Report an Issue](https://github.com/ChrisTitusTech/winutil/issues)

---

## Support

- Leave a ⭐ to show support!
- Faster Dotnet Implementation for sale here: https://www.cttstore.com/windows-toolbox

## Sponsors

These are the sponsors that help keep this project alive with monthly contributions.

[](https://github.com/ysaito8015)[](https://github.com/dwelfusius)[](https://github.com/mews-se)[](https://github.com/jdiegmueller)[](https://github.com/robertsandrock)[](https://github.com/paulsheets)[](https://github.com/djones369)[](https://github.com/anthonymendez)[](https://github.com/FatBastard0)[](https://github.com/DursleyGuy)[](https://github.com/DwayneTheRockLobster1)[](https://github.com/KieraKujisawa)[](https://github.com/seanh1995)[](https://github.com/Abs313a)[](https://github.com/kydoa)[](https://github.com/hafiz-muhammad)

---

## Contributors

[](https://github.com/ChrisTitusTech/winutil/graphs/contributors)

Thanks to everyone who has contributed time and effort to this project. Keep rocking 🍻

## 2. Official Technical Reference & Guides (ChrisTitusTech/website)

# Christitus.com

The source for [christitus.com](https://christitus.com), built as a fully static
Astro site and deployed with Cloudflare Pages.

## Requirements

- Node.js 24
- npm

Install the exact dependency tree and run the complete local gate:

```bash
npm ci
npm run validate
```

Development commands:

```bash
npm run dev          # production-eligible content only
npm run dev:content  # include draft and future content locally
npm run build        # static output in dist/
npm run preview      # serve the production artifact
```

Focused validation is available through `npm run check`, `npm test`,
`npm run test:browser`, `npm run test:browser:webkit`, and
`npm run test:lighthouse`. Historical article Markdown is excluded from broad
formatting and Markdown-lint rewrites; source, configuration, migration docs,
and the post template remain enforced.

## Create a post

The repository scaffolder is the Astro equivalent of a Hugo archetype. In an
interactive terminal, omit categories to choose from the complete numbered
list:

```bash
npm run new:post -- "My new article"
```

For non-interactive use, pass one or more exact category names:

```bash
npm run new:post -- "My new article" \
  --category Linux \
  --category "Software Dev"
```

The command renders `templates/post.md.tmpl` into
`content/posts/<year>/<slug>.md`, defaults the post to `draft: true`, and
refuses file, URL, redirect, static-asset, taxonomy, feed, or pagination
collisions. The available categories are Android, ChromeOS, Development,
FreeBSD, Hardware, Linux, MacOS, Misc, Networking, Software Dev, Titus,
Virtualization, Windows, Windows Server, and YouTube.

Set the featured image at `static/images/<year>-thumbs/<slug>.webp`, edit the
generated front matter and body, then preview drafts with `npm run dev:content`.

## Repository layout

- `src/` contains Astro pages, layouts, components, styles, and browser code.
- `content/` contains articles and standalone page Markdown.
- `static/` is copied directly into the published site.
- `data/livestreams.json` and `static/chats/` are maintained by Python
  automation and a managed pull-request workflow.
- `scripts/` contains content preparation, validation, the post scaffolder, and
  data automation.
- `tests/` contains unit, route-contract, and browser coverage.
- `SPEC.md` and `ROADMAP.md` record the migration contract and cutover gates.

Cloudflare production cutover, repository-rule activation, and the first live
managed-data PR are separate guarded operations documented in Phase 5 of
`ROADMAP.md`.