Version française
GCfilms won't be updated. Every new features or bug fixes will be implemented in the new project that replaces GCfilms: GCstar, personal collections manager .

This page describes how GCfilms and its dependencies could be installed on Mac OS X. This has been done successfully by Julien on Mac OS X 10.4 (aka Tiger). He sent these instructions to us.

Preparation

| (Top) |

GCfilms has to be installed in X11 environments, not on native ones. So first step would be to install it if you won't already have it. You may find more information about this on the X11 for Mac OS X page.

The dependencies will be installed through DarwinPorts. So you should consult documentation on its website to know how it should be used.

Dependencies installation

| (Top) |

First step is to install gtk2-perl. This is done through this command:

> sudo port install p5-gtk2

This should also install Perl and Gtk2. While there is already a Perl binary in /usr/local/bin, the new one will be /opt/local/bin/perl.

There are other packages to install. The following commands will install them:

> sudo port install p5-lwp-authen-wsse
> sudo port install p5-html-parser
> sudo port install p5-archive-tar
> sudo port install p5-archive-zip
> sudo port install p5-xml-simple

The three last ones are optional but provide some useful features (for importation and exportation of collections). They could be installed later if needed.

GCfilms installation

| (Top) |

You have first to download the .tar.gz version from the GCfilms repository. Extract it somewhere on your disk and go into the generated directory, gcfilms. Then launch this command:

> sudo /opt/local/bin/perl ./install

A window like this should be opened:

Window of installation program

Feel free to choose the installation path you want during the next step. But if you want to be consistent with DarwinPorts, use /opt/local.

Once this step done, there are some options. The first one (Add GCfilms to Applications menu) should be unchecked. Then you may validate the whole installation.

There is one last operation. Edit the file /opt/local/bin/gcfilms (the path could change according to what have been choosen during the installation). You should change the first line to #!/opt/local/bin/perl (the path where Perl was installed from DarwinPorts).

To use GCfilms, just launch /opt/local/bin/gcfilms.

Settings

| (Top) |

To better use GCfilms on Mac OS X systems, there are some options that could be changed. Open the preferences dialog and go to the Path tab.

Paths tab of preferences dialog box

The 2 first fields could be filled with the value: open. Then the default applications (as configured on your system) will be used to open web pages or play video files.


Should you have a problem using GCfilms, you can submit a bug on Gna!.