elie/Fido
1
0
Fork 0
mirror of https://github.com/pbatard/Fido.git synced 2025-09-16 14:18:02 +02:00
Code Issues Packages Projects Releases Wiki Activity

Update Readme

Browse Source 
* Fix typos, improve style, etc.
This commit is contained in:
Pete Batard
2019-07-14 00:04:12 +01:00
parent e4645bfabc
commit b0599d7a94
1 changed files with 37 additions and 31 deletions
Download Patch File Download Diff File Expand all files Collapse all files

68
README.md
View File

@@ -7,26 +7,32 @@ Fido: Full ISO Download Script (for Windows retail ISOs)
Description Description
----------- -----------
Fido is a PowerShell script that is primarily designed to be used in [Rufus](https://github.com/pbatard/rufus) but that Fido is a PowerShell script that is primarily designed to be used in [Rufus](https://github.com/pbatard/rufus), but that
can also be used in standalone fashion, and that automates access to the official Windows retail ISO download links. can also be used in standalone fashion, and whose purpose is to automate access to the official Microsoft Windows retail
ISO download links.
We decided to create this script because, while Microsoft does make retail ISO download links freely and publicly This script exists because, while Microsoft does make retail ISO download links freely and publicly available (at least
available on their website (at least for Windows 8 and Windows 10), it only does so after actively forcing users to for Windows 8 and Windows 10), it only does so after actively forcing users to jump through a lot of unwarranted hoops,
jump through a lot of unwarranted hoops, that create an exceedingly counterproductive, if not downright unfriendly, that create an exceedingly counterproductive, if not downright unfriendly, consumer experience and that greatly detract
consumer experience, which greatly detracts from what people really want (direct access to ISO downloads). from what people really want (direct access to ISO downloads).
As to the reason one might want to download Windows __retail__ ISOs, as opposed to the ISOs that can be generated by As to the reason one might want to download Windows __retail__ ISOs, as opposed to the ISOs that are generated by
Microsoft's own Media Creation Tool (MCT), this is because it is only with an official retail ISO that one can assert Microsoft's own Media Creation Tool (MCT), this is because using official retail ISOs is currently the only way to
with complete certainty whether its content has been altered in any way or not. Indeed, retail Microsoft's ISOs are the assert with absolute certainty that the OS content has not been altered. Indeed, because there only exists a single
only ones you will be able to obtain an official SHA-1 for (from sites [such as this one](https://msdn.rg-adguard.net/public.php)) master for each of them, Microsoft retail ISOs are the only ones you can obtain an official SHA-1 for (from MSDN, if you
allowing you to be 100% certain that the image you are using is non corrupted and safe to use. have access to it, or from sites [such as this one](https://msdn.rg-adguard.net/public.php)) allowing you to be 100%
sure that the image you are using has not been corrupted and is safe to use.
This, in turn, offers assurance that the content __YOU__ are using to install your OS, and which it is indeed critical This, in turn, offers assurance that the content __YOU__ are using to install your OS, which it is indeed critical to
to validate beforehand if you care about security, does matches bit for bit the one that Microsoft officially released. validate beforehand if you have the slightest concern about security, does match, bit for bit, the one that Microsoft
released.
On the other hand, because no two MCT ISOs are the same (due to MCT always regenerating the ISO content on the fly) On the other hand, regardless of the manner in which Microsoft's Media Creation Tool produces its content, because no
it is impossible to get the same kind of assurance from non-retail ISOs. Hence the need to provide users with a much two MCT ISOs are ever the same (due to MCT always regenerating the ISO content on the fly) it is currently impossible to
easier and less restrictive way to access official retail ISOs... validate with absolute certainty whether any ISO that was generated by the MCT is safe to use. Especially, unlike what
is the case for retail ISOs, it is impossible to tell whether an MCT ISO may have been corrupted after generation.
Hence the need to provide users with a much easier and less restrictive way to access official retail ISOs...
License License
------- -------
@@ -45,31 +51,31 @@ redirect you __away__ from the pages that allow you to download retail ISOs):
* https://www.microsoft.com/software-download/Windows10ISO * https://www.microsoft.com/software-download/Windows10ISO
After visiting those with a full browser (Internet Explorer, running through the `Invoke-WebRequest` PowerShell Cmdlet), After visiting those with a full browser (Internet Explorer, running through the `Invoke-WebRequest` PowerShell Cmdlet),
to confirm that they are accessible queries web APIs on the Microsoft servers to first request the language selection to confirm that they are accessible, the script then queries the web API from the Microsoft servers to first request the
available for the for the version of Windows that was selected, and then the download links for the various architecture language selection available for the version of Windows selected by the user, and then request the actual download links
enabled for that version + language combination. for all the architectures available for that specific combination of version + language.
Requirements Requirements
------------ ------------
PowerShell 3.0 or later is required. But the script does detect if you are using an older version and points you to the PowerShell 3.0 or later is required. However the script will detect if you are using an older version and point you to
relevant PowerShell 3.0 download page if needed, which should only be the case if you are running a vanilla version of the relevant PowerShell 3.0 download page if needed (which should only ever occur if you are running a vanilla version
Windows 7. of Windows 7).
Also, because Internet Explorer is being used behind the scenes, if you haven't gone through the first time setup for Also, because Internet Explorer is being invoked behind the scenes, if you haven't gone through the first time setup for
Internet Explorer, you may receive an error about it when running the script. If that is the case, then you need to Internet Explorer, you may receive an error about this when running the script. If that is the case, then you should
make sure that you manually launch IE at least once and complete the setup. make sure that you manually launch IE at least once and complete the setup.
Note that, if running this script elevated, this annoyance can be avoided by using the `-DisableFirstRunCustomize` Note however that, if you are running the script elevated, you can work around the above annoyance by using the
option (which basically __temporarily__ creates the key of the same name in the registry __if__ it doesn't already `-DisableFirstRunCustomize` option which basically __temporarily__ creates a key of the same name in the registry __if__
exist, to bypass that behaviour). it doesn't already exist, to bypass the first time setup error.
Additional Notes Additional Notes
---------------- ----------------
Because of it's intended usage with Rufus, this script is not designed to cover all possible retail ISO downloads, but Because of its intended usage with Rufus, this script is not designed to cover every possible retail ISO downloads.
mostly those that the general public are likely to use. For instance, we currently have no plan to add support for Instead we mostly chose the ones that the general public is likely to request. For instance, we currently have no plan
LTSB/LTSC Windows 10 ISOs downloads. to add support for LTSB/LTSC Windows 10 ISOs downloads.
If you are interested in such downloads, you are kindly invited to visit the relevant download pages from Microsoft If you are interested in such downloads, then you are kindly invited to visit the relevant download pages from Microsoft
such as [this one](https://www.microsoft.com/evalcenter/evaluate-windows-10-enterprise) for LTSC versions. such as [this one](https://www.microsoft.com/evalcenter/evaluate-windows-10-enterprise) for LTSC versions.