MinGW Distro - nuwen.net

Download

My MinGW distribution ("distro") is x64-native and currently contains GCC 13.2.0 and Boost 1.84.0.

mingw-19.0.exe (60.5 MB) : This is a self-extracting archive. It's incredibly easy to install; see How To Install below.

My build scripts are available on GitHub, and they're also stored within the distro itself.

I recommend installing 7-Zip, gh, and git; I don't bundle them in the distro anymore.

Contents

The components of this distro fall into these categories:

• Essentials: The components of MinGW itself. They are required in order to run GCC.
• Libraries: Useful C and C++ libraries.
• Utilities: Programs used by programmers.

* With jpegtran.

** With pcre2grep.

What MinGW Is

I recommend that anyone who is learning Standard C++ and who uses Windows for a primary development environment should use two compilers: the most modern version of Microsoft Visual C++ and the most modern version of GCC, the GNU Compiler Collection. Using two compilers that conform closely to the Standard subjects your code to more strenuous trials than using a single compiler would.

MinGW is a port of GCC to Windows. It is free of charge and simple to use (well, as simple as toolchains ever get). It produces standalone Windows executables which may be distributed in any manner. MinGW's official website mingw-w64.org provides various builds, but I maintain my own distro because I demand complete control. (It's a long story, but mingw-w64 forked from mingw.org. Although my distro was based on mingw.org for many years, I now consider mingw-w64 to be the one true MinGW.)

Please note that I did not write any of the components of my distro. I simply compiled them and packaged them together.

How To Install

First, run the self-extracting archive. It'll ask you for a directory:

Whatever you say, it'll create a MinGW subdirectory there. I recommend saying C:\ (as in the screenshot) so it'll create C:\MinGW .

Second, click Extract. It'll display a progress bar:

Just wait until it's done. I've gone to great lengths to make the distro as small as possible, but there's still a lot of stuff to extract.

Third, open the root of the distro, which is C:\MinGW if you followed my recommendation. There, you'll find two batch files and README_STL.txt . Inside the readme, there are copies of this webpage's Contents and History sections in case you forget which version of the distro you have or what it contains. There are also the following usage instructions:

Option A: In Windows Terminal, add a Command Prompt profile and set its command line to
    `%SystemRoot%\System32\cmd.exe /k C:\MinGW\set_distro_paths.bat` (without backticks).
    By default, the profile's starting directory will be System32, which is undesirable.
    So, create a working directory somewhere and set the profile's starting directory
    accordingly (e.g. I use C:\Temp).

Option B: In an existing Command Prompt, run set_distro_paths.bat to add the
    distro to that Command Prompt's PATH.

Option C: Create a shortcut to open_distro_window.bat, which will open a new
    Command Prompt with the distro on its PATH. You may move the shortcut
    to another directory (or the Desktop), and you may modify the
    shortcut's properties to start in a directory of your choice (for
    example, C:\Temp).

Leave set_distro_paths.bat and open_distro_window.bat in the root of the distro.

Option A is easily reversible. Neither Option B nor Option C permanently modifies your system.

Finally, type g++ --version in your Command Prompt and hit Enter. You should see something like this:

C:\Temp>g++ --version
g++ (GCC) 13.2.0
Copyright (C) 2023 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.


C:\Temp>

If you see something like that, then you have successfully installed MinGW.

Notes:

• My distro is directory-independent, so you can put it in a directory other than C:\MinGW . If you feel like playing with fire, I even tested paths-with-spaces when I wrote my batch files, but I can't guarantee that all of the distro's components will be similarly tolerant.
• You should not modify anything in the MinGW directory unless you know what you're doing. In particular, do not compile your programs there!

How To Upgrade

Simply replace C:\MinGW .

I shouldn't need to warn you about extracting a newer version of the distro into a directory which already contains an older version. That would create a mess.

How To Uninstall

Simply delete C:\MinGW .

How To Build Your Own Distro

components-19.0.7z (58.6 MB) : My distro is formed by extracting these binary components into a single directory, then adding the batch files and readme. These binary components are useful if you want to create a subset of my distro, or if you want to update a few components without having to rebuild everything.

Building the components from scratch requires a few things. First, you'll need their sources, which you can obtain from their official websites. Second, you'll need my build scripts and patches, which are in the scripts-VERSION subdirectory in the root of the distro. Finally, the build scripts must be run in MSYS2, and README.md in scripts-VERSION explains how to set that up.

The scripts-VERSION subdirectory is a git repository, available on GitHub.

History

Disclaimer

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

https://nuwen.net/mingw.html (updated 1/14/2024)
Stephan T. Lavavej
Home: stl@nuwen.net
Work: stl@microsoft.com
This is my personal website. I work for Microsoft, but I don't speak for them.