gist/briar/README.md

# Briar notes

Briar is a P2P over Tor messenger that can also peer over LAN and Bluetooth.

`my-accounts.csv` has list of my Briar addresses, as there isn't support
for multiple devices. They possibly should be in aminda.eu, but I don't
know what would be a good way to show them as browser integrated CSV
viewers are rare and I don't think these would be in so much demand.

_Note that as per the FAQ, the connection request needs to be accepted
within 48 hours by entering your Briar address. However after that
introductions can be made without timeout concerns._

Briar doesn't hold as big place in my heart as IRC or Matrix to have a
dedicated page either and my HTML table tendency is effort even if the page
wasn't given a navigation menu entry.

## Contents

<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->

- [My account naming](#my-account-naming)
  - [Which accounts of mine you should care about?](#which-accounts-of-mine-you-should-care-about)
- [Briar desktop](#briar-desktop)
- [Further reading and quotes](#further-reading-and-quotes)

<!-- END doctoc generated TOC please keep comment here to allow auto update -->

## My account naming

I tend to name my accounts `Aminda-HOSTNAME (%Y-%j)` e.g.
`Aminda-Lumina (2022-153)` where `%Y` is year in 4 digits and `%j` the day
of the year (001 to 366). However the older the Briar account still in use,
the more random naming scheme there is.

This is by no means a security feature, anyone can name their device like
that, it's more of convenience should there be older and newer me on same
device in contacts lists. This doesn't either mean that I will remember
this scheme or updating these files.

### Which accounts of mine you should care about?

For more details such as the Briar links, refer to `my-accounts.tsv`.

- My Briar desktops serve my phones that only connect to network when charging,
  although the bundled `tor` taking 100 % of CPU has reduced their online time.
  - `Aminda-Lumina (2022-153)` has became more active and travels with
    me. ThinkPad T470 so focus on productivity.
  - `Aminda (SedricFlatpak-2022-075)` home device that also runs Samba for
    PlayStation 2 and in general is more gayming focused.
  - `Aminda-Lavenza (2023-281)` is my Steam Deck on SteamOS, preview channel
    and it might be unstable and get removed suddenly if the OS fails on me,
    but I seldom open Briar on it due to the effort. It's just so much more
    pleasant to use with dock connected to TV with BT controller and
    neckspeaker and just for gaming and when I do need terminal, SSH exists. I
    am rambling now...
- My phones are
  - `Aminda-Yeul 2024-W05-6` - my primary phone, Fairphone 5 so hopefully around for a long time. Replaced `Aminda-Janus (2023-061)` due to charging port accident, has had two factory resets.
  - `Mikaela` - my tertiary phone predating the naming scheme discussed earlier,
    but as it's SailfishOS Android AppSupport important Briar features are not
    implemented and I don't use it that much. Since the decommissioning of Axel (aka. "A") also my oldest Briar account that can be seen around on forums.
  - `Aminda-Janus (2023-061)` - my previous main phone. 10 000 mAh battery is nice, but slow charging taking days to full charge isn't, it will go away at some point.
- My family devices that are seldom online don't need to be cared about that
  much, but they have all the forums that my other devices if I have been
  sharing them.
  - `Aminda-Zaldaryn (2022-161)` - mostly seen when I am at family.
  - `Aminda-Rbtpzn (2023-034)` - 2006 desktop PC that really shouldn't have
    Briar.
- Then there are deprecated accounts/devices that occassionally come online
  but are not a priority.
  - `Aminda-Lumina-UserTest-2023-045` is a Briar test build instance as a
    result of attempting to contribute and test Briar flatpak.
- And dead accounts.
  - `Aminda-Janus (2022-311)`
    - factory reset on 2023-061. Note changed date number.
  - `A`
    - factory reset on 2023-244. The name `A` will not be reused, if this phone
      ever returns to Briar, which is unlikely for lack of resources, it would be `Aminda-Axel (%Y-%j)`

And to repeat one more time:

> `%j     The day of the year as a decimal number (range 001 to 366).  (Calculated from tm_yday.)`

-- `Manual page strftime(3)`

## Briar desktop

Port: [it will pick one and try to stick with it](https://matrix.to/#/%23briar_desktop%3Atchncs.de/%24FKJk80vFnp2Fqnyov8g2S1QGJuY8SrJBlPjjqGSaW5M?via=pikaviestin.fi&via=matrix.org&via=dendrite.matrix.org&via=tchncs.de), so `sudo netstat -plnt` is your friend, look for `java`. It should be on LAN and link-local interfaces.

I install it from Flathub and at the time of writing it seems to roughly have feature parity with the Android version meaning all private messages, forums, private groups, mailbox and forums are supported in that order.

## Further reading and quotes

- https://briarproject.org/quick-start/
  - > Please note that Briar will only synchronize messages with your contacts, not with nearby strangers who are running Briar. And it will only sync the messages you’ve chosen to share with each contact. For example, if you invite your contacts X and Y to join a forum, and they accept, then messages in that forum will be synced with X or Y whenever they’re within range. So you can receive forum messages from X in one location, travel to another location, and deliver those messages to Y.
  - > But this doesn’t work for private messages: they’re only synchronized directly between the sender and recipient.
- https://code.briarproject.org/briar/briar/-/wikis/FAQ
  - > Your Briar link contains a public key and it is safe to publish in the same way as a PGP public key. If you want to contact someone via Briar, both of you need to add each other's links.
  - > No, your online status isn't exposed by publishing your `briar://` link. Only your contacts can tell whether you're online.
  - > No. Unlike with adding contacts at a distance and its 48 hours timeout, there's no such thing for introductions.
- https://code.briarproject.org/briar/briar-desktop/-/wikis/Changelog
  - > `[0.2.0-beta 2022-02-22]` Synchronize messages via local LAN
- [#2081: Add to FAQ most frequent reasons why Briar fails to connect to a contact](https://code.briarproject.org/briar/briar/-/issues/2081)