UUP dump app essay

UUP dump app

"UUP dump app" is a UUP dump project that runs locally on your machine
You can get any build with it, but very old builds are dead on the MSFT side and it's not possible to get those builds even with an older database archive
UUP dump Discord server: https://discord.gg/yVRbtb2

The "website" code is located in the "uup-dump" folder
The "website" config file location is "uup-dump\config.ini"
The "JSON API" code is located in the "uup-dump\json-api" folder
The "UUP dump API" code is located in the "uup-dump\api" folder
The very limited "standalone" copy is located in the "uup-dump\sta" folder
The build database consists of "fileinfo" and "packs" folders inside the "uup-dump" folder

Some options in the "uup-dump\config.ini" config file:
allow_corpnet - this option allows you to check internal non-downloadable builds, works only with the MSIT channel
show_render_time - this option displays page rendering statistics in the lower left corner of the web page
proxy - this option allows you to use HTTP proxy, for example: proxy=127.0.0.1:50555

You can move the "uupdump-get.cmd" and "uupdump-run.cmd" scripts to the root folder if you do not want to use the "uupdump-aio.cmd" script

In short, you should run the server with the prefered script and then add some builds to your database


1. How to run it

"UUP dump app" download links:
https://mega.nz/folder/YoAFAY6S#YK8llN-X4wi3fyumy_Zbxw
https://app.mediafire.com/r2j3lzhhghsv6
https://pixeldrain.com/l/zHAzrL4G

Download and extract the "uupdump-x64-v1.7.1-r7.7z" or "uupdump-x64-v1.7.1-r7.7z" archive to any folder without Unicode symbols in the path
Then use the "uupdump-aio.cmd" or "scripts\uupdump-run.cmd" script to start the server. The Apache HTTP Server is much faster and more stable
If for some reason you can't run the Apache HTTP Server, you could try the built-in PHP web server, but it is very slow and not reliable in a local network environment

Some scripts features won't work if there are Unicode symbols in the path to the UUP dump app, and this is a PHP problem
x64 version is for 64-bit Windows OS only
x86 version is for both 32-bit and 64-bit OS, on 64-bit systems it should be slower than the x64 version


PHP and the Apache HTTP Server require Microsoft Visual C++ Redistributable Runtimes, you can get it from MSFT or use any reliable AIO Repack

MSFT links:
https://aka.ms/vs/17/release/vc_redist.x86.exe
https://aka.ms/vs/17/release/vc_redist.x64.exe

AIO Repack by abbodi1406:
https://github.com/abbodi1406/vcredist

If you are having problems with VC++ Redist, try to remove it with the /aiR switch in the AIO Repack, then reinstall it


You can edit the "uupdump-aio.cmd" and "uupdump-run.cmd" scripts options using Notepad++:
serverrun - changes the local server start mode
autorun - automatically launches the website in your default web browser
uimode - switches website to Dark or Light mode on startup
browser - changes the default web browser, also works with portable web browsers


2. How to automatically add the latest builds to your database

If you want to get the latest builds then just use the "uupdump-aio.cmd" or "scripts\uupdump-get.cmd" script. Run the "Start detecting new builds" option and wait ~10 minutes
All data is from Windows Update, so your results may vary depending on the CDN and availability of the service in your area. Normally you should get ~40 build entries on the first few runs

Windows Insider program is banned in Russia / Belarus, use VPN to get around this restriction or you'll only get Retail builds
If the Windows Update service is busy, just rerun the "Start detecting new builds" option several times, expect some errors in the log. Use VPN if you can't get it to work in your location

If Windows Update is blocked on your machine, you won't be able to get builds from MSFT into your database
To get it to work you should check your host file (C:\Windows\System32\drivers\etc\hosts) and remove any MSFT related stuff
If that doesn't help, check (or disable) your firewall, or try it on another machine

If you do not want to get builds for all architectures (x86, amd64, arm64) or for all channels (Retail, RP, Beta, Dev, Canary) then just change the script options
The "MSIT {Internal Corpnet}" channel is excluded from the ALL channel by default


You can edit these scripts and modify the detected builds, or enable autorun of the local server, etc.

Let's break down builds checker example in the "uupdump-get.cmd" script:
call :dAll Retail "19044 1202 125"

