Manual

Introduction

This article is a stub, it needs translation from the Manuel in French. Help is welcome.

Minimal configuration

• Processor : Pentium 2 166Mhz
• Read only memory vive (RAM) : 32 Méga Octets
• Operating system : GNU/Linux, BSD, MacOSX, Windows
• Video : A 3D card is NOT required.

The user interface

Main window

The main menu. On the left the main sections. On top the sub menus.

Administering GCompris

Activity selection

Select an activity.

Profile creation

Editing profiles.

User and class creation

The classes and the users.

Groups creation

Creating groups.

Reporting

Trace usage for the children Jon.

Identification

Children recognize their name and click on it.

Children enter their login.

Deployment

If you administer a school network, you can over load the configuration options of your users by yours. To edit a configuration file, the easiest way is to create one from GCompris. Simply configure GCompris as you wish, quit it and copy the created configuration file in the system one. From it, you can remove the options you don't want to be compulsory.

Configuration file example:

music=1
fx=1
screensize=1
fullscreen=1
timer=1
key="default"

GNU/Linux

On GNU/Linux, the configuration file is in the user directory under ~/.config/gcompris/gcompris.conf

You must copy your own system configuration file under /etc/gcompris.conf

Windows

On Windows, the configuration file is in C:\Documents and Settings\YOUR USER\.config\gcompris\gcompris.conf

You must put the system configuration file at the GCompris's root installation directory. By default, it's C:\Program Files\Gcompris

On Windows, it makes sense to put at least the line 'key="your 6 digit key"'. This way, all users on this PC won't have to activate GCompris.

On school networks, you can simply copy this file using your deployment system.

Portable GCompris

Portable software is a class of software that is suitable for use on portable drives such as a USB (thumb) drive or iPod, although any external hard drive could theoretically be used. The concept of carrying one's favored applications, utilities, and files on a portable drive for use on any computer is one which has evolved considerably in recent years.

GCompris can be made portable very easily by installing it on the target thumb drive and adding in its directory a gcompris.conf configuration file which includes a local user and configuration directory. The directory are specified as relative to the gcompris.exe binary.

Configuration file example:

user_dir="../My GCompris"
config_dir="../GCompris_config"
key="your 6 digit key if you have it"

Useful options

Running GCompris from a console with the --help option will display all the parameters it accepts:

• -f, --fullscreen run gcompris in fullscreen mode.
• -w, --window run gcompris in window mode.
• -s, --sound run gcompris with sound enabled.
• -m, --mute run gcompris without sound.
• -c, --cursor run gcompris with the default gnome cursor.
• -d, --difficulty display only activities with this difficulty level.
• -D, --debug display debug informations on the console.
• -v, --version Print the version of gcompris
• -x, --noxf86vm Disable XF86VidMode (No screen resolution change).
• -l, --root-menu Run gcompris with local menu (e.g -l /reading will let you play only activities in the reading directory, -l /strategy/connect4 only the connect4 activity)
• -L, --local-activity Run GCompris with local activity directory added to menu
• -a, --administration Run GCompris in administration and user-management mode
• -b, --database Use alternate database for profiles [$HOME/.config/gcompris/gcompris_sqlite.db]
• -j, --logs Use alternate database for logs
• --create-db Create the alternate database for profiles
• --reread-menu Re-read XML Menus and store them in the database
• -p, --profile Set the profile to use. Use 'gcompris -a' to create profiles
• --profile-list List all available profiles. Use 'gcompris -a' to create profiles
• --config-dir Config directory location: [$HOME/.config/gcompris]. Alternate is to set $XDG_CONFIG_HOME.
• --user-dir The location of user directories: [$HOME/My GCompris]
• --experimental Run the experimental activities
• --disable-quit Disable the quit button
• --disable-config Disable the config button
• --display-resource Display the resources on stdout based on the selected activities
• --server GCompris will get images, sounds and activity data from this server if not found locally.
• --web-only Only when --server is provided, disable check for local resource first. Data are always taken from the web server.
• --cache-dir In server mode, specify the cache directory used to avoid useless downloads.
• -g, --drag-mode Global drag and drop mode: normal, 2clicks, both. Default mode is normal.
• --nobackimg Do not display the background images of activities.