Mercurial > libervia-backend
annotate README.md @ 4180:b86912d3fd33
plugin IP: fix use of legacy URL + coroutine use:
An https:/salut-a-toi.org URL was used to retrieve external IP, but it's not valid
anymore, resulting in an exception. This feature is currently disabled.
Also moved several methods from legacy inline callbacks to coroutines.
| author | Goffi <goffi@goffi.org> |
|---|---|
| date | Sat, 09 Dec 2023 14:30:54 +0100 |
| parents | 0ea6b34f8f18 |
| children |
| rev | line source |
|---|---|
| 4080 | 1 # Libervia |
| 0 | 2 |
| 4080 | 3 ### Copyrights |
| 0 | 4 |
| 4080 | 5 - Jérôme Poisson aka Goffi 2008-2023 |
| 6 - Adrien Cossa aka Souliane 2013-2016 | |
| 7 - Additional contributions by community members | |
| 0 | 8 |
| 4080 | 9 Libervia stands out as a one-of-a-kind XMPP (Jabber) client that brings you a |
| 10 comprehensive, multi-purpose, and multi-platform solution. It doesn't just focus on | |
| 11 instant messaging but offers an array of tools and features all in one place. | |
| 12 | |
| 13 ## License | |
| 0 | 14 |
| 4080 | 15 Libervia is a Libre software (Free as in "Freedom"), distributed under the AGPL v3+ |
| 16 license. For the full license, please refer to the `COPYING` file. | |
| 0 | 17 |
| 4080 | 18 ## Relevant URLs |
| 0 | 19 |
| 4080 | 20 Here are some useful URLs, all of which (except for the source code repository) are |
| 21 powered by Libervia itself, showcasing the flexibility and versatility of the tool: | |
| 0 | 22 |
| 4080 | 23 - Official Website: <https://libervia.org> |
| 24 - Documentation: <https://libervia.org/documentation> | |
| 25 - Bug Tracker: <https://libervia.org/tickets> | |
| 26 - Source Code: <https://repos.goffi.org/libervia-backend/> | |
| 27 - News: <https://libervia.org/news> (currently the same as the blog below) | |
| 28 - Main Developer's Blog: <https://www.goffi.org/> | |
|
238
83d2bc0abf2a
version, README, CHANGELOG and INSTALL updates
Goffi <goffi@goffi.org>
parents:
228
diff
changeset
|
29 |
| 4080 | 30 Additionally, our blogs are accessible via ActivityPub thanks to the Libervia XMPP <=> |
| 31 ActivityPub gateway. | |
| 0 | 32 |
| 4080 | 33 ## About |
|
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
|
34 |
| 4080 | 35 Libervia is a unique XMPP client based on a daemon/frontends architecture. It supports |
| 36 multi-frontends (desktop, web, console interface, CLI, etc.) and provides a plethora of | |
| 37 multi-purpose tools such as instant messaging, microblogging, photo albums, calendar | |
| 38 events, file sharing, A/V calls, and state-of-the-art end-to-end encryption. | |
|
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
|
39 |
| 4080 | 40 Embedded within our DNA is a strong commitment to ethics. Our social contract provides |
| 41 insight into these principles - refer to `CONTRAT_SOCIAL` or `CONTRAT_SOCIAL_en`. | |
|
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
|
42 |
| 4080 | 43 This repository contains the "backend" of Libervia—the heart of the software. To use it, |
| 44 you will need to install one or more frontends: | |
|
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
|
45 |
| 4080 | 46 - [Libervia Web](https://repos.goffi.org/libervia-web/): Our flagship frontend, offering a |
| 47 potent, customizable social network for a broad spectrum of users—families, friends, | |
| 48 groups, associations, public services, companies, and more. | |
| 49 - [Libervia Desktop](https://repos.goffi.org/libervia-desktop/): Integrated with your | |
| 50 desktop, this frontend is under continual development. The existing | |
| 51 [Kivy](https://kivy.org/)-based version includes a prototype Android version, with an | |
| 52 upcoming iteration to be based on Qt. | |
| 53 - Libervia CLI: Bundled with Libervia Backend, our CLI is a true standout—one of the most | |
| 54 powerful XMPP CLIs out there. It's the go-to tool for quick tasks or crafting automation | |
| 55 scripts. | |
| 56 - Libervia TUI: Perfect for terminal enthusiasts or headless server operations, our TUI is | |
| 57 included with Libervia Backend. | |
| 0 | 58 |
| 59 | |
| 4080 | 60 Libervia can also function as an XMPP server component or a "generic" plugin. Currently, |
| 61 we offer two components: | |
|
1541
685fad1c18e4
README, README4PACKAGERS: some update about third party modules.
Goffi <goffi@goffi.org>
parents:
1396
diff
changeset
|
62 |
| 4080 | 63 - An advanced file sharing component supporting [HTTP File |
| 64 Upload](https://xmpp.org/extensions/xep-0363.html), [Jingle File | |
| 65 Transfer](https://xmpp.org/extensions), file deletion, public link, access permission, | |
| 66 quotas, etc. | |
| 67 - An XMPP <=> ActivityPub Gateway, enabling users to interact with ActivityPub content | |
| 68 (from platforms like Mastodon, Pleroma, PeerTube, Mobilizon, etc.) as if they were XMPP | |
| 69 blogs or private messages, and vice versa. | |
| 0 | 70 |
| 4080 | 71 ## How To Use It? |
| 658 | 72 |
| 4080 | 73 For installation instructions and general documentation, please refer to the `doc` |
| 74 directory or visit <https://libervia.org/documentation/> | |
| 900 | 75 |
| 4080 | 76 ## Contributions |
|
2549
f685ad80ee98
README: specified URIs location for tickets and merge requests
Goffi <goffi@goffi.org>
parents:
2483
diff
changeset
|
77 |
|
f685ad80ee98
README: specified URIs location for tickets and merge requests
Goffi <goffi@goffi.org>
parents:
2483
diff
changeset
|
78 Here are the URIs you can use to publish/retrieve tickets or merge requests: |
|
f685ad80ee98
README: specified URIs location for tickets and merge requests
Goffi <goffi@goffi.org>
parents:
2483
diff
changeset
|
79 |
| 4080 | 80 - Tickets: xmpp:pubsub.goffi.org?;node=org.salut-a-toi.tickets%3A0 (please use "core" |
| 81 label) | |
| 82 - Merge requests: xmpp:pubsub.goffi.org?;node=org.salut-a-toi.merge_requests%3A0 (please | |
| 83 use "core" label) | |
| 2557 | 84 |
| 4080 | 85 Tickets and merge requests are managed by Libervia itself using XMPP. For more |
| 86 information, visit <https://libervia.org/tickets> | |
| 2104 | 87 |
| 4080 | 88 ## Contact |
| 871 | 89 |
| 4080 | 90 Join us on the XMPP MUC room |
| 91 [libervia@chat.jabberfr.org](xmpp:libervia@chat.jabberfr.org?join) ([web | |
| 92 link](https://chat.jabberfr.org/converse.js/libervia@chat.jabberfr.org)), or contact us | |
| 93 directly: | |
| 871 | 94 |
| 4080 | 95 - contact@salut-a-toi.invalid (replace `invalid` with `org`) |
| 96 - goffi@goffi.invalid (email, replace `invalid` with `org`) | |
| 0 | 97 |
| 98 This software is dedicated to Roger Poisson. |