mirror of
https://forge.fsky.io/lda/Parsee.git
synced 2026-03-13 15:05:11 +00:00
bb836789b2
Suspend killers are now no more. Except the actual killers to be gone eventually. Plumbing is also very basic as of now, but it "works".
61 lines
2.2 KiB
Markdown
61 lines
2.2 KiB
Markdown
# Parsee - the jealous XMPP<=>Matrix bridge
|
|
<img src="https://img.shields.io/liberapay/receives/Parsee.svg?logo=liberapay"><br>
|
|
Parsee is a Matrix<=>XMPP bridge written in C99, with Cytoplasm, similar to Bifrost,
|
|
but it is NOT a drop-in replacment.
|
|
|
|
## Why?
|
|
### Naming
|
|
The name 'Parsee' is actually a reference to [Parsee Mizuhashi](https://en.touhouwiki.net/wiki/Parsee_Mizuhashi), a
|
|
"*bridge* princess".
|
|
|
|
### Reasoning (personal to LDA)
|
|
I hate Bifrost. I also wanted to dip my toes in XMPP, XML, and bridges a bit. Also, as a sister project to KappaChat,
|
|
this means that I can integrate Parsee with KappaChat however I wish it to be, which allows me to mess around with a
|
|
codebase I'm already familiar with.
|
|
|
|
### "Why not just use Matrix lol"
|
|
### "Why not just use XMPP lol"
|
|
These two having the same answer should be enough information. Also can I *just* have fun?
|
|
|
|
~~Also dependency bad.~~
|
|
|
|
## BUILDING
|
|
```sh
|
|
$ make # This generates a 'parsee' executable.
|
|
$
|
|
```
|
|
|
|
### DEPENDENCIES
|
|
Parsee tries to avoid dependencies aside from [Cytoplasm](https://git.telodendria.io/Telodendria/Cytoplasm).
|
|
|
|
## RUNNING
|
|
TODO
|
|
|
|
## DOCS
|
|
TODO
|
|
|
|
## TODOS
|
|
- PROPER FUCKING AVATARS
|
|
XEP-0084 IS THE WORST PIECE OF SHIT KNOWN TO MAN. If any Jabberbros want to
|
|
look at terrible code/XML and suggest things to have *proper* avatar support,
|
|
I'm all in.
|
|
- Look at XEPS-TBD.TXT for XEPs to be done
|
|
- Achievements
|
|
### Why?
|
|
> "[...] and it [BoVeX] has an achievement system, because another thing I don't like is
|
|
> when software will not acknowledge that you've reached an obscure error state, essentially
|
|
> outsmarting it."
|
|
|
|
- [Tom Murphy VII](https://tom7.org)
|
|
|
|
## DONATING/CONTRIBUTING
|
|
If you know things about XMPP or Matrix, yet aren't familiar with C99, or just
|
|
want to suggest a feature, you may open an issue.
|
|
|
|
Packaging Parsee (and Cytoplasm) for your specific platform might be a nice to have,
|
|
to make Parsee easier to setup and manage.
|
|
|
|
**(DON'T FOR NOW, THERE IS LITERALLY NOWHERE THIS GOES TO)**
|
|
You may also donate to [the LiberaPay](https://en.liberapay.com/Parsee), alongside
|
|
[Telodendria's](https://en.liberapay.com/Telodendria), as it is the project
|
|
currently maintaining Cytoplasm.
|