Trac is being migrated to new services! Issues can be found in our new YouTrack instance and WIKI pages can be found on our website.

Version 13 (modified by hsa2, 14 years ago) (diff)

--

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

Attachments (4)

Download all attachments as: .zip

All information, including names and email addresses, entered onto this website or sent to mailing lists affiliated with this website will be public. Do not post confidential information, especially passwords!