Ayttm: Universal Instant Messaging Client |
|
Advanced Topics
Ayttm is a highly customizable program but what you see in the GUI is
not all! There's some more to Ayttm that's hidden because it's less
often useful but more often confusing to the general user. However if
you're inquisitive, adventurous or just want to impress your Ayttm
using friends, read on, for this chapter has been written for you.
Manually setting preferences
Ayttm's predecessor EveryBuddy had a lot of preferences that are no
longer in the Ayttm GUI to keep things simple. However, those
preferences are still accessible through the Ayttm preferences file:
~/.ayttm/prefs. This file has many name=value lines, where name is the name
of some preference and value is its value. We take a look
below at these preferences.
- x_contact-window=int
- The value of this pref is an integer that gives the distance of
the left edge of Ayttm's main window from the left edge of the
screen, in pixels. This parameter gets set automatically while Ayttm
exits.
- y_contact-window=int
- The value of this pref is an integer that gives the distance of
the top edge of Ayttm's main window from the top edge of the
screen, in pixels. This parameter gets set automatically while Ayttm
exits.
- status_show_level=(0|1|2)
- This pref controls the view that is shown in the main window at
startup. 0 shows the Accounts view, 1 shows the Contacts
view and 2 shows the Online view. Default: 2.
- do _typing_notify=(0|1)
- Set this pref to 0 to disable receiving the "Typing..."
notification in chat windows. Set to 1 to enable receiving this
notification. Default: 1.
- do_send_typing_notify=(0|1)
- This is complementary to the above preference. Set it to 0 to
disable sending "Typing..." notification. People chatting with you
will not be able to see the "ABC is typing a message" or similar
notification from you. Set it to 1 to enable sending this
notification. Default: 1.
- do_escape_close=(0|1)
- Set this pref to 0 to disable closing of chat windows when you
hit the ESC key. Set it to 1 to be able to close chat windows by
hitting the ESC key. Default: 1.
- do_convo_timestamp=(0|1)
- Set this pref to 0 to disable timestamping of each message in a
conversation. Set it to 1 to enable timestamping of all conversation
messages. Default: 0.
- do_enter_send=(0|1)
- Set this pref to 0 to disable sending of messages when you hit the
Enter key. Hitting Enter will then start a new line in the
message that you are typing. Set this pref to 1 to enable sending of
messages when you hit enter. When enabled, you can insert new lines in
your message by hitting Shift+Enter. This preference has no
effect if you disable multi-line chat. Default: 1.
- do_raise_window=(0|1)
- Set this pref to 0 to disable raising of a chat window when a new
message arrives in it. Set it to 1 to raise the chat window when a new
message arrives. This will bring the chat window forward if it was
hidden behind other windows when a new message arrived. Default:
0.
- do_send_idle_time=(0|1)
- Set this preference to 0 to disable sending "Idle" notification to
the servers. Your friends will never see you as "Idle" if you set this
pref to 0. Set it to 1 to enable sending the "Idle"
notification. Default: 1.
- do_timestamp=(0|1)
- Set this preference to 0 if you don't want to have timestamps at
the beginning and ending of conversations. Set this pref to 1 to
enable timestamps at the beginning and end of conversations. Default:
1.
- do_ignore_fore=(0|1)
- Set this pref to 0 to see the text colors that your friends set in
their messages. Set it to 1 to disable text colors set by your
friends. You will then see the text in your default color. Default:
0.
- do_ignore_back=(0|1)
- Set this pref to 0 to see the background colors that your friends
set in their messages. Set it to 1 to disable background colors set by
your friends. You will then see your default background
color. Default: 0.
- do_ignore_font=(0|1)
- Set this pref to 0 to see the fonts that your friends set in their
messages, provided they are available on your system. Set it to 1 to
disable fonts set by your friends. You will then see your default
font. Default: 0.
- do_smiley=(0|1)
- Set this pref to 0 to disable drawing smileys in conversations and
logs. Set this pref to 1 to enable drawing smileys in conversations
and logs. Default: 1.
- FontFace=string
- The font to use by default for conversations. It is recommended
that you set this preference through the GUI. Default: helvetica.
- do_logging=(0|1)
- Set this pref to 0 to disable logging of conversations. Set this
to 1 to enable logging of conversations. You can then view
conversation logs by selecting the View Log
option in a Contact's context-menu. Default: 0.
- do_strip_html=(0|1)
- Set this pref to 0 to disable stripping of HTML tags from
conversation logs. Set this to 1 to enable stripping of HTML tags from
conversation logs. You will then not be able to see any formatting in
the log messages but your logs will be smaller in size. Default:
0.
- do_restore_last_conv=(0|1)
- Set this pref to 0 to disable restoration of the last
conversation. Set this pref to 1 to enable restoration of the last
conversation. If this pref is set to 1, you will see the last
conversation you had with a contact whenever a chat window for that
contact is launched. Default 0.
- do_tabbed_chat=(0|1)
- Set this pref to 0 to disable tabbed
chatting. Set it to 1 to enable tabbed chatting. Default: 0.
- do_tabbed_chat_orient=(0|1|2|3)
- Set this pref to 0 to see chat tabs at the bottom, to 1 to see
tabs at the top, to 2 to see tabs on the left and to 3 to see tabs on
the right edge of the chat window. This pref has no effect if tabbed
chatting is disabled.
- accel_next_tab=string
- This pref controls the keyboard shortcut for switching to the next
tab in a tabbed chat window. It is recommended that you set this pref
through the GUI.
- accel_prev_tab=string
- This pref controls the keyboard shortcut for switching to the
previous tab in a tabbed chat window. It is recommended that you set
this pref through the GUI.
- do_no_sound_when_away=(0|1)
- Set this pref to 0 to enable sounds even when your status is
"Away". Set it to 1 to disable sounds when your status is
"Away". Default: 0.
- do_no_sound_for_ignore=(0|1)
- Set this pref to 0 to enable sounds for ignored contacts. Set it
to 1 to disable sounds for ignored contacts too. Default: 0.
- do_online_sound=(0|1)
- Set this pref to 0 to disable playing of sounds when people sign
on or sign off. Set it to 1 to enable playing of sounds when people
sign on or sign off. Default: 1.
- do_play_send=(0|1)
- Set this pref to 0 to disable playing of a sound every time you
send a message. Set it to 1 to enable playing of a sound when you send
a message. Default: 1.
- do_play_first=(0|1)
- Set this pref to 0 to disable playing a special sound when
receiving the first message of a conversation. Set it to 1 to enable
playing a special sound when receiving the first message of a
conversation. Default: 0.
- do_play_receive=(0|1)
- Set this pref to 0 to disable playing of a sound every time you
receive a message. Set it to 1 to enable playing of a sound when you
receive a message. Default: 1.
- BuddyArriveFilename=string
- Set path to the audio file to be played when a contact signs
on.
- BuddyAwayFilename=string
- Set path to the audio file to be played when a contact goes
"away".
- BuddyLeaveFilename=string
- Set path to the audio file to be played when a contact
leaves.
- SendFilename=string
- Set path to the audio file to be played when a message is
sent.
- ReceiveFilename=string
- Set path to the audio file to be played when a message is
received.
- FirstMsgFilename=string
- Set path to the audio file to be played when the first message is
received.
- SoundVolume=float
- Set a float factor by which the volume of Ayttm sounds must be
lowered relative to the system sound (PCM).Default: 0.000000.
- do_ayttm_debug=(0|1)
- Set this pref to 0 to disable console debug messages from
Ayttm. Set it to 1 to enable console debug messages from
Ayttm. Default: 0.
- do_ayttm_debug_html=(0|1)
- Set this pref to 0 to disable console debug messages related to
HTML parsing from Ayttm. Set it to 1 to enable console debug messages
related to HTML parsing from Ayttm. Default: 0.
- do_plugin_debug=(0|1)
- Set this pref to 0 to disable console debug messages from
Ayttm plugins. Set it to 1 to enable console debug messages from Ayttm
plugins. Default: 0.
- length_contact_window=int
- This pref sets the height of the main window in pixels.
- width_contact_window=int
- This pref sets the width of the main window in pixels.
- do_noautoresize=(0|1)
- Set this pref to 0 to allow auto-resizing. If auto-resizing is
allowed, Ayttm's main window will grow automatically to contain long
contact names or status messages. Set it to 1 to disallow
auto-resizing. Default: 0.
- use_alternate_browser=(0|1)
- Set this pref to 0 to use the default browser for opening
hyperlinks etc. Set it to 1 to if you want to use an alternate
browser. Default: 0.
- alternate_browser=string
- Set the command to the alternate browser. This pref has no effect
if the last pref is set to 0.
- proxy_type=(0|1|2|3)
- Set the type of proxy here. 0 means no proxy, 1 means HTTP proxy,
2 means SOCKS4 proxy and 3 means SOCKS5 proxy. Default: 0.
- proxy_host=string
- Set the hostname or IP address of the proxy to use.
- proxy_port=int
- Set the proxy port number to use.
- do_proxy_auth=(0|1)
- Set this pref to 0 if the proxy to be used doesn't require
authentication. Set it to 1 if the proxy requires
authentication. Default: 0.
- proxy_user=string
- Set the username for proxy authentication.
- proxy_password=string
- Set the password for proxy authentication.
- use_recoding=(0|1)
- Set this to 0 to disable recoding of messages. Set it to 1 to
enable recoding of messages. If this is enabled you can specify
transformation of message encoding between incoming and outgoing
messages. Default: 0.
- local_encoding=string
- Set the local endoding to be used for recoding messages.
- remote_encoding=string
- Set the remote encoding to be used for recoding messages.
- modules_path=string
- Set the path where Ayttm modules can be found.