Skip to content

UXL Launcher Version 3.4 Release Candidate 1

Pre-release
Pre-release
Compare
Choose a tag to compare
@DrewNaylor DrewNaylor released this 06 Oct 04:17
· 81 commits to master since this release

UXL Launcher Version 3.4 Release Candidate 1 Changelog

Released on 10/6/2020 (MM/DD/YYYY).

Only three-ish months after version 3.3, UXL Launcher Version 3.4 is ready for the release candidate stage. If all goes well, two weeks from now the stable version will be released.

Before I get into the main paragraph, this version fixes a security vulnerability where the officeDriveLocation could be set to something like https://google.com/search?q=, which would result in the user being sent to a Google search for whatever app they clicked on, or worse. This is now fixed, and I highly recommend updating to this version. It should be safe to update to the release candidate version as there shouldn't be too many changes between now and the final. There will be a 3.3.1 update published for those who want a stable version with this fix. While most people probably wouldn't run into that issue, it's still something that needs to be solved as the config file the app ships with could be modified too; it's not just the one in LocalAppData that's a concern.

This time, other than that last-minute security fix, the main focus was on re-arranging stuff in the Options window so that the options that probably would be used the most are easier to access. Many controls in the Options window had their text changed to be more specific with what they're for, as well. With the end of support for Office 2010, the defaults have been updated to be Office 2019 with 64-bit Office on 64-bit Windows (or 32-bit Office on 32-bit Windows), as Microsoft now recommends 64-bit Office with Office 2019. Besides that, there are a few other new features and changes that may be of interest. Please be sure to read the Readme included with this version of UXL Launcher or online as it has important info. Also refer to the System Requirements.

If you're reading this in Notepad or another text editor, it displays best in Word Wrap view. Click on Format>Word Wrap on the top bar. Notepad++ users will find it under View>Word Wrap. Word Wrap is automatically done if viewing on GitHub or on the website.

Hashes

You can use Windows PowerShell to confirm the hash of the main UXL Launcher EXE file by running
Get-FileHash .\UXL-Launcher.exe -Algorithm SHA256 in the folder you extracted the archive to and comparing the output to my sum listed below. HowToGeek has a nice article on this, but the Windows section is a bit further down on the page.

7-Zip also has a way to check file hashes in the CRC SHA dropdown in the file context menu. This project is not associated with 7-Zip.

To check the hash for other files, replace UXL-Launcher.exe with the appropriate file.

SHA-256 sum for "UXL-Launcher.exe" in the archive:
3FDB90F24EBFD512AE39436EE6A038E0D2954BE9FA5C996DB7CB7AEFA617CF15

SHA-256 sum for "lib\libscrollswitchtabs.dll" in the archive:
423A65849280D1F9665AD03094DD8648482E889CD4FA0F7AA4CA7AE8F087C7A7

SHA-256 sum for "UXL-Launcher.exe.config" in the archive:
6893BB5389DA7FFB63961CA35B4C7892B627181894F20950D93149277114CB7D

SHA-256 sum for "UXL-Launcher_v3.4-RC1.exe" (the installer attached to this release):
6BDB1255C54D5FAE08A60DFFE2C5A9C2C4BDB668F8584537B2356BCD7AAAE12F

