Sound Themes

Installing

The theme.xml file, all sound files (along with any image preview) should be placed in $PURPLEHOME/themes/$THEMENAME/purple/sound/, where $PURPLEHOME by default is ~/.purple on Linux. Alternatively, in Linux the files can be put in /usr/share/themes/$THEMENAME/purple/sound/, or into $XDG_DATA_HOME/themes/$THEMENAME/purple/sound/, where $XDG_DATA_HOME defaults to ~/.local if not set.

Creating

A theme consists of a XML file called theme.xml, all of the sound files used by the theme, and an optional image preview/logo file.

The root node of the XML file contains all information about the theme including the name, author, type of theme (sound), as well as the name of a image file to display as a preview of the theme. The theme file should also contain a description element which gives a short description of the theme.

Under the root node, the theme should contain a list of event elements. Each event element should contain a name and a file attribute. The name attribute corresponds to the event for which the sound should be played, while the file attribute is the name of the file to play. A file can be used for multiple events and events can be left off so a sound is not played for a particular event. The event names are:

• login - a contact logs in
• logout - a contact logs off
• im_recv - a contact sends a message
• first_im_recv - a contact starts a conversation
• send_im - you send a message
• join_chat - a person enters a chat
• left_chat - a person leaves a chat
• send_chat_msg - you send a message in a chat
• chat_msg_recv - someone else sends a message in a chat
• nick_said - someone says your username in a chat

An example theme would look like:

<?xml version="1.0" encoding="UTF-8"?>
<theme type="sound" name="Example sound theme" author="Your name" image="logo.png">
	<description>This is an example theme.</description>
	<event name="login" file="contact_logged_on.mp3"/>
	<event name="logout" file="contact_logged_off.mp3"/>
	<event name="im_recv" file="im_received.mp3"/>
	<event name="first_im_recv" file="new_im_received.mp3"/>
	<event name="send_im" file="im_sent.mp3"/>
	<event name="join_chat" file="contact_logged_on.mp3"/>
	<event name="left_chat" file="contact_logged_off.mp3"/>
	<event name="send_chat_msg" file="chat_message_sent.mp3"/>
	<event name="chat_msg_recv" file="chat_message_received.mp3"/>
        <!-- event "nick_said" is not set-->
</theme>

Note: Sound files must be in a format compatible with the sound playing method used (for example, only Wave files may be used on Windows)

Example Themes

• Synthetic Frost​ port of the ​Adium sound theme by ​SyntheticFrost
• Synthetic Frost in WAV-format​ conversion of the above Adium sound theme by ​Dirtsa
• GLaDOS Sound theme for Pidgin​ by ​H.Gökhan SARI