π

the XMPP client from hell

Experimental and extremely weird XMPP client made with Go. No solicitors.

pi is currently pre-pre-pre-pre alpha software which you should not use right now.

pi uses Fyne for the frontend and uses the Oasis SDK for XMPP functionality.

pi is an extremely opinionated client. It aims to have as little extra windows as possible, instead using alt-menus to perform many of the actions you'd see in a typical client.

διαμόρφωση

(configuration)

When you launch pi, you will be greeted with a create account screen. You will then be able to enter your XMPP account details and then relaunch the application to log in.

If you want to add MUCs or DMs, you must configure the program. Here is the general idea:

{
	"Login": {
		"Host": "example.com:5222",
		"User": "user@example.com",
		"Password": "123456",
		"DisplayName": "user",
		"NoTLS": false,
		"StartTLS": true,
		"Mucs": [
			"room1@group.example.com",
			"room2@group.example.com"
		]
	},
	"DMs": [
		"mike@example.com",
		"louis@example.com"
	],
	"Notifications": false
}

Edit this file as necessary.

Currently joining and saving DM tabs is not supported, nor is getting avatars, reactions, encryption of media embed.

As of writing, pi supports basic message sending and receiving, replies and file upload.

να χτίσω

(building)

To build pi, you will need the latest version of Go, at least 1.21. You can grab it here.

The build instructions are very simple. Simply clone the repo, fetch the repositories and build the program:

Here is a summary of the commands you would need to use to build and run the program:

git clone https://github.com/sunglocto/pi
cd pi
go mod tidy
go build .
vim pi.json
./pi

Uh, Windows???

Eventually. Don't count on it.

Static executable snapshots are also provided for GNU/Linux systems.

χρήση

(usage)

TODO

επιπλέον

(extra)

Pi version numbers are the digits of Pi followed by a letter indicating the phase of development the program is in.

For example, the version string:

3.14a

Is the third version produced in the alpha phase.

The digits of Pi will reset back to 3 when moving to a new phase.

If the number gets too long, it will reset to one digit of 2π. Once that gets to long, it will be digits of 3π and etc.

Named after Psi.