Skip to content

JCLemme/misfin

Repository files navigation

misfin (is) mail (for the) small web

💬 📯 📬

misfin://hello@misfin.org What's up?\r\n
↓↓↓↓
20 1e:9f:11:e4:8f:aa:12:b3:cb...

what is this?

Misfin is to email what Gemini is to the Web. Set up a Misfin server alongside your Gemini capsule, and start networking with other capsuleers - no signup required. For the full details, see gemini://misfin.org/ .

details?

A Misfin message is a single string of UTF-8 gemtext, no more than 2,048 characters long. Want to write more? Send two messages. What about attachments? Host it on a Gemini server and add a link line - you get the fingerprint of your recipient back, so you can even gate access if it's eyes only. Keeping Misfin mail simple makes it a better fit for the small web - it's easier to implement, easier to secure, and easier to keep running.

i don't like it?

Good, because we're still trying to nail down the details. This version is Misfin(B), but there's another, more SMTP-like version - Misfin(A) - that is also implemented here. Eventually we're settling on one or the other, but feel free to experiment. For the moment though? Download the reference implementation, make a certificate, and send your comments to misfin://rfc@misfin.org. (Or make a ticket on sourcehut, or on Github, or post about it on station, or w/e).

run your own

There isn't a production mailserver written yet, but you can run the (new! improved!) testing suite and send/receive mail. Run python -m transponder.debug to see how. (You'll need to install pyopenssl first).

python -m transponder.debug make-cert queen "Queen bee" hive.com queen_hive.pem
python -m transponder.debug receive-as queen_hive.pem

...

python -m transponder.debug make-cert bee "Worker bee" hive.com bee_hive.pem
python -m transponder.debug send-as bee_hive.pem queen@hive.com "Where's the flowers at"

About

The Misfin mail protocol

gemini://misfin.org/

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published