Windows Installation

  • Run the installer program, follow the instructions.
  • Start jose by double-clicking jose.exe
  • Or start jose from the command line with java -jar jose.jar
  • You will find more information in the release notes and the jose manual .

3D Installation for Windows

  • Unzip the package into your existing jose directory.
  • Windows 2000 or later, or Windows XP is required.
    Windows 98 users can download Java3D 1.3.1 from
  • DirectX 8, or OpenGL 1.1 is required.

Linux Installation

3D Installation for Linux

  • Unzip the package into your existing jose directory.
  • System Requirements: Graphics adapter with driver that supports the GLX extension: GLX 1.3 or later and OpenGL 1.2 or later

Mac OS X Installation

3D Installation for Mac OS X

  • Mac OS X 10.3.1 or later with Java 1.4.1 or later is required
  • Download Java3D from
  • run the installer

Upgrade Instructions

  • You need an existing jose installation
  • The upgrade package will update any version to the current release version
  • Unzip the package into your jose directory. When asked for overwriting files, click "Yes to All".

Textures Installation

  • Unzip the package into your existing jose directory.
  • Use Edit/Options/Colors and 3D settings to select textures.

Sound Files Installation

  • Unzip the package into your existing jose directory.
  • Use Edit/Options to adjust sound settings.

Database Installation

  • choose Open... from the File menu
  • select a database archive file (*.jose)
  • opening an archive file may take some time. However, the import need only be run once. After the archive has been copied into your personal database, it will be available immediately.

Opening Book Installation

  • choose Options... from the Edit menu
  • select the Opening Books tab
  • click the [+] to add a new file

Notes on Java

  • jose requires Java Runtime Environment 1.4 or 1.5 installed on your system.If you don't have it, download a package that includes it.
  • Or download it from .
  • If you're not sure which version is installed on your system, open a command prompt and type java -version.
  • Note that jose will not run with older Java versions; in particular, it won't run with Microsoft's Java environment.