Prefs.yaml

From Digsbies Wiki

Prefs.yaml is the text file which defines preferences that are not configurable via the Preferences window in Digsby. Many Digsby features can be tweaked by making a change to the prefs.yaml file.

Creating prefs.yaml

Prefs.yaml does not exist by default, and must be created in the customization directory. A text editor like notepad, or Notepad++ may be used. Ensure that the file is not saved as prefs.yaml.txt. Make sure you can see file extensions. An improperly-named file will not be registered and used by Digsby.

Understanding yaml

YAML is a flexible human-readable format that is used liberally in Digsby for storing information on disk. To edit YAML, one must understand that whitespace is significant, and data structure hierarchy is maintained by outline indentation. That is, the amount of space in front of the words on a line is necessary, and alternation will change the meaning of that line.

A sample YAML document:

receipt:     Oz-Ware Purchase Invoice
date:        2007-08-06
customer:
    given:   Dorothy
    family:  Gale

items:
    - part_no:   A4786
      descrip:   Water Bucket (Filled)
      price:     1.47
      quantity:  4

More information on YAML is available at the aforementioned link.

Placing customizations in prefs.yaml

While there is not true documentation for prefs.yaml, the values listed in defaults.yaml are all legal. Below is an excerpt of defaults.yaml for Digsby r26376

trayicons:
    digsby:
        show_status_orb: yes
        show_available_orb: no
        unread_messages:
            flash_interval_ms: 1000
            show_count: yes
            flash_only_count: no
    email:
        gray_on_empty: yes
        show_count: yes

More information can be found on the official Digsby message board.