Ayttm: Universal Instant Messaging Client

Ayttm logo



User Manual - | Contents | 1. Getting Online | 2. Chatting | 3. Managing Contacts | 4. Configuration | 5. Advanced |

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.

User Manual - | Contents | 1. Getting Online | 2. Chatting | 3. Managing Contacts | 4. Configuration | 5. Advanced |


Visit our project page on
SourceForge.net Latest version: 0.6.3 (Release notes and Changelog)
Contact: ayttm-users@lists.sourceforge.net.