LegacyUpdate/README.md

64 lines
7.2 KiB
Markdown
Raw Normal View History

2022-10-13 00:34:13 -04:00
# [<img src="https://legacyupdate.net/socialbanner.png" alt="Legacy Update">](http://legacyupdate.net/)
2022-10-06 11:14:47 -04:00
2023-01-15 11:26:55 -05:00
[![wakatime](https://wakatime.com/badge/github/kirb/LegacyUpdate.svg)](https://wakatime.com/badge/github/kirb/LegacyUpdate)
2023-10-25 23:50:12 -04:00
[![Build](https://github.com/kirb/test/actions/workflows/build.yml/badge.svg)](https://github.com/kirb/test/actions/workflows/build.yml)
2023-01-15 11:26:55 -05:00
2022-10-06 11:14:47 -04:00
Since Windows XP was discontinued in 2014, followed by Windows 7 in 2020, Microsofts support for their earlier OSes has significantly dwindled. As XP and earlier dont officially support modern security improvements, such as the SHA256 hash algorithm required by modern SSL and Authenticode certificates [as of 2019](https://support.microsoft.com/en-us/topic/2019-sha-2-code-signing-support-requirement-for-windows-and-wsus-64d1c82d-31ee-c273-3930-69a4cde8e64f), much of the internet has become inaccessible to these devices. Adding insult to injury, Microsoft [actively removed](https://techcommunity.microsoft.com/t5/windows-it-pro-blog/sha-1-windows-content-to-be-retired-august-3-2020/ba-p/1544373) many downloads for XP and earlier versions in 2020. In effect, working with these OSes is now incredibly difficult.
To address this, [**Legacy Update**](https://legacyupdate.net/) hosts a patched instance of the Windows Update website. This works because the original Windows Update website simply accesses an ActiveX control that connects to the Windows Update service running on your computer.
2022-10-13 00:34:13 -04:00
> *If this website helped you to update your old PCs, please consider [leaving a tip](https://github.com/sponsors/kirb) to help me pay for the server costs. Thank you!*
2022-10-06 11:14:47 -04:00
2023-10-25 23:50:12 -04:00
## Download
Download the latest version from the [Releases](https://github.com/kirb/LegacyUpdate/releases) page of this repo, or from [**legacyupdate.net**](https://legacyupdate.net/).
You can also download the [latest nightly build](https://nightly.link/kirb/LegacyUpdate/workflows/build/main/artifact.zip), based on the current development work. Nightly builds are not guaranteed to be stable, and unlike release builds, require at least Windows 2000 SP4 or Windows XP SP2. If youre not sure what to download, you probably want the [stable release](https://legacyupdate.net/).
2022-10-06 11:14:47 -04:00
## The ActiveX Control
2023-01-24 20:15:40 -05:00
This repo hosts an ActiveX control used as a replica of the original one developed by Microsoft for the official Windows Update website. The original version of Legacy Update required using a proxy autoconfiguration file (.pac) and some additional configuration of IE security settings to intercept requests to the **update.microsoft.com** site, because the Microsoft Wuweb.dll control validates that it is being used on the official update.microsoft.com domain. With the custom Legacy Update ActiveX control, proxying is no longer required, because we have full control over the validation logic. This also allows adding additional convenient features not possible with JavaScript alone.
2022-10-06 11:14:47 -04:00
2022-10-13 00:34:13 -04:00
### Building
The project can be built on any version of Windows from XP to 11, though if you run a later OS youll ideally want to set up an XP VM for testing.
You will need to install:
* [Visual Studio](https://visualstudio.microsoft.com/vs/) - select the following individual components:
* C++ Windows XP Support for VS 2017 (v141) tools
* C++ ATL for v141 build tools (x86 & x64)
* [Visual Studio 2008](https://my.visualstudio.com/Downloads?q=Visual%20Studio%20Express%202008%20with%20Service%20Pack%201&pgroup=) for compiling a build that works on XP RTM and 2000 SP4 - not required if you only want to build for XP SP2 and later
* [NSIS](https://nsis.sourceforge.io/)
2023-01-24 20:15:40 -05:00
In `setup/` you will need to download the following additional files:
2022-10-13 00:34:13 -04:00
* A copy of updroots.exe, which you can extract from [this update](http://download.windowsupdate.com/d/msdownload/update/software/secu/2015/03/rvkroots_3f2ce4676450c06f109b5b4e68bec252873ccc21.exe) using 7-Zip or extract.exe.
2023-01-24 20:15:40 -05:00
Ive already bundled copies of the NSIS plugins [w7tbp](https://nsis.sourceforge.io/TaskbarProgress_plug-in) (Windows 7+ taskbar progress bar feature - zlib license), [FindProc](https://nsis.sourceforge.io/FindProcDLL_plug-in) (checks if a process is running - ? license), and my fork of [NSxfer](https://github.com/kirb/nsis-nsxfer) (file downloader - zlib license).
2022-11-13 20:34:46 -05:00
### Testing
For debugging, if running on XP with IE8, install [Utilu IE Collection](https://www.utilu.com/iecollection/). IE6/IE7 is much more useful for debugging the native code, because of its simplistic single-process model. Visual Studio is able to launch it and directly attach to the process the code is running in.
To configure the debugger:
2023-01-24 20:15:40 -05:00
1. Right click LegacyUpdate in the Solution Explorer &rarr; Properties
2022-11-13 20:34:46 -05:00
2. In the Debugging tab, set the Command field to:
* For system IE install: `$(ProgramW6432)\Internet Explorer\iexplore.exe`
* For Utilu IE6 RTM: `$(ProgramW6432)\Utilu IE Collection\IE600\iexplore.exe`
* For Utilu IE6 SP2: `$(ProgramW6432)\Utilu IE Collection\IE600XPSP2\iexplore.exe`
* For Utilu IE7: `$(ProgramW6432)\Utilu IE Collection\IE700\iexplore.exe`
3. Set the Command Arguments field to `http://legacyupdate.net/windowsupdate/v6/`, or any other URL you want to use for debugging
4. If running on XP, in the Debugger tab, set Register Output to Yes.
2023-01-24 20:15:40 -05:00
If running on Vista or later, this will throw a permission denied error due to UAC. Youll need to manually register the control using `regsvr32 LegacyUpdate.dll` in an administrator command prompt.
2022-10-13 00:34:13 -04:00
## Website source code
I havent yet open sourced the website. This is because the vast majority of it is Microsoft code - just with a handful of patches Ive made to remove Microsoft trademark branding, switch it to the Legacy Update ActiveX control, and make some slight bug fixes/improvements. It doesnt feel appropriate to put an open source license on something I dont own. However, if you would like to review it, you can right click &rarr; View Source on the website and take a poke around, mainly in the JavaScript files. You might find [DebugBar](https://www.debugbar.com/download.php) and [CompanionJS](https://www.my-debugbar.com/wiki/CompanionJS/HomePage) (requires Visual Studio or standalone [Microsoft Script Debugger](https://web.archive.org/web/20131113042519/http://download.microsoft.com/download/7/7/d/77d8df05-6fbc-4718-a319-be14317a6811/scd10en.exe)) useful.
Ive tinkered with writing a [ground-up replacement](https://twitter.com/hbkirb/status/1584537446716350466) of the Microsoft-developed Windows Update website, which Ill open source when I feel its ready for public use (there are currently a number of bugs and missing features).
2022-10-06 11:14:47 -04:00
## Disclaimer
The existence of this project shouldnt be taken as an endorsement to continue using unsupported OSes. You should stick to a supported OS such as Windows 10 or 11 (or, try Linux?!). However, this service exists anyway in recognition that using these OSes is sometimes necessary to run legacy hardware/software, or just interesting to play around with.
This project is not affiliated with or endorsed by Microsoft. This software is provided “as is”, without warranty of any kind. We dont believe anything should go wrong, but please ensure you have backups of any important data anyway.
## License
Licensed under the Apache License, version 2.0. Refer to [LICENSE.md](https://github.com/kirb/LegacyUpdate/blob/main/LICENSE.md).