view README @ 207:a43b66af3872

browser side: changed bubbles background color
author Goffi <>
date Thu, 27 Jun 2013 22:09:34 +0200
parents 732ed69ffe11
children ce5b33f499c5
line wrap: on
line source

Libervia v0.3.0
(c) Jérôme Poisson aka Goffi 2008, 2009, 2010, 2011, 2012, 2013

Libervia is a frontend for SàT
SàT is a XMPP (Jabber) client.


Libervia is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

Libervia is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with Libervia.  If not, see <>.

It is currently in a very alpha stage, and absolutely not usable for everyday use, use at your own risks !

** WTF ? **

Libervia is a web frontend for the "Salut à Toi" (SàT) XMPP client. Please check SàT for more information (it's anyway needed to run libervia)

** How to use it ? **

Refer to the wiki for installation/use instructions:

** Credit **

All the credits are the same than the ones for "Salut à Toi", as it is a global project.

A big big thank to the authors/contributors of...

SàT (plugin_xep_0065) use nearly all the code from proxy65 ( wich was coded by Dave Smith (2002-2004) and maintained by Fabio Forno (2007-2008).
As the original MIT license allow, the code is reused and sublicensed until GPL v3 to follow the rest of the code.

SàT (jp) use ProgressBar (, a class coded by Nilton Volpato which allow the textual representation of progression.

SàT is heavily based on the twisted framework (, a very great tool which offer a lot of protocols management. There are too many contributors to name them here, so take a look on the website :).

SàT use a library with high level enhancements on top of twisted, which is called wokkel ( Lot of thanks to Ralph Meijer and all other contributors.

wxWidgets & wxPython:
The Wix frontend is made with wxWidgets ( and its python version wxPython (wxPython), which is a really handy UI toolkit who works on most popular platforms. It can be found on probably all major Gnu/Linux distributions.

Primitivus is based on Urwid ( which saved me a lot of time. It's really a great library to easily make a sophisticated interface.

Libervia is built with a Pyjamas (, a Google Web Toolkit port for python, including Python to Javascript compiler, and Pyjamas Desktop which allow to execute the same application on the desktop or throught a browser. It's really an amazing tool.

Pyfeed and Xe:
SàT core and Libervia use pyfeed and xe (, 2 libraries made Steve R. Hastings really useful to parse/generate xml stuff as atom feeds.

Libervia use txJSON-RPC (, a twisted library to communicate with the browser's javascript throught JSON-RPC

Mutagen ( is an audio metadata handling library, it's use by the radiocol plugin.

pictures found in frontends/src/wix/images/crystal/:
These pictures come from Crystal clear, were made by Everaldo Coelho ( and YellowIcon ( They are under LGPL V3 licence (see frontends/src/wix/images/COPYING.LESSER).
Found on and

pictures found in frontends/src/wix/images/cards/ and /public/cards in Libervia:
The Tarot cards pictures come from the deck found on wikicommons (the script used to cut them is available at frontend/src/wix/images/, and available at under Creative Commons BY-SA. The authors shown on the site are Piast and Svick. The splitted cards are, according to the license, available under the same conditions.

the powerfull ImageMagick ( is used by the script written to split the previously named picture.

and the others:
and of course, nothing would be possible without Python (, Gnu and the Free Software Foundation (,, the Linux Kernel (, and the coder of the tools I use like Vim (, Mercurial (, or all the KDE stuff ( and of course, and also XFCE (, etc. Thanks thanks thanks, thank to everybody in the Free (Libre) chain for making a part of the dream.

If I forgot any credit (and I probably have), please contact me (mail below) to fix it.

** Contributors **

Salut à Toi has received contributions from:

- Adrien Vigneron <>: huge work on Libervia's CSS, SàT Logo (the mascot is its work), and Quiz game graphisms. He's friendly and talented, his work is really appreciated.

- Xavier Maillard <>: bugs fixes. He's following the project for a while, maybe a future frontend contributor ?

- Emmanuel Gil Peyrot <>: bugs fixes. A guy always around XMPP projects, he plan to work on a non D-Bus bridge.

- Matthieu Rakotojaona <>: English translation of the social contract. A great quality translation !

Many thanks to them.

** Contact **

You can contact me on (e-mail) or (jid)
You'll find the latest version and other stuffs on my * websites:
- presentation ( the project presentation site
- wiki (, in french & english so far
- ftp ( for the latest version, or previous ones (and other projects)
- blog ( for latest news (in french)
- bugtracker ( to report any problem or give suggestions
- various mailing lists ( are about to be created

This software is dedicated to Roger Poisson.