MSN(2)

NAME
msn - An opensource Python implementation for the MSN messenger protocol version 8

SYNOPSIS

msn [profilename]

DESCRIPTION

This manual page documents briefly the msn command.

This manual page was written for the Debian distribution because the original program does not have a manual page.

msn is a program intended to be used as a proof of concept for the msnlib functions. It shows some of the capabilities of the library.

When a profilename is passed as parameter, msn will use that profile account information (previously configured and stored by msnsetup) to connect.

COMMANDS

The program has a builtin command "help" which shows the latest list of commands available for the program. Below is the complete list of commands available.

In most cases, when you are asked for a nick, you can alternatively enter the email. This makes it easier to handle people with weird or long nicks.

status [mode]
    Shows the current status, or changes it to "mode", which can be one of: online, away, busy, brb, phone, lunch, invisible, idle

q
    Quits the program.

w
    Prints your entire contact list. Contacts connected are highlighted in bold.

ww
    Prints your entire contact list, including email addresses.

wn
    Prints your entire contact list, including real nicknames.

wr
    Prints your reverse contact list (this is simply the list of all the people who have you on their contact list).

wd
    Prints the differences between your forward and reverse lists.

e
    Prints your online contacts.

ee
    Prints your online contacts, including email addresses.

eg
    Prints your online contacts with the groups.

en
    Prints your online contacts, including real nicknames.

h
    Shows your incoming message history. This is a list of the last N messages that you received. The amount is configurable with the directive "input history size" in the msnrc file, which defaults to 10.

add email [nick][groupname]
    Adds the user "email" with the nickname "nick" to the group "groupname".

del nick
    Deletes the user with nick "nick".

ren nick newnick
    Renames the user with nick "nick" to appear as "newnick".

info [nick]
    Without parameters shows your personal info. If a nick is passed as parameter, shows the user information and pending messages (if any). It also includes some advanced information (like the server socket or tid).

lignore [nick]
    Locally ignores the user, or displays the locally ignored users list. This makes the messages coming from the user not to be displayed, but they are still logged so you can see them later.

lunignore nick
    Removes a user from the locally ignored users list.

block nick
    Blocks a user.

unblock nick
    Unblocks a blocked user.

g
    Shows the groups list.

gadd gname
    Adds the group "gname".

gdel gname
    Deletes the group "gname". Note that all the users in the group will be deleted too.

gren old new
    Renames the group "old" with the name "new".

color [theme]
    Shows the available color themes, or sets the color theme to "theme".

close nick
    Closes the switchboard connection with "nick". There is no need to use this command and is included just for advanced users and debugging.

config
    Shows the configuration, in the internal representation, along with other special automatic variables. This means that many commands and values won't have the same format; for instance, instead of 'yes' you will often see a "1". This command is mostly exclusively included for bug reporting.

info [nick]
    Shows the user information and pending messages (if any), or your personal info.

nick [newnick]
    Changes your nick to "newnick", or shows your current nick.

privacy p a
    Sets whether to accept messages from people who is not on your list (p) and require authorization (a).

m nick text
    Sends a message to "nick" with the "text". The standard and most practical way of sending a message. Tab completion expands to this.

a text
    Sends a message with "text" to the last person you sent a message to.

r text
    Sends a message with "text" to the last person that sent you a message.

invite nick1 to nick2
    Invites nick1 into the chat with nick2.

FILES

${HOME}/.msn/msnrc
    The default configuration file for the account information, stored by msnsetup.

${HOME}/.msn/msnrc-{profilename}
    The configuration file for a specific profile name that stores that account information, chosen by the user and stored by msnsetup.

DIAGNOSTICS

The following diagnostics may be issued on stderr:

Bad configuration file. Exiting.
    The configuration file seems to contain a broken configuration line. Use the --verbose option, to get more info.

msn provides some return codes, that can be used in scripts:
Code | Diagnostic
0 | Program exited successfully.
1 | The configuration file seems to be broken.

BUGS

Comments and patches are always welcome; please send them to albertito@blitiri.com.ar

Further information on how to report a bug can be found inside the documentation directory, in the file 'reporting_bugs'.

SEE ALSO

msnsetup(2)

AUTHOR

Julia Palandri <julia.palandri@gmail.com>
    Wrote this manpage for the Debian system.

COPYRIGHT
Copyright © 2011 Julia Palandri

This manual page was written for the Debian system (and may be used by others).

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or (at your option) any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.