Muse2ps installation instructions
1 Compiled muse2ps program
You can download compiled program files for muse2ps using your favorite web browser by right-clicking on filenames in the table below and choosing "Save As..." in the menu which appears (but the saving process will depend on the particular browser and operating system). Alternatively, the following two sections explain how to download using two common command-line downloading tools.
|muse2ps.tar.bz2||Tar file containing source code and test examples.|
|muse2ps-linux||Program executable compiled statically for linux.|
|muse2ps-osx||Program executable compiled for Apple OS X, version 10.4 and higher.|
|muse2ps.exe||Program executable compiled for Microsoft Windows (prone to stack overflows in older versions of Windows). It is currently advised to download the source code and compile within a Cygwin terminal if you want to run on Windows (not suitable for the amateur Windows user who is not familiar with Unix).|
If you do not want to compile muse2ps from the source code (particularly when using Microsoft Windows), you only need to download the compiled program for your operating system. Follow the instructions given below for your specific operating system. If you are using a unix-based operating system other than linux, then you are expected to be computer-literate enough to compile from the source code.
1.1 Downloading in a Linux or Cygwin terminal
wget http://www.ccarh.org/software/muse2ps/muse2ps-linux -O muse2ps
And for Windows/cygwin:
Note that the Windows version of muse2ps does not require cygwin in order to be run. Cygwin is used in this case only to facilitate downloading from a terminal.
1.2 Downloading in Apple OS X using Terminal.app
curl http://www.ccarh.org/software/muse2ps/muse2ps-osx -o muse2ps
1.3 Testing the executable program file
After downloading the program, you will probably need to set the file permissions so that the file can be run as a program. In OS X or linux, use the command:
chmod 0755 muse2ps
or, in Windows/cygwin:
chmod 0755 muse2ps.exe
Next, download the MuseData stage2 file bach-bwv852-1.md2 using curl or wget (or save from an internet browser).
curl http://www.ccarh.org/software/muse2ps/bach-bwv852-1.md2 -o bach-bwv852-1.md2
This file can be used as test input data into the muse2ps program. Then run the muse2ps program with this command in linux or OS X:
cat bach-bwv852-1.md2 | ./muse2ps > bach-bwv852-1.ps
On Windows/cygwin computers, you might need to use "./muse2ps.exe" as the command name. On Windows computers without cygwin, you can run this equivalent command in the Command Prompt program (provided that you are in the correct directory):
type bach-bwv852-1.md2 | muse2ps > bach-bwv852-1.ps
If the program runs successfully, the file bach-bwv852-1.ps should contain PostScript data. To view this PostScript data, you will have to use a program which understands that data format. For example, Adobe Distiller or Acrobat Professional can convert PostScript files into PDF files. Programs which can view PostScript files directly include GhostView which is available for Windows and linux (a variant called gv is common on linux computers).
2 Downloading source code
From the command-line, you can download the source code for muse2ps with wget or curl:
curl http://www.ccarh.org/software/muse2ps/muse2ps.tar.bz2 -o muse2ps.tar.bz2
If you click on the link to the source code, most web browsers can automatically download the tar file and open it as a folder within the operating system. This folder can be dragged to a location of your choosing on your hard disk. To unpack the tar file manually from the command line, type in linux, OS X, or Windows/cygwin:
tar xvjf muse2ps.tar.bz2
This will create a directory called muse2ps. To compile the program, change directory into the newly created directory, and type the command "make":
cd muse2ps make
This will create the file muse2ps within the directory which is the executable program for muse2ps. You can look in the tests for test example (or follow the instructions above for running a test usage of one of the pre-compiled program files):
cd tests make
The above two commands should produce three PostScript files within the tests directory (The creation of a PostScript file for Beethoven's Ninth Symphony will take a while). Use your favorite PostScript viewing or printing programs to examine the resulting output files. The directory muse2ps/tests/pdf contains PDF files which should match the PostScript output from muse2ps:
- bach-bwv852-1.pdf: A Bach Well-tempered Clavier prelude.
- beethoven-sym5-4.pdf : Beethoven, Fifth Symphony, movement 4.
- beethoven-sym9.pdf: Beethoven, Ninth Symphony, complete.
3 Documentation for muse2ps
Documentation for using muse2ps is available here. The documentation describes the options and input data format for the program.