2024-10-07 19:02:41 +02:00
|
|
|
# FASI
|
|
|
|
|
2024-10-08 09:13:40 +02:00
|
|
|
Fast And Sleek Invite (FASI)
|
|
|
|
|
|
|
|
## About
|
|
|
|
|
|
|
|
FASI is an HTML invite page for XMPP.
|
|
|
|
The main purpose, is to provide an interface to share XMPP contacts via HTML
|
|
|
|
browsers.
|
|
|
|
It also provides an interface to explore XMPP server conferences, pubsub and
|
|
|
|
other services.
|
|
|
|
|
2024-10-08 14:59:23 +02:00
|
|
|
### Reasons for creating FASI
|
2024-10-08 14:20:29 +02:00
|
|
|
|
2024-10-09 17:14:25 +02:00
|
|
|
The main reasons for the realization of FASI are to:
|
2024-10-08 14:20:29 +02:00
|
|
|
|
|
|
|
- Add interactive capabilities, as well as vCard information;
|
|
|
|
- Create rapport with the viewers, by displaying vCard information, such as Full
|
|
|
|
Name and Description or Note;
|
2024-10-08 14:59:23 +02:00
|
|
|
- Realize the beautiful simplicity of XMPP, so that more people would be
|
|
|
|
motivated to utilize, install, serve, and develop XMPP software;
|
2024-10-08 14:20:29 +02:00
|
|
|
- Charm our "normie" friends, so called, by displaying an attractive contact
|
|
|
|
HTML page, which they can also utilize;
|
|
|
|
- Utilize an invitation page, with XMPP capabilities, regardless to the software
|
|
|
|
that powers an XMPP server;
|
|
|
|
- Realize that HTTP is obsolete and should be treated as an optional publishing
|
|
|
|
mean, because anything that HTTP offers, is already possible with XMPP, since
|
|
|
|
a couple of decades ago.
|
2024-10-09 17:14:25 +02:00
|
|
|
- Extend support for Gopher and Gemini, which do not allow scripts, and,
|
|
|
|
therefore, a server-side is essential for these ASCII type mediums.
|
2024-10-08 14:20:29 +02:00
|
|
|
|
|
|
|
### Special features
|
|
|
|
|
|
|
|
- Fetch vCards and photos;
|
|
|
|
- Indicate of available conferences, nodes and services;
|
|
|
|
- Retrieve number of conferences, nodes, participants, node items and services;
|
|
|
|
- Preview recent conference messages;
|
|
|
|
- View journal articles (i.e. PubSub node items that are published as Atom Over
|
|
|
|
XMPP).
|
|
|
|
|
2024-10-09 17:14:25 +02:00
|
|
|
### Unintended features
|
2024-10-08 14:20:29 +02:00
|
|
|
|
|
|
|
- Browse services;
|
|
|
|
- Explore JID and node items.
|
|
|
|
|
|
|
|
### Other features
|
|
|
|
|
2024-10-09 17:14:25 +02:00
|
|
|
- Customization for specific brands (e.g. Conversations, Cheogram, monocles chat
|
|
|
|
and yaxim);
|
|
|
|
- Dark mode;
|
2024-10-08 14:20:29 +02:00
|
|
|
- Dynamic background in accordance to the photo colors.
|
|
|
|
|
|
|
|
## Technicalities
|
|
|
|
|
2024-10-08 09:13:40 +02:00
|
|
|
FASI is written in Python and utilizes Jinja2, FastAPI and Slixmpp.
|
|
|
|
|
2024-10-08 14:20:29 +02:00
|
|
|
FASI require an XMPP account to work, it only needs an XMPP server.
|
|
|
|
|
2024-10-08 09:13:40 +02:00
|
|
|
## Features
|
2024-10-08 14:20:29 +02:00
|
|
|
|
2024-10-08 09:13:40 +02:00
|
|
|
- MUC
|
|
|
|
- Photo
|
|
|
|
- PubSub
|
|
|
|
- QR code
|
2024-10-08 14:20:29 +02:00
|
|
|
- Service Discovery
|
2024-10-08 09:13:40 +02:00
|
|
|
- vCard
|
|
|
|
|
2024-10-08 14:20:29 +02:00
|
|
|
## XEP
|
|
|
|
|
|
|
|
- XEP-0030: Service Discovery
|
|
|
|
- XEP-0045: Multi-User Chat
|
|
|
|
- XEP-0054: vcard-temp
|
|
|
|
- XEP-0060: Publish-Subscribe
|
|
|
|
|
2024-10-08 09:13:40 +02:00
|
|
|
## Install
|
|
|
|
|
|
|
|
Use the following commands, to begin FASI.
|
|
|
|
|
|
|
|
```shell
|
|
|
|
git clone https://git.xmpp-it.net/sch/FASI
|
|
|
|
cd FASI/
|
|
|
|
python -m uvicorn fasi:app
|
|
|
|
```
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
AGPL-3.0-only
|
|
|
|
|
|
|
|
## Copyright
|
|
|
|
|
|
|
|
Schimon Jehudah Zachary 2024
|
2024-10-08 14:20:29 +02:00
|
|
|
|
2024-10-08 14:59:23 +02:00
|
|
|
## Thanks
|
|
|
|
|
2024-10-09 17:14:25 +02:00
|
|
|
A special thank you for Mr. Georg Lukas of [op-co.de](https://op-co.de/) from
|
|
|
|
Germany, who has gracefully published a sophisticated client-side HTML
|
|
|
|
invitation page, and consequently exposed that idea to the founder of this
|
|
|
|
project.
|
2024-10-08 14:59:23 +02:00
|
|
|
|
|
|
|
## Similar Projects
|
2024-10-08 14:20:29 +02:00
|
|
|
|
|
|
|
- [Easy XMPP Invitation Landing Page](https://github.com/modernxmpp/easy-xmpp-invitation) from Mr. Georg Lukas;
|
|
|
|
- [mod_invite](https://modules.prosody.im/mod_invite.html) module for Prosody.
|