Difference between revisions of "Muse2ps installation instructions"
(created page) |
|||
| Line 8: | Line 8: | ||
{{muse2psdownloadtable}} | {{muse2psdownloadtable}} | ||
| − | === Downloading from the command-line === | + | === Program executable === |
| + | |||
| + | 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. 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 [http://www.cygwin.com cygwin] for Microsoft Windows, you can use the [http://en.wikipedia.org/wiki/Wget wget] program to download directly from a terminal. For linux: | ||
| + | |||
| + | wget <nowiki>http://www.ccarh.org/software/muse2ps/muse2ps-linux</nowiki> -O muse2ps | ||
| + | |||
| + | And for Windows/cygwin: | ||
| + | wget <nowiki>http://www.ccarh.org/software/muse2ps/muse2ps.exe</nowiki> | ||
| + | |||
| + | 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 [http://en.wikipedia.org/wiki/Terminal.app Terminal.app] ==== | ||
| + | |||
| + | The executable muse2ps program compiled for Apple OS X (10.4 and higher) can be downloaded in [http://en.wikipedia.org/wiki/Terminal.app Terminal.app] using the command-line downloading program called [http://en.wikipedia.org/wiki/CURL curl]: | ||
| + | |||
| + | curl <nowiki>http://www.ccarh.org/software/muse2ps/muse2ps-osx</nowiki> -o muse2ps | ||
| + | |||
| + | After downloading the program, you will probably need to set the file permissions so that the file can be run as a program: | ||
| + | |||
| + | chmod 0755 muse2ps | ||
| + | |||
| + | ==== Testing the executable ==== | ||
| + | |||
| + | 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: | ||
| + | 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> . | ||
| + | |||
| + | 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 04:54, 18 December 2010
Contents
Downloading executable programs or source code
You can download the files from your favorite web browser (which will depend on the particular browser and operating system) from the following table:
| 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). |
Program executable
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. 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
After downloading the program, you will probably need to set the file permissions so that the file can be run as a program:
chmod 0755 muse2ps
Testing the executable
Download the file bach-bwv852-1.md2 using curl or wget (or save from a browser). Then run the muse2ps program with the command:
cat bach-bwv852-1.md2 | ./muse2ps > bach-bwv852-1.ps
On Windows computers, use "muse2ps.exe" in the Console rather than "./muse2ps". In a cygwin terminal, you might need to use "./muse2ps.exe .
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).