GCstar behaviour can be changed through many options. First item of Configuration menu opens a window containing these options. They are grouped in 5 tabs.

Under the tabs, there is a checkbox, Expert Mode. When it is checked, some extra features will be available. By default it is unchecked to hide some settings that won’t be needed most of the time. But in this documentation, everything is explained. So on screenshots, this option is activated.

Main preferences

| Top |

Main tab

Language used in interface can be changed with first option. The translations are made thanks to some contributers. Some may be incomplete and the text will be displayed in english. If you find untranslated text in your language, do not hesitate to open a topic in developers and contributers forum with any translation you could provide.

The other option is a skin selection. One of them is Gtk. It means in fact that no skin will be applied on GCstar and your global Gtk settings will be used. Other values are for special skins. The GCstar skin contains icons made by le Spektre.

Please note that any option changed in this tab won’t be effective until a GCstar restart.


| Top |

Display tab

First option, Items list may be used to choose how collection list has to be displayed. It can be as text, pictures or detailed list. This two last modes have some specific settings, available through the button that will appear next to the display choice.

For image mode:

Image mode settings

When selecting picture mode, a numeric value can be specified. This is the number of columns used to generate the list. The pictures size may also be changed.

Second part of the window contains options about style. A background picture could be used (with different skins) or some plain colors.

For detailed mode:

Detailed mode settings

In detailed mode, the pictures size could also be changed. Then there are options about items grouping (as seen in the chapter concerning grouping). The first option is used to select the field to group items.

The checkbox Keep together orphaned items controls the way the items are sorted when grouping is activated. If it is checked, all the items that are not in a category will be after the grouped ones. When unchecked, they will be all sorted together.

Add number of elements on categories will add the count of items as number appended to the group name.

Second part of the window contains the fields to be displayed in the list.

In Display tab, there is the option Layout. It changes information display. The different available layouts differ according to current collection type. For the ones that are read only, a skin could also be specified.

Following option in Display tab is to select toolbar size (or hide it) and also its position in GCstar window.

There is then a checkbox used to display or not status bar. This bar is used to display current items number. It concerns the ones that are displayed, i.e. using filtering criteria. It could also display information about current task made by GCstar and a progress bar when some long operations are performed.

Last part of this tab is for articles management. Some items can have an article on the beginning of the name (such as “The”, “A”,...). If the box is checked, these articles are removed from the beginning and displayed on the end of the title between parentheses. But the real name remains unchanged.

There is also a list of articles to be specified. These words must preceed a white space or a quote to be considered as articles. Note that the quote have to be excluded from the specified article. List items must be comma separated and in any case (”The” will match “the”, “THE” or even “tHe”).

Let’s have a small example with a movie list containing The Big Lebowski and articles list containing The. In left side of the main window, this movie will be shown as Big Lebowski (The). And it will be with movies having a B as first letter.


| Top |

Paths tabs

Applications group of options is to specify some external applications used by GCstar. The default option is to Use programs defined by system. Then the global systems settings will be used when an application is required.

But it is also possible to override this by using Use specified programs. The button next to this option open a window where the programs used to open web pages, to play videos and to play sounds could be selected.

Then there is a parameter for the directory to use to stock pictures downloaded from the Internet or imported automatically.

You don’t have to enter the full path for these options. You can use the Open button to graphically select the file or the folder.

But you could also use some special values as explained under this field. The default value (that you may restore with the corresponding button) is ./%FILE_BASE%_pictures/. So if your collection is /home/tian/documents/my_movies.gcs, the pictures will be stored in /home/tian/documents/my_movies_pictures. You may edit this pattern as you wish. The only constraints is that . (a dot) or %WORKING_DIR% could only be used on the very beginning of the path.

This setting is a global. Each collection may override it in their particular settings (accessible through File > Properties menu).

For the choices discussed in the following two paragraphs to be available to see or change, the Expert Mode checkbox at the bottom of the dialog box must be checked.

It is also possible to select the format for the name of pictures themselves. They could begin with gcstar_, followed by a unique number. Or they may also be generated using the item name. The special characters and spaces will be replaced with _ (underscore). As an example, the picture for the movie Alien Resurrection will be stored in a file named Alien_Resurrection_0.jpg. A number is also added to prevent duplicate.

At last, there is a checkbox Use relative paths for images. When checked, picture paths stored into collections will be relative (according to list location). This may be useful to share a collection between many operating systems on the same machine and is necessary to set in both Linux and Windows instances of GCstar for the Windows machines to access images in a collection on Samba shares within a local network.


| Top |

Internet tab

Concerning Internet access, everything is done through this tab.

When a search is performed, it can be done on many web sites. The first option let user select what kind of operations have to be performed. A default web site can be selected from this list. But other values are available.

First ones, Ask must be used it the user want to be asked for the site to use everytime a search is launched. Difference between first and second one is the sites that are shown in the selection window. If the user choose to have only a limited number of choices, a button appears next to the list. Clicking on it will open a window where the site have to be specified.

The other option is to perform search automatically on all the specified sites (it stops when something is found, so their order may be important).

There is then a checkbox be checked if the user doesn’t want all information to be imported. A window will contain all these values, and the user will be able to select which one needs to be used.

As some searches may take a long time, it is possible to stop them if corresponding box is checked (not available on Win32 systems)

To use a proxy, there is a specific option. The proxy address has to be specified like this:


Next options concern e-mails. From address has to specified for sent e-mails.

There is two available methods to send e-mails. Sendmail one uses sendmail program which should be present on many Unices and GNU/Linux distributions. This program has to be launchable from a terminal without any path specification.

The other method, is a more universal one. It uses an SMTP. The server address must be entered as used in an e-mail client. It will often be something like smtp.your_provider.tld.

Both of these options will open an internal GCstar’s window to let you edit the email before sending. But you could also directly use your favorite email client for this task and for the actual sending. With the button Configure mailing programs, you are able to configure these external programs. This will open a window as shown below.

Configuration of mailing programs

You need to set the command line that GCstar should use to launch them in email edition mode. The parameters to use are shown in in the window. These programs could then be selected in the E-mailer list. GCstar comes with some pre-configured email clients.


| Top |

Conveniences tab

This tab contains some boxes that be checked or not. Corresponding feature is deactivated when the box is unchecked.

First option is to choose if startup screen must be shown or not. When deactivated, startup will be slightly quicker, but you won’t get any feedback about the current operations.

Ask confirmation before item deletion can be used to have a dialog box shown when a deletion is requested. Without this, removals are effective immediatly.

If Automatically save collection is checked, the list is saved when GCstar is quitted or a new collection is opened. When this option is deactivated, only manual save operations perform this. But when leaving the application, you will be prompted for a manual save if there are some pending changes.

Load previous collection on startup lets you start GCstar with the collection you previously opened before leaving it. When it is unchecked, on each start you will be prompted for the creation or import of a collection.

There is then recent collections management. GCstar can stock last opened collections to let user find them quickly through File menu. Option is to select the history size (how many previous collections should be in the menu). The button can be used to clear the history.

en/settings.txt · Last modified: 30/12/2011 01:57 by

Should you have a problem using GCstar, you can open a bug report or request some support on GCstar forums.