Installation

From jOrgan Wiki v1.25.1
Revision as of 13:21, 29 July 2015 by Bcasper (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Installing jOrgan

This page gives you information about the installing process to get jOrgan running on any system. For more detailed instructions appropriate to your operation system please follow these links:

jOrgan requires Java to be loaded on your computer. Please see the Java section below before installing jOrgan.

  • For Windows users we offer an installer for a convenient start into the world of virtual organs. An easy, self explanatory process installs jOrgan for you.

You can download jOrgan contained in a wikipedia:ZIP_(file_format) file which you should extract anywhere on your local hard drive:

 jOrgan.zip

The following instruction is for Linux and MAC systems - Windows users can bypass this section and start reading again at the Testing your new installation section.

Open a wikipedia:Shell (computing), change into the extraction directory and start jOrgan with the following command:

java -jar jorgan.jar

jOrgan root folder directory structure


JOrgan directory structure.jpg

Windows OS. Ensure to preserve the directory structure present inside the downloaded file, otherwise jOrgan will not operate properly. This structure only relates to the example dispositions supplied with jOrgan. The lesson here is to preserve the file structure of each jOrgan disposition the way it is supplied. Most external dispositions will have a very different structure to what you see here, and will fail if they are changed to match this actual jOrgan installation structure. Once you have learned how files are addressed inside a jOrgan disposition, you will be free to organise things how you choose.

  • the "dispositions" folder contains small jOrgan example dispositions
  • the "docs" folder contains documents like licenses and credits
  • the "lib" folder contains any jOrgan program extensions and libraries
  • the "skin" folder contains jOrgan's default skins
  • "jOrgan.exe" starts jOrgan using the Windows shell
  • "jorgan.jar" starts jOrgan using the Java shell

To know about this directory structure, is essential for working with jOrgan.

Testing your new installation

jOrgan comes with a small example Disposition. You should open it to verify that your system is set up correctly:

A virtual keyboard is located at the bottom of the program window. Please press some keys on the keyboard and operate the elements to hear some organ sounds. Once you have this setup up and running you should try to experiment with the example disposition. Start the customize wizard to adjust it to your equipment.

Java

To run jOrgan you need a Java Runtime Environment 6 or latest. You need to be aware of whether your computer is running in 32 bit or 64 bit. If you don't know and just let Java install automatically, Java will install the version that matches the "bits" of the browser you are using to access the Java web site and download. This is the best link to use. [1] It is what is referred to as the manual or off-line install. This way you can choose the 32 bit, the 64 bit or both bit versions. If no wikipedia:JRE is already installed on your computer you can download it from the following locations:

OS JRE
Windows www.java.com
Linux www.java.com
Mac developer.apple.com

Add-ons

Several add-ons are available for jOrgan:

  • Skins are used to style elements on a virtual console. They are the graphical aspects that you see on your computer screen, including the labels and how they move. Most users of jOrgan don't need to understand how this works unless you are wanting to customize the appearance of a particular jOrgan disposition (or instrument). All good Dispositions will either link to a jOrgan default skin or have their own customized skin included in their package.
  • Extensions add additional features to jOrgan, e.g. they offer better integration with other programs.

The Windows installer contains all current and relevant Extensions. It is recommended to check and ensure that all Extensions are "selected" at that point in the installation. The complete jOrgan package is only small so there is no advantage in trying to trim it. You would only not select an Extension if you knew exactly what it did, and that you definitely didn't need it. Tomorrow you might download a Disposition that requires an Extension you didn't install.

For Linux installations, each add-on has to be downloaded separately and extracted into the same folder as the jOrgan installation.

Reviews

https://sourceforge.net/projects/jorgan/reviews/

Portable jOrgan Test Kits for the interested beginner

in progress.

...intended for Windows XP and higher jOrgan newbies, coming with a jOrgan FluidSynth disposition and a Java Runtime Environment pre-configured.
Since parts of that concept are not supported by Linux, Linux users are recommended to have a look at the marvelous installation-free Puppy Linux CD of Graham Goode instead.

Those packages aren't intended to replace default jOrgan and Java installations anyway, nor they may contain the latest jOrgan, Java and/or instrument versions. Using the Test kits should lead to delve deeper into jOrgan matters.

The links below do give you access to download selected portable example dispositions from the jOrgan shared dispositions pool, allowing to test quite easily what can be achieved with jOrgan software.

  • The packages are provided in 7-zip format, incredibly saving disk space and download traffic. The free and non-cost 7-zip Windows and Linux versions are available here.
  • Unzip and place the file anywhere on your computer's hard drive, SSD, or to any matching portable medium (like USB sticks and devices, Flash cards) and explore that folder.
    A test kit folder should look like this:


JOrgan Test Kit folder structure.jpg


  • double-click the "start_xxxxx.bat" file.
  • If you've a soundcard and some amplifier or headphones connected, use the jOrgan virtual keyboards and the mouse, to initiate sounds. Additionally, use the "Shift" key to hold notes, for creating chords.
  • If you've one or more keyboards connected to your computer and want to use them with the program, you'll have to set up your input devices using the jOrgan customize wizard.

If you now experience any issues, getting no sounds, experience sound distortions and crackles, or something else not working,
feel free to join our mailing list, please, for many helping hands.


Available Test Kits:


Available shared dispositions, expecting a standard jOrgan installation and basic knowledge about jOrgan and MIDI:


Further information: