README... and excuse me for my bad english!

======================================= Installing ====================================

First of all you should have conky installed. You can do it with your distro's package
manager or downloading source and compile it. If you want audacious support and another
special things that conky has, you should download the source and compile it. But if you
have gentoo things are more easier ;)

* If you are reading this, you have already downloaded the tarball... Extract its contents
to some directory you have access on your system.
* Copy the conkyrc file to ~/.conkyrc
* Copy the scripts folder to ~/.scripts
* Edit ~/.conkyrc according to your wishes... in following sections I will explain how to
customize scripts, for more details about conky itself see the man page.

=========================== Hotmail Script customizing =================================

The conky config file calls the hotmail script in the line:

${execpi 300 python ~/.scripts/hotmail.py usuario contraseña 4}

In the file this line appears twice because I have a laptop with wireless connection and
ethernet connection. To check your own msn mail, just edit the parameters of the execpi
command. For example, if your hotmail user is example555@hotmail.com, and your password
is password, you should edit these lines like this:

${execpi 300 python ~/.scripts/hotmail.py example55 password 4}

The latest "4" says to the script max number of mails that it can show in conky. Obviously,
you can edit it.

But if you have another type of msn account, like ...@hotmail.es, ...@msn.com, ...@live.com
and another, you need edit the script directly. Open ~/.scripts/hotmail.py, and go to 13
line. It puts the following:

urllib.FancyURLopener.prompt_user_passwd = lambda self, host, realm: ("%s@hotmail.com" % usuario, password)

If you have, for example, and ...@hotmail.fr account, edit the piece between the "", to make it like this:

urllib.FancyURLopener.prompt_user_passwd = lambda self, host, realm: ("%s@hotmail.fr" % usuario, password)

But WARNING! I don't know if another hotmail type of accounts can be readed by hotmailrss
(www.palmeteo.com/hotmailrss), the part that read the hotmail account.

If you don't like the way that new mails are shown (very probably), just change the 22 line
to the following:

print '> %20.20s%s : %20.20s%s' % (de, len(de) >= 25 and '...' or '', asunto, len(asunto) >= 25 and '...' or '')

In Gmail script you can do the same, in the 26 line.

============================ Gmail Script customizing ==================================

Gmail script is a little like the hotmail script. Conky config file calls gmail script in the
line:

${execpi 300 python ~/.scripts/gmail.py usuario contraseña 4}

Just change "usuario" with your gmail user, "contraseña" with your password and the "4" for the 
max number of mails you want watch. 

If you don't like the way that new mails are shown (very probably), just change the 26 line,
like is explained in the Hotmail section.

============================= Portage section customizing ===============================

This is only for gentoo users. If your distribution is not gentoo, just delete these lines:

${font Liberation Mono:bold:size=9}${alignc}>>> PORTAGE [${execi 300 ~/.scripts/portage.py}] <<<${font}
${execi 50 genlop -lnu | sed -e 's/.*\([><]\+\)/\1/' | tail -n 4}

But if you are a happy gentoo user, you should have genlop installed. You can do it with

emerge -lav genlop

This section shows the latest emerged packages and the date when portage was synced last.
You can customize how many packages editing this line in .conkyrc file:

${execi 50 genlop -lnu | sed -e 's/.*\([><]\+\)/\1/' | tail -n 4}

The latest number is how many packages it will show. Change this number according to your
wishes.
