~~NOCACHE~~


====== Windows installation ======

This page contains instructions to install GCstar on Microsoft Windows systems.

===== Current version =====

Just download the [[http://download.gna.org/gcstar/win32/GCstar_[VERSION]_Setup.exe|GCstar installation program for Windows [VERSION] ]]. It contains all the dependencies you need.

Once installed, the update feature doesn't work. This is a known problem in 1.4.0. It should be fixed in a feature release.


===== Versions before 1.4.0 =====

==== Dependencies ====

GCstar uses [[http://gtk2-perl.sourceforge.net/|gtk2-perl]]. Since version 1.1.0, it needs to be installed manually. You just need to follow the instructions on this page: [[http://www.lostmind.de/gtk2-perl/]]

If you previously installed version 1.0.0 (or less) of GCstar and want to go with this installation, you first need to delete **usr** directory in the directory where you installed GCstar. It is really recommended to do so because you will benefit from newer versions of GCstar dependencies.

==== Install GCstar ====

You need to download from the [[http://download.gna.org/gcstar/win32/|Download repository for Windows]] the version you want to install. Launch this executable and follow the instructions.

==== FAQ ====

These frequently asked questions are specific to the Windows installation of versions before 1.4.0.

**When launching GCstar, nothing happens or the splash screen is frozen. What could I do?**

First try to run GCstar from an MS-DOS console. Then go into the directory where GCstar is installed, sub-directory bin. If you kept default settings, it could be done with:

<terminal>cd %%"C:\Program Files\GCstar\bin"%%</terminal>

Then launch GCstar as follows:

<terminal>perl ./gcstar</terminal>

You will be able to see if there are some error messages displayed that could be helpful. You could have this error: ''%%Can't locate object method signal_connect via package "GCFrame"...%%''

This is caused by a Gtk2 version mismatch. You may check your current version with:

<terminal>%%perl -MGtk2 -e "print $Gtk2::VERSION"%%</terminal>

If it is different from the one that you installed previously, enter these commands to reinstall everything:

<terminal>
ppm remove Gtk2
ppm remove Glib
ppm remove Cairo
ppm remove ExtUtils-PkgConfig
ppm remove ExtUtils-Depends

ppm repo add %%http://www.lostmind.de/gtk2-perl/ppm/%%
ppm install Gtk2
</terminal>

**How could I install missing modules?**

GCstar uses some Perl modules. Some of them are optional. These optional modules are used by import/export and extract plugins. To list them, click on **Help menu**, then **Dependencies**. If you find a missing module, it could be installed with this command in a command prompt:
<terminal>ppm install Module::Name</terminal>

The module name is case-sensitive. As an example, if GCstar doesn't import information for MP3 files, you probably are missing %%MP3%%::Info. Then enter this command:

<terminal>ppm install %%MP3::Info%%</terminal>


**Why is the interface different from screenshots?**

With the default installation of Gtk2, there is not a lot of themes. You may [[http://sourceforge.net/project/showfiles.php?group_id=14718&package_id=102330|download a pack of themes]]. Then to select a theme, go to Start Menu, Programs, Gtk+, Themes Selector.