It only takes a few steps to get connected in Arbor!

Installation

Sprig is currently the best way to experience Arbor but there is also a CLI client called wisteria for which there is a separate getting started guide. To download the latest version, head to the release page. Choose the topmost list item (click the version number) then find your download link. The Windows release will have windows in the file name, Linux will have linux, and so on.

If you're on Android, there is also an APK that can be downloaded and installed. However, you'll need to have your phone in developer mode, installation from unknown sources enabled, etc. If you don't, don't worry about it and simply wait until it's released in F-Droid or Google Play. A version for iOS is in the works.

Once you have the file, unpack the archive. This can generally be accomplished by double-clicking it in your file manager or you can just use tar xvf <file-name> from the Linux or macOS command line. You'll be left with a single executable named sprig. Move that wherever you'd like but remember its location for later.

Create your account

An Arbor account is called an Identity and creation is quite simple. Open a terminal, navigate to the folder where you put the sprig executable, and double-click it. Confirm that messages are immutable then enter arbor.chat:7117 and click Connect. Make sure you don't press enter as that will currently insert a newline character and the connection will fail. After typing the address, just click the button.

On the next screen, select "Create new Identity", enter your desired username, then click Create. From there, simply click View These Communities!

Using Sprig

By default, all messages are unselected. When you tap one, it becomes selected and its ancestors and children will be a darker colour. To the right of the selected message, there is a Reply button. Clicking that will reveal a dialogue at the bottom of the screen where you can type your reply. The clipboard to the left of the text entry field is for pasting text from your clipboard and the button to the right is for sending the message. Clicking the × in the top right of that dialogue will dismiss it.

At the top of the message view, there are four buttons.

  • Back
    • Simply used to return to the main screen
  • Copy
    • Copy the selected message
  • Filter
    • Only display messages that are direct parents or children of the selected message
  • New conversation
    • This is used to create a new conversation, a message at the root of the tree with no ancestry
Updating Sprig

Simply follow the directions for installing Sprig then just launch it. Feel free to delete the old binary if you wish.

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 0a41a60c21bc80c8c5a6e57e5465dd82b58174ee
Author: Amolith <amolith@secluded.site>
Date:   2020-07-14T23:48:59-04:00

integrate vale

This massive patch attemps to standardise out documentation. For those
unfamiliar with it, Vale is "a syntax-aware linter for prose built with
speed and extensibility in mind" [1]. I built on Vale's
implementation [2] of Google's style guide [3] with specifics for Arbor
and the vocabulary we've started using.

[1]: https://github.com/errata-ai/vale
[2]: https://github.com/errata-ai/Google
[3]: https://developers.google.com/style/

I didn't modify any of the docs that are already written so some of them
will have a ton of errors. Once Arbor's style has been reviewed and a
bit more polished, I'll go through and start implementing the
recommended changes. To that end, install Vale [1], run it on a few
files, and see what the output says. Feedback is welcome.

[1]: https://errata-ai.gitbook.io/vale/getting-started/installation
Clone this wiki
https://git.sr.ht/~whereswaldon/arborchat (read-only)
git@git.sr.ht:~whereswaldon/arborchat (read/write)