annotate README @ 2229:761fa220a717

tools (common/uri): minor comment update
author Goffi <goffi@goffi.org>
date Thu, 20 Apr 2017 17:20:44 +0200
parents 4f189bd1d9ed
children 8b37a62336c3
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1997
3c92c0b977b5 version update (0.6.1)
Goffi <goffi@goffi.org>
parents: 1935
diff changeset
1 SàT v0.6.1
1766
d17772b0fe22 copyright update
Goffi <goffi@goffi.org>
parents: 1718
diff changeset
2 (c) Jérôme Poisson aka Goffi 2008-2016
d17772b0fe22 copyright update
Goffi <goffi@goffi.org>
parents: 1718
diff changeset
3 (c) Adrien Cossa aka Souliane 2013-2016
0
goffi@necton2
parents:
diff changeset
4
goffi@necton2
parents:
diff changeset
5 SàT is a XMPP (Jabber) client.
goffi@necton2
parents:
diff changeset
6
goffi@necton2
parents:
diff changeset
7
874
1f5ad976fa32 some typos fixes in the README files
souliane <souliane@mailoo.org>
parents: 871
diff changeset
8 ** LICENCE **
0
goffi@necton2
parents:
diff changeset
9
goffi@necton2
parents:
diff changeset
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
goffi@necton2
parents:
diff changeset
12 the Free Software Foundation, either version 3 of the License, or
goffi@necton2
parents:
diff changeset
13 (at your option) any later version.
goffi@necton2
parents:
diff changeset
14
goffi@necton2
parents:
diff changeset
15 SàT is distributed in the hope that it will be useful,
goffi@necton2
parents:
diff changeset
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
goffi@necton2
parents:
diff changeset
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
goffi@necton2
parents:
diff changeset
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
goffi@necton2
parents:
diff changeset
21 along with SàT. If not, see <http://www.gnu.org/licenses/>.
goffi@necton2
parents:
diff changeset
22
goffi@necton2
parents:
diff changeset
23
871
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
24 ** ABOUT **
0
goffi@necton2
parents:
diff changeset
25
871
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
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
goffi@necton2
parents:
diff changeset
28
goffi@necton2
parents:
diff changeset
29 For the moment, the frontends are:
goffi@necton2
parents:
diff changeset
30
2104
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
31 * primitivus: a console interface client, for terminal lovers
871
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
32 * jp: the powerful command line toolkit.
2104
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
33 * libervia: the web frontend. It's in a different package, check libervia on the wiki: https://wiki.goffi.org/wiki/Libervia
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
34 * cagou: the desktop/mobile frontend. It's in a different package
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
35 * bellaciao: a Qt frontend at an early development stage (development currently paused)
0
goffi@necton2
parents:
diff changeset
36
goffi@necton2
parents:
diff changeset
37 other frontends planed in the near future:
goffi@necton2
parents:
diff changeset
38
871
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
39 * mobile frontends, fuse frontend, etc.
0
goffi@necton2
parents:
diff changeset
40
goffi@necton2
parents:
diff changeset
41
871
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
42 ** HOW TO USE IT ? **
0
goffi@necton2
parents:
diff changeset
43
871
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
44 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
45
2104
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
46 A wiki is available online (https://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
goffi@necton2
parents:
diff changeset
47
goffi@necton2
parents:
diff changeset
48
871
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
49 ** MISC **
0
goffi@necton2
parents:
diff changeset
50
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
51 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
52 $ 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
53
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 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
55
874
1f5ad976fa32 some typos fixes in the README files
souliane <souliane@mailoo.org>
parents: 871
diff changeset
56 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
57
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 --- /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
59 #!/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
60
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 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
62
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 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
64 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
65 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
66 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
67
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 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
69 --- 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
70
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 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
72 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
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 --
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
75
587
952322b1d490 Remove trailing whitespaces.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents: 581
diff changeset
76 You can find Primitivus shortcuts on the wiki:
2104
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
77 https://wiki.goffi.org/wiki/Primitivus
348
8ff113e2abcb updated README and CHANGELOG
Goffi <goffi@goffi.org>
parents: 322
diff changeset
78
0
goffi@necton2
parents:
diff changeset
79 --
goffi@necton2
parents:
diff changeset
80
2104
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
81 SàT is the acronym (yes another one :( ) in tribute to the song Salut à Toi from the Bérurier Noir band and it means "hi to you" (which seems appropriate for a communication software). If you want to listen to the song, we also recommend the excellent cover from Les Ogres de Barback.
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
82 jp stands for "Jabber coPy" or "JumP", and was choosen for its similarity with "cp" and short name.
1201
62135e3ca7ff misc: README typos fixes
Matteo Cypriani <mcy@lm7.fr>
parents: 1192
diff changeset
83 Primitivus is based on Urwid, and, according to their FAQ, "ur" is a German prefix for "ancestral or primal" (primitivus is a latin word).
2104
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
84 Libervia is made from "Liber" (libre) and via (road, path). It could be understood as the libre road, or the path to freedom.
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
85 Cagou is the name of a beautiful bird (who bark and can't fly) from New-Caledonia, and it's also a wink to Kivy, the framework used.
0
goffi@necton2
parents:
diff changeset
86
goffi@necton2
parents:
diff changeset
87
871
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
88 ** CREDIT **
0
goffi@necton2
parents:
diff changeset
89
181
a566f654929e README update:
Goffi <goffi@goffi.org>
parents: 57
diff changeset
90 A big big thank to the authors/contributors of...
a566f654929e README update:
Goffi <goffi@goffi.org>
parents: 57
diff changeset
91
0
goffi@necton2
parents:
diff changeset
92 proxy65:
874
1f5ad976fa32 some typos fixes in the README files
souliane <souliane@mailoo.org>
parents: 871
diff changeset
93 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
94 As the original MIT licence allows, the code is reused and sub-licenced until GPL v3 to follow the rest of the code.
0
goffi@necton2
parents:
diff changeset
95
goffi@necton2
parents:
diff changeset
96 progressbar:
181
a566f654929e README update:
Goffi <goffi@goffi.org>
parents: 57
diff changeset
97 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
goffi@necton2
parents:
diff changeset
98
goffi@necton2
parents:
diff changeset
99 twisted:
348
8ff113e2abcb updated README and CHANGELOG
Goffi <goffi@goffi.org>
parents: 322
diff changeset
100 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
goffi@necton2
parents:
diff changeset
101
24
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents: 0
diff changeset
102 wokkel:
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents: 0
diff changeset
103 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
104
181
a566f654929e README update:
Goffi <goffi@goffi.org>
parents: 57
diff changeset
105 Urwid:
a566f654929e README update:
Goffi <goffi@goffi.org>
parents: 57
diff changeset
106 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
107
348
8ff113e2abcb updated README and CHANGELOG
Goffi <goffi@goffi.org>
parents: 322
diff changeset
108 Pyjamas:
874
1f5ad976fa32 some typos fixes in the README files
souliane <souliane@mailoo.org>
parents: 871
diff changeset
109 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
8ff113e2abcb updated README and CHANGELOG
Goffi <goffi@goffi.org>
parents: 322
diff changeset
110
2104
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
111 Kivy and its linked tools (python-for-android, buildozer, plyer, pyjnius):
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
112 Kivy and linked tools (https://kivy.org) are used to build Cagou frontend, and to port it on several platforms. Excellent pieces of software, well thought,
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
113
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
114 Kivy garden:
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
115 in addition to Kivy itself, extension from the garden are used:
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
116 - contextmenu: used to display main and context menus
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
117
1541
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
118 lxml(http://lxml.de/):
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
119 this powerful and efficient XML parsing module is used sometimes to replace Twisted internal tools: its API is handy, and it have some features like evil content cleaning.
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
120
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
121 pillow(https://python-pillow.github.io/):
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
122 This image manipulation module is used for avatars
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
123
348
8ff113e2abcb updated README and CHANGELOG
Goffi <goffi@goffi.org>
parents: 322
diff changeset
124 txJSON-RPC:
8ff113e2abcb updated README and CHANGELOG
Goffi <goffi@goffi.org>
parents: 322
diff changeset
125 Libervia use txJSON-RPC (https://launchpad.net/txjsonrpc), a twisted library to communicate with the browser's javascript throught JSON-RPC
8ff113e2abcb updated README and CHANGELOG
Goffi <goffi@goffi.org>
parents: 322
diff changeset
126
578
28331ecf0a65 misc: README cleaning + added Mutagen to credits
Goffi <goffi@goffi.org>
parents: 576
diff changeset
127 Mutagen:
1541
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
128 Mutagen (https://bitbucket.org/lazka/mutagen) is an audio metadata handling library, it's used by the radiocol plugin.
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
129
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
130 Python OTR (http://python-otr.pentabarf.de), PyCrypto (https://www.dlitz.net/software/pycrypto) and pyOpenSSL(https://github.com/pyca/pyopenssl):
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
131 Used for cryptography
578
28331ecf0a65 misc: README cleaning + added Mutagen to credits
Goffi <goffi@goffi.org>
parents: 576
diff changeset
132
1157
c4b62e6b7377 add licence information for otr.js and dependencies
souliane <souliane@mailoo.org>
parents: 900
diff changeset
133 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
134 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
135 - 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
136 - 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
137 - 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
138 - 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
139 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
140
1541
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
141 mardown (https://pythonhosted.org/Markdown/) and html2text (https://pypi.python.org/pypi/html2text/2015.6.21):
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
142 both are used for syntaxes conversions
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
143
1717
77a010f1f8cb README and README4PACKAGERS: add Jinja2 to the dependencies list
souliane <souliane@mailoo.org>
parents: 1561
diff changeset
144 Jinja2 (http://jinja.pocoo.org/):
77a010f1f8cb README and README4PACKAGERS: add Jinja2 to the dependencies list
souliane <souliane@mailoo.org>
parents: 1561
diff changeset
145 a poweful template engine for Python that we use for designing Libervia's static blog pages
77a010f1f8cb README and README4PACKAGERS: add Jinja2 to the dependencies list
souliane <souliane@mailoo.org>
parents: 1561
diff changeset
146
1541
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
147 miniupnp (http://miniupnp.free.fr/):
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
148 this UPnP-IGD implementation is used to facilitate P2P sessions
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
149
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
150 netifaces (https://pypi.python.org/pypi/netifaces):
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
151 when available, this module is used to detect local IPs
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
152
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
153 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
154 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
a566f654929e README update:
Goffi <goffi@goffi.org>
parents: 57
diff changeset
155
a566f654929e README update:
Goffi <goffi@goffi.org>
parents: 57
diff changeset
156 the powerfull ImageMagick (http://www.imagemagick.org/) is used by the script written to split the previously named picture.
a566f654929e README update:
Goffi <goffi@goffi.org>
parents: 57
diff changeset
157
1541
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
158 PyXDF (http://freedesktop.org/wiki/Software/pyxdg):
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
159 Used to follow FreeDesktop XDG standards
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
160
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
161 A special thank to people working on XMPP standards, libre standards are the way to go !
685fad1c18e4 README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents: 1396
diff changeset
162
0
goffi@necton2
parents:
diff changeset
163 and the others:
2104
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
164 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 we 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 this.
0
goffi@necton2
parents:
diff changeset
165
2104
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
166 If we forgot any credit (and we probably have), please contact us (mail below) to fix it.
24
61124cb82fb7 Updated README and licenses (for images), added installation instructions.
Goffi <goffi@goffi.org>
parents: 0
diff changeset
167
871
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
168
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
169 ** CONTRIBUTORS **
0
goffi@necton2
parents:
diff changeset
170
482
e0d1eed4a46b misc: updated README with contributors
Goffi <goffi@goffi.org>
parents: 480
diff changeset
171 Salut à Toi has received contributions from:
e0d1eed4a46b misc: updated README with contributors
Goffi <goffi@goffi.org>
parents: 480
diff changeset
172
1201
62135e3ca7ff misc: README typos fixes
Matteo Cypriani <mcy@lm7.fr>
parents: 1192
diff changeset
173 - 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
goffi@necton2
parents:
diff changeset
174
1201
62135e3ca7ff misc: README typos fixes
Matteo Cypriani <mcy@lm7.fr>
parents: 1192
diff changeset
175 - Xavier Maillard <xavier@maillard.im>: bugs fixes. He's following the project for a while, maybe a future frontend contributor?
0
goffi@necton2
parents:
diff changeset
176
816
4429bd7d5efb misc (README): updated Link Mauve and Dal contributions, moved Souliane as a main contributor
Goffi <goffi@goffi.org>
parents: 811
diff changeset
177 - 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
178
1201
62135e3ca7ff misc: README typos fixes
Matteo Cypriani <mcy@lm7.fr>
parents: 1192
diff changeset
179 - 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
180
1201
62135e3ca7ff misc: README typos fixes
Matteo Cypriani <mcy@lm7.fr>
parents: 1192
diff changeset
181 - 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
182
1201
62135e3ca7ff misc: README typos fixes
Matteo Cypriani <mcy@lm7.fr>
parents: 1192
diff changeset
183 - Dal <kedals0@gmail.com>: profiles management, argparse refactoring in jp.
658
e26134122ed7 misc: added Dal to contributors
Goffi <goffi@goffi.org>
parents: 640
diff changeset
184
1204
2ee0cd57144e misc: added Olly Betts to contributors + various fixed for Matteo Cypriani
Goffi <goffi@goffi.org>
parents: 1203
diff changeset
185 - 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
186
2006
0ddf3edf643a added Chteufleur in contributors in README
Goffi <goffi@goffi.org>
parents: 1997
diff changeset
187 - Olly Betts <olly@survex.com>: icon fix in Wix [N.B: Wix has since been removed]
0ddf3edf643a added Chteufleur in contributors in README
Goffi <goffi@goffi.org>
parents: 1997
diff changeset
188
2025
43516c915ca6 misc: updated Chteufleur contributions in README
Goffi <goffi@goffi.org>
parents: 2006
diff changeset
189 - Geoffrey Pouzet <chteufleur@kingpenguin.tk>: XEP-0070 and XEP-0184 implementations
900
21681070f913 misc: added Naha to README
Goffi <goffi@goffi.org>
parents: 887
diff changeset
190
482
e0d1eed4a46b misc: updated README with contributors
Goffi <goffi@goffi.org>
parents: 480
diff changeset
191 Many thanks to them.
0
goffi@necton2
parents:
diff changeset
192
1201
62135e3ca7ff misc: README typos fixes
Matteo Cypriani <mcy@lm7.fr>
parents: 1192
diff changeset
193 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
194
871
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
195
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
196 ** CONTACT **
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
197
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
198 You can join us on the XMPP MUC room (sat@chat.jabberfr.org), or individually:
0
goffi@necton2
parents:
diff changeset
199
2104
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
200 SàT team:
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
201 - contact@salut-a-toi.invalid (replace invalid by org)
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
202 - https://libervia.org/blog/salut-a-toi (blog)
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
203
871
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
204 Goffi:
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
205 - goffi@goffi.org (e-mail)
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
206 - goffi@jabber.fr (jid)
2104
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
207 - https://www.goffi.org (blog - based on Libervia -, with fresh news about SàT)
871
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
208
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
209 Souliane:
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
210 - souliane@mailoo.org (e-mail)
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
211 - souliane@libervia.org (jid)
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
212
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
213 You'll find the latest version and other stuffs on *.goffi.org websites:
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
214
1201
62135e3ca7ff misc: README typos fixes
Matteo Cypriani <mcy@lm7.fr>
parents: 1192
diff changeset
215 - 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
216 - 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
217 - bugtracker (bugs.goffi.org) to report any problem or give suggestions
871
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
218 - mailing lists (lists.goffi.org)
5d08ab99e8dd README and INSTALL updates
Goffi <goffi@goffi.org>
parents: 816
diff changeset
219
2104
4f189bd1d9ed misc: README update
Goffi <goffi@goffi.org>
parents: 2025
diff changeset
220 and the official SàT website is at https://www.salut-a-toi.org
0
goffi@necton2
parents:
diff changeset
221
goffi@necton2
parents:
diff changeset
222
goffi@necton2
parents:
diff changeset
223 This software is dedicated to Roger Poisson.