Skip to content

FileOrganizer.UI v0.2.0 — WinUI 3 shell preview

Choose a tag to compare

@SysAdminDoc SysAdminDoc released this 30 Apr 23:33
· 261 commits to main since this release

FileOrganizer.UI v0.2.0 — WinUI 3 shell preview

First public preview of the new C# / .NET 8 / WinUI 3 desktop shell that
will eventually replace the legacy PyQt6 GUI. The shell mirrors the
UniversalConverterX layout (side-tab NavigationView, dark Steam palette
with a cyan accent) and calls into the existing Python core via NDJSON
sidecar scripts. The Python core (v8.x) is unchanged and keeps doing
the AI / classification / dedup / photo work.

This release is parallel to the Python v8.x line — install it alongside,
not instead of, an existing FileOrganizer install.

Live in v0.2.0

Page Status Wraps
Home Live
Organize Live organize_run.py (--stats / --preview --quiet / --validate)
Cleanup Live cleanup_run.py (six progressive scanners)
Files Placeholder fileorganizer/files.py
Duplicates Placeholder fileorganizer/duplicates.py
Photos Placeholder fileorganizer/photos.py
Watch Placeholder fileorganizer/workers.py
Toolbox Placeholder asset_db.py · classify_design.py · organize_run.py

Cleanup ships all six scanners: empty folders, empty files, temp/junk,
broken/corrupt (magic-byte check + optional ZIP/TAR validation), big
files (size threshold), and old downloads (last-accessed-N-days).
Results stream live, cancellation kills the child Python process tree.

Download

FileOrganizer-UI-v0.2.0-win-x64.zip — self-contained Windows x64 build
(WinUI 3 + Windows App SDK runtime bundled, ~64 MB compressed / ~160 MB
extracted). Includes the Python sidecars + fileorganizer/ package so
the live pages have what they need to run.

SHA256: 6A124B774788D7213D77791E31AA21B992579EC5B93534612EF6A91682CC75D1

Run

  1. Extract the zip anywhere.
  2. Make sure Python 3.10+ is on PATH, or drop a .venv\Scripts\python.exe
    next to the scripts at the extract root, or set %FILEORGANIZER_PYTHON%.
  3. python -m pip install -r requirements.txt once.
  4. Double-click shell\FileOrganizer.exe.

The shell auto-detects the sidecar scripts by walking up from the
executable until it finds organize_run.py.

Caveats

  • Unsigned. Windows SmartScreen may warn on first launch.
  • Self-contained: no separate .NET 8 runtime install needed.
  • Python 3.10+ is still required for the live pages (Organize, Cleanup).
  • The legacy PyQt6 GUI (python -m fileorganizer) keeps working in
    parallel until the WinUI 3 shell reaches feature parity.

Build from source

git clone https://github.com/SysAdminDoc/FileOrganizer.git
cd FileOrganizer
pwsh src/build.ps1                    # Debug
pwsh src/build.ps1 -Configuration Release

The script wraps VS 2026 MSBuild because bare dotnet build fails on the
.NET 10 SDK + WindowsAppSDK 1.5 AppX/PRI task path on this Windows box.

Source

Tag: ui-v0.2.0 · Commit: 54b7b42 (Cleanup wired)