This will help you get Mr. Voice up and running on either a Unix or Windows system.
If you are installing Mr. Voice on a new machine, one which does not contain an existing Mr. Voice 0.x or 1.x installation, skip these steps and go straight to the installation section.
Mr. Voice 2.0 involves a migration from the old database backend (MySQL) used in Mr. Voice 1.10.6 and before, to a new database backend (SQLite). In order to migrate your data from the old database to the new one, you need to run the migration utility.
Windows users should double-click on the upgrade20.exe file. It will open up a DOS box. Follow the instructions on-screen and, if there are no errors, it will create the new Mr. Voice database file and update your configuration to point to it. If there are errors, your MySQL database will not be modified, so you can always use 1.10.6 or lower as usual while I'm working on the problem.
Unix users should run the tools/upgrade20.pl script, and it will do the same as in the Windows instructions.
Once you are comfortable that the upgrade worked properly and that you're set up in Mr. Voice 2.0, you can delete your old MySQL installation to save disk space and system resources.
Windows users can disable the MySQL service, while keeping the software installed, by right-clicking on the stoplight in the system tray and choosing WinNT->Stop Service. This will leave your old data alone, but the MySQL service will not be running and using system resources. To completely remove MySQL from your system, go to Add/Remove Programs, choose MySQL, and hit "Remove". Then, you can delete the C:\mysql directory. Once that is done, MySQL is gone, along with your old database.
For Unix users, you may want to go into the MySQL command shell and "drop database mrvoice", and/or uninstall MySQL from your system completely (if it was only being used for Mr. Voice, of course)
Unpack the mrvoice-x.x.tar.gz archive. It will create a mrvoice-x.x directory. The mrvoice.pl file is the only one needed to run the program (meaning that you can move mrvoice.pl to another location after you're done configuring it), but there are other files in the archive, such as documentation, licenses, etc.
Compile and/or install any required software from above (perl modules, etc.). I will skip the software setup, assuming that if you're trying to run this on a Unix system, you're geeky enough to install the required stuff by yourself. ;-) If you run into issues, feel free to email me or check the software's website.
At this point, all of the software should be set up and ready for configuration!
First, download WinAmp and install it the normal way, by double-clicking the installer icon and using the defaults provided.
If you're using the httpQ plugin for WinAmp, download its zip file and install it. Then, do the following steps:
Start WinAmp by itself, right-click on the "OAIDV" bar on the left of the window, choose Options->Preferences.
Go down to Plugins->General Purpose. You should see the httpQ plugin listed. Highlight that, and hit "configure".
Under the General tab, put in a password (your choosing), leave the port at 4800, and check the box to start the service automatically. Hit the Apply button, then the x at the top-right. Close the preferences, and exit from WinAmp. Remember the password you just set up - you will need it later.
Any other WinAmp plugins (OGG, AAC, etc.) should be installed in the default way following the instructions provided with the package.
Unzip the mrvoice-current.zip file to your desired location. It will create a directory named mrvoice-x.x under the location that you choose. These instructions will assume that you unzip it to C:\, creating the C:\mrvoice-x.x\ directory, where x.x is the version number.
The first time you run Mr. Voice on a particular computer, you will need to set up the configuration. With later releases, you can just unzip the new version, and skip these remaining steps.
You will need a directory to store your MP3 files, and a directory to store your hotkey save files. I suggest C:\MP3\ for the MP3 directory and C:\hotkeys\ for the save files, but you can pick anything. Go ahead and create the directories now.
Finally, to actually run the software, double-click on the file mrvoice.exe. The program should start up! The first time you run the program (or, more specifically, if it can't find its configuration file), you will be given the option of creating a default configuration, or going into the preferences to set the values manually. The default should be good enough for most people. It sets up the following values, creating directories where needed:
MP3 Directory: C:\MP3
Hotkey Directory: C:\HOTKEYS
MP3 Player: C:\Program Files\Winamp\Winamp.exe
Database File: C:\MRVOICE.DB
After doing the initial setup, Mr. Voice will exit. Restart it, and it will initialize your database and run the program.