Um ein Buddy-List-Theme zu installieren, verschiebt man die theme.xml (ggf. gemeinsam mit einem Vorschau-Bild) nach $PURPLEHOME/themes/$THEMENAME/purple/blist/. Die Antwort auf die Frage, wo sich $PURPLEHOME befindet, gibt es hier.

In Pidgin wählt man das Theme dann unter Werkzeuge - Einstellungen - Themes aus.

Am einfachsten lässt sich ein Theme erstellen, indem man ein vorhandenes Theme als Vorlage nimmt (z.B. indem man das von unten nimmt, in einen Text-Editor kopiert und als theme.xml abspeichert). Ein Buddy-List-Theme besteht aus einer XML-Datei namens theme.xml und optional einem Bild als Vorschau oder Theme-Icon.

Das Wurzelelement der XML-Datei enthält alle Informationen über das Theme, nämlich den Name, Autor, Typ des Themes (pidgin buddy list), sowie den Dateinamen des Vorschaubildes. Außerdem sollte die Datei ein Description-Element enthalten, das eine kurze Beschreibung des Themes liefert.

Die XML-Datei enthält Elemente für unterschiedliche Bereiche der Buddy-Liste:

• blist - Das 'color' Attribut setzt die Hintergrundfarbe für die gesamte Buddy-Liste.
• groups - Hier gibt es zwei Sub-Elemente für aus- und eingeklappte Gruppen. Beide Elemente werden verwendet, um die Schriftart und -farbe des Gruppennamens zu setzen.
• buddys - Dies wird verwendet, um verschiedene Elemente für einen Buddy/Kontakt/Chat zu bestimmen. Hiermit wird die Anordnung der Items für jeden Buddy gesetzt, sowie die Schriftart und Schriftfarbe in Abhängigkeit vom Status.
  • placement - Definiert die Reihenfolge von 0 bis 4 für jedes Element eines Buddys/Kontakts/Chats. -1 wird verwendet, um Elemente zu verstecken. Das show_status-Attribut kann die Statusnachricht für alle Buddys anzeigen oder verstecken. Folgende Attribute existieren:
    • status_icon - Das Icon, das den Status eines Buddys anzeigt (verfügbar, abwesend, beschäftigt, etc.)
    • name - der Name des Buddys/Kontakts/Chats
    • emblem - spezielle Symbole, um Dinge wie bspw. Webclients anzuzeigen
    • protocol_icon - Icons, die anzeigen, welches Protokoll der Buddy verwendet
    • buddy_icon - das Buddy-Icon eines Kontakts
    • show_status - Wenn dieses Attribut auf 1 gesetzt ist, wird die Statusnachricht für jeden Buddy angezeigt, bei 0 wird die Statusnachricht für alle Buddys versteckt.
  • background - das 'color' Attribut bestimmt die Hintergrundfarbe eines jeden Buddys
  • contact_text - setzt Schriftart und -farbe für einen Buddy
  • online_text - setzt Schriftart und -farbe für einen Buddy, der verfügbar ist
  • away_text - setzt Schriftart und -farbe für einen Buddy, der abwesend ist
  • offline_text - setzt Schriftart und -farbe für einen Buddy, der offline ist
  • idle_text - setzt Schriftart und -farbe für einen Buddy, der untätig ist
  • status_text - setzt Schriftart und -farbe für die Statusnachricht eines Buddys
  • message_text - setzt Schriftart und -farbe für einen Buddy, der eine Nachricht gesendet hat
  • message_nick_said_text - setzt Schriftart und -farbe für einen Chat, in dem der eigene Name gesagt wurde

Alle Attribute, die Schriftart und Schriftfarbe betreffen, können leer gelassen werden, oder zu allem geändert werden, was von Pango unterstützt wird.

Pango Schriftart-Beschreibung

Pango Farbenbeschreibung

Die wichtigsten Fälle sind hier vermutlich Schriftart und -größe, die folgendermaßen angegeben werden: font=„Arial 15“ (für Schriftart Arial in 15pt).

Hier ein Beispiel, das die oben beschriebenen Elemente einsetzt:

<?xml version="1.0" encoding="UTF-8"?>
<theme type="pidgin buddy list" 
   name="Beispiel-Theme" 
   author="Name des Autors" 
   image="Beispiel_theme_logo.png"
>
 
 
   <description>
       eine kurze Beschreibung des Themes
   </description>
 
   <blist color="#000000"/>
 
   <groups>
       <expanded background="#FFFFFF" color="#000000" font=""/>
       <collapsed background="black" color="white" font=""/>
   </groups>
 
   <buddys>
       <placement status_icon="0" 
              name="1" 
              emblem="2" 
              protocol_icon="3"
              buddy_icon="4" 
              show_status="1"
        />
 
       <background color="#111111"/>
 
       <contact_text font="Purisa" color="#FFDFBF"/>
 
       <online_text font="Arial 15" color="#FFDFBF"/>
       <away_text font="" color=""/>
       <offline_text font="" color=""/>
       <idle_text font="" color=""/>
 
       <message_text font="" color=""/>
       <message_nick_said_text font="" color=""/>
 
       <status_text font="" color=""/>
   </buddys>
</theme>

Wenn das Theme fertig ist, kann man es wie oben beschrieben installieren. Möglicherweise ist ein Neustart von Pidgin notwendig, bevor man es unter Werkzeuge - Einstellungen - Themes auswählen kann.