How to install hengbandforosx

Installing the precompiled binaries on Mac OS X 10.8 or later

To install the English version, download the *-English.dmg file (Hengband-2.2.1.7d-English.dmg is the latest) corresponding to the revision you want.  Double click on the downloaded file to open the disk image, and then drag the hengband application to where you want to store it.  Double clicking on the application will run it.  Since the application has not been signed, you'll likely have to make an exception for it to use the application.  Follow https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac
for Apple's instructions on how to do that.  In short, one way to grant an exception is

  • Control click (i.e. click while holding the control button down) on the application in the Finder.
  • Select "Open" in the menu that comes up.
  • That will bring up a confirmation dialog about allowing the application to open on the system.
  • If your account does not have administrator privileges, there'll be an additional dialog asking you to authenticate as an administrator to apply the exception to the security settings.

To install the Japanese version, the installation instructions are essentially the same, but you'll need to download the *-Japanese.dmg file (Hengband-2.2.1.7d-Japanese.dmg is the latest) corresponding to the revision you want.

Building from the packaged source code for OS X

Building the application from the source code will require a C compiler and an Objective C compiler (I used the ones packaged with Apple's Xcode).  To build the Japanese version, the nkf utility, https://osdn.net/projects/nkf/ , will have to be in the path.

Download the *.tar.gz (hengband-2.2.1.7d.tar.gz is the latest) corresponding to the version you want.  Unpack that compressed archive.  To compile the English version of the Cocoa interface on Mac OS X, run these commands from the top-level directory of the unpacked archive:

./configure --disable-japanese --enable-cocoa
make install

That will create the application, hengband.app, in that directory.  You may move that application to wherever you wish.  Compiling the Japanese version is much the same:  run

./configure --enable-cocoa
make install

in the top-level directory of the unpacked archive.