Difference between revisions of "Muse2ps installation instructions"

From CCARH Wiki
Jump to navigation Jump to search
Line 28: Line 28:
 
==== Testing the executable ====
 
==== Testing the executable ====
  
After downloading the program, you will probably need to set the file permissions so that the file can be run as a program.  In OSX or linux, use the command:
+
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
 
     chmod 0755 muse2ps
Line 34: Line 34:
 
     chmod 0755 muse2ps.exe
 
     chmod 0755 muse2ps.exe
  
Next, Download the file [http://www.ccarh.org/software/muse2ps/bach-bwv852-1.md2 bach-bwv852-1.md2] using curl or wget (or save from a browser).  Then run the muse2ps program with the command:
+
Next, Download the a MuseData stage2 file [http://www.ccarh.org/software/muse2ps/bach-bwv852-1.md2 bach-bwv852-1.md2] using curl or wget (or save from an internet browser).  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
 
     cat bach-bwv852-1.md2 | ./muse2ps > bach-bwv852-1.ps
On Windows computers, use "<tt>muse2ps.exe</tt>" in the Console rather than "<tt>./muse2ps</tt>"In a cygwin terminal, you might need to use "<tt>./muse2ps.exe</tt> .
+
On Windows/cygwin computers, you might need to use "<tt>./muse2ps.exe</tt> as the command nameOn Windows computers without cygwin, you can run this equivalent command in the [http://en.wikipedia.org/wiki/Command_Prompt Command Prompt] program (if 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 directory include GhostView which is available for Windows and linux (often called gv in linux).
 
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 directory include GhostView which is available for Windows and linux (often called gv in linux).

Revision as of 17:34, 18 December 2010

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.

File Description
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.

Downloading in Linux or cygwin

In both Linux and cygwin for Microsoft Windows, you can use the wget program to download directly from a terminal. For linux:

   wget http://www.ccarh.org/software/muse2ps/muse2ps-linux -O muse2ps

And for Windows/cygwin:

   wget http://www.ccarh.org/software/muse2ps/muse2ps.exe 

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.

Downloading in Apple OS X using Terminal.app

The executable muse2ps program compiled for Apple OS X (10.4 and higher) can be downloaded in Terminal.app using the command-line downloading program called curl:

  curl http://www.ccarh.org/software/muse2ps/muse2ps-osx -o muse2ps

Testing the executable

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 a MuseData stage2 file bach-bwv852-1.md2 using curl or wget (or save from an internet browser). 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 (if 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 directory include GhostView which is available for Windows and linux (often called gv in linux).

Downloading source code

Compiling source code