view README @ 72:f271fff3a713

MUC implementation: first draft /!\ the experimental muc branche of wokkel must be used - bridge: new roomJoined signal - wix: contact list widget is now in a separate file, and manage different kinds of presentation - wix: chat window now manage group chat (first draft, not working yet) - wix: constants are now in a separate class, so then can be accessible from everywhere - wix: new menu to join room (do nothing yet, except entering in a test room) - new plugin for xep 0045 (MUC), use wokkel experimental MUC branch - plugins: the profile is now given for get_handler, cause it can be used internally by a plugin (e.g.: xep-0045 plugin)
author Goffi <goffi@goffi.org>
date Sun, 21 Mar 2010 10:28:55 +1100
parents a5b5fb5fc9fd
children a566f654929e
line wrap: on
line source

SàT
(c) Jérôme Poisson aka Goffi 2008, 2009, 2010

SàT is a XMPP (Jabber) client.





** LICENSE **

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

SàT is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with SàT.  If not, see <http://www.gnu.org/licenses/>.



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





** WTF ? **
SàT is a XMPP (Jabber) client, made on a daemon/frontend architecture. Its aim is not only to be an instant messagery client: XMPP offer a lot more, and differents tools will come in the future.

For the moment, the frontends are:

* wix: a wxwidget frontend, the main graphical frontend
* sortilège: a ncurses client, for screen lovers
* jp: the command line toolkit. The tool for geeks by geeks

other frontends planed in the near future:

* a web frontend
* a KDE 4 frontend, as KDE is my main desktop environment





** How to use it ? **

For installation instructions, please read the file "INSTALL".

SàT is really at an early dev stage, so it's maybe the buggiest software you have ever seen, and there are for the moment absolutely nothing to ease the installation and use (but it will be the case ASAP, one of the goal of the project is the ease of use).
There will probably be a wiki doc in the future.





** Misc **

-- Shortcuts for sortilège (temporary):
C-L: access contact list (enter to valid)
F2: Show/Hide contact list
C-S: Short representation of contacts in chat window
C-C: Use colors... or not
C-T: Timestamp
C-X: Leave
--

SàT is the acronym (yes another one :( ) in tribute to the song Salut à Toi from the Bérurier Noir band. I recommand also the excelent cover from Les Ogres de Barback.
jp stands for Jabber coPy or JumP. If you look well, you can also find my initials ;)
sortilège means "spell" in french, and it is ncurses based...
wix come of course from the WX of wxwidgets and just sound cool :).


** /!\ Privacy warning /!\ **

To make setup easier, SàT ask my website (http://www.goffi.org) the external ip address of client. So a request is made to this page: http://www.goffi.org/sat_tools/get_ip.php .
The IP are not collected. Future releases will probably come with a warning about this and an easy way to avoid it.


** Credit **

proxy65:
SàT (plugin_xep_0065) use nearly all the code from proxy65 (http://code.google.com/p/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. Thanks a lot to them !

progressbar:
SàT (jp) use ProgressBar (http://pypi.python.org/pypi/progressbar/2.2), a class coded by Nilton Volpato which allow the textual representation of progression. thanks to him

twisted:
SàT is based on the twisted framework (http://twistedmatrix.com/trac/), a very great tools which offer a lot of protocols management. There are too many contributors to name them here, so take a look on the website :). Again, thanks to them

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

wxWidgets & wxPython:
The Wix frontend is made with wxWidgets (www.wxwidgets.org) 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. as usual, thanks to the authors.

pictures found in frontends/wix/images/crystal/:
These pictures come from Crystal clear, were made by Everaldo Coelho (www.everaldo.com) and YellowIcon (www.yellowicon.com). They are under LGPL V3 licence (see frontends/wix/images/COPYING.LESSER). Thanks to them.
Found on http://commons.wikimedia.org/wiki/File:Crystal_Clear_app_browser.png and http://commons.wikimedia.org/wiki/File:Crystal_Clear_app_cache.png

and the others:
and of course, nothing would be possible without Python (http://www.python.org/), Gnu and the Free Software Foundation (http://www.gnu.org, http://www.fsf.org/), the Linux Kernel (http://www.kernel.org/), and the coder of the tools I use like Vim (http://www.vim.org/), Mercurial (http://www.selenic.com/mercurial/wiki/), or all the KDE stuff (http://www.kde.org/ and of course http://amarok.kde.org/), 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.





** Contact **

You can contact me on goffi@goffi.org . Yes I know, I don't give my JID ;)
You'll find the latest version on my website: http://www.goffi.org (it's mainly in french, I will probably make a little part in english in the future).



This software is dedicated to Roger Poisson.