gitwtfhub

wtf is gdid-guard?

rroy676/gdid-guard — explained in plain English

Analysis updated 2026-05-18

20PowerShellAudience · generalComplexity · 2/5Setup · moderate

TL;DR

A Windows PowerShell tool that audits and reduces exposure from Microsoft's device tracking identifier, with a restore script to undo changes.

Mindmap

mindmap
  root((GDID-Guard))
    What it does
      Audits device identifier exposure
      Reduces telemetry exposure
      Restores previous settings
    Tech stack
      PowerShell
      Windows Registry
      Windows Firewall
    Use cases
      Check current exposure
      Disable tracking features
      Compare snapshots
      Undo a remediation
    Audience
      Privacy conscious users
      Windows power users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Check what identifiers and settings currently expose your device to Microsoft's device graph.

REASON 2

Disable the Connected Devices Platform and related tracking features on a Windows machine.

REASON 3

Compare a saved snapshot against your current settings to see what changed.

REASON 4

Undo a previous remediation using the companion restore script if you change your mind.

What's in the stack?

PowerShell

How it stacks up

rroy676/gdid-guardisraleche/spicetifymanagerkiendt91/video-mix-with-codex
Stars201919
LanguagePowerShellPowerShellPowerShell
Setup difficultymoderateeasyhard
Complexity2/52/53/5
Audiencegeneralgeneralvibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Windows 10 or 11 with PowerShell 5.1 or newer, administrator rights are required for the remediation and restore scripts.

No license information was found in the explanation provided.

Wtf does this do

GDID-Guard is a Windows privacy tool for checking and reducing exposure from the Global Device Identifier system, an identifier Windows assigns when a device signs into a Microsoft Account and registers into Microsoft's device graph through a background feature called the Connected Devices Platform. It falls into the same category as tools like O&O ShutUp10++, but focuses specifically on this one identifier chain rather than telemetry in general. The main script offers a read only audit mode that reports the current state of the relevant service, settings, identity cache, and firewall rules without changing anything. It can also save a timestamped snapshot of that state to compare against later, and a compare mode that shows exactly what changed between two snapshots. A separate remediation mode, which requires administrator rights, applies fixes you choose individually: disabling the Connected Devices Platform, turning off Activity History, clearing the local identity cache, or blocking known endpoints at the firewall level. Before making changes it creates a Windows System Restore point and automatically saves a snapshot of the state beforehand, and every action gets written to a log file. A companion restore script can undo each of those changes individually or all at once, using the saved pre change snapshot where possible. The project also ships a plain text list of known device graph hostnames that can be dropped into tools like Pi-hole or AdGuard as a custom blocklist. The README is upfront about the limits of the approach. Disabling the Connected Devices Platform trades away features like cross device Activity History sync and parts of Phone Link. If the device stays signed into a Microsoft Account, Windows can still assign a new identifier the next time it registers with the device graph, since the identifier is issued by Microsoft's servers rather than only stored in local settings. IP based firewall rules can also go stale if Microsoft changes the addresses behind the relevant hostnames, so the author suggests DNS level blocking as a more durable option. The tool requires Windows 10 or 11 and PowerShell 5.1 or newer, with administrator privileges needed for the remediation and restore scripts.

Yoink these prompts

Prompt 1
Explain what the Global Device Identifier and Connected Devices Platform actually do on Windows.
Prompt 2
Walk me through running GDID-Guard's audit mode safely before making any changes.
Prompt 3
What features would I lose on Windows if I disable the Connected Devices Platform with this tool?
Prompt 4
How does GDID-Guard's snapshot and restore system let me undo a remediation later?

Frequently asked questions

wtf is gdid-guard?

A Windows PowerShell tool that audits and reduces exposure from Microsoft's device tracking identifier, with a restore script to undo changes.

What language is gdid-guard written in?

Mainly PowerShell. The stack also includes PowerShell.

What license does gdid-guard use?

No license information was found in the explanation provided.

How hard is gdid-guard to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is gdid-guard for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.