Installing

Download the latest DevilutionX release and extract the contents to a location of your choosing or build from source.

Windows

Copy DIABDAT.MPQ from your CD or GoG installation (or extract it from the GoG installer) to the folder containing the DevilutionX executable or to the data folder. The data folder path may differ, but will normally be %AppData%\diasurgical\devilution
To run the Hellfire expansion of Diablo you will need to copy hellfire.mpq, hfmonk.mpq, hfmusic.mpq, hfvoice.mpq into the same location as DIABDAT.MPQ.
Run .\devilutionx.exe

Linux

Copy DIABDAT.MPQ from your CD or GoG installation (or extract it from the GoG installer) to the folder containing the DevilutionX executable or to the data folder. The data folder path may differ depending on distro, version and security settings, but will normally be ~/.local/share/diasurgical/devilution/
To run the Hellfire expansion of Diablo you will need to copy hellfire.mpq, hfmonk.mpq, hfmusic.mpq, hfvoice.mpq into the same location as DIABDAT.MPQ.
Install SDL2, SDL2_mixer and SDL2_ttf:
- Ubuntu/Debian/Rasbian sudo apt install libsdl2-2.0-0 libsdl2-ttf-2.0-0 libsdl2-mixer-2.0-0
- Fedora sudo dnf install SDL2 SDL2_ttf SDL2_mixer
Run ./devilutionx

Ubuntu PPA

sudo add-apt-repository ppa:devilutionx/stable
sudo add-apt-repository ppa:devilutionx/dev

sudo apt update
sudo apt install devilutionx

Copy DIABDAT.MPQ from your CD or GoG installation (or extract it from the GoG installer) to ~/.local/share/diasurgical/devilution/
To run the Hellfire expansion of Diablo you will need to copy hellfire.mpq, hfmonk.mpq, hfmusic.mpq, hfvoice.mpq into the same location as DIABDAT.MPQ.
Run DevilutionX or DevilutionX Hellfire from menu to start game

MacOS X

Copy DIABDAT.MPQ from your CD or GoG installation (or extract it from the GoG installer) to the folder containing the DevilutionX executable or to the data folder. The data folder path may differ, but will normally be ~/Library/Application Support/diasurgical/devilution
To run the Hellfire expansion of Diablo you will need to copy hellfire.mpq, hfmonk.mpq, hfmusic.mpq, hfvoice.mpq into the same location as DIABDAT.MPQ.
Run ./devilutionx

Nintendo Switch

Copy devilutionx.nro and CharisSILB.ttf in into /switch/devilutionx
Copy DIABDAT.MPQ from your CD or GoG installation (or extract it from the GoG installer) to /switch/devilutionx.
To run the Hellfire expansion of Diablo you will need to copy hellfire.mpq, hfmonk.mpq, hfmusic.mpq, hfvoice.mpq into the same location as DIABDAT.MPQ.
Launch devilutionx.nro. Hold R on any installed game and launch it. Do not use album to launch, if you use album, the homebrew will only have a small amount memory available, and the touch keyboard won't work. This is true for all homebrew, not just DevilutionX.

New Nintendo 3DS

Copy devilutionx.3dsx into sd:/3ds/devilutionx/.
Copy DIABDAT.MPQ from your CD or GoG installation (or extract it from the GoG installer) to sd:/3ds/devilutionx/.
To run the Hellfire expansion of Diablo you will need to copy hellfire.mpq, hfmonk.mpq, hfmusic.mpq, hfvoice.mpq into the same location as DIABDAT.MPQ.
Launch devilutionx.3dsx with the Homebrew Launcher.
- Note: When the Hellfire .mpqs are installed you can still launch regular Diablo by passing --diablo to devilutionx.3dsx.

Copy devilutionx.cia to your SD card and install with a title manager, e.g. FBI. devilutionx.cia can be removed after being installed.
Copy DIABDAT.MPQ from your CD or GoG installation (or extract it from the GoG installer) to sd:/3ds/devilutionx/.
To run the Hellfire expansion of Diablo you will need to copy hellfire.mpq, hfmonk.mpq, hfmusic.mpq, hfvoice.mpq into the same location as DIABDAT.MPQ.
Launch Diablo from your 3DS Homemenu.

Playstation Vita

Install devilutionx.vpk
Copy DIABDAT.MPQ from your CD or GoG installation (or extract it from the GoG installer) to ux0:/data/diasurgical/devilution/.
To run the Hellfire expansion of Diablo you will need to copy hellfire.mpq, hfmonk.mpq, hfmusic.mpq, hfvoice.mpq into the same location as DIABDAT.MPQ.

ClockworkPi GameShell

Copy the __init__.py to a newly created folder under /home/cpi/apps/Menu and run it from the menu. The folder then symbolizes the devilutionX icon.
From this menu, you can press 'X' to clone the git repository for devilutionX and compile the code. Dependencies are installed automatically (cmake and SDL development packages).
Once installed, 'X' pulls the updated code and does the compiling. Note that any changes made locally to the source are reverted before pulling.
When the compile is finished, copy DIABDAT.MPQ from your CD or GoG installation (or extract it from the GoG installer) to /home/cpi/.local/share/diasurgical/devilution/
To run the Hellfire expansion of Diablo you will need to copy hellfire.mpq, hfmonk.mpq, hfmusic.mpq, hfvoice.mpq into the same location as DIABDAT.MPQ.
You can now play the game from the same icon.

GKD350h

Copy devilutionx-gkd350h.opk to /media/data/apps or /media/sdcard/apps/.
Copy DIABDAT.MPQ from your CD or GoG installation (or extract it from the GoG installer) to /usr/local/home/.local/share/diasurgical/devilution/DIABDAT.MPQ
To run the Hellfire expansion of Diablo you will need to copy hellfire.mpq, hfmonk.mpq, hfmusic.mpq, hfvoice.mpq into the same location as DIABDAT.MPQ.

RetroFW

Requires RetroFW 2.0+.

Copy devilutionx-retrofw.opk to the apps directory.
Copy DIABDAT.MPQ from your CD or GoG installation (or extract it from the GoG installer) to ~/.local/share/diasurgical/devilution
To run the Hellfire expansion of Diablo you will need to copy hellfire.mpq, hfmonk.mpq, hfmusic.mpq, hfvoice.mpq into the same location as DIABDAT.MPQ.

~ is your home directory, /home/retrofw by default.

RG350

Requires firmware v1.5+

Copy devilutionx-rg350.opk to /media/sdcard/APPS/.
Copy DIABDAT.MPQ from your CD or GoG installation (or extract it from the GoG installer) to /media/home/.local/share/diasurgical/devilution/DIABDAT.MPQ
To run the Hellfire expansion of Diablo you will need to copy hellfire.mpq, hfmonk.mpq, hfmusic.mpq, hfvoice.mpq into the same location as DIABDAT.MPQ.
NOTE: You can copy DIABDAT.MPQ to sdcard instead and create a symlink at the expected location. To do this, SSH into your RG350 and run:
```
ln -sf /media/sdcard/<path_to_`DIABDAT.MPQ`> /media/home/.local/share/diasurgical/devilution/`DIABDAT.MPQ`
```

Optional

For better widescreen support you can copy devilutionx.mpq to the same location as DIABDAT.MPQ