# GTKYahoo Configuration File
#
# Boolean options such as yes or no can also be specified as on/off or
# true/false.
# 
# Backslashes can be used within the quoted strings below to protect quotes
# For example, if your password is abc"123, you could specify any of:
#
#       Password "abc\"123"
#       Password 'abc"123'
#       Password 'abc\"123'
#
# All of the configuration directives are case insensitive. Comments
# are supported, but only on a single line, using any of the common comment
# styles: shell(#), samba(;), c++(//), c(/* */)
#
# NOTE: Anything below marked with NIY is _N_ot _I_mplemented _Y_et
# This means that you can specify the option, but that it won't do anything.
#

# Global and Per-Config Options
# Global sets the defaults, Per-Config changes the settings depending
# on which config you choose when starting gtkyahoo. 
#
# Any of the options that are specified below in the Global section can
# also be specified in the Config sections.
#
Global
	show-online-only no

	#
	# Enable debugging. Debugging is based on particular keys being enabled
	# Keys include: yahoolib, packets, sendraw
	# The special key "all" enables ALL debug traces
	#
	debug "yahoolib"
	debug "packets"
	debug "sendraw"

	# Auto-Reply facility - this allows your pager to automatically reply
	# to messages (answering machine). The first option specifies whether
	# the answering machine is initially turned on or off. The second
	# option (which is optional) specifies the default message
	auto-reply off "Sorry, I'm at work! Call me if it's important."

	# Email Auto-Reply facility - this will send any messages you receive
	# to an email address. The address is passed as-is on a To: line piped
	# to "sendmail -t" (or whatever is configured as the email handler).
	auto-forward off "youraddress@somedomain.com"
	
	# URL handler - defines a command that is executed to view a URL. The
	# URL is passed as the first argument.
	url-handler "/usr/local/bin/netscape"

	# Sound handler - define a command that plays the sound file listed on
	# the command line, used by the "sound" action type
	sound-handler "/usr/local/bin/wavplay"

	# EMail handler - defines a command that is executed to send email. The
	# address is passed as the first argument. This is used for the email
	# auto-reply feature. 
	email-handler "/usr/lib/sendmail"

	# Override default pixmaps.  Supply a path to a valid _xpm_ file.
	# Appropriate transparent background color is 'None'.  We are not
	# using imlib here so you must convert the pixmaps yourself to
	# xpm.
	xpm-status-away "/path/to/pixmap.xpm"
	xpm-status-here "/path/to/pixmap.xpm"
	xpm-status-offline "/path/to/pixmap.xpm"

	#
	# Connection options
	# Type is "normal", "http", "http-proxy", "socks4", "socks5"
	# None of the proxy code is implemented yet.
	#
	#connect-mode "http"  
	#proxy-host "hostname"
	#proxy-port 80
	#proxy-user "userid"
	#proxy-password "password"

	# How many times to re-attempt initial connection
	#connect-retries 5

	# How long (seconds) to wait between each connection attempt
	#connect-delay 1

	# Set the number of rows shown in the friends list in the main window
	#  (-1 will use gtk's suggested default)
	#friends-list-height 12

	# Set the default height and width of chat windows (in characters.
	# specifying -1 for either parameter will use its default)
	#chat-window-size 80 10

	# Do we want word wrap on in chat windows?  If off will still go
	# wrap next line, but might break in the middle of a word.
	# (default=no)
	#chat-window-word-wrap yes

	# Show timestamp on each line of the chat window (default=yes).
	#show-chat-timestamp no

	# Log system messages to a file. Partial path will be interpreted
	# relative to the ~/.gtkyahoo directory.
	# log-file "log"

	# Log all conversations to file(s) based on the specified format. 
	# Currently these are the supported format strings:
	# gtkyahoo specific:
	# @F	chat_from
	# @T	chat_to
	# date and time format follows the format of 'date', man date for more details:
	# %a	The abbreviated weekday name
	# %D	date (mm/dd/yy)
	# %T	time, 24-hour (hh:mm:ss)
	#
	# Partial path will be interpreted # relative to the ~/.gtkyahoo directory.
	# 
	# chat-log-fileformat "%y%m%d-@F-@T-%T"

	# Accept messages from known friends only.
	# friendly-messages-only yes
	# my-fonts-only yes (the default)

	# Show a notification messages in main window
	# show_notify_messages yes

	# Number of seconds of inactivity before marking self as idle
	# Defaults to 300 (5 minutes)
	# idle-time 120

	# Specify an action to be issued in response to an event
	# These are cumulative, if you do more than one, both
	# actions will take place
	# 
	# "type" is one of: all, mail-new, mail-none, logon, logoff
	#	mylogon, mylogoff, message, status
	#
	# "action" is an action defined in an Action/End-Action block
	#	see below for syntax
	# 
	# Events specified in a Config or Contact block will be in effect
	# for that config or contact only.
	#
	# event "type" "action"
End-Global


# Per-Config Options
# Configuration label is what will be displayed in the popup menu
# when you start the pager
#
# Multiple config can be defined, for now, the last one specified is
# what takes effect
Config "configuration label"
	UserID "your_userid_here"
	Password "your_password_here"
End-Config

#
# Per-Contact options
# These allow you to define pager behavior for certain people
#
Contact "contact_name"
	Name "label to show next to name in pager listing"  # NIY!

	# Events specified in a Contact block will be in effect
	# for that contact only.
	#
	# event "type" "action"
End-Contact

#
# Define an action that can be triggered upon certain events
#
#################################################################
# NOTE - With the new actions code, these are not yet implemented
#
# Where appropriate, the following substitutions will be
# made when parsing the *-action command line:
#
# %u = Userid (character string indicating the buddy who just
#      logged on or off)
# %s = Status (int value)
# %o = Old status (int value)
# \% = %
#
# You don't have to use any of these.  I'm happy with just 
# "esdplay beep.wav" for most of mine.
#
# Note, the string substitutions (currently only %u) will strip
# shell metacharacters
#
# You can also use the action type "sound", which will use the 
# "sound-handler" program to play it. By default, this is just
# a 'cat $1 > /dev/audio', so it can only handle headerless ulaw 
# format files.
#
################################################################# 

Action "play beep"
	Type "command"
	Command "wavplay beep.wav"
	Delay 5		# min number of seconds beteen triggerings
End-Action

################################################################# 
# Action Type dialog is now supported
# "parameter" Message must supply a string that is the meesage to
# be displayed at the designated event
################################################################# 

# e.g. when user craig log's on display a dialog saying so!

Action "craig logged on"
	Type "dialog"
	Message "Craig has logged on!"
End-Action

Contact "craig"
	event "logon" "craig logged on"
End-Contact