Advanced Preferences Keys

This page documents all the defaults/preferences keys used by Leapfrog which are not configurable from the GUI of the application.

Setting the Values

The values for these advanced preferences can be set by directly editing the preferences file (by hand or using the "Property List Editor" application), by using the defaults command line tool, or by passing some special arguments to the executable of the application. If you choose to edit the file, its pathname is "~/Library/Preferences/pt.sapo.SAPOMessenger.plist". For the other methods, here are some examples: 

$ defaults write pt.sapo.SAPOMessenger MyKey -string "some text"
$ defaults write pt.sapo.SAPOMessenger MyKey -int 5
$ defaults write pt.sapo.SAPOMessenger MyKey -float 3.0
$ defaults write pt.sapo.SAPOMessenger MyKey -bool TRUE

$ ./SAPO\ Messenger.app/Contents/MacOS/SAPO\ Messenger -MyKey MyStringValue

Preferences Keys

IncludeDebugMenu

  • Type: boolean
  • Default value: FALSE
  • Description: Enables the display of an extra "Debug" menu in the main menu bar. This menu contains commands that show an XML console for the current connection and a viewer for inspecting server disco#items and disco#info data and sapo:agents data. Also enables the display of the presence subscription state for each JID in the "Get Info" window and the display of an extended textual description about every connected resource for all the JIDs of the contact.

IncludeDebugGroups

  • Type: boolean
  • Default value: FALSE
  • Description: Enables the display of all internally used roster groups and the contacts that are members of these groups. Those contacts and groups wouldn't normally be shown in the interface but are kept internally for convenience. This is useful for debugging purposes only.

ShowNonRosterContacts

  • Type: boolean
  • Default value: FALSE
  • Description: Enables the display of contacts that would normally be hidden from the roster list. By setting this key to TRUE, JIDs having no "@" or whose host name component isn't marked as "roster_contact" in the data returned by sapo:agents can then be seen listed in the roster window.

IncludeAdvancedPrefs

  • Type: boolean
  • Default value: FALSE
  • Description: Enables the display of the "Advanced" preferences pane. On this pane there are configuration options for connecting to an alternate server among other things.

RosterNotificationsGracePeriod

  • Type: float
  • Default value: 30.0 seconds
  • Description: This is the duration of the time interval right after we have connected/disconnected during which no contact status change notifications are sent to Growl.

DataTransferProxy

  • Type: string
  • Default value: Item returned by the server disco#info having a feature named "http://jabber.org/protocol/bytestreams".
  • Description: The proxy server used for file transfers.

DebugLoggingToFileEnabled

  • Type: boolean
  • Default value: FALSE
  • Description: Enables the writing of a verbose debug log to a file (currently "~/SapoIM_Debug.log"). When this option is enabled, the user is warned about this at startup and is given a chance to disable the feature and restart the app.