Download / Install

Assuming you already have DMD installed:

1. Download Goldie and SemiTwist D Tools.

   There are two ways to download these:

   • Prepackaged Downloads at Goldie downloads page

     These prepackaged releases include Goldie, SemiTwist D Tools and prebuilt local Goldie documentation. They're available with prebuilt binaries for specific OSes. While prebuilt binaries are not currently available for all OSes, compiling from source is easy, and submissions of prebuilt binaries are welcome.

     Why 7z?

     The prepackaged releases are in .7z format because it provides much higher compression than .zip or .tar.bz2. For Goldie, a .7z is less than half the size a .zip or .tar.bz2 would be. Besides, these days, no programmer should be without a .7z tool.

     If you're on Windows, you can use 7-Zip or WinRAR. If you're on a Unix-like system, you can use P7ZIP. On Debian or Ubuntu, you can install P7ZIP with the command:

     >sudo apt-get install p7zip-full

     When P7ZIP is installed, it may already be integrated with your file manager's default compression tool.

   • Subversion

     Goldie and SemiTwist D Tools can both be obtained via Subversion:

     >svn co -r 234 http://svn.dsource.org/projects/semitwist/trunk SemiTwistDTools >svn co http://svn.dsource.org/projects/goldie/tags/v0.6 Goldie

     The Subversion releases include prebuilt binaries for Windows. Read below to see how to build the binaries yourself. Prebuilt local Goldie documentation is not included, but you can easily build it (after you finish installing Goldie) with the instructions on the GenDocs page.

2. Build SemiTwist D Tools.
   [You can skip this step if you obtained a release with prebuilt binaries for your OS.]

   From the main SemiTwist D Tools directory:

   >buildAll

   On WinXP, environment variables can be accessed by: Right-Click on "My Computer", "Properties", "Advanced" tab, "Environment Variables" button. You'll need to start a new command prompt for it to take effect. You might also need to log out and back in again.

   NOTE FOR USERS OF DMD 2.054 AND OLDER:
   
   The versions of RDMD that come with DMD 2.054 and older have bugs that prevent it from working with the latest Goldie and SemiTwist D Tools. So if you're not using at least DMD 2.055, you will need to grab the RDMD from DMD 2.055 or newer.
   
   To do this, download and extract the DMD 2.055 zip. Then, go into the bin subdirectory for your operating system, and copy rdmd into the bin subdirectory of your DMD installation. If you're on Windows, you can simply copy rdmd.exe into both the main Goldie and the main SemiTwist D Tools directories.

3. Add the executable directories for Goldie and SemiTwist D Tools to your PATH environment variable.
   [This is optional, but recommended.]

   These directories are:

   {main Goldie directory}/bin/ {main SemiTwistDTools directory}/bin/

   See step #2 above for how to access the environment variables on WinXP.

   Having these on your PATH shouldn't cause any name collisions because all the executables for Goldie and SemiTwist D Tools are prefixed with goldie- and semitwist- respectively.

4. Tell your compiler where to find Goldie and SemiTwist D Tools.
   [You can skip this step if you only intend to use the prebuilt tools and not the D library.]

   To do this for DMD:

   Go to DMD's bin directory and open sc.ini (Windows) or dmd.conf (All other OSes). On the line that starts with DFLAGS=, add the following flags:

   -Ipath_to_SemiTwistDTools/src -Ipath_to_Goldie/src

5. Build Goldie's tools and sample apps.
   [You can skip this step if you obtained a release with prebuilt binaries for your OS.]

   (See the note above regarding RDMD.)

   From Goldie's root directory:

   >semitwist-stbuild all

   To see how to build the debug versions of Goldie's tools and sample apps, or only build one tool, or perform a cleaning:

   >semitwist-stbuild --help