Skip to content

v1.0.0

Latest
Latest

Choose a tag to compare

View all tags
@seto77 seto77 released this 04 Aug 15:10
v1.0.0
91b5f6a

The first release. Reclaim OneDrive for Business storage without admin rights, by moving old
file versions to the recycle bin. No app registration, no Client ID.

Getting started

  1. Download OneDriveVersionCleaner-win-x64.zip and unpack it wherever you like
  2. Run OneDriveVersionCleaner.exe

There is no installer. The .NET runtime is bundled, so it runs on a machine with no .NET
installed. Nothing is written to the registry or to Program Files. To remove it, delete the
folder you unpacked — settings and logs live separately, in
%LOCALAPPDATA%\OneDriveVersionCleaner\.

The exe is not Authenticode signed, so SmartScreen warns on first run.

Get-FileHash .\OneDriveVersionCleaner-win-x64.zip -Algorithm SHA256
b3c87fdc3ddb00d86bcd72f236f4a9d009a4281d1ac48e21b7d179d68bf6188d

Requirements

  • Windows
  • The Microsoft Edge WebView2 runtime (already present on Windows 11)
  • OneDrive for Business (a work or school account), synced

What it does

  • Walks your OneDrive folder and lists past versions largest first
  • Select several with Shift or Ctrl and move them to the recycle bin in one go
  • Narrow the targets by rules: versions kept, age, file size, total history size
  • Export the analysis to CSV and JSON
  • Record every deletion as JSON Lines
  • English and Japanese interface, switchable from the menu at any time, no restart needed

What it will not do

These are deliberately not implemented:

  • Deleting a file itself
  • Deleting the current version
  • Permanent deletion — nothing bypasses the recycle bin, so everything stays restorable from the web
  • Deleting without a record — if the log cannot be opened, nothing is moved

Before you point it at real data

Confirm the behaviour on a small test folder first. This tool deletes version history. A
step-by-step procedure is in
RESTART_TEST_INSTRUCTIONS.md
(Japanese).

Known limitations

  • Your own OneDrive only. SharePoint team sites, Teams libraries and shared shortcuts are out of scope
  • One run asks the service about at most 1,000 files by default. Whatever does not fit is left for a
    later run — the largest are asked about first — so repeat the scan until the status line stops
    reporting files left for the next run
  • The grid shows the largest 5,000 rows. The CSV and JSON exports contain everything
  • There is no resuming an interrupted run
  • Items in the recycle bin still count against your quota. To actually get the space back, empty the
    recycle bin afterwards

Disclaimer

The author accepts no liability for any damage arising from the use of this software.

Assets 4
Loading