Salut à Toi/en

De Goffiwiki.


We have a presentation website on http://salut-a-toi.org

Sommaire

Overview

Salut à Toi (or SàT for "Hi to You"), is a XMPP/Jabber client which can have several frontends, i.e. several user interfaces.

You can get some descriptions and follow the development on this blog (most of time in French, sometimes in English).
A global presentation is available here.

Download

You can download the last version here: ftp://ftp.goffi.org/sat/sat.tar.bz2
If you want an older version, you can get it at: ftp://ftp.goffi.org/sat/
Source code is also available on the mercurial repository: http://repos.goffi.org/sat/

You can clone the hg repository with:

hg clone http://repos.goffi.org/sat/

Installation

Last release

stable version is currenlty not up-to-date on pypi, we recommand using development version for the moment

You can automatically install SàT and its dependencies using easy_install or pip. You will however need to install Python's headers (needed to build some packages), PyGObject and developments version of libxml2 and libxslt (to compile lxml python library). On some ARM systems like Raspberry Pi or OLinuXino, it is also required to install libjpeg-dev and libffi-dev beforehand.

The environment variable SAT_INSTALL customises the installation, it contains flags separated by spaces:

  • "nopreinstall" skip all preinstallation checks
  • "autodeb" automatically install missing packages on Debian based distributions

PyGobject is automatically installed on Debian based distributions if "autodeb" option is set. Indeed, on Debian based distribution, you can type:

sudo apt-get install python-pip python-virtualenv python-dev libxml2-dev libxslt-dev libjpeg-dev libffi-dev zlib1g-dev
virtualenv --system-site-packages sat
source sat/bin/activate
pip2 install -U setuptools
SAT_INSTALL="autodeb" pip2 install sat

After installing SàT, you need to install the media:

mkdir -p /path/to/sat_media
cd /path/to/sat_media
wget ftp://ftp.goffi.org/sat_media/sat_media.tar.bz2
tar -jxvf sat_media.tar.bz2

then, create a ~/.sat.conf file which contains:

[DEFAULT]
media_dir=/path/to/sat_media

Of course, replace /path/to/sat_media with the actual path you want to use.

Development version

You can also install the last development version following the same instructions than for the last release, but installing from the mercurial repository instead of using the release archives. This gives:

sudo apt-get install python-pip python-virtualenv mercurial python-dev libxml2-dev libxslt-dev libjpeg-dev libffi-dev zlib1g-dev
virtualenv --system-site-packages sat
source sat/bin/activate
pip2 install -U setuptools
SAT_INSTALL="autodeb" pip2 install "hg+http://repos.goffi.org/sat/"

After installing SàT, you need to install the media:

mkdir -p /path/to
cd /path/to
hg clone http://repos.goffi.org/sat_media

then, create the file ~/.config/sat/sat.conf containing:

[DEFAULT]
media_dir=/path/to/sat_media

Of course, replace /path/to with the actual path you want to use.

Usage

To launch the sat backend, enter:

sat

You can stop it with:

sat stop

To know if backend is launched or not:

sat status

NOTE: since SàT v0.5.0, the backend is automatically launched when a frontend needs it.

Frontends

So far, the following frontends exist:

To launch Primitivus, just type:

primitivus

then create a profile (XMPP account must already exist). To use jp, follow its help:

jp --help

For Libervia, the web interface, check http://wiki.goffi.org/wiki/Libervia/en

These other frontends are in development or planned:

  • Bellacio based on Qt, a rich desktop frontend
  • Cagou a frontend based on Kivy that will work on both desktop and Android devices.

The following frontends have been deprecated:

  • Wix, a desktop frontend based on WxWidgets, deprecated with version 0.6.0

Plugins

SàT not only focuses on instant messaging: XMPP has a huge potential, and other applications are considered. For example, a French Tarot game is already available. SàT uses a plugin system and it allows to display a certain user interface on the various frontends. The Tarot game works equally in the Primitivus's terminal display and in Libervia's web interface - each player of a game can use the frontend of his or her choice.

Features

Here is a list of main SàT features, click on them to go to the wiki page.

  • Web interface usable from any web browser
  • Console interface, light and powerful
  • Command line tool, useful to script
  • Instant messaging
  • Rich text and WYSIWYG editor
  • Micro-blogging with a static webpage/feed generated from your public posts
  • Ad-Hoc commands, i.e. to use SàT as a remote control for your applications
  • Pipe a command output or send a file to one of your contact
  • Using an email client (MUA) to send/receive messages
  • French Tarot game, collective radio...

The full features set is described here.

Community

You can join our chat room on sat@chat.jabberfr.org
There are also mailing lists available: http://lists.goffi.org
Bugs or suggestions can be added to: http://bugs.goffi.org

Developers can have a look at the development page.

Autres langues