OneDrive Helper v0.9.0 (card popups, logo, finish locked fixes at next sign-in)

Warning

Not yet fully tested on Remote Desktop (RDS) session hosts, including multi-host farms with FSLogix, Azure Virtual Desktop and Citrix. Take extra care there: pilot it on one host or a small group first, and keep v0.8.2 to roll back to. Full testing will be done in the next few days and these notes will be updated. To leave out the new sign-out behaviour entirely, set RestartToFinish to 0.

New

• Card popups instead of Windows message boxes. Every question and message (the fix confirmation and its result, the administrator approval, contact details, "What does this mean?", and the settings tool's messages) now uses the same style of card as the alerts. Long messages scroll with the mouse wheel; warnings and errors have a Copy text button for support tickets.

• Company logo. New setting LogoFile. Pick a PNG in the settings tool (250 x 75 pixels works well; at most 2000 x 1000 and 2 MB) and it's shown at the top of every card. Export writes it as logo.png next to the settings file; install --config copies it to %ProgramData%\OneDriveHelper\logo.png. The RMM install script on the project page has an optional $LogoBase64 line.

• Locked files: finish the fix at the next sign-in. When a folder is skipped because a program won't let go of a file, the user is offered:

  • on a single-user workstation: Restart now / Restart later / Not now
  • on Remote Desktop, Azure Virtual Desktop (including Windows multi-session), Citrix, VMware Horizon, FSLogix, or with someone else signed in: Sign out now / Sign out later / Not now

  At their next sign-in OneDrive Helper finishes the fix by itself, as the user, before they open anything, with no second administrator approval. The request is saved in the user's profile, so with roaming or FSLogix profiles it's picked up on whichever session host they land on. It expires after 3 days. New setting RestartToFinish (on by default) and events 5014 (restart or sign-out requested) and 5015 (fix finished after signing in again).

• Recovery report. A fix that doesn't finish cleanly (a folder put back, kept aside, partly removed, or recovered after an interruption) leaves RECOVERY-REPORT.txt next to the backups. It says where each folder is, where its backup is, and which copy has the user's latest edits. A new fix always gets its own folders, so it never overwrites an earlier backup.

Testing

• New automated tests: a fix process killed after the backup copy and then recovered, a backup disk filling up mid-copy, reruns not treating OneDrive Helper's own folders as broken, and the restart / sign-out logic.
• A manual release checklist is in docs/release-checklist.md. It hasn't been completed for this release yet; it will be over the next few days.

Upgrading

Run OneDriveHelper.exe install from the new zip, or re-run the RMM install script on the project page, which is updated for this release. Your settings carry over.

Downloads

File	For
OneDriveHelper-v0.9.0-x64.zip	Most PCs (Intel / AMD 64-bit)
OneDriveHelper-v0.9.0-arm64.zip	Windows on ARM
SHA256SUMS.txt	Checksums to verify the zips

These binaries are not code-signed yet. You're welcome to build from source instead with .\release.ps1 -Version 0.9.0.