Installation Instructions

Mac

Double-click the zip archive to open it and then move the Diogenes application to your Applications folder.

Windows

Just double-click on the installer and answer the questions as prompted.

Linux

Follow your distribution's usual practice for installing third-party packages.

An Untrusted Application?

Some computers may complain that Diogenes is application which has been downloaded from the Internet and ask you to confirm that you want to go ahead and install it. This is safe to do.

On Windows: When you are running the installer, Microsoft Defender may warn you that this app is unrecognized and you may have to click through some warnings to confirm that you want to run an application from an unknown publisher.

On a Mac: If you have problems, your computer may have been set to install only applications from the App Store. This setting is found in System Preferences → Security & Privacy. Make sure that under “Allow applications from”, you have selected the option “App store and identified developers”.

---

Manual instructions (for experts only)

If your computer is too old to meet the minimum system requirements to install and run the current version of Diogenes, you can still use it if you are willing to enter some commands manually.

The integrated Diogenes application consists of a client, which is like a web browser, and a server that works with the texts. The minimum requirements pertain to the client. Even a very old computer ought to be able to run the server and connect to it with an ordinary web browser. Here are step-by-step instructions, which do presume a small amount of technical knowledge.

• Download and install Diogenes for your platform.

  Alternatively, just download the Diogenes package for Arch Linux, which is just a plain zip file and unzip it wherever you like. Perl is the only prerequisite.

• Open a Terminal or command-line application. For Macs, this is Terminal.app; for Windows this is cmd/Command Prompt; for Linux it is any terminal.

• Diogenes needs to know the location of the databases, and if you are running the server manually you will have to put this in a configuration file. Its location depends on your platform:

  Mac

  /Users/USERNAME/Library/Application Support/Diogenes/diogenes.prefs

  Windows

  C:\Users\USERNAME\AppData\Diogenes\diogenes.prefs or C:\Users\USERNAME\AppData\Roaming\Diogenes\diogenes.prefs

  Linux

  ~/.config/Diogenes/diogenes.prefs

• Edit this file with a plain text editor to indicate the locations of the databases, like so:

  tlg_dir "/Path/to/tlg/folder/"
  phi_dir "/Path/to/phi/folder/"
  ddp_dir "/Path/to/phi/folder/"
            

  You can put other settings in this file as well, such as:

  old_pdf_dir "/Path/to/Oxford Latin Dictionary.pdf"
  tll_pdf_dir "/Path/to/TLL/open/access/pdfs"
            

• Now you are ready to start Diogenes. In the terminal, type the command to run the Diogenes server. You may have to adapt the command if Diogenes was installed or unzipped in a non-standard place:

  Mac

  /Applications/Diogenes.app/Contents/server/diogenes-server.pl

  Windows

  C:\Program Files (x86)\Diogenes\server\diogenes-server.pl

  Linux

  /usr/local/diogenes/server/diogenes-server.pl

• If the command was successful it should say something like this: Startup complete. You may now point your browser at this address:
http://127.0.0.1:8888

• Paste that URL into the address bar of your web browser and you should see the front page of Diogenes.