Mercurial > libervia-backend
annotate README @ 1525:49d33cb48207
plugin file: first draft:
This plugin will be used to manage file transfers, and choose the best available method.
It embed a class dedicated to files: SatFile, which act as a file objects but manage some high level stuffs (like progression).
author | Goffi <goffi@goffi.org> |
---|---|
date | Fri, 25 Sep 2015 19:19:12 +0200 |
parents | 069ad98b360d |
children | 685fad1c18e4 |
rev | line source |
---|---|
1208 | 1 SàT v0.5.1 |
1396 | 2 (c) Jérôme Poisson aka Goffi 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015 |
3 (c) Adrien Cossa aka Souliane 2013, 2014, 2015 | |
0 | 4 |
5 SàT is a XMPP (Jabber) client. | |
6 | |
7 | |
874
1f5ad976fa32
some typos fixes in the README files
souliane <souliane@mailoo.org>
parents:
871
diff
changeset
|
8 ** LICENCE ** |
0 | 9 |
10 SàT is free software: you can redistribute it and/or modify | |
480
2a072735e459
Licence modification: the full project is now under AGPL v3+ instead of GPL v3+
Goffi <goffi@goffi.org>
parents:
459
diff
changeset
|
11 it under the terms of the GNU Affero General Public License as published by |
0 | 12 the Free Software Foundation, either version 3 of the License, or |
13 (at your option) any later version. | |
14 | |
15 SàT is distributed in the hope that it will be useful, | |
16 but WITHOUT ANY WARRANTY; without even the implied warranty of | |
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
480
2a072735e459
Licence modification: the full project is now under AGPL v3+ instead of GPL v3+
Goffi <goffi@goffi.org>
parents:
459
diff
changeset
|
18 GNU Affero General Public License for more details. |
0 | 19 |
480
2a072735e459
Licence modification: the full project is now under AGPL v3+ instead of GPL v3+
Goffi <goffi@goffi.org>
parents:
459
diff
changeset
|
20 You should have received a copy of the GNU Affero General Public License |
0 | 21 along with SàT. If not, see <http://www.gnu.org/licenses/>. |
22 | |
23 | |
871 | 24 ** ABOUT ** |
0 | 25 |
871 | 26 SàT is a XMPP (Jabber) client, made on a daemon/frontends architecture. Its aim is not only to be an instant messaging client: SàT manage microblogging, file transfer, rich text edition, piping over XMPP, XMPP remote, etc. |
874
1f5ad976fa32
some typos fixes in the README files
souliane <souliane@mailoo.org>
parents:
871
diff
changeset
|
27 In addition, SàT has been built with ethic in mind, a social contract show the main lines (see CONTRAT_SOCIAL or CONTRAT_SOCIAL_en). We have a lot of debates about the right way to do things, more on a social way than on a technical way (but consider technique too). |
0 | 28 |
29 For the moment, the frontends are: | |
30 | |
181 | 31 * primitivus: a console interface client, for screen lovers |
871 | 32 * jp: the powerful command line toolkit. |
348 | 33 * libervia: the web frontend. It's in a different package, check libervia on the wiki: http://wiki.goffi.org/wiki/Libervia |
871 | 34 * bellaciao: a Qt frontend at an early development stage |
0 | 35 |
36 other frontends planed in the near future: | |
37 | |
871 | 38 * mobile frontends, fuse frontend, etc. |
0 | 39 |
40 | |
871 | 41 ** HOW TO USE IT ? ** |
0 | 42 |
871 | 43 For installation instructions, please read the file "INSTALL". Note that SàT is available in several GNU/Linux distributions |
238
83d2bc0abf2a
version, README, CHANGELOG and INSTALL updates
Goffi <goffi@goffi.org>
parents:
228
diff
changeset
|
44 |
1201 | 45 A wiki is available online (http://wiki.goffi.org), in French and English so far (we would appreciate any help for other languages). You can also have a look at the bottom of this files (in contact section) for other available websites. |
0 | 46 |
47 | |
871 | 48 ** MISC ** |
0 | 49 |
626
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
50 To use SàT, you need to have D-Bus daemon launched (http://www.freedesktop.org/wiki/Software/dbus/). If you use X Window, it should already be launched. If your are on a terminal environment without X11 (e.g. on a server) you may have to launch it. You can launch a daemon using the following command: |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
51 $ eval `dbus-launch --sh-syntax` |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
52 |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
53 Be careful to use the same environment variables if you start a new session. |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
54 |
874
1f5ad976fa32
some typos fixes in the README files
souliane <souliane@mailoo.org>
parents:
871
diff
changeset
|
55 I personally use the following script to do that automatically: |
626
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
56 |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
57 --- /usr/local/bin/dbus-launch.sh --- |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
58 #!/bin/sh |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
59 |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
60 DBUS_PATH="/tmp/.dbus.`whoami`" |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
61 |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
62 if [ ! -e $DBUS_PATH ]; then |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
63 dbus-launch --sh-syntax > $DBUS_PATH |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
64 chmod 400 $DBUS_PATH |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
65 fi |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
66 |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
67 cat $DBUS_PATH |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
68 --- end of /usr/local/bin/dbus-launch.sh --- |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
69 |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
70 You can launch this script by putting at the end of your .zshrc (or whatever you're using): |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
71 eval `/usr/local/bin/dbus-launch.sh` |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
72 |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
73 -- |
190ccc6dc36c
doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27.
Goffi <goffi@goffi.org>
parents:
614
diff
changeset
|
74 |
587
952322b1d490
Remove trailing whitespaces.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
581
diff
changeset
|
75 You can find Primitivus shortcuts on the wiki: |
348 | 76 http://wiki.goffi.org/wiki/Primitivus |
77 | |
0 | 78 -- |
79 | |
874
1f5ad976fa32
some typos fixes in the README files
souliane <souliane@mailoo.org>
parents:
871
diff
changeset
|
80 SàT is the acronym (yes another one :( ) in tribute to the song Salut à Toi from the Bérurier Noir band. I recommend also the excellent cover from Les Ogres de Barback. |
871 | 81 jp stands for "Jabber coPy" or "JumP". |
1201 | 82 Primitivus is based on Urwid, and, according to their FAQ, "ur" is a German prefix for "ancestral or primal" (primitivus is a latin word). |
0 | 83 |
84 | |
871 | 85 ** /!\ PRIVACY WARNING /!\ ** |
0 | 86 |
1201 | 87 To make setup easier, SàT asks a 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 . |
871 | 88 The IP will appear in the private Apache logs (in the same way as IP used to download the software), which are automatically saved, but will not be used. Future releases will probably come with a warning about this and an easy way to avoid it. |
0 | 89 |
90 | |
871 | 91 ** CREDIT ** |
0 | 92 |
181 | 93 A big big thank to the authors/contributors of... |
94 | |
0 | 95 proxy65: |
874
1f5ad976fa32
some typos fixes in the README files
souliane <souliane@mailoo.org>
parents:
871
diff
changeset
|
96 SàT (plugin_xep_0065) use nearly all the code from proxy65 (http://code.google.com/p/proxy65/) which was coded by Dave Smith (2002-2004) and maintained by Fabio Forno (2007-2008). |
1157
c4b62e6b7377
add licence information for otr.js and dependencies
souliane <souliane@mailoo.org>
parents:
900
diff
changeset
|
97 As the original MIT licence allows, the code is reused and sub-licenced until GPL v3 to follow the rest of the code. |
0 | 98 |
99 progressbar: | |
181 | 100 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. |
0 | 101 |
102 twisted: | |
348 | 103 SàT is heavily based on the twisted framework (http://twistedmatrix.com/trac/), 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 :). |
0 | 104 |
24
61124cb82fb7
Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
0
diff
changeset
|
105 wokkel: |
61124cb82fb7
Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
0
diff
changeset
|
106 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. |
61124cb82fb7
Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
0
diff
changeset
|
107 |
181 | 108 Urwid: |
109 Primitivus is based on Urwid (http://excess.org/urwid/) which saved me a lot of time. It's really a great library to easily make a sophisticated interface. | |
24
61124cb82fb7
Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
0
diff
changeset
|
110 |
348 | 111 Pyjamas: |
874
1f5ad976fa32
some typos fixes in the README files
souliane <souliane@mailoo.org>
parents:
871
diff
changeset
|
112 Libervia is built with a Pyjamas (http://pyjs.org), 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 through a browser. It's really an amazing tool. |
348 | 113 |
114 Pyfeed and Xe: | |
1203
6e08ee45bf0a
misc: updated urls of pyxe an pyfeed
Matteo Cypriani <mcy@lm7.fr>
parents:
1201
diff
changeset
|
115 SàT core and Libervia use pyfeed and xe (http://home.avvanta.com/%7Esteveha/pyfeed.html), 2 libraries made Steve R. Hastings really useful to parse/generate xml stuff as atom feeds. |
348 | 116 |
117 txJSON-RPC: | |
118 Libervia use txJSON-RPC (https://launchpad.net/txjsonrpc), a twisted library to communicate with the browser's javascript throught JSON-RPC | |
119 | |
578
28331ecf0a65
misc: README cleaning + added Mutagen to credits
Goffi <goffi@goffi.org>
parents:
576
diff
changeset
|
120 Mutagen: |
28331ecf0a65
misc: README cleaning + added Mutagen to credits
Goffi <goffi@goffi.org>
parents:
576
diff
changeset
|
121 Mutagen (https://code.google.com/p/mutagen/) is an audio metadata handling library, it's use by the radiocol plugin. |
28331ecf0a65
misc: README cleaning + added Mutagen to credits
Goffi <goffi@goffi.org>
parents:
576
diff
changeset
|
122 |
1157
c4b62e6b7377
add licence information for otr.js and dependencies
souliane <souliane@mailoo.org>
parents:
900
diff
changeset
|
123 otr.js and its dependencies Big Integer Library, CryptoJS, EventEmitter: |
c4b62e6b7377
add licence information for otr.js and dependencies
souliane <souliane@mailoo.org>
parents:
900
diff
changeset
|
124 Libervia frontend uses otr.js and its dependencies: |
c4b62e6b7377
add licence information for otr.js and dependencies
souliane <souliane@mailoo.org>
parents:
900
diff
changeset
|
125 - otr.js was coded by Arlo Breault (2014) and is released under the Mozilla Public License Version 2.0 |
c4b62e6b7377
add licence information for otr.js and dependencies
souliane <souliane@mailoo.org>
parents:
900
diff
changeset
|
126 - Big Integer Library was coded by Leemon Baird (2000-2013) and is in the public domain |
c4b62e6b7377
add licence information for otr.js and dependencies
souliane <souliane@mailoo.org>
parents:
900
diff
changeset
|
127 - CryptoJS was coded by Jeff Mott (2009-2013) and is released under the MIT licence |
c4b62e6b7377
add licence information for otr.js and dependencies
souliane <souliane@mailoo.org>
parents:
900
diff
changeset
|
128 - EventEmitter was coded by Oliver Caldwell (2011-2013) and is released under the MIT licence |
c4b62e6b7377
add licence information for otr.js and dependencies
souliane <souliane@mailoo.org>
parents:
900
diff
changeset
|
129 As the original licences allow, the code is reused and sub-licenced until GPL v3 to follow the rest of the code. |
c4b62e6b7377
add licence information for otr.js and dependencies
souliane <souliane@mailoo.org>
parents:
900
diff
changeset
|
130 |
1176
bc3cdf770328
README: redirect media credits to sat_media repository (the pictures are no more hosted here)
souliane <souliane@mailoo.org>
parents:
1157
diff
changeset
|
131 pictures found in the sat_media repository and used by SàT and Libervia: |
bc3cdf770328
README: redirect media credits to sat_media repository (the pictures are no more hosted here)
souliane <souliane@mailoo.org>
parents:
1157
diff
changeset
|
132 Please read the credits and licence information that are given in the README and COPYING files for each work: http://repos.goffi.org/sat_media/file |
181 | 133 |
134 the powerfull ImageMagick (http://www.imagemagick.org/) is used by the script written to split the previously named picture. | |
135 | |
0 | 136 and the others: |
871 | 137 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/), and also XFCE (http://www.xfce.org), etc. Thanks thanks thanks, thanks to everybody in the Free (Libre) chain for making a part of the dream. |
0 | 138 |
24
61124cb82fb7
Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
0
diff
changeset
|
139 If I forgot any credit (and I probably have), please contact me (mail below) to fix it. |
61124cb82fb7
Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents:
0
diff
changeset
|
140 |
871 | 141 |
142 ** CONTRIBUTORS ** | |
0 | 143 |
482
e0d1eed4a46b
misc: updated README with contributors
Goffi <goffi@goffi.org>
parents:
480
diff
changeset
|
144 Salut à Toi has received contributions from: |
e0d1eed4a46b
misc: updated README with contributors
Goffi <goffi@goffi.org>
parents:
480
diff
changeset
|
145 |
1201 | 146 - Adrien Vigneron <adrienvigneron@mailoo.org>: huge work on Libervia's CSS, SàT Logo (the mascot is his work), and Quiz game graphics. He's friendly and talented, his work is really appreciated. |
0 | 147 |
1201 | 148 - Xavier Maillard <xavier@maillard.im>: bugs fixes. He's following the project for a while, maybe a future frontend contributor? |
0 | 149 |
816
4429bd7d5efb
misc (README): updated Link Mauve and Dal contributions, moved Souliane as a main contributor
Goffi <goffi@goffi.org>
parents:
811
diff
changeset
|
150 - Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>: bugs fixes, Libervia's notification, Libervia as a twisted application plugin. A guy always around XMPP projects, he plan to work on a non D-Bus bridge. |
482
e0d1eed4a46b
misc: updated README with contributors
Goffi <goffi@goffi.org>
parents:
480
diff
changeset
|
151 |
1201 | 152 - Matthieu Rakotojaona <matthieu.rakotojaona@gmail.com>: English translation of the social contract. A great quality translation! |
482
e0d1eed4a46b
misc: updated README with contributors
Goffi <goffi@goffi.org>
parents:
480
diff
changeset
|
153 |
1201 | 154 - Thomas Preud'homme <robotux@debian.org>: bugs fixes. He's also one of the co-maintainer of the Debian package. |
614
bef0f893482f
misc: added Thomas Preud'homme to contributors + a thanks message to maintainers =)
Goffi <goffi@goffi.org>
parents:
587
diff
changeset
|
155 |
1201 | 156 - Dal <kedals0@gmail.com>: profiles management, argparse refactoring in jp. |
658 | 157 |
1204
2ee0cd57144e
misc: added Olly Betts to contributors + various fixed for Matteo Cypriani
Goffi <goffi@goffi.org>
parents:
1203
diff
changeset
|
158 - Matteo Cypriani <mcy@lm7.fr>: jp's mainloop update + doc improvements + various fixes. He's also the other co-maintainer of the Debian package. |
2ee0cd57144e
misc: added Olly Betts to contributors + various fixed for Matteo Cypriani
Goffi <goffi@goffi.org>
parents:
1203
diff
changeset
|
159 |
1291
0db0013c59dd
remove remaining references to Wix
souliane <souliane@mailoo.org>
parents:
1208
diff
changeset
|
160 - Olly Betts <olly@survex.com>: icon fix in Wix [N.B: Wix has been removed] |
900 | 161 |
482
e0d1eed4a46b
misc: updated README with contributors
Goffi <goffi@goffi.org>
parents:
480
diff
changeset
|
162 Many thanks to them. |
0 | 163 |
1201 | 164 A big thanks also to all the maintainers of SàT packages. |
614
bef0f893482f
misc: added Thomas Preud'homme to contributors + a thanks message to maintainers =)
Goffi <goffi@goffi.org>
parents:
587
diff
changeset
|
165 |
871 | 166 |
167 ** CONTACT ** | |
168 | |
169 You can join us on the XMPP MUC room (sat@chat.jabberfr.org), or individually: | |
0 | 170 |
871 | 171 Goffi: |
172 - goffi@goffi.org (e-mail) | |
173 - goffi@jabber.fr (jid) | |
174 - http://www.goffi.org (blog, with fresh news about SàT) | |
175 | |
176 Souliane: | |
177 - souliane@mailoo.org (e-mail) | |
178 - souliane@libervia.org (jid) | |
179 | |
180 You'll find the latest version and other stuffs on *.goffi.org websites: | |
181 | |
1201 | 182 - wiki (wiki.goffi.org), in French & English so far |
238
83d2bc0abf2a
version, README, CHANGELOG and INSTALL updates
Goffi <goffi@goffi.org>
parents:
228
diff
changeset
|
183 - ftp (ftp.goffi.org) for the latest version, or previous ones (and other projects) |
83d2bc0abf2a
version, README, CHANGELOG and INSTALL updates
Goffi <goffi@goffi.org>
parents:
228
diff
changeset
|
184 - bugtracker (bugs.goffi.org) to report any problem or give suggestions |
871 | 185 - mailing lists (lists.goffi.org) |
186 | |
187 and the official SàT website is at http://www.salut-a-toi.org | |
0 | 188 |
189 | |
190 | |
191 This software is dedicated to Roger Poisson. |