Galeon Themes: Creation

This is a quick tutorial explaining how to create and install themes for the Galeon webbrowser. It describes the theme format used by galeon 0.12 and above.

1) Theme format

• Galeon themes consist of a directory filled with images for various parts of the interface.
• Icons may contain alpha-channels.
• Toolbar button images can also have a NAME-prelight.png version, which is displayed when the mouse is above the button. For example Back.png is used when the mouse is not over the button, and Back-prelight.png is used when the mouse is over the button.
• Please use ThemeName.tar.gz style packages, for future expansion of galeon's theme possibilities and consistency.

This list specifies the list of filenames that can be used (if a file isn't provided a default image will be used):

New.png	Toolbar button for opening a new window or tab
Back.png	Toolbar button for going back in history
Up.png	Toolbar button for going up one level
Forward.png	Toolbar button for going forward in history
Refresh.png	Toolbar button for refreshing content
Home.png	Toolbar button for going to your home page
Stop.png	Toolbar button for stopping current data transfer
Go.png	Toolbar button for going to the location specified in the location entry
Bookmarks.png	Toolbar togglebutton for displaying the bookmarks dock
History.png	Toolbar togglebutton for displaying the history dock
Print.png	Toolbar button for printing the currently loaded document
BackHistory.png	Toolbar button for displaying the back history dropdown menu
ForwardHistory.png	Toolbar button for displaying the forward history dropdown menu
ClearLocation.png	Toolbar button for clearing the location entry
insecure.xpm	Statusbar icon for insecure sites
secure.xpm	Statusbar icon for secure sites
small-close.xpm	Tab closebutton
smart-bm-tray.xpm	Smart bookmark tray icon (the ">>" icon in the default theme)
i-bookmark.xpm	Bookmark icon
default.xpm	Default bookmarks folder icon
default_open.xpm	Opened default bookmarks folder icon
dir.xpm	Bookmarks folder icon
dir_open.xpm	Opened bookmarks folder icon

Example theme structure (created when unpacking ExampleTheme.tar.gz):

ExampleTheme/New.png
ExampleTheme/Back.png
ExampleTheme/Up.png
ExampleTheme/Forward.png
ExampleTheme/Home.png
ExampleTheme/Refresh.png
ExampleTheme/Stop.png

2) Installing themes

2.1 Installing themes in your home directory

Uncompress the theme package, if necessary. Put the created directory in ~/.galeon/themes. If a directory wasn't created, create one.

2.2 Installing themes system-wide

Uncompress the theme package, if necessary. Put the created directory in PREFIX/share/galeon/themes. If a direcetory wasn't created, create one.

3) Spinner theme format

• Spinner themes consist of a directoy filled with images for the various frames of the animation.
• Please use SpinnerName.tar.gz style packages, for future expansion of galeon's theme possibilities and consistency.

Spinners consist of images (each image is a frame) labeled like this:

001.png
002.png
003.png
..etc..

Spinners are installed just like ordinary themes, but they should be put in the "spinners" directory instead of the "themes" directory.

4) Publish

Once your theme is done, package it up and either email it to topher@wcsg.org or put it on the web and alert topher@wcsg.org