You'll need to download the latest client version for your operating system from the release page. Choose the most top list item (click on the version number) and then find the download link. Here's how to choose:


  • macOS: Choose the one with macOS_x86_64 in the name
  • Windows: Choose the one with windows_x86_64 in the name
  • Linux: Choose the one with Linux_x86_64 in the name (unless you're on a different architecture like a raspberry pi)

Once you have the file, unpack the archive. This can generally be accomplished by double-clicking it in your file manager. You should be left with a folder that contains an executable file called wisteria (wisteria.exe on Windows).

Move that executable file wherever you'd like. You just need to remember where so that you can navigate there in a terminal later on.

Create your account

An Arbor account is called an Identity. If you already have a PGP key, wisteria can be launched with FIXME to use that key for Identity creation. If you don't have a key, no worries.

Open a terminal and navigate to the folder where you put the wisteria executable. Run:

# launch the client connected to our server infrastructure

Select Create New Identity and follow the prompts. If you provided your own PGP key, you might be prompted to enter the password.

Using Wisteria

You can use the arrow keys (or h/j/k/l) to scroll your cursor between messages. The red message is selected, and determines the coloration of all other visible messages. Yellow messages are ancestors of the selected message (it is a reply to them), whereas green messages are descendants of the selected message.

You can filter the history to only messages related to the selected message (ancestors and descendants) by pressing the spacebar. Press it again to turn this filter off.

To reply to the selected message, just hit Enter (or Return), type your message, then press Enter (or Return) again. You may be prompted to enter your GPG key passphrase. After that, you should see your new message appear in wisteria and it will be sent to other connected relays.

To start a new conversation (not related to your currently selected reply) press c instead of Enter. You compose your new message in the same way.

You can see the wisteria log by pressing L (press it again to switch back to history).

Updating Wisteria

Follow the directions for installing wisteria, then just launch it.

Going Further

Do you want to:

  • Report a bug? Open a ticket in our issue tracker!
  • Give us some feedback? Send us an email on our mailing list!
  • Get involved? See our home page for ways you can help our community (no code skills required)!

About this wiki

commit 34dece6c77833c5fba2dad338d9fb0360876aeef
Author: Amolith <>
Date:   2020-06-30T11:22:25-04:00

add new diagrams and update docs

I added the new diagrams and updated the docs to include them along with
an explanation of what's going on for the simpler overview.

I included the graphml files so they can be imported and edited/improve
later on but I don't know how they'll work in other programs; I created
them in yEd:

The dark diagrams have transparent backgrounds so they should be
suitable for any shade and the light diagrams are simply white. SVGs are
including for editing colors and exporting at various sizes.
Clone this wiki (read-only) (read/write)