This project was created for graduate school circa 2010 and is no longer maintained. Links may be broken.
MXMLiszt 0.9.2 (Beta)
___________________________________________________________________________
Table of Contents
Introduction Installation Troubleshooting How it works FAQ Links
___________________________________________________________________________
Introduction
MXMLiszt is a web-based delivery and search/retrieval environment for MusicXML [http://www.recordare.com/musicxml] files and their manifestations. MXMLiszt and an accompanying research paper, Beyond Images: Encoding Music for Access and Retrieval [http://blog.humaneguitarist.org/uploads/MXMLiszt/Beyond_Images__Encoding_Music_for_Access_and_Retrieval.pdf], were created in order to complete a Master's in Library and Information Science [http://www.slis.ua.edu/] at the University of Alabama under the direction of Dr. Steven L. MacCall [http://www.slis.ua.edu/Maccall.html]. On the name "MXMLiszt":
MXMLiszt = MusicXML List.
MXMLiszt is pronounced [mak-suh-muh-list [http://www.merriam-webster.com/dictionary/maximalist]].
MXMLiszt references the great musical maximalist, Franz Liszt [http://www.biography.com/articles/Franz-Liszt-9383467].
___________________________________________________________________________
Installation (Windows 32-bit, home-based server)
MXMLiszt is currently known to work on the following 32-bit Windows servers:
* Successfully tested for production and hosting on Windows XP Home Edition (Service Pack 3) and Windows 7 (Professional).
* Successfully tested for hosting on Windows Server 2003.
MXMLiszt uses the following backend software*:
* Musescore (version 0.9.5)
* MusicXML Library (version 2.0)
* ImageMagick (version 6.5.9-5)
* Zong! Player (version 0.4.48)**
* Saxon-HE (version 9.2)
* BaseX (version 6)
* Additionally, you need the Java Runtime Environment [http://www.oracle.com/technetwork/java/javase/downloads/index.html] and an Apache server that supports PHP 5.
* Note that many of the software versions are not the most current; this will be addressed in future versions. ** The Zong! Player is included with MXMLiszt 0.9.2. To get MXMLiszt up and running do the following:
1. Assuming you don't have an Apache/PHP setup, download XAMPP [http://www.apachefriends.org/en/xampp.html ].
+ Create a "bin" folder inside the root XAMPP folder.
+ Because some of the MXMLiszt scripts take a lot of time to run, increase the maximum execute time in "php.ini" to more than the default of 60 seconds. I used “3600”.
2. Download the MXMLiszt-0.9.2.zip [http://blog.humaneguitarist.org/uploads/MXMLiszt/MXMLiszt-0.9.2.zip] file.
+ Extract the files/folders and place the root "MXMLiszt" folder inside XAMPP's “htdocs” folder.
+ Open "setup.php" and change line 5 (below) to replace the default Administrator password from “tausig” to your own password.
o
<span style="font-size: small;"><span style="background: none repeat scroll 0% 0% transparent;">$validPassword = "tausig";</span></span>
3. Download MuseScore [http://musescore.org/].
+ Install MuseScore inside the “bin” folder you made in Step 1.
+ Rename the root folder to just “MuseScore”.
+ The program executable should be located at "bin\MuseScore\bin\mscore.exe".
+ Run MuseScore and go to Edit>Preferences>Export and uncheck “Screen shot function”.
+ Click "Apply".
+ Go to Edit>Preferences>Score and select "A4" as the default paper size and make sure "Landscape" and "Two sided" are unchecked.
+ Click “Apply”.
+ Close the program.
4. Download MusicXML Library [http://libmusicxml.sourceforge.net/].
+ Create a folder called “libmusicxml” inside your “bin” folder and extract all the MusicXML Library files in that folder.
+ The transposition executable should be located at "bin\libmusicxml\xmltranspose.exe".
5. Download ImageMagick [http://www.imagemagick.org/].
+ Install ImageMagick inside the “bin” folder.
+ Rename the root folder to simply “ImageMagick”.
+ The “convert” executable should be located at "bin\ImageMagick\convert.exe".
6. Download the Java version of BaseX [http://basex.org/].
+ Place the .jar file in the “bin” folder.
7. Download Saxon-HE [http://saxon.sourceforge.net/].
+ Extract the .jar file to the “bin” folder.
8. Run “xampp-control.exe” from the root XAMPP folder and start only the Apache module:
IMAGE: [http://blog.humaneguitarist.org/uploads/MXMLiszt/xampp.png]
9. You should now be able to go to “http://localhost/MXMLiszt/” or "http://127.0.0.1/MXMLiszt/" from your browser and see the MXMLiszt welcome page:
IMAGE: [http://blog.humaneguitarist.org/uploads/MXMLiszt/mxmliszt-0.9.2.png]
10. Now login via the "Administrator>Login/Logoff" link and execute options 1 through 6; this may take a while.
11. Hope it works!
___________________________________________________________________________
Troubleshooting
Administrator errors:
1. generateMODS.php not working
+ Make sure Java is installed.
+ You must have a live internet connexion for Saxon to perform XSLT operations due to xsd/schema needs.
User errors:
1. Zong! Player not working
+ Make sure Java [http://www.java.com/] is installed. I use version 1.6.0_20.
+ Make sure you've installed the Java Soundbank [http://java.sun.com/products/java-media/sound/soundbanks.html].
+ Occassionally, there are MusicXML files Zong! Player cannot play. I plan to contact the programmers and ask why this might happen from time to time.
2. Some of the PDFs have very odd spacing and page layout issues.
+ I think this is an issue with MuseScore. I own Finale Notepad [http://www.finalemusic.com/notepad/] and it seems to do a better job with MusicXML import. But, I really don't know yet why these things happen from time to time with certain pieces. I should probably experiment more with MuseScore style configurations.
___________________________________________________________________________
How it works
MXMLiszt works on the principle that while the MusicXML encoding for a given composition is itself a manifestation of a work (i.e. the “composition”), the MusicXML file itself can function as a sub-work capable of birthing derivative image and audio files; manifestations also include musical transpositions in MusicXML format, thus allowing the the transpositions to serve as sub-sub-works also capable of spawning new image and audio content. The following graphic attempts to depict the essential overall framework of the platform:
IMAGE: [http://blog.humaneguitarist.org/uploads/MXMLiszt/workflowDiagram.png]
___________________________________________________________________________
FAQ
1. Why are you using the Zong! Player? MuseScore can create OGG [http://www.vorbis.com/] files from free SoundFonts [http://en.wikipedia.org/wiki/SoundFont] and the audio can be embedded in the HTML5