Skip to content

Releases: RobertasTa/temp-cleaner

v1.4 - Senos sistemos pedsakai

Choose a tag to compare

@RobertasTa RobertasTa released this 20 Sep 16:49

What's new in v1.4 — the old system disk that says what it is

Someone takes the system disk out of an old computer, puts it into an
enclosure, and plugs it in. Every space tool then tells them the same useless
truth: the space adds up. It does — every file on that drive is counted.
What none of them says is that those files are the leftovers of a Windows that
has not booted in years, sitting on a drive their owner now thinks of as
storage.

The Disk — where did the space go window now recognises that drive.

It shows a list of traces, not a verdict. Windows registry, the Windows
folder, user profiles, Windows.old, pagefile.sys, hiberfil.sys — whatever
is actually there, named one by one. A drive may have been half-cleaned
already, and a list shows that by itself, where a single verdict would hide it.

Three limits it does not cross:

  • On your system drive it says nothing at all. The drive you booted from is
    supposed to look like this.
  • No action, no button, nothing to click. The window has never deleted
    anything and still does not.
  • No sizes. How much space those leftovers take is a question Windows
    already answers with its own tools; adding our own number would invite the
    one thing this window refuses to do.

Dual boot was the case that could have made it lie. A second working
Windows on another drive looks exactly like an abandoned one. So: if a profile
on that drive was used within the last 60 days and no strong trace — a registry
hive, a page file — is present, the window stays quiet. When the strong traces
are there it speaks, but it says out loud that this may be a second working
system, and leaves the reading to you.

It also tells you when the drive was last used, taken from the profile
itself, because a date does more to settle the question than any wording we
could choose.

Scanning, preview, cleaning and every safety guard — AGE / LOCKED / JUNCTION
and the blue "found it, suggesting nothing" rule — are untouched. Everything
added here lives in the two files the Disk window already uses; the main window
changes by one line, the version number.

Files

file what it is
TempCleaner-1.4-setup.exe installer — no admin rights, installs into your user profile
TempCleaner.exe the program itself, single file, nothing installed

winget install RobertasTa.TempCleaner will bring v1.4 once the manifest is
merged.

v1.3 — Kur dingo vieta

Choose a tag to compare

@RobertasTa RobertasTa released this 17 Sep 06:15

What's new in v1.3 — a second window that adds up four separate accounts of your disk

A disk has at least four independent sources of truth about its own size, and
none of them knows about the other three:

source what it says where it comes from
the drive itself its physical size the drive's own geometry
the partition table how much of the drive is used by partitions at all the partition entry
the file system used and free GetDiskFreeSpaceEx
our scan how much we actually found in files this program

Most tools show one of these and say nothing about the rest. The new
Disk — where did the space go window puts all four next to each other and
points at the places where they disagree, because the answer is usually in a
gap rather than in any single number.

Each gap has its own list of suspects, and the window names them:

  • drive larger than the sum of its partitions → unallocated space, a hidden
    partition, a factory area (HPA/DCO)
  • partition larger than used + free → file-system accounting
  • used larger than what we found → files we are not allowed to see, or files
    we missed

The pie has five slices — data, system files, junk, free, and
unexplained. The last one is the point of the whole window: thin is
reassuring, thick shows you the problem before you have read a single word.

This window changes nothing on your disk. It reads, adds up and explains.
Every repair it mentions is something you do yourself, with a named tool.

It tells you what it could not see. Every scanner silently skips folders it
has no rights to, paths longer than 260 characters, and locked files — and then
prints a total as if it were complete. This one reports its own blind spot
instead of hiding it, and you can see at a glance whether the unexplained slice
is a real mystery or simply the part we were not allowed to read.

No administrator rights, and no request for them. This was the one thing
that could have sunk the feature, and it was measured rather than assumed:
opening a volume or a physical drive for reading is refused without elevation,
but opening it with zero desired access succeeds, and the metadata calls we
need read no data at all. So the drive and partition figures are available to
an ordinary user. File-level items that genuinely require elevation
(pagefile.sys, hiberfil.sys, shadow copies) are not claimed — they are part
of what the window openly calls "system files" and does not itemise.

If the numbers still make no sense, you can take them to someone who knows.
The window writes everything it measured into a plain text report — the four
accounts, every gap, and what was unreadable — so you can hand it to a
technician or paste it into an assistant instead of trying to describe the
problem from memory.

The Disk button stays greyed out until you have run a scan. Our own scan is
one of the four accounts; without it the window would be comparing three
numbers and guessing at the fourth.

Nine fixes from one live test. The first person to use this window was not
the person who wrote it, and everything he tripped over is fixed: the window no
longer refuses to be made smaller; it says "partition" where it used to say
"volume"; partitions without a drive letter have their own legend entry; the
reread button says what it rereads; the heading names the drive you are looking
at; "everything adds up" now says what adds up to what; right-clicking a term
highlights it before searching, and searches technical terms in English, where
the answers are.

Scanning, preview, cleaning and every safety guard (AGE / LOCKED / JUNCTION /
the blue "found it, suggesting nothing" rule from v1.2) are untouched. The
seven lines this feature adds to the existing window are a button, its state, a
signal, the handler and the version number; everything else lives in two new
files.

Files

file what it is
TempCleaner-1.3-setup.exe installer — no admin rights, installs into your user profile
TempCleaner.exe the program itself, single file, nothing installed

winget install RobertasTa.TempCleaner will bring v1.3 once the manifest is
merged.

v1.2 — Sprendžiate jūs

Choose a tag to compare

@RobertasTa RobertasTa released this 12 Sep 14:35

What's new in v1.2 — a fourth colour, and two things that were quietly broken

The program now finds folders it refuses to suggest touching.

A measurement on a real machine showed this cleaner was about to offer three
locations it must not: a Synology sync folder holding 1,018,504 files, Autodesk
Inventor logs, and a cache being written to at that very moment. Deleting those
would not just free space — it could break a running sync or a paid tool
someone works in.

The traffic light keeps three colours, because they say what the program
suggests. The fourth one, BLUE, says the opposite: found it, suggesting
nothing, you decide.
Blue folders never enter "Clean all". You can still
clean one on its own, behind its own warning.

A folder turns blue for one of three reasons:

  • it is a sync folder (Synology, OneDrive, Dropbox…),
  • it belongs to paid software (Autodesk, Adobe, JetBrains…),
  • it is being written to right now.

The first two come from name lists that are deliberately incomplete — no list
knows every program in the world, and we say so instead of pretending
otherwise. The third needs no list, and it is the one that caught all three
cases above.

The threshold was measured, not chosen. Across 474 locations on a real
machine, "at least one file younger than a day" marked 22 folders — including a
browser cache holding six fresh files that is perfectly safe to clean. At
twenty files it marks six, and they are the right six. A percentage rule was
dropped: the sync folder's fresh files are 8 % of a million, so any percentage
would have missed the main target. The 11.6 GB package cache that no built-in
tool sees stays yellow, exactly as before.

Two repairs:

  • The "?" button now opens the instructions in the published build. Both
    README files were missing from the packaged executable, so the help was
    silent in both languages. Thirty-one automated checks never caught it,
    because they run from source, where those files sit right there.
  • Table rows are readable in a dark system theme. A cell that sets only its
    background inherits white text from the theme and vanishes on our light row
    colours. Every cell now sets both colours.

Scanning, preview, cleaning and all safety guards (AGE / LOCKED / JUNCTION) are
unchanged. The test suite gained two checks: every table cell must carry both
colours, and blue must never reach "Clean all".

A note on the first version of that colour check: it stayed green even with
the fix reverted, because a Qt cell with no colour set returns a default brush
rather than nothing. It now asks the item data directly, and both new checks
were verified by reverting the fix and watching them fail.

Files

file what it is
TempCleaner-1.2-setup.exe installer — no admin rights, installs into your user profile
TempCleaner.exe the program itself, if you prefer a single portable file

SHA-256:

TempCleaner.exe            0b2e39f8e81e599616b7b7ac589dda569b7c6419dcf62347bc5d9e51888b2a51
TempCleaner-1.2-setup.exe  2e739ea1c09003e70febc9f1c1b00e62990d05cb7ece267d565521fa11bdbb49

Windows SmartScreen will greet an unsigned program with a blue window — click
"More info" → "Run anyway". The README explains how to verify the download
yourself before you do.

Idea credit: Robertas — the blue colour was born from his own machine, where
the three dangerous suggestions showed up. Built, measured and documented by
Claude.

v1.1 — What is this?

Choose a tag to compare

@RobertasTa RobertasTa released this 16 Aug 12:04

What's new in v1.1 — "What is this?"

Ordinary users often have no idea what half the programs living in their
Temp/AppData folders actually are. Now the cleaner can tell you:

  • Right-click any row -> "What is this?" — for known programs your
    default browser opens the vendor's official page (offline knowledge
    base with 66 curated entries, every URL verified). For unknown ones —
    a Google search with just the program's name.
  • Privacy by design: only the program/vendor folder name goes into
    the search query — never the full path, never your username. The
    network is used only when you explicitly click.
  • The same menu also offers Copy path and Open folder.
  • One exe for both languages — the UI language (English / Lithuanian)
    now switches inside the app; first run follows your Windows language.
  • "?" help corner — About dialog and an in-app user guide, including
    "Ask the AI that wrote it" instructions.

Nothing else changed — scanning, preview, cleaning and all safety guards
(AGE / LOCKED / JUNCTION) are untouched and covered by the same test
suite (now 31 new unit tests + live GUI test on a synthetic tree).

Also new in the repository: docs/COMPARISON_TEST.md —
a reproducible live comparison protocol vs Storage Sense and CCleaner,
including the points where they win.

Idea credit: Robertas — born from watching real users squint at yellow
rows. Built, tested and documented by Claude.


SHA256 (TempCleaner.exe):
14C3CD21943C2B0101B5942BCB3E1864C8948419672FC3A4C12F2CEF63DF12EC

Changelog

## v1.1 (2026-08-16)
- NEW: "What is this?" right-click menu — vendor page for known programs
  (offline 66-entry knowledge base), Google search for unknown ones;
  privacy-safe (program name only, never paths/username).
- NEW: "Copy path" and "Open folder" context menu actions.
- NEW: one exe for both UI languages (in-app switcher, follows OS language).
- NEW: "?" help corner with About + in-app guide.
- Docs: honest "Do you even need this?" in all plain-text guides;
  reproducible COMPARISON_TEST.md protocol.
- Internal: zinynas.py module (zero Qt, fully unit-tested), 31 new tests.

Temp Cleaner v1.0

Choose a tag to compare

@RobertasTa RobertasTa released this 10 Aug 10:46

First public release of Temp Cleaner — a Windows temp-file cleaner for people who want to see and understand what happens before anything is deleted.

Highlights

  • Colour-coded safety: GREEN locations are safe to clean with one button, YELLOW are cleaned only one-by-one with confirmation, RED are view-only (never touched).
  • Dry-run preview — see exactly what would be deleted, down to a per-folder breakdown, before deleting anything.
  • Age limit slider (1–30 days) with live recalculation — only files older than the limit are ever deleted.
  • Every skipped file is explained (AGE / LOCKED / JUNCTION) and every action lands in a plain-text audit log.
  • Portable mode — a checkbox moves all working files next to the exe (marker TempCleaner_portable.txt), leaving no traces on the computer.
  • LT / EN switchable in-app (one exe); plain-text guides also in Russian.
  • No ads, no telemetry, no network access. Open source, MIT.

Download

TempCleaner.exe (~37 MB, portable, no installation, no admin needed)

SHA-256: F2FFBC9BBF1003184909334DDFEE13D8481C666EDAD9139E8DE298D3DA8CD2F2

Requires Windows 10 or newer (64-bit). The exe is unsigned — SmartScreen may show "Windows protected your PC" on first run: click More info → Run anyway. If your antivirus is suspicious of an unsigned PyInstaller exe, the full source is in this repository and you can build it yourself in minutes.

Who made this

Written, tested and maintained by Claude (Anthropic AI); published by Robertas. Questions? Paste this repo's link into claude.ai with your question — the AI will read the actual code and answer. Any language works.