From SEIA OpenSource Wiki
Jump to: navigation, search

Download the archive from the project site


First step is to uncompress the AMSN archive. You can do this in a directory in your home directory but AMSN will be only available to your user. Also, this is not the beter way to do as you mix program in your data directory. As AMSN does not require to be compiled, the best folder to put it in is /opt (optional packages). So, open a terminal console, and go ahead :

$ su -                                              (Switch to root user)
Password:<Enter your root password>                 (We're now root user (notice the # prompt instead of $)
# cd /opt                                           (Go to /opt directory)
# tar -zxvf /home/your_user/amsn-0_93.tar.gz        (change the path where you saved the downloaded file)
# chown -R root:root amsn-0_93                      (Fix the file owner to root)
# ln -s /opt/amsn-0_93 /opt/amsn                    (Create a symbolic link (like a shortcut)
# ls -ld amsn*                                      (Show you the amsn-0_93 and the shortcut)
# exit                                              (Come back as a standard user)

From the KDE desktop of your user, right click on the desktop and select 'Link to Application' (Mdk9.x) or 'File->Link to Application...' (Mdk10.1). On this dialog:

  • General tab : Enter a name (e.g. AMSN), click on the icon, select 'other icons' as source, click on browse, enter /opt/amsn/icons/64x64 for the path and select aMSN_64.png icon (or the one you like beter :-) )
  • Application tab : Enter a description (e.g. Alvaro's messenger, a comment if you like, and /opt/amsn/amsn for the command

Now, click <OK> and the new icon will be put on your desktop

If you want an icon in the kicker bar, right-click in the bar, select Pannel_Menu->Add->Special_Button->Non-KDE_Application

  • As executable, type /opt/amsn/amsn
  • Click on the icon, select 'Other icons', click browse, and select /opt/amsn/icons/64x64/aMSN_64.png as before.

First run

  • Launch AMSN by double clicking on the icon. The AMSN main window will appear and the about box too. Click <Close> on the about box.
  • You can now select your language (Tool->language...) and some preference (Tools->Preferences...). Some preference will only be available after you create your account.
  • Click on 'Click here to login...'. The login dialog will appear.
  • Click on 'Add New Profile...'
  • Fill the account email address.
  • You can do this several time if needed.
  • Now, select one account, fill the password and click on <OK>
  • The first time you connect, AMSN as to download an encryption module. Select your system architecture (generally, Linux-x86) and click <OK>
  • The download (357Kb) will proceed and the install will be automatically done.
  • At the message 'TLS module installation was sucessful' click <OK>
  • Now login again...


AMSN has a plugins system to extend functionality. Those plugins are not compiled by default and you're on your own. One interresting plugin is the 'traydock' plugin. Compiling is very distro dependant and even on the same distro, it depend on what packages you've installed. So sometimes you should go to the software manager to add some tools or libraries. Here my experience with MandrakeLinux 10.1 Community DVD edition. Install is done as explained in this page. The 'Developpement' group has been selected in the package to install.

$ su -
Password:<Enter root password>
# cd /opt/amsn/plugins/traydock
# urpmi imlib-devel                    (This was not installed on my system)
# ./configure

... to be continued ...