Skip to content

Installing

codingncaffeine edited this page Oct 14, 2026 · 4 revisions

Installing

WadSmith runs on Linux, under both X11 and Wayland, and on Windows 10 and 11 (64-bit). You need WadSmith itself, UZDoom (or GZDoom) to play maps, and a game to make maps for.

Install WadSmith

  • Arch Linux: install the AUR package wadsmith-bin.

  • Debian and Ubuntu: download the .deb from the latest release, then run:

    sudo apt install ./wadsmith_*_amd64.deb
  • Any Linux: download the tarball from the latest release, unpack it anywhere, and run ./wadsmith from the unpacked folder.

  • Windows: download the win-x64 zip from the latest release, unpack it anywhere, and run wadsmith.exe. Everything it needs is inside, sound on the shelf included. On Windows, WadSmith keeps its settings under AppData and your projects in Documents\WadSmith.

Start it with wadsmith or from WadSmith in your applications menu (the .deb and the AUR package add both). The tarball is started with ./wadsmith. The command-line tool wadsmith-cli is installed beside it (./wadsmith-cli in the tarball); see Command Line.

Install UZDoom

UZDoom plays your maps. It carries on GZDoom, which is no longer developed; GZDoom works too, and WadSmith uses it when UZDoom is not installed.

  • Any Linux: from Flathub, flatpak install flathub org.zdoom.UZDoom, or the AppImage from UZDoom's releases. An AppImage you have never started is not marked as a program yet: choose it in Preferences, under Engine, and WadSmith marks it for you.
  • Arch Linux: the AUR package uzdoom-bin.
  • Debian and Ubuntu: the Flatpak or the AppImage; there is no UZDoom package in the distribution.
  • Windows: the zip from UZDoom's releases, unpacked anywhere, or winget install UZDoom.UZDoom, or Scoop's games bucket.

WadSmith finds UZDoom by itself, whichever way you installed it: on your path and where packages put it, the Flatpak, an AppImage in Applications, AppImages, Downloads, the desktop or Games, and on Windows where winget, Scoop or Chocolatey put it, or an unzipped folder in Downloads, the desktop or a Games folder. UZDoom comes first, then GZDoom. If yours is somewhere else, choose it in Preferences, under Engine.

Install it before you start mapping: WadSmith reads the names of the monsters, items and other objects from the engine's own data file, so without one the Objects shelf is empty and Play has nothing to run. Drawing rooms, textures and everything else works without it.

Get a game

WadSmith needs the game data of a game to build on. Use your own copy of Doom, Doom II, Heretic, Hexen or Strife, or the free Freedoom.

  • WadSmith looks for your games by itself: in the usual places, where GZDoom's own settings search, and inside ZIP files (a base game inside one is taken out for you). If yours are somewhere else, press Pick a game file... and choose the WAD itself (DOOM2.WAD, HERETIC.WAD, or a ZIP holding one), or Add a folder... — WadSmith also looks in the folders beside and above the one you pick.
  • When a folder you added holds no base game, the start screen says what it did hold (WADs, archives, map files) and what a base game is.
  • With no game at all, the start screen offers Get Freedoom. WadSmith downloads it (about 30 MB), checks it, and keeps it in its own games folder. Freedoom plays like Doom and Doom II.

Your game files are only read, never changed. WadSmith ships no game data.

Sound on the shelf (optional)

If SDL2 is installed, pointing at a monster or item on the Objects shelf plays the sound it makes. Without SDL2 everything else works the same. You can switch the sounds off in Preferences.

Check it works

Run wadsmith --version to print the version and licence. Then follow First Steps.

If something goes wrong, see Troubleshooting.

Clone this wiki locally