Creating Dock Icons

The easiest thing to do is to browse into an existing .AdiumIcon (via Show Package Contents in Finder) and see the layout. The pack consists of a number of png files along with an IconPack.plist file which specifies how the png images are used.

If the Apple Developer Tools are installed, you may find it easiest to load the IconPack.plist into the Property List Editor, located in /Developer/Applications.

Alternately, viewed in a text editor, IconPack.plist is formatted in the following manner:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "">
<plist version="1.0">
                <string>Your Title Here</string>
                <string>Your Name Here</string>
                <string>Link to Your Web Site Here</string>
                        <true/> OR </false> (This one is a true or false value)
                        <string>VALUE_SECOND_ITEM_FOR_THIS_STATE (this one is a string)</string>
                        <true/> OR </false> (This one is a true or false value)
                        <string>VALUE_SECOND_ITEM_FOR_THIS_STATE (this one is a string)</string>

You should have <key>state_key</key> and <dict>....</dict> sets for each state you wish to support. The following states are available; all but Invisible are expected to be handled by all dock icon packs, and moderators will reject submitted packs which do not support them.

  • Base
    • Shown when Adium is not connected
  • Online
    • Shown when Adium is connected
  • Alert
    • Shown when unread messages are waiting
  • Away
    • Shown when any account is away
  • Connecting
    • Shown when any account is connecting
  • Idle
    • Shown when any account is idle
  • Preview
    • Shown in the Appearance preference pane's drop down and the dock icon sheet which can be viewed from there
  • Invisible
    • Optional.
  • ApplicationIcon
    • Optional.

Base is the state shown when Adium is not connected. Preview is generally the same as Online.

The ApplicationIcon state is not found in most existing icon packs, so you'll probably need to add it yourself if you make your AdimIcon by modifying another pack. If specified, the image file for ApplicationIcon should be 512x512 pixels. This icon will be used in the Finder, Quick View, and other locations for full-quality display.

All other icons should be 128x128 pixels.

The following keys are available for use with each state:

  • <key>Image</key>
    • <string>filename.png</string> - Applicable only for a non-animating state. The image to show when in the state.
  • <key>Overlay</key>
    • <true/> if the image specified by this state is drawn on top of the Base or Online state as appropriate, or <false/>
  • <key>Animated</key>
    • <true/> if this state animates, or <false/>
  • <key>Delay</key>
    • Applicable only for an animated state. <real>time in seconds</real>, indicating the time between frames of animation
  • <key>Images</key>
    • Applicable only for an animated state. <array> <string>FirstImage.png</string> <string>SecondImage.png</string> .... </array>
Page last modified by Robert, 9 years ago