NOTE: I am no longer developing or supporting WadSmoosh. Please fork the code or find a community fork if you need something fixed or added. See GOODBYE.md for details.
WadSmoosh merges your provided Ultimate Doom, Doom 2, Master Levels, No Rest for the Living, Final Doom, and Sigil data into a single IWAD file that can be played in GZDoom, with each game as its own entry in the episode list. This makes it very convenient to play all of classic Doom's official releases without relaunching the game with different settings.
It's fine if you don't have all of the Doom games, eg you have Doom 2 but not Final Doom - WadSmoosh will package up everything it can find.
If you're not a Doom expert and just bought these games off Steam etc, see the Absolute Beginner's Guide section below.
Simply copy all your WADs into the source_wads/ subfolder, then run WadSmoosh. A log will appear showing progress and any errors that arise.
If you're in Windows, click wadsmoosh.exe.
If you're in macOS or Linux, run the wadsmoo.sh shell script - Python 2 and 3 are both supported now.
WadSmoosh will create a new file called doom_complete.pk3 with all the game content in it. You can run this in GZDoom with -iwad doom_complete.pk3 at the command line, or even rename it to doom2.wad and run without any command line needed. GZDoom 2.4 and later will recognize the doom_complete.pk3 file as a valid IWAD without any name change needed.
If you've extracted the No Rest for the Living add-on episode for Doom 2 from Doom 3: BFG Edition or the PSN or XBLA versions, make sure it's named nerve.wad in the source_wads/ folder.
In rare cases, you may need to uncheck the source_wads/ folder's read-only status.
Advanced users can edit wadsmoosh_data.py to customize how and what WadSmoosh extracts. This file is Python code, read by the main program at runtime, so no recompile is required. You can also customize the ordering of the Master Levels by running WadSmoosh from the command line with a text file defining the ordering as an extra parameter. The "Xaser ordering" is the default, but masterlevels_order.txt provides the mostly-alphabetical "PSN ordering", and more info on this customization option is included in comments at the top of that file. This is the only configuration option that WadSmoosh supports, and in general I'm opposed to adding more such options without turning WadSmoosh into a full-on GUI program.
WadSmoosh is not a general-purpose tool for merging Doom WADs; it is for merging retail content only - it was created in 2016 out of a desire for a "complete" retail version of Doom and Doom II, and only exists as a program because the IWAD file that it generates cannot be distributed legally. Please do not ask if WadSmoosh will support any specific WAD. If you want to add your own content to a custom IWAD, please either modify WadSmoosh's source code yourself, or simply edit the doom_complete.pk3 file WadSmoosh generated on your computer by opening it in a ZIP archive management program. Please do not ask me for support when doing either.
Here is the official list of WADs that WadSmoosh will recognize:
- Ultimate Doom (
doom.wad) - Doom (original registered version of
doom.wad, containing only episodes 1-3) - Doom II (
doom2.wad) - The Master Levels (the 20 unmodified WAD files from the retail release)
- Final Doom (
tnt.wadandplutonia.wad) - No Rest for the Living (
nerve.wad) - Sigil (
sigil.wadand its optional music addonsigil_shreds.wad) - Sigil II (
sigil2.wad, either its MIDI or MP3 soundtrack versions) sewers.wadandbetray.wad(the two secret levels from the original Xbox port of Doom)
For Sigil and Sigil II, all the filenames for different releases of those WADs are also recognized; you shouldn't have to rename your original files.
None of the "official add-on" content from the Unity-based rereleases of Doom and Doom II is supported. Only the versions of doom.wad and doom2.wad in the install folders for these ports are supported; they are virtually identical to the original data files.
- Download WadSmoosh and extract it to a folder.
- Find the folder(s) where Steam/GoG installed your game(s). For Steam, this will be something like
<Steam folder>\SteamApps\Common\<game name>\base. - Copy any files you find with a
.WADextension to thesource_wads/subfolder where you extracted WadSmoosh. - Double-click
wadsmoosh.exe. A console window will pop up to show progress. - When it closes, you should have a file in the WadSmoosh folder called
doom_complete.pk3. - Download GZDoom and extract it to a folder.
- Copy the
doom_complete.pk3file to GZDoom's folder. - Launch GZDoom and play!
If you have any issues, the How_to_download_and_run_Doom page on the Doom wiki might be helpful.