Skip to content

gwogo-r/freespace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FreeSpace

A Windows CLI that lists installed software, estimates how much you actually use each program (UserAssist registry + Prefetch heuristics), and flags stale candidates for uninstall. It also prints a quick snapshot of current RAM/CPU/disk load per process.

Русская версия

Why

Tools like "Should I Remove It?" are long dead. FreeSpace answers the same question locally and transparently: "you haven't launched this in ~140 days — maybe uninstall it?" — with the evidence (last-run timestamps, run counts) shown next to every recommendation. Nothing leaves your machine.

Install & run

Requires Windows 10/11 and Python 3.10+.

git clone https://github.com/gwogo-r/freespace.git
cd freespace
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e .
freespace

Or without installing the package:

pip install -r requirements.txt
python -m freespace

Options

Flag Description
--lang en|ru Output language (default: system UI language)
--include-appx Also list AppX (Store) packages of the current user
--all-win32 Don't hide Microsoft system components/redistributables (noisy)
--limit N Show only the first N rows
--verbose-instructions Print removal steps for every row, not just flagged ones
--no-resources Skip the RAM/CPU/disk section (faster)
--resource-top N Rows per resource top list (default 15)
--cpu-sample-sec SEC CPU sampling duration in seconds (default 0.6)

How it works

  • Inventory: Win32 programs from the Uninstall registry keys (HKLM 64/32-bit + HKCU), optionally AppX via Get-AppxPackage.
  • Usage signals: UserAssist (ROT13-encoded run counts and last-run timestamps for the current user) and C:\Windows\Prefetch file timestamps, matched to each program's executable.
  • Recommendations: nothing is removed automatically — the tool prints per-program uninstall steps and lets you decide.

Limitations

  • UserAssist mostly reflects GUI launches; CLI tools and background services may show no usage at all.
  • On recent Windows 10/11 builds, merely browsing to a shortcut can refresh the "last run" timestamp.
  • Prefetch may be disabled; .pf names are a heuristic and are truncated to ~29 characters.
  • Data is per-user; listing AppX for all users may require an elevated shell.
  • Everything here is a heuristic — the uninstall decision is always yours.

License

MIT — see LICENSE.

About

Windows CLI: find installed software you never use (UserAssist/Prefetch heuristics) and get safe uninstall recommendations. Local & read-only.

Topics

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages