0d2e55fa14
Add more information to the file README.
90 lines
2.2 KiB
Markdown
90 lines
2.2 KiB
Markdown
# FASI
|
|
|
|
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.
|
|
|
|
### Reasons for creating of FASI
|
|
|
|
The main reasons for the realization of FASI are:
|
|
|
|
- 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;
|
|
- 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.
|
|
|
|
### 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).
|
|
|
|
### Byproduct
|
|
|
|
- Browse services;
|
|
- Explore JID and node items.
|
|
|
|
### Other features
|
|
|
|
- Customization for specific brands (e.g. monocles chat);
|
|
- Dynamic background in accordance to the photo colors.
|
|
|
|
## Technicalities
|
|
|
|
FASI is written in Python and utilizes Jinja2, FastAPI and Slixmpp.
|
|
|
|
FASI require an XMPP account to work, it only needs an XMPP server.
|
|
|
|
## Features
|
|
|
|
- MUC
|
|
- Photo
|
|
- PubSub
|
|
- QR code
|
|
- Service Discovery
|
|
- vCard
|
|
|
|
## XEP
|
|
|
|
- XEP-0030: Service Discovery
|
|
- XEP-0045: Multi-User Chat
|
|
- XEP-0054: vcard-temp
|
|
- XEP-0060: Publish-Subscribe
|
|
|
|
## 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
|
|
|
|
# Similar Projects
|
|
|
|
- [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.
|