Contents:

• Windows
  • Installation
  • Game Data
  • Config Directory
  • Using Soundfonts
• macOS
  • Installation
  • Game Data
  • Config Directory
  • Using Soundfonts
• Linux
  • Installation
  • Game Data
  • Config Directory
  • Using Soundfonts
• Steam Deck
  • Installation
  • Desktop Mode
  • Gaming Mode
    • Adding Woof! to Steam
    • Gyro Controls
    • Other Controllers
    • Launch Options

1. Go to Releases and download Woof-#.#.#-win64.zip.
2. Extract the zip file to a directory.
3. Start the game with woof.exe.

An IWAD file is required to play. These are typically named:

• DOOM.WAD
• DOOM2.WAD
• PLUTONIA.WAD
• TNT.WAD

IWADs are detected in the following locations:

• In the same directory as woof.exe.
• Steam and GOG installations of the Doom games.
• Environment variables DOOMWADDIR and DOOMWADPATH.

Woof! launches Doom II by default. To launch other games, use the -iwad command line parameter. Example:

woof.exe -iwad DOOM.WAD

• The config directory is the directory containing woof.exe.

• The data directories autoload, savegames, and soundfonts are in the same location.

• The config file is woof.cfg.

  

1. Copy soundfonts to the soundfonts directory.

2. Launch Woof! and change the MIDI Player option.

   

macOS releases are not provided. However, Woof! is available through Homebrew.

1. Install Homebrew.
2. Install the woof-doom package.
3. The woof executable is installed to:
   • Apple Silicon: /opt/homebrew/Cellar/woof-doom/#.#.#/bin
   • Intel Processor: /usr/local/Cellar/woof-doom/#.#.#/bin

An IWAD file is required to play. These are typically named:

• DOOM.WAD
• DOOM2.WAD
• PLUTONIA.WAD
• TNT.WAD

Copy IWADs to the config directory at $HOME/Library/Application\ Support/woof.

Woof! launches Doom II by default. To launch other games, use the -iwad command line parameter. Example:

./woof -iwad DOOM.WAD

• The config directory is $HOME/Library/Application\ Support/woof.

• The data directories autoload, savegames, and soundfonts are in the same location.

• The config file is woof.cfg.

  

1. Copy soundfonts to the soundfonts directory.

2. Launch Woof! and change the MIDI Player option.

   

1. Go to Releases and download Woof-#.#.#-Linux.AppImage.

2. Rename the file to woof.AppImage (or simply woof).

3. Make it executable.

   

4. Start the game by double-clicking the file or typing ./woof.AppImage in a terminal.

An IWAD file is required to play. These are typically named:

• DOOM.WAD
• DOOM2.WAD
• PLUTONIA.WAD
• TNT.WAD

IWADs are detected in the following locations:

• Current directory.
• Config directory at $XDG_DATA_HOME/woof or $HOME/.local/share/woof.
• Steam installations of the Doom games in $HOME/.steam/root/steamapps/common.
• Environment variables DOOMWADDIR and DOOMWADPATH.

Additional IWAD locations:

$XDG_DATA_HOME/games/doom
$XDG_DATA_DIRS/games/doom
$XDG_DATA_DIRS/games/doom3bfg/base/wads

Which usually translate to:

$HOME/.local/share/games/doom
/usr/local/share/games/doom
/usr/share/games/doom
/usr/local/share/games/doom3bfg/base/wads
/usr/share/games/doom3bfg/base/wads

Woof! launches Doom II by default. To launch other games, use the -iwad command line parameter. Example:

./woof.AppImage -iwad DOOM.WAD

• The config directory is $XDG_DATA_HOME/woof or $HOME/.local/share/woof.

• The data directories autoload, savegames, and soundfonts are in the same location.

• The config file is woof.cfg.

  

1. Copy soundfonts to one of the following locations:

   $XDG_DATA_HOME/woof/soundfonts
   $XDG_DATA_HOME/soundfonts
   

   Which usually translate to:

   $HOME/.local/share/woof/soundfonts
   $HOME/.local/share/soundfonts
   

2. Launch Woof! and change the MIDI Player option.

   

1. Switch to Desktop Mode:

   • Open the Steam Menu and select Power.

     

   • Select Switch to Desktop.

     

2. Follow the Linux section.

3. Continue to Desktop Mode or Gaming Mode.

1. Exit the Steam application. This allows Woof! to access the Steam Deck's controls natively.

   

2. Launch Woof! and go to the Gamepad menu. The device should be Steam Deck with gyro options enabled.

   

1. To play Woof! in Gaming Mode, first add it to Steam while in Desktop Mode:

   • Launch the Steam application.

   • Click Add a Game at the lower left corner of the window.

   • Click Add a Non-Steam Game....

     

   • Click Browse... and select woof.AppImage.

   • Click Add Selected Programs.

2. A shortcut to woof.AppImage will appear in the Steam library.

   • Right-click the shortcut and select Properties....

     

   • Edit the name and appearance to preference.

     

3. Switch back to Gaming Mode:

   • Click the Return to Gaming Mode shortcut on the desktop.

     

   • Wait for the Gaming Mode interface to appear.

   • Navigate to the Woof! entry.

     

4. Launch Woof! and go to the Gamepad menu. The device should be Steam Virtual Gamepad with gyro options disabled.

   

1. To use the Steam Deck's gyro controls in Gaming Mode, open the controller settings and change Gyro Behavior to Gyro To Mouse [Beta].

   

2. For accurate gyro aiming:

   • Select the gear icon and set Dots Per 360° to 8192px.

   • Return to Woof! and set Mouse Turn Sensitivity to 5.

     

When using other controllers, such as a DualSense or Switch Pro controller, configure the Steam Input Override to preference. Select Disable Steam Input to give Woof! direct access to the controller. Otherwise, leave it at the default setting.

Use the Launch Options box for command line parameters.