Installation - Revision history

37.201.212.220: /* via Whisky on Apple Silicon Macs */ fixed incorrect line to add; the part in brackets is added by whisky. Adding it manually will crash DF every time. Try yourself please!

2024-11-14T20:14:38Z

via Whisky on Apple Silicon Macs: fixed incorrect line to add; the part in brackets is added by whisky. Adding it manually will crash DF every time. Try yourself please!

Jecowa: WhiskyWine seems to be the new GPTK

2024-11-06T09:56:55Z

WhiskyWine seems to be the new GPTK

Jecowa: /* MacOS */ I think GPTK is only for DirectX 12, and I don't think Dwarf Fortress uses DirectX. Whisky can, at least, run DF without it

2024-11-05T23:29:52Z

MacOS: I think GPTK is only for DirectX 12, and I don't think Dwarf Fortress uses DirectX. Whisky can, at least, run DF without it

Jecowa: /* MacOS */

2024-11-05T23:21:27Z

MacOS

Jecowa: /* MacOS */ having readers install brew for Whisky is unnecessary and makes the task more complicated for those unfamiliar with it. I've always seen the override as "msvcp140_atomic_wait (native, builtin)", but don't know if it matters

2024-11-05T23:20:35Z

MacOS: having readers install brew for Whisky is unnecessary and makes the task more complicated for those unfamiliar with it. I've always seen the override as "msvcp140_atomic_wait (native, builtin)", but don't know if it matters

Jecowa: /* MacOS */ Whisky only works on Apple Silicon Macs. Don't think Whisky is exclusive to Sequoia.

2024-11-05T23:01:03Z

MacOS: Whisky only works on Apple Silicon Macs. Don't think Whisky is exclusive to Sequoia.

80.251.183.204: /* For OS X 15 and up */ typos and better heading

2024-11-05T16:45:55Z

For OS X 15 and up: typos and better heading

80.251.183.204: /* MacOS */ Updated instructions how to run DF Premium via Whisky

2024-11-05T16:41:34Z

MacOS: Updated instructions how to run DF Premium via Whisky

Lethosor: /* Linux */ missing /

2024-10-02T04:51:59Z

Linux: missing /

Lethosor: the package is not named the same on other distros. Also, that's SDL_image, not SDL2. Pulled package names from old version of the page; some distros may require more.

2024-10-02T04:51:11Z

the package is *not* named the same on other distros. Also, that's SDL_image, not SDL2. Pulled package names from old version of the page; some distros may require more.

@@ Line 94: / Line 94: @@
 * Create your first bottle. Win10 will work fine.
 * Click Bottle Configuration, then Open Wine Configuration. In the pane “Libraries”, add a new override:
-  msvcp140_atomic_wait (native, builtin)
+  msvcp140_atomic_wait
 * Download Steam for Windows installer on your Mac
 * In Whisky click “Open C: Drive”, navigate to your Steam installation file, double-click the file and follow the instructions.

@@ Line 91: / Line 91: @@
 * Download the zip file for the [https://github.com/Whisky-App/Whisky/releases lastest release of Whisky].
 * Unzip the app and, optionally, move it to your /Applications/ folder.
-* Open the Whisky app and verify in the Setup settings that Rosetta is installed.
+* Open the Whisky app and verify in the Setup settings that Rosetta and "WhiskyWine" are installed and checked. (Versions of Whisky prior to v2.3.0 will have "GPTK" instead of "WhiskyWine".<sup><nowiki>[</nowiki>[https://github.com/Whisky-App/Whisky/commit/d98a8147f1e25bffc9501020a45423f217e6a4cc source]]</sup>)
 * Create your first bottle. Win10 will work fine.
 * Click Bottle Configuration, then Open Wine Configuration. In the pane “Libraries”, add a new override:

@@ Line 91: / Line 91: @@
 * Download the zip file for the [https://github.com/Whisky-App/Whisky/releases lastest release of Whisky].
 * Unzip the app and, optionally, move it to your /Applications/ folder.
-* Open the Whisky app and verify in the Setup settings that Rosetta and GPTK are installed and checked.
+* Open the Whisky app and verify in the Setup settings that Rosetta is installed.
 * Create your first bottle. Win10 will work fine.
 * Click Bottle Configuration, then Open Wine Configuration. In the pane “Libraries”, add a new override:

@@ Line 88: / Line 88: @@
 Although there is no native build, you can run Dwarf Fortress Premium version on a Mac through either [https://getwhisky.app Whisky] or [https://www.winehq.org/ Wine]. Whisky only works on Apple Silicon Macs, but is the preferred option if you are on Apple Silicon.
-=== via Whisky on Apple Silicon Macs ===https://github.com/Whisky-App/Whisky/releases
+=== via Whisky on Apple Silicon Macs ===
 * Download the zip file for the [https://github.com/Whisky-App/Whisky/releases lastest release of Whisky].
 * Unzip the app and, optionally, move it to your /Applications/ folder.

@@ Line 86: / Line 86: @@
 == MacOS ==
-Although there is no native build, you can run Dwarf Fortress Premium version on a Mac through either [https://getwhisky.app Whisky] or [https://www.winehq.org/ Wine]. Whisky only works on Apple Silicon Macs. Both will use [https://brew.sh/ Homebrew] to be installed, which is a Mac OS packet manager. If you don't have any experience with this, it might seem a bit overwhelming at first, but you should be fine just following the step-by-step guide below. If you need help with Homebrew, you find plenty of tutorials on the web. You will also need to run [https://en.wikipedia.org/wiki/Terminal_(macOS) Terminal], which is a build in App you can find and start through a search via Spotlight.
+Although there is no native build, you can run Dwarf Fortress Premium version on a Mac through either [https://getwhisky.app Whisky] or [https://www.winehq.org/ Wine]. Whisky only works on Apple Silicon Macs, but is the preferred option if you are on Apple Silicon.
-=== via Whisky on Apple Silicon Macs ===
+=== via Whisky on Apple Silicon Macs ===https://github.com/Whisky-App/Whisky/releases
-* If you have not installed Homebrew go to the [https://brew.sh/ offical homepage and follow the steps listed there].
+* Download the zip file for the [https://github.com/Whisky-App/Whisky/releases lastest release of Whisky].
-* Once Homebrew is working, open a new Terminal window type (or copy & paste):
+* Unzip the app and, optionally, move it to your /Applications/ folder.
-  brew install --cask whisky
+* Open the Whisky app and verify in the Setup settings that Rosetta and GPTK are installed and checked.
 * Create your first bottle. Win10 will work fine.
 * Click Bottle Configuration, then Open Wine Configuration. In the pane “Libraries”, add a new override:
-  msvcp140_atomic_wait
+  msvcp140_atomic_wait (native, builtin)
 * Download Steam for Windows installer on your Mac
 * In Whisky click “Open C: Drive”, navigate to your Steam installation file, double-click the file and follow the instructions.
@@ Line 105: / Line 104: @@
 === via Wine for older MacOS distributions ===
 If you have Homebrew installed, you can open Terminal and paste the following for installing Wine through brew.
   brew install --cask --no-quarantine wine-stable

@@ Line 88: / Line 88: @@
 Although there is no native build, you can run Dwarf Fortress Premium version on a Mac through either [https://getwhisky.app Whisky] or [https://www.winehq.org/ Wine]. Both will use [https://brew.sh/ Homebrew] to be installed. Which is an OS X packet manager. If you don't have any experience with this, it might seem a bit overwhelming at first, but you should be fine just following the step-by-step guide below. If you need help with Homebrew, you find plenty of tutorials on the web. You will also need to run [https://en.wikipedia.org/wiki/Terminal_(macOS) Terminal], which is a build in App you can find and start through a search via Spotlight.
-=== For OS X 15 and up ===
+=== OS X 15 Sequoia===
-* If you have not installed Homebrew go to the[https://brew.sh/ offical homepage and follow the steps listed there].
+* If you have not installed Homebrew go to the [https://brew.sh/ offical homepage and follow the steps listed there].
 * Once Homebrew is working, open a new Terminal window type (or copy & paste):
    brew install --cask whisky
@@ Line 103: / Line 103: @@
 For the Classic version follow the steps to create a Win10 bottle. Download the latest classic version from the[https://www.bay12games.com/dwarves/ Dwarf Fortress website]. Unpack the .zip file. Click “Open C: Drive” in Whisky and navigate to the unzipped classic version. Click Dwarf Fortress.exe to run the game.
 === For older OS X distributions ===
 If you have Homebrew installed, you can open Terminal and paste the following for installing Wine through brew.

@@ Line 81: / Line 81: @@
 If sound is not working for you, load the game through the DFHack launcher (<code>./dfhack</code>) or change the startup command to:
-  LD_LIBRARY_PATH=. .dwarfort
+  LD_LIBRARY_PATH=. ./dwarfort
 If you see any errors related to glibc when starting DF (for example, "version `GLIBC_2.34' not found"), your version of Linux is too old and will need to be upgraded (e.g. Ubuntu 20.04 LTS is insufficient, but 22.04 LTS should work). Alternatively, you can try running the Windows version in Wine.

@@ Line 54: / Line 54: @@
 where /path/to/df_XX_YY_linux.tar.bz2 is the path and filename of the actual file you downloaded.
-'''Prerequisites:''' ''Dwarf Fortress'' versions 50+ require the SDL2 library, which is not included with the binary. To install it on Debian-based systems (e.g. Ubuntu/Linux Mint/Pop!_OS), use the command:
+'''Dependencies:''' ''Dwarf Fortress'' requires at least the SDL2 and SDL2_image libraries. If you downloaded Classic or Itch builds of DF, these libraries are not included. To install these libraries, run the appropriate command for your distro:
   sudo apt install libsdl2-image-2.0-0
-Hopefully the package is named the same on other package managers so you can adapt this command for them by changing the "apt" to "dnf" for installation on Fedora, for example.
+* on Fedora/CentOS, use one of the following depending on your package manager:
 '''Running''': First, change to the new directory