deutex - do things with wad files
deutex [OPTIONS] -add incomplete.wad out.wad
deutex [OPTIONS] -af flats.wad
deutex [OPTIONS] -append incomplete.wad
deutex [OPTIONS] -as sprite.wad
deutex [OPTIONS] -check in.wad
deutex [OPTIONS] -debug [in.gif]
deutex [OPTIONS] -get entry [in.wad]
deutex [OPTIONS] -join incomplete.wad in.wad
deutex [OPTIONS] -make [dirctivs.txt] out.wad
deutex [OPTIONS] -merge in.wad
deutex [OPTIONS] -pkgfx [in.wad [out.txt]]
deutex [OPTIONS] -pknormal [in.wad [out.txt]]
deutex [OPTIONS] -restore
deutex [OPTIONS] -usedidx [in.wad]
deutex [OPTIONS] -usedtex [in.wad]
deutex [OPTIONS] -unused in.wad
deutex [OPTIONS] -wadir [in.wad]
deutex [OPTIONS] -xtract in.wad [dirctivs.txt]
DeuTex is a wad composer for Doom, Heretic, Hexen and Strife. It can be used to extract the lumps of a wad and save them as individual files or the reverse, and much more.
When extracting a lump to a file, it does not just copy the raw data, it converts it to an appropriate format (such as PPM for graphics, Sun audio for samples, etc.). Conversely, when it reads files for inclusion in pwads, it does the necessary conversions (for example, from PPM to Doom picture format).
Decomposing a wad¶
To decompose a wad (i.e. extract its contents), use the -extract (a.k.a. -xtract) command. When decomposing a wad, DeuTex creates one file for each lump. The files are created in one of the following subdirectories of the working directory: flats/, lumps/, musics/, patches/, sounds/, sprites/, textures/. The decomposing process also creates a very important file, wadinfo.txt, which will be used later when composing.
To extract the contents of the Doom II iwad,
deutex -doom2 /path/to/doom2.wad -xtract
To extract the contents of a Doom II pwad named mywad.wad,
deutex -doom2 /path/to/doom2.wad -xtract mywad.wad
To extract only the sprites,
deutex -doom2 /path/to/doom2.wad -sprites -xtract
To extract only the sounds,
deutex -doom2 /path/to/doom2.wad -sounds -xtract
Composing (building) a wad¶
Composing is the symmetrical process. It’s done with the three commands -build, -create and -make, that are equivalent. Using wadinfo.txt and the files in flats/, lumps/, musics/, patches/, sounds/, sprites/ and textures/, DeuTex creates a new wad.
To create a new pwad named mywad.wad,
deutex -doom2 /path/to/doom2.wad -make mywad.wad
To create a new iwad named mytc.wad,
deutex -doom2 /path/to/doom2.wad -iwad -make mytc.wad
DeuTex has many (too many?) other commands like -join, -merge, -usedtex etc.
Modal options not requiring an iwad¶
-?, -h, -help, --help
Modal options requiring an iwad¶
-add in.wad out.wad
-build|-create|-make [in.txt] out.wad
-extract|-xtract [in.wad [out.txt]]
-get entry [in.wad]
-join incomplete.wad in.wad
-pkgfx [in.wad [out.txt]]
-pknormal [in.wad [out.txt]]
-rgb r g b
All messages are identified by a unique code. Some messages are identical; the code is useful to distinguish them. All codes have four characters: two letters and two digits. The letters identify the part of the code where the message comes from, the digits give the message number within that area. In general, numbers are assigned so that messages that come from parts of the code that are executed earlier have lower numbers.
DeuTex is copyright © 1994-1995 Olivier Montanuy, copyright © 1999-2005 André Majorel, copyright © 2006-2019 contributors to DeuTex.
Most of this program is under the GNU General Public License version 2, but some of it is available under other licenses. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See LICENSE for specific information and copyright notices. All trademarks are property of their owners.
The original author of DeuTex is Olivier Montanuy. From 1994 to 1996, DeuTex was maintained by Olivier Montanuy with help from Per Allansson, James Bonfield, Sharon Bowles, Mark Mathews, and Chuck Rossi. The original manual was written by Kevin McGrail.
From version 4.0 (1999) through 4.4.902 (2005), the maintainer was André Majorel (http://www.teaser.fr/~amajorel).
The project has since been maintained by a loose collaboration of authors primarily as part of the Debian project and Freedoom project. They include Jon Dowland, Simon Howard, Mike Swanson, RjY, Ayub Ahmed, and Nick Zatkovich.
Please report bugs to the issue tracker at https://github.com/Doom-Utils/deutex.