Repository navigation
1.0.1
Release Notes - Program Manager v1.0.1
Overview
Version 1.0.1 is a bug fix release that replaces the Windows program scanner's PowerShell-based .lnk parser with a pure Python implementation. The previous approach caused severe usability issues on Windows.
Bug Fixes
Windows Program Scanner Rewritten (Critical)
- Problem: The "Scan for Programs" feature spawned a separate PowerShell process for every
.lnkshortcut in the Start Menu. A typical Windows installation has 100+ shortcuts, resulting in hundreds of visible console windows that stole focus and rendered the system unusable during scanning. - Fix: Replaced with a pure Python binary parser that reads the MS-SHLLINK format directly using
struct. Scanning is now instant with zero subprocess calls and zero visible windows. - Supports both ANSI and Unicode string encoding in
.lnkfiles - Extracts target path, icon location, and working directory from raw bytes
- Falls back to relative path when LinkInfo has no local base path
Build Script References Updated
- Updater's
find_build_script()now looks forbuild.ps1instead of the removedbuild.cmd - Updater's
run_build_script()invokes PowerShell with-ExecutionPolicy Bypass -Fileinstead ofcmd /c - Documentation references updated in README.md and CLAUDE.md
Build Scripts Modernized
build.shand newbuild.ps1now mirror s3browser's build logic:- Auto-create and activate
.venvif not in a virtual environment - Install dependencies and PyInstaller automatically
- Exclude unused PyQt6 modules to reduce binary size
- Create
~/binif it doesn't exist and install the built executable there
- Auto-create and activate
build.cmdreplaced bybuild.ps1(PowerShell) for Windows- Windows build handles in-use executable via rename-before-copy
Test Suite
- 95 tests (up from 88 in v1.0.0), all passing
- Added 7 tests for the
.lnkbinary parser:- Valid file with target path
- Icon location extraction
- Relative path fallback when no LinkInfo
- Corrupt file handling (too small, bad header)
- Missing file handling
- ANSI string mode
Files Changed
Added
build.ps1- Windows build script (PowerShell, replacesbuild.cmd)
Modified
progman/utils/scanner.py- Pure Python.lnkparser replacing PowerShell subprocess callsprogman/utils/updater.py- Referencesbuild.ps1and invokes via PowerShellbuild.sh- Full-featured build with venv management and~/bininstalltests/test_scanner.py- Added.lnkbinary parser testsREADME.md- Updated build script referencesCLAUDE.md- Updated build script references
Removed
build.cmd- Replaced bybuild.ps1
Known Limitations
- macOS icon extraction returns
.icnspaths which Qt may not render on all platforms - GitHub API rate limit: 60 requests/hour for unauthenticated access (sufficient for 7-day check interval)
- The
.lnkbinary parser covers standard Shell Link formats; exotic or malformed shortcuts created by non-standard tools may not parse correctly (they are silently skipped)