:dAll - architecture, :dAll = x86, x64, arm64. You can find more values at the end of the script
Retail - channel (or ring), some supported values: Retail, ReleasePreview, Beta, Dev, Canary, MSIT. Read more in the "UUP dump API" documentation
19044 - build version
1202 - Cumulative Update version (19044 1202 means build 19044.1202 if you don't get it)
125 - SKU, edition of the build (125 is the "Enterprise LTSC" edition)

Some SKU values:
101 - Home
48 - Pro
121 - Education
4 - Enterprise
72 - Enterprise Evaluation
125 - Enterprise LTSC
129 - Enterprise LTSC Evaluation
119 - Team
7 - Server Standard
8 - Server Datacenter
406 - Azure Stack HCI
407 - Server Datacenter Azure Edition


As mentioned above, the build database consists of "fileinfo" and "packs" folders
Simply speaking, the "fileinfo" data is builds and the "packs" data is Metadata for each build
By default the "Start detecting new builds" option is getting both "fileinfo" and "packs" data

If you only need the new builds then disable the "Generate packs" option
If you only need to generate metadata for all or manually added builds then go to the "Generate all packs" menu and run the "Start generating all packs" option


3. How to add the latest builds to your database manually

There are several ways to do this, the first of which is the "Quick Options" block on the website home page
Just click on the any architecture button (x64, arm64 or all) next to your chosen channel and you should get the latest build in ~10 seconds

If you want to get a public Preview build on the "Retail" channel then you should check that build on the "Release Preview" channel instead
"Quick Options" should work with any 22621+ client build, so if you want to get a Windows 10 build, this isn't your method
You will need to generate metadata for your manually added builds: run the "uupdump-aio.cmd" or "scripts\uupdump-get.cmd" script and use the "Start generating all packs" option in the "Generate all packs" menu


Another way to manually add the latest builds is to use the "+ New build" feature on the website. The logic is the same as in the "uupdump-aio.cmd" or "scripts\uupdump-get.cmd" scripts
In most cases it's sufficient to check only base builds, for example: 19045.1, 22000.1, 22621.1, 22631.1 and so on
You will still need to manually generate metadata for each added build. Again, run the "uupdump-aio.cmd" or "scripts\uupdump-get.cmd" script and use the "Start generating all packs" option in the "Generate all packs" menu


4. How to add any old build to your database manually

If you want to get any old build and do not have an archive of builds in your database, this section is for you

You can add any exact build on the "+ New build" page on the website with "thisonly" flag
It is possible to edit the "uupdump-aio.cmd" or "scripts\uupdump-get.cmd" scripts and use it instead, but this is not an efficient way so let's focus on the "+ New build" page on the website

Example of manually adding build 22621.1848 on the "+ New build" page on the website:
x64 / amd64 | Retail | 22621.1848+thisonly | Pro --> Next

Generate metadata for your added builds using the "Start generating all packs" script option


5. How to get a very large builds archive and add it to your database

The builds archive should be located in the same cloud folder as the UUP dump app
Download and extract the archive file "Builds archive - Oct 19, 2023.7z" and move its contents to the "uup-dump" folder
Warning: Archive is very heavy and takes about ~10 Gb. of space after extraction


Alternatively you can run the "scripts\uupdump-download-archive-aria2.cmd" script which should download the latest builds data from Github using aria2
Advanced users can use git to clone and update "fileinfo" and "packs" repos using the "scripts\uupdump-download-archive-git.cmd" script

Keep in mind that builds data on Github is not updated regularly, you can find the unofficial repos here:
https://github.com/EverchangerL/fileinfo - UUP dump file information repository
https://github.com/EverchangerL/packs - UUP dump packs repository


6. How to check non-downloadable internal builds

It's possible to check some internal builds with the UUP dump app. You can't download any internal build without MSFT VPN so this section is pointless

Easy way:
Run the "uupdump-aio.cmd" or "scripts\uupdump-get.cmd" script, change "Channel" option to the "MSIT {Internal Corpnet}" and run the "Start detecting new builds" option


Manual way:
Edit the "uup-dump\config.ini" config file and enable the "allow_corpnet" option (allow_corpnet=true)
After that use the "+ New build" feature on the website to check some builds with "corpnet" flag

It's also possible to combine the "thisonly" and "corpnet" flags separated by a comma
If the "thisonly" flag is not present then you can try to fetch any base build (19045.1+corpnet, 22621.1+corpnet, 22631.1+corpnet and so on) or a slightly older build
If the "thisonly" flag is active then you should try to fetch the exact internal build number (for example 22631.2424+thisonly,corpnet)


The MSIT channel can also be useful without the "allow_corpnet" option: it allows you to skip the in-place upgrade in Windows Update and get some of the latest EOL builds


7. How to use JSON API

If you know what JSON API is and want to use it then this section is for you

First, start the server. Then add some builds to your database using any method
After that generate metadata for your added builds using the "Start generating all packs" script option

Try to open http://127.0.0.1:44715/json-api/listid.php link in your web browser to make sure everything is working correctly


8. How to run the local server in your local network environment (Apache HTTP Server only)

If you want to get access to the UUP dump website or JSON API from your another device on your local network then simply edit the "apache\conf\httpd.conf" config file:
Listen 127.0.0.1:44715 --> Listen 44715

Change port or your internal IP if you want
Warning: Do not host anything on any public network, this local server is not designed for that

You may want to run the Apache HTTP Server as a service using the "scripts\apache-service-aio.cmd" script


9. Linux & macOS support

Download the "uupdump-x64-v1.5.2.7z" archive and get the UUP Dump website source code from the "uup-dump/website" folder
Host this website on any web server, you can use the PHP built-in server if you don't want to use anything else
For the JSON API to work properly, you should set the environment variable: websiteDir=".."
Dependencies: 7-Zip, PHP 8 + curl, zip, xml extensions