 |
|||
|
|
Creating a .cshrc file. Assume you have put the jMusic folder in your User directory, use a text editor to create a file called .cshrc with the following (single) line in it. In OS X not all Aqua text editors can read or write files starting with a dot, as these are generally hidden. We suggest that you open a terminal and use the pico editor to create and or edit your .schrc file. Navigate to your home directory by typing cd ~. In the terminal type pico .cshrc then add the line below. setenv CLASSPATH .:${home}/jMusic/jmusic.jar:${home}/jMusic/inst/
Save the file in your user directory. e.g: /User/andrew/.cshrc |
In OS X systems that use the bash shell by default it is the ~/.bashrc file.
|
Creating a .bashrc file. Assume you have put the jMusic folder in your User directory, use a text editor to create a file called .cshrc with the following (single) line in it. In OS X not all Aqua text editors can read or write files starting with a dot, as these are generally hidden. We suggest that you open a terminal and use the pico editor to create and or edit your .schrc file. Navigate to your home directory by typing cd ~. In the terminal type pico .bashrc then add the line below. export CLASSPATH=.:$HOME/jMusic/jmusic.jar:$HOME/jMusic/inst/ Save the
file in your user
directory. e.g: /User/andrew/.basrc Create (or
edit an existing) a
.profile file inthe same directory by typing pico .profile. Add
the following
line to the file: . .bashrc
|
4. Reshresh the teminal to utilise the changed environment variables. Open a terminal window (or quit and reopen if already open) to initiate the .cshrc file. (The terminal app is in the /Applications/Utilities/ directory.) Use the commands javac filename.java or java filename to run jMusic files.
5. (Optional) To use the MidiShare package (msjm) for MIDI input and output you will need to download and install MidiShare from Grame, including the Java developer tools with the grame.jar file. You should run msconnect to connect the various midi input/output sources that you might have. All the files need to go in the working directory. The grame.jar needs to be added as an environment variable in the classpath. For example, add :${home}/jMusic/graeme.jar to the end of the setenv CLASSPATH command above if the grame.jar file is in the jMusic folder.
Note: With Java for OS X version 1.4.2 Apple broke QTJava support, so the jMusic jmqt package does not work. If you have this version of Java installed please avoid the qtjm package within jMusic (for now at least - there is an update in the works at Apple we believe).
Mac OS 9
Install java: (Skip these steps if you have a Java runner and compiler already.)
- Download and install the MRJ (Macintosh Runtime Java) from Apple
- Download an install the MRJ SDK (Software Development Kit) from Apple.
Install jMusic:
- Download the jmusic_1.5.tar.gz file from SourceForge and unstuff with
stuffit
expander. (Follow links from jMusic_Stable). If it doesn't
automatically uncompress, drop the file onto Stuffit Expander to do so.
This will result in a folder called "jMusic".
Put the 'jmusic.jar' file and 'inst' folder in your Java classpath. This involves placing the files inside the MRJClasses folder inside MRJLibraries, inside Extensions, inside the System folder. You will find all other java packages here such, as "MRJClasses.zip".
......./System Folder/Extensions/MRJLibraries/MRJClasses
Make sure the names are exactly the same as the folders (without the 'alias' suffix).
- To use the
qtjm playback
utilities make sure that Apple's QuickTime java (QTJava.zip file) is
installed. Installing this is an option when you run the Quicktime
installer (make sure it is version 5) from Apple. When installing QuickTime, choose
'Custom
Install' and select the QTJava option. It will install a QTJava.zip
file in the MRJClasses folder.
Note: Java for Mac OS9 is version 1.1 which does not support the Swing GUI library or JavaSound MIDI and audio libaries. jMusic does use JavaSound for playback in some cases, but does not Swing (although many of the applications built using jMusic do), users of Mac OS9 may wish to download the Swing libraries from Sun. Put the Swing.jar file in the classpath - the MRJClasses folder.
- (Optional) To use the MidiShare package (msjm) for MIDI input and output you will need to download and install MidiShare from Grame, including the Java developer tools with the grame.jar file. You should run msconnect to connect the various midi input/output sources that you might have. You need to copy the midishare drivers that you want to have started on midishare wakeup time into the midishare directory in system. The grame.jar, or an alias of it, needs to go in the folder in system where you put all the other java libraries, System Folder/Extensions/MRJ Libraries/MRJClasses.
Windows
First stage, install Java bits.
- Download the latest Java development kit installer from Sun. Run the executable and follow the on-screen prompts to install.
- Download
jMusic
from sourceForge. Choose
the latest file under the jMusic_Stable heading and unzip it to
c:\jmusic.
- Some
environment variables must
be set before jMusic can be run successfully. This can be done in
several ways.
You may wish to try creating, compiling and running a simple jMusic program to test if the tools has been set up correctly. Here is a tutorial to try which will work on all flavours of Windows.- Under Win9x or WinME, add the following command to c:\autoexec.bat and reset your computer.
- Under
Win2000, NT or XP,
Open the System Properties Dialog. (By right-clicking My Computer and going to Properties OR by naviagting through Start | Settings | Control Panel | System)
Choose the Advanced tab
Click Environment Variables... Ensure that a variable called CLASSPATH exists and it contains c:\jmusic\jmusic.jar;c:\jmusic\inst
- (Optional) To
use the MidiShare
package (jmms) for MIDI input and output you will need to download and
install MidiShare from Grame, including the Java
developer tools
with the grame.jar file. You should run msconnect to connect the
various midi input/output sources that you might have. The midishare
user file is called midishare186.zip The midishare developer file is
called midishare2000.zip They are in the same ftp folder, and the
layout is a bit confusing (careful). You need to put the dlls that you
want to use, as well as the midishare32dll (which has all the important
native classes) into the system folder, so that they can be awakened at
midishare startup time. Make sure the .ini files are put into the
windows or winNT folder.
(Optional step) If you wish to use the QuickTime playback utilities you need to install Quicktime with the optional Java components enabled. Download the Quicktime installer from Apple. When installing, choose to do a 'Custom Install' and ensure that the 'Quicktime for Java' checkbox is selected.
The next stage is to set up jMusic.
For even more information on getting going with Java try the getting started instructions from Sun's java homepage.
jMusic source
code
The full set of .java source files for jMusic are availible from SourceForge.
Documentation
The Javadoc-generated documentation in HTML format can be downloaded from sourceforge. It can also be viewed online from this site.
Tutorials
and Examples
Work through the online tutorials and documented example code to see how to compose with jMusic.
Visit the Digital Instrument Building web resource that features jMusic tutorials focused on music software development.
Download the jMusic tutorials as a zip archive. [15.4 MB]
Feedback
We are very interested to hear your comments about jMusic, the music you write with it, and to see any additions to the classes you might make. Check previous questions or suggestions at the jMusic-dev list or send amessage by subscribing to the list or Contact us directly.
Developers
Join the team
formally by
registering at
Supported by the following organisations:
