Software Installation

This chapter describes the hardware requirements and installation of MusicReader.

Hardware requirements

 * Windows XP/Vista/7 or Mac OS X
 * Processor of at least 1.3 Ghz.
 * 512 MB RAM or more (1024 MB or more recommended)
 * At least 200 MB free hard disk space for program


 * MusicReader recommends medium screens (12"+) in portrait mode (1 page) or large screens (17"+) in landscape mode (2 pages).
 * Digitizer pen or touchscreen is recommended as input device, but mouse and keyboard are also supported.
 * Normal screens provide a larger display-area than widescreens, on widescreen monitors the sheet music will be a little smaller in size.

Installation
This section describes the program and license installation.

Windows

The installation steps on Windows for the program are:
 * 1) Run the installation program (musicreader.exe) and follow the instructions in the installation wizard.
 * 2) Create a directory where you want to store all your sheet music.
 * 3)  Start MusicReader and go to [[Image:Settings.gif|30px]] in the menu [[Image:Applications.gif|30px]] to configure the software.
 * 4) Configure at least the library and recording paths and choose your screen size.
 * 5) Restart MusicReader and you are ready to use it.

Mac OS X

The installation steps on Mac OS for the program are:
 * 1) Run the installation program (MusicReader.dmg) and follow the instructions in the installation wizard.
 * 2) Create a directory where you want to store all your sheet music.
 * 3)  Start MusicReader and go to [[Image:Settings.gif|30px]] in the menu [[Image:Applications.gif|30px]] to configure the software.
 * 4) Configure at least the library and recording paths and choose your screen size.
 * 5) Restart MusicReader and you are ready to use it.

License

The licenses of MusicReader are integrated in special license file (license.lic). In most cases you will receive this license file by e-mail. Before you can install it, you need to save the file on a temporary location on your computer. You can't open the license file itself.

There are two ways to install a new license:
 * 1) If you are a new user or if your previous license is expired or corrupt, then you can choose a new license when you start MusicReader or MusicConvert.
 * 2) Otherwise you can install the new license via the settings dialog, [[Image:Settings.gif|30px]] in the menu [[Image:Applications.gif|30px]]. The button "Install..." in the tab "License" can be used to install a new license file.

Upgrade
When you want to upgrade to a newer version of MusicReader you can simply install this version over the old installation. It's not necessary to uninstall the old version, but you need to be sure you install the new version in the same directory.

Security messages (Windows only)
During installation and first start of MusicReader you can get some security messages and warnings like: You need to confirm these messages in order to use MusicReader. There is no need to worry about these messages because they are standard procedures for the security of your system.
 * Printer Driver not certified
 * Firewall notices
 * User Account Control / Administration messages (Vista)

Plug-in Installation
Some functionality of the software needs to be manually. The reason for not integrating them in the standard installation lays mainly in legal restrictions for distribution of these plugins. These restrictions do not apply when plugins are installed separately, but you are advised to read the license agreement of the software. This chapter describes installation of the MP3, PDF and screen rotation plug-ins.

MP3 Support
To enable MP3 support you need to download the Sun Java MP3 plugin. Follow steps below to do this, please ignore all information on the website of Sun Microsystems.
 * 1) Go to this website
 * 2) Click on "Download" [[Image:sunDownload.gif|70px]]
 * 3) Select "Other" (!!! Not "Windows" !!!)
 * 4) Select "I agree to the Software License Agreement" and press "Continue".
 * 5) Click on "javamp3-1_0.zip".
 * 6) Save this file in the plugins directory of MusicReader
 * 7) On Windows this is in most cases c:\program files\MusicReader\plugins\
 * 8) On Mac OS you need to go to Application->MusicReader then click with right button on MusicReader and choose "Show Package Contents". Move the file to Contents -> Resources -> Java -> Plugins.
 * 9) Start MusicReader to complete the installation, if previous steps are correct you get a "Installed MP3 Plugin, please restart MusicReader." message. Under Windows Vista you need to start MusicReader as administrator to install the plugin. To do this click with the right mouse button on the MusicReader icon and select "Run as administrator". You only need to do this once.
 * 10) Start MusicReader again to use it with MP3 Support

PDF Support (Windows only)
There are two ways to install PDF support

Using Setup

You can install PDF support by running the MusicReader setup again. Under "Select Additional Tasks" there will be a item called GPL Ghostscript - PDF import support if GPL Ghostscript is not installed already. This option will download and install the necessary support and requires an Internet connection on your system.

Manually

For import of PDF files in MusicConvert you need to install Ghostscript.
 * 1) Download Ghostscript 8.70 from SourceForge or Ghostscript 8.62 from  http://pages.cs.wisc.edu/~ghost/doc/GPL/gpl861.htm (Download  gs861w32.exe which is at the bottom of the page - under "Microsoft Windows").
 * 2) Install the downloaded file

Rotation Support (Windows only)
On some systems MusicReader cannot automatically rotate the screen. If this is the case on your system then you can download iRotate to enable it. There are two options for the installation.

Using Setup

You can install rotation support by running the MusicReader setup again. Under "Select Additional Tasks" there will be a item called IRotate - Support for screen rotation if screen rotation is not yet supported. This option will download and install the necessary support and requires an Internet connection on your system.

Manually

You can also download this program manually from http://www.entechtaiwan.com/util/irotate.shtm and install it on your system.