Downloading Diagnil

Summary of available download files for the current version (3.0):

Ready-to-run installers (for most users)

Source code distributions (for technically oriented users)

Installation details are provided below. Proceed as directed according to your operating system type.

Quick Installation

Microsoft Windows

1. Download the appropriate installer file from the table above to the desktop or a folder of your choice.
2. This executable setup file can be launched in the usual ways on Windows, e.g., double clicking its icon. With most versions of Windows (NT/2000/XP/Vista/Win7), you will likely need "administrative privilege" to install in the default folders. This means you will need to be running under, or need to switch to, an "owner" or "administrator" account. With more recent editions (Vista and Windows 7), you might simply be asked for your permission to proceed.
3. After the setup program starts, it will prompt you through the installation process. Afterwards you will have a desktop shortcut and a start menu item for launching Diagnil.

Mac OS X

If you have the Tiger, (Snow) Leopard, or Lion version of OS X (10.4+), each disk image file contains a pre-configured application suitable for immediate use under OS X.

1. Choose the file from the table above that matches your processor family, either Intel or PowerPC. Most people will need Intel; all Macs made after 2006 have Intel processors. If unsure of the type, select the Apple logo on the menu bar (left-most item) and look under "About This Mac".
2. Download the disk image file you selected. Your browser will either open the disk image, or save it to the desktop or a folder of your choice. It has the name 'Diagnil-3.0-intel.dmg' or 'Diagnil-3.0-power.dmg'.
3. If the 'dmg' file was saved, double-click its icon to open it. If you want to try the Diagnil application before installing, simply double-click the Diagnil icon. If you decide to install it, drag its icon to the Applications folder. You might need to have access to an Administrator password for this step.
4. Alternatively, you can copy the application contained in the disk image to another folder or to your desktop. Wherever it is located, you will now have a ready-to-run application for OS X.

Linux

Most recent versions of Linux can run Diagnil out of the box.

1. Download the tar archive file from the table above. It has the name 'Diagnil-3.0.tgz'.
2. Unpack the distribution using the command 'tar xzf <path>/Diagnil-3.0.tgz' in a directory of your choice. The subdirectory Diagnil-3.0 will be created.
3. You may now start using Diagnil from a shell via the command '<path>/Diagnil-3.0/diagnil.py'. This file is an executable script.
4. If you prefer, you can create a shortcut or launcher icon for starting the application. Use '<path>/Diagnil-3.0/diagnil.py' as the startup command. If this command fails, try 'python <path>/Diagnil-3.0/diagnil.py' instead.

Using the source code distribution

• Diagnil is written in the Python programming language and requires a run-time environment. This includes the Tkinter component, which is a Python library providing access to the Tcl/Tk graphical user interface (GUI) services.
• Microsoft Windows systems normally lack Python and the supporting packages; see the Python download page to retrieve them. Tkinter and Tcl/Tk come bundled with the Windows Python distribution.
• As of version 10.4 (Tiger), OS X comes with Python and Tkinter already installed as well as an Aqua version of Tcl/Tk. Nevertheless, OS X users might want to download a fresh version of Tcl/Tk to obtain the latest bug fixes. One known problem is poor behavior with mouse wheels and touchpads. If you experience such problems and find them objectionable, you can try a newer version. Choose a version in the 8.4 series newer than 8.4.13 or one in the 8.5 series.
• Python is included in most Linux and Unix distributions. Some Linux distributions include Python but not the Tkinter package or the Tcl/Tk package it requires. These are usually available and easily obtained through your system-specific package retrieval mechanism.
• If you need to download Python, note that Diagnil requires a version in the 2.x series (at least 2.6). It will not work with the newer 3.x versions of Python.
• To install and run Diagnil, download and unpack one of the source archive files from the table above. It will create a directory called Diagnil-3.0.
• You may now start using Diagnil from a shell or other application launching mechanism. No build or compilation phase is required. Simply invoke the command '<path>/Diagnil-3.0/diagnil.py' or its functional equivalent.
• If this command fails, or you want to use a different version of Python, try 'python <path>/Diagnil-3.0/diagnil.py' instead.

Administrator:   Ben Di Vito		Last Updated:   05 Aug 2012