Added

  • New theme: ProDark (issue #185)
    • Description: Dark theme meant to resemble Office 2019's "Black" theme. The colors may not match exactly as they were eyeballed from the colors used in Word 2019. This theme is not associated with Microsoft, and Microsoft Office is a copyright and trademark/registered trademark of Microsoft Corporation in the United States and other countries.
    • This is the new default dark theme used when matching the Windows 10 theme settings (see below).
  • You can now choose which dark theme UXL Launcher uses when set to match the Windows 10 theme settings by changing the Dark theme for system theme matching dropdown under Tools>Options>Theme (previously Personalization). (issue #186, pull request #192)
    • Current choices are Maudern, ProDark, and TenDark. Anything else will be set to ProDark and will not be displayed in the Options window dropdown, unlike the theme list dropdown.
    • PortableThemeEngine also gained this feature and was bumped to version 2.1, while the built-in theme engine was bumped to version 1.04. No other theme engine changes are in this version, so themes won't have to change their theme engine runtime version numbers if people don't want to, but I did anyway.
    • If you want to specify the dark theme for system theme matching when using PortableThemeEngine, you'd set libportablethemeengine.ThemeEngine.DarkThemeForSystemThemeMatching to one of the options above. Anything not in that list will be set to ProDark. Once the dark theme is applied, the property will automatically be reset to ProDark in case you want to go back to the default dark theme in the same session without specifying it again.
    • PortableThemeEngineDebugger may be of use to people who want to experiment with this feature, though you'll have to build it yourself as a binary isn't provided.
  • Tabs in the Options and About windows can now be switched between using the mouse scroll wheel. This functionality is provided by libscrollswitchtabs, part of the drews-libs project.
  • In case you decline migrating settings on the first startup of an application upgrade, you can now migrate them at any time using the Migrate settings button under Tools>Options...>Maintenance. (issue #178)
    • NB: This will overwrite your current settings, so use caution.
    • It'll only work if you're running the program from the same place as the previous version.
    • This feature may be useful for people using the Zip file version as, by default, that one doesn't ask to migrate settings on first startup even if there's a UXL_Launcher folder in LocalAppData. It'll have to be extracted to the same place to work as the previous list item states, though.
    • After migrating, the app will restart automatically.
  • Any time a setting requires an application restart (for now, only turning on or off the theme engine), a messagebox will pop up asking the user if they want to restart now. (issue #177)
    • If this message is declined, it won't pop up again during that session even if the theme engine is turned on or off multiple times in that session.
    • Description from the commit:
    Allow the user to restart the application if the theme engine is turned on or off. This'll prevent the "test settings"
    messagebox from showing up if they do restart, but that's intended since there could be other things that would
    influence the results at a later point. If the user clicks "No", they won't be bothered to restart for the rest of the
    session.
    

Changed

  • Many of the controls in the Options window have been moved around (some across tabs) and had their text changed to better explain what they do. See pull request #190 for more details.
    • Switched the tabs for Bypass configured location and the Office drive location (now simply Root drive path) (issue #73)
    • Instead of requiring users to type in the drive letter they installed Office to, they can now select it from a dropdown of all drives that are "ready".
      • If they change the drive letter manually in the config file, it'll show up in the list, but changing it to something else and saving settings will get rid of it.
      • Please be aware that this means arbitrary drive letters can no longer be placed into the drive letter box as only drives Windows determines as "ready" are available. This is what was originally intended, so it's no big loss.
      • Arbitrary drive letters can still be used by modifying the config file, but if the location is unavailable, a warning label will show up below the dropdown.
      • If you plug in a drive after opening the Options window, you can click the Refresh button next to the dropdown to have it show up in the dropdown as long as it's ready. (issue #191)
    • Controls and groupboxes have been resized and repositioned so they look better. One major example of this is on the Theme tab, where the theme details textbox has been moved to the right side and the checkboxes and other controls have been moved to the left side.
    • The theme details textbox is now slightly taller.
    • Now the Enable Office 365/Click-to-Run Compatibility checkbox is hidden if Office 2019 is selected, since it's irrelevant for that version.
    • Tab text update:
    • Enable Office 365/Click-to-Run Compatibility checkbox has been changed to Enable Office 365/Click-to-Run Compatibility [line break] (Always enabled for Office 2019 and above)
    • Since 64-bit Office is the default for Office 2019 when downloaded from the Office website, there were changes in the Root Path tab:
      • 64-bit Windows is now Program Files (x86): 32-bit Office on 64-bit Windows
      • 32-bit Windows is now Program Files: 64-bit Office on 64-bit Windows, [line break] 32-bit Office on 32-bit Windows, or 32-bit Office 2013 from Office 365
      • Program Files: 64-bit... is the new default, since 64-bit Office is now the default download as mentioned above.
      • The description and recommended selection labels have been updated to accommodate this change.
      • Due to Microsoft recommending 64-bit Office 2019 by default when downloading from Office.com, the setting cpuIsSixtyFourBit now defaults to False instead of True. The name would have been changed, but that doesn't allow for easily migrating settings between versions.
      • More details (issue #184)
    • Match Windows 10 theme checkbox text has been changed to Match system theme and its tooltip now references the Dark theme for system theme matching dropdown.
  • Instead of using 32-bit Mode or 64-bit Mode in the titlebar, we'll now display PF Mode or PF-x86 Mode since that's more accurate to what's going on.
  • Office 2019 (16nomsi) is now the default version of Office in the Office version selector dropdown and the userOfficeVersion setting.
  • Tab indexes have been improved so that the buttons at the bottom of the Options window go from right to left instead of left to right. This means that the Save button will be reached first instead of Defaults, for example.
  • If (Custom) is selected in the theme list dropdown and there's nothing in the custom theme path textbox, the theme description textbox will now display, "You can use a custom theme by clicking Browse... and picking a custom theme file from the file system or by pasting the custom theme path in the custom theme path textbox."
  • The strings with "private" in their names that were used in the Office Locater code have been removed and the public strings are being modified instead. This'll help optimize things.
  • Some apps are passing the value of My.Settings.bypassConfiguredLocationForAllApps directly to the isolated error handler to reduce code duplication. (issue #188)
  • When the custom theme path textbox is empty, the theme details textbox now has info on what to do to use a custom theme.

Fixed

  • Security vulnerability: It used to be possible to change My.Settings.officeDriveLocation to something like https://google.com/search?q=, which would take users to a Google search. This has been fixed by checking the length of the setting, and if it's not equal to 1, changing it back to C before using it on startup.
  • Bug: "match system theme" checkbox doesn't block the custom theme controls from being used if "(Custom)" is selected in the dropdown. (issue #194)

Removed

  • Deleted the future change notice from the Options window since it's implemented now.

Deprecation/future change notices

  • TE1.x/UXL Launcher Theme Engine will be deprecated sometime after support for TE2.x/PortableThemeEngine is introduced, and UXL Launcher 4.0 will fully remove support for TE1.x. Estimated deprecation timeline; may be changed at any moment:
    • TE1.x full support; TE2.x gains features to match what TE1.x can do <-- You Are Here
    • TE2.x support introduced; TE1.x is still the default but can be switched to using TE2.x via the UI
    • TE2.x becomes the default; TE1.x is deprecated but support is still available and can be used again through the UI
    • TE2.x is still the default; TE1.x is still available, but the UI to switch back to it is removed so you'll have to edit the config file instead
    • TE1.x support is fully removed; only TE2.x remains