Maintained branch of the original Dwarf Therapist for Dwarf Fortress.
Clone or download
Latest commit 63910f7 Dec 23, 2016
Permalink
Failed to load latest commit information.
debian Update debian/changelog to reflect recent changes. Feb 27, 2016
dist Fixing Linux build after #225 / 2e4168a Feb 2, 2015
doc typo: "dwarve s" => "dwarves" Feb 10, 2015
inc auto-connect option, option messages Jul 4, 2016
osx modify paths of osx deploy script Jan 25, 2016
resources auto-retry connection Jun 28, 2016
scripts Update export-dt-ini.lua Oct 13, 2016
share Create v0.43.05_graphics.ini Nov 29, 2016
src fix option status tip, auto-connect beta Jul 6, 2016
thirdparty/qtcolorpicker-2.6 WIP role preference work, misc cleanup Oct 12, 2014
ui fix option status tip, auto-connect beta Jul 6, 2016
.gitignore modify paths of osx deploy script Jan 25, 2016
.travis.yml automatic yes to apt-get install prompts May 18, 2016
BUILDING.rst Added missing dependencies for Debian-based systems. Fixes #301 Apr 3, 2016
CHANGELOG.txt version 37.0.0 release Feb 22, 2016
Doxyfile * started work on issue 98 (integrated help) Oct 2, 2009
DwarfTherapist.rc Changes to support DF 2012. And windows layouts for 34.01. Feb 16, 2012
LICENSE.txt * Added wing comments around LICENSE file (becase I auto-include it … Jun 11, 2010
README.rst Update README.rst May 23, 2016
dwarftherapist.pro QT4 updating/notify compatibility Jun 27, 2016
dwarftherapist_en.ts Update dwarftherapist_en.ts Jan 10, 2016
hammer.icns v20.6.3 Oct 10, 2013
hammer.ico Prepping for release of alpha (v0.1.5) Jul 22, 2009
resource.h Prepping for release of alpha (v0.1.5) Jul 22, 2009
resources.qrc auto-retry connection Jun 28, 2016

README.rst

Dwarf Therapist

https://travis-ci.org/splintermind/Dwarf-Therapist.svg?branch=DF2016

This is a heavily modified version of the original Dwarf Therapist.

Many new features (attributes, roles, optimization plans, health views, inventory, etc.) have been added, and many bugs have been resolved.

If you'd like to help support this project:

Buy me a Beer! ... and I'll have happy thoughts ...

The changelog is available at GitHub.

Latest Release

The latest release is always published in the project's releases page. These releases normally contain packages for Windows and OSX.

Alternate Download (DFFD)

If the latest published releases do not contain a package, they may be found on DFFD.

Windows 32-bit

OSX

Linux

There is currently no official package for Linux. You can find the instructions to build from source in BUILDING.rst.

Running the program

On default installations of most Debian-based distributions, you'll most likely need to run Dwarf Therapist with sudo. This is due to the Yama ptrace LSM enabled by default on such distros. You can explicitly give Dwarf Therapist permission to ptrace on Debian-based distributions with:

sudo apt-get install libcap2-bin && sudo setcap cap_sys_ptrace=eip ./bin/release/DwarfTherapist

Or, you can create a script that will run Dwarf Therapist as a child of Dwarf Fortress:

#!/bin/bash
set -e
cd df_linux
./df &
cd ../dwarftherapist
exec ./bin/release/DwarfTherapist

Alternatively, you can use the dist/dwarftherapist wrapper to automatically grant DT permissions to attach to a running DF process.

Support

Primary support is available at the Dwarf Therapist thread at the Bay 12 Forums; if you are sure you have found a bug, file an issue at the GitHub issue tracker. Provide as much information as possible to help reproduce the issue. Most runtime bugs will require you to send a save, preferably uploaded at DFFD. You may also be requested to provide a log, which is saved in log/log.txt on Windows and OSX and output to stderr on Linux systems (use 2> log.txt to collect).

You can also join us in #dwarftherapist on Freenode.