README
author Myhailo Danylenko <isbear@ukrpost.net>
Thu, 30 Jun 2011 16:09:04 +0300
changeset 36 32424a111e97
parent 23 2b7060ce1152
child 40 fbdae6975352
permissions -rw-r--r--
remove api.h, offending 0.10.0
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
     1
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
     2
This is a module, implementing avatar publishing/retrieving via pep/pubsub.
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
     3
This module informs you, when your buddies publish their avatars via pep
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
     4
and provides command '/avatar' to publish your own. But this is not all.
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
     5
It also will show you buddy's avatar! Yes, it is aalib :)
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
     6
23
2b7060ce1152 New module loading scheme
Myhailo Danylenko <isbear@ukrpost.net>
parents: 11
diff changeset
     7
This module depends on module 'pep'.
0
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
     8
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
     9
For this module to actually do something you should set option
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    10
avatars_directory - a place, where your buddy's avatars will be saved.
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    11
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    12
Note, that currently only pubsub-publishing of avatars is supported
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    13
(retrieving too works only for pubsub, but there you will be at least
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    14
informed of url, that you can use to view avatar manually). Thus, as
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    15
standard states, that pubsub-published data must be image/png, your
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    16
avatar should be in png format.
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    17
2
c1ee5fae2549 Added note about server support for pep and pubsub
Myhailo Danylenko <isbear@ukrpost.net>
parents: 0
diff changeset
    18
To receive notifications you need only to load it (better at startup, as
c1ee5fae2549 Added note about server support for pep and pubsub
Myhailo Danylenko <isbear@ukrpost.net>
parents: 0
diff changeset
    19
I had some problems otherwise due to server's caching features). Then when
c1ee5fae2549 Added note about server support for pep and pubsub
Myhailo Danylenko <isbear@ukrpost.net>
parents: 0
diff changeset
    20
your buddy will change avatar, you will receive notification and new
c1ee5fae2549 Added note about server support for pep and pubsub
Myhailo Danylenko <isbear@ukrpost.net>
parents: 0
diff changeset
    21
avatar will be downloaded, saved and printed to buddy's window. To publish
c1ee5fae2549 Added note about server support for pep and pubsub
Myhailo Danylenko <isbear@ukrpost.net>
parents: 0
diff changeset
    22
avatar you need your server to support both pep and pubsub (many public
c1ee5fae2549 Added note about server support for pep and pubsub
Myhailo Danylenko <isbear@ukrpost.net>
parents: 0
diff changeset
    23
jabber servers offer only pubsub or neither, while for example prosody in
c1ee5fae2549 Added note about server support for pep and pubsub
Myhailo Danylenko <isbear@ukrpost.net>
parents: 0
diff changeset
    24
default debian's complectation supports only pep).
c1ee5fae2549 Added note about server support for pep and pubsub
Myhailo Danylenko <isbear@ukrpost.net>
parents: 0
diff changeset
    25
4
43eb96df8612 Mention AAOPTS in README
Myhailo Danylenko <isbear@ukrpost.net>
parents: 2
diff changeset
    26
You can use AAOPTS environment variable to set aalib operation options, like
43eb96df8612 Mention AAOPTS in README
Myhailo Danylenko <isbear@ukrpost.net>
parents: 2
diff changeset
    27
contrast, brightness, etc (you can change mcabber environment at run-time
43eb96df8612 Mention AAOPTS in README
Myhailo Danylenko <isbear@ukrpost.net>
parents: 2
diff changeset
    28
with env module). For a list of options see aalib documentation:
43eb96df8612 Mention AAOPTS in README
Myhailo Danylenko <isbear@ukrpost.net>
parents: 2
diff changeset
    29
http://aa-project.sourceforge.net/aalib/aalib_9.html
43eb96df8612 Mention AAOPTS in README
Myhailo Danylenko <isbear@ukrpost.net>
parents: 2
diff changeset
    30
0
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    31
INSTALLATION
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    32
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    33
To install it, you need:
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    34
loudmouth
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    35
glib
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    36
aalib
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    37
libpng
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    38
mcabber's headers
10
f9ab0b7f462a mention pep as dep
Myhailo Danylenko <isbear@ukrpost.net>
parents: 7
diff changeset
    39
pep module's headers
0
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    40
cmake
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    41
make
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    42
gcc
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    43
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    44
Then do
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    45
$ mkdir build
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    46
$ cd build
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    47
$ cmake ..
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    48
$ make edit_cache
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    49
$ make
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    50
# make install
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    51
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    52
Debian users can instead of make install do
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    53
$ fakeroot make package
11
2f9ffa1c24c5 Change mcabber headers naming scheme
Myhailo Danylenko <isbear@ukrpost.net>
parents: 10
diff changeset
    54
# dpkg -i libmcabber-avatar*.deb
0
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    55
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    56
Users of other distributions can select appropriate package
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    57
generator, using cache editor.
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    58
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    59
LICENSE
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    60
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    61
This code underlies terms of GNU GPL v2 or later. You can find it in file COPYING
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    62
from this distribution or on a GNU web-site <http://www.gnu.org/licenses/>.
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    63
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    64
CONTACTS
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    65
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    66
I will be happy to get feedback, patches, suggestions, etc.
7
b33256405413 Update contact jid
Myhailo Danylenko <isbear@ukrpost.net>
parents: 4
diff changeset
    67
You can send me email or contact via jabber <isbear@unixzone.org.ua>.
0
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    68
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    69
  -- Myhailo Danylenko <isbear@ukrpost.net>
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    70
29423ceb6adf Initial commit
Myhailo Danylenko <isbear@ukrpost.net>
parents:
diff changeset
    71