goto: The NEUMES Project homepage Neumed and Ekphonetic Universal Manuscript Encoding Standard  

The N E U M E S
Table of Contents.
§ 1. About the Data-Entry Program
§ 2. Instructions for Users
§ 3. Compatibility chart of Web browsers
§ 4. Technical Documentation
Shortcut:  Run the Data-Entry Applet

About the Data-Entry Program

Information A Musicologist's View of NEUMES Data-Entry
  • In this essay Dr Debra Lacoste gives her opinion about NEUMES Data Entry from a musicologist's viewpoint .
InformationProgram Description
  • Presented here is the NEUMES Data-Entry Applet, version 2. This is a computer program to assist in creating digital transcriptions of chant, including NEUMES character data and NeumesXML descriptive metadata. (See, screenshot-1 [filesize: 118 kB] and screenshot-2 [filesize: 93 kB] for a prevue.) Note: this version is still in 'beta test'; it lacks many features that we have planned for user-friendliness and generality, and it is not yet ready for production work.1

  • With this Applet, you can save and retrieve NeumesXML transcriptions to/from your local computer disk. You can copy chant text into your transcription from other programs or Web sites. Syntax-checking is supported, and you can view your transcription in NeumesXML 'beta-test' visualization. There is a graphical panel for viewing source manuscript images.

Instructions for Users

  InformationDeployment Instructions
  • The data-entry program is a Java™ Applet that runs inside your Web browser. Your browser will retrieve the Applet from the NEUMES Project's webserver, and execute the program your browser's Java Virtual Machine (JVM). Your browser's JVM must support Java version 1.4.2 or higher, which is available for Windows® PC, UNIX, Linux, Macintosh® OS X, and other computer platforms. (See, the Compatibility table, below.)

  • Graphical viewing of transcriptions requires JavaScript and pop-up windows to be enabled in your browser. We recommend that you enable these features just for the NEUMES domain (, but you may do so for all domains.

  • We highly recommend that you use the Java Plug-In, version 1.4 or higher. The Java Plug-In guarantees that you will be running the latest version of the Data-Entry Applet. The Java Plug-In automatically checks for updates to the program components. If it finds a new version, it downloads the newer version to your computer; otherwise, the last version you ran executes again without any further downloading.

  • Note: To run this program, Java Security requires that you 'Grant this session' (or 'Run', or 'trust the signed applet' ... the wording depends on what browser you are using). This is required so that you can load and save NEUMES transcriptions or manuscript images from/to your computer's disk. It is required also for the cut/copy/paste operations, and for copying chant text from other websites. Finally, it is required in order to save your Applet settings, so that the Applet will behave according to your preferences on the next time you run it.

    Note: The NEUMES Data-Entry Applet is digitally signed by encryption to deter tampering by unauthorized parties. We have made every effort to ensure the security of your computer while running this Applet. However, the NEUMES Project cannot assume liability for consequential damages that anyone might claim as a result of using this Applet.
InformationTranscription Tutorial
  • For a tutorial on creating NEUMES transcriptions, see, "NEUMES Transcription Primer." The Primer was written mainly for Western European (Latin) neume notations, but much of the instruction is applicable also to Eastern Orthodox or Byzantine chant transcription. The Primer is accessible also from within the Applet in the 'Help' menu.

Run the AppletRUN the Program  (in a new window)

Table 1. Web browser compatibility for the NEUMES Data-Entry Applet. 

Operating System



XP, 2000, Me, NT, 98, or 95

Internet Explorer 5.0 and higher

OK; needs Java Plug-In

Netscape Navigator 6 or higher and Mozilla

OK; needs Java Plug-In or JRE provided by installer

Netscape Navigator 4.x


Linux (Intel)

Netscape 6 or higher and Mozilla

OK; needs Java Plug-In

Netscape 4.x


Mac OS X

Internet Explorer;
Safari 1.2.1 tested OK


Mac OS Classic
(ver. 8 or 9)


Not compatible: no Java 1.4.2 is available for this platform.

Technical Documentation

The information provided in this section is not needed for running the Data-Entry Applet. Reading this section might cause confusion for musicologists whose interest is just in using the program. We provide this information in order to show our work, and to have a permanent record of some software-design decisions we made in the underlying software. Menu

[1] The Data-Entry Applet was designed by Louis Barton. The programming was done by Louis Barton, Barry Ng, and Tillman Weyde.

The transcription text colorization uses the JEdit Syntax Package by Slava Pestov, now maintained by Oliver Henning as org.syntax.jedit. The JEdit Syntax Package is available at It uses MIT-style [Massachusetts Institute of Technology] licensing that allows free use, modification and redistribution. The version used here was patched by Tillman Weyde.

The visualization servlet uses the com.oreilly.servlet Java™ package for decoding multipart HTTP requests, whose source code, object code, and documentation are copyright 2001-2002 by Jason Hunter (license terms can be found at
Protected by law under one or more of the following copyrights:
Copyright 2005-2008, The University of Oxford.
Copyright 2003-2005, Louis W. G. Barton.
Copyright 2002-2003, The President and Fellows of Harvard College; contains software or other intellectual property licensed from Louis W. G. Barton, copyright 1995-2001 by Louis W. G. Barton.