An installation script for the Dwarf Fortress Lazy Newb Pack, for Linux.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

This Is Unmaintained

As of 2014-06-24, this repository is unmaintained. No further updates will be added. See this post for more information.

You are free to fork this under the terms of the GPLv3 or study the code to build your own under another license.


df-lnp-installer is a shell script that installs the Dwarf Fortress Lazy Newb Pack. It downloads and builds a DF installation from available source code and binaries.

Included Mods

  • Lazy Newb Pack for Linux 0.5.3-SNAPSHOT-20130822
  • DF Hack 0.34.11-r3
  • Falconne's DFHack UI Plugins v0.44
  • SoundSense r42 (app only)
  • Dwarf Therapist v20.5 (splintermind, pulled and built from source) with manual
  • Quickfort 1.01
  • Chromafort 2010-04-25
  • A series of blueprints for Quickfort.
  • Various embark profiles.
  • Tilesets
    • [12x12] Jolly Bastion 34.10v5
    • [16x16] ASCII Default 0.34.11
    • [16x16] CLA v15
    • [16x16] Ironhand 0.73.4
    • [16x16] Mayday 0.34.11
    • [16x16] Obsidian 0.8a
    • [16x16] Phoebus 34.11v01
    • [16x16] Spacefox 34.11v1.0

System Requirements

  • A Java runtime environment for the LNP GUI.
  • SDL 1.2, 32-bit
  • LibGLU 1, 32-bit
  • LibGTK 2.0, 32-bit
  • OpenAL 1.2, 32-bit
  • LibJPEG 6.2, 32-bit
  • Git
  • Mercurial (hg)
  • Qt4 Development Libraries including qmake
  • Python 2.x (for Quickfort)
  • The following fairly standard Linux utilities:
    • wget
    • sha1sum
    • sed
    • tar
    • unzip
    • unrar
    • make
    • g++
    • gcc
    • xterm

The df-lnp-installer script will automatically check your system for the required libraries.

The Debian (and possibly Ubuntu) command to install these dependencies is:

sudo apt-get install default-jre libsdl1.2debian:i386 libsdl-image1.2:i386 libsdl-ttf2.0-0:i386 libglu1-mesa:i386 libgtk2.0-0:i386 libopenal1:i386 libjpeg62:i386 git mercurial libqt4-dev qt4-qmake wget coreutils tar unzip unrar make g++ gcc patch xterm sed python bzip2

The Fedora command to install these dependencies is:

sudo yum install java-1.7.0-openjdk gcc gcc-c++ automake libgcc.i686 git cmake glibc-devel.i686 zlib-devel.i686 perl-XML-LibXSLT perl-XML-LibXML mercurial qt.i686 libgcc.i686 qt-devel SDL.i686 SDL_image.i686 SDL_ttf.i686 gtk2.i686 mesa-libGLU.i686 openal-soft.i686 libsndfile.i686 xterm unrar unzip python


Usage: [OPTIONS]

--override-user-agent  # Download files as Mozilla user agent, not Wget user agent. Useful if you get 403 errors.
--skip-download        # Install using the existing contents of the ./downloads folder.
--skip-deps            # Install without checking for dependencies.
--skip-sha             # Install without checking file checksums.
--upgrade, -u          # Upgrade an existing DF installation.
--version, -v          # Print the df-lnp-installer version.
--help, --usage        # Print this message.

Full Installation

  1. Clone the git repository with git clone
  2. Run ./ and follow the prompts.
  3. Once DF is installed, enter the DF folder and run ./startlnp.
  4. Start the SoundSense r42 utility from the Utilities tab.
  5. Click the "Pack Update" tab.
  6. Click "Start Automatic Update".
  7. Get a Dwarven Ale; it's going to be a while.
  8. Once finished, close SoundSense, and muck about with LNP as normal.

Upgrading an Existing Installation

  1. Update your git repository with git pull
  2. Run ./ --upgrade. When asked, enter the directory you already installed DF into.
  3. Your save files and soundsense audio packs will be backed up.

Common Issues

See the WIKI.

Tested On

  • Debian 7 "Wheezy", stable, using Dash (default) shell.
  • Debian 7 "Jessie/Sid", testing, using Dash (default) shell.