Briar

RU / EN

Briar is a peer-to-peer messenger.

What is Briar?

Briar is a messaging app designed for activists, journalists, and anyone else who needs a safe, easy and robust way to communicate.

Unlike traditional messaging apps, Briar doesn’t rely on a central server - messages are synchronized directly between the users' devices.

If the internet’s down, Briar can sync via Bluetooth or Wi-Fi, keeping the information flowing in a crisis. If the internet’s up, Briar can sync via the Tor network, protecting users and their relationships from surveillance.

Creating an Account

When you open the Briar app for the first time you'll be asked to create an account. Your account will be stored securely on your device, encrypted with your password.

Choose your nickname carefully as you can't change it later. You can choose the same nickname as someone else, just like in real life.

Choose a password that's hard to guess but easy to remember. If you forget your password we can't help you regain access to your account.

If you need to delete your account in a hurry, just uninstall the Briar app.

Battery Settings

After choosing your nickname and password, Briar will ask for permission to disable battery optimizations so it can run in the background. This is necessary because there's no server to receive messages on your behalf while Briar is in the background: Briar needs to receive those messages itself.

On Huawei and Xiaomi devices you'll be asked to take extra steps to let Briar run in the background. Please follow the instructions carefully.

Adding a Contact

After creating your account you'll see an empty contact list. To add a contact, press the plus button (+). There are two options, depending on whether the person you want to add is nearby.

If the person you want to add is nearby, choose "Add contact nearby". If the person you want to add is not nearby and you have Internet access, choose "Add contact at a distance".

Adding a Contact Nearby

When you choose "Add contact nearby", Briar will ask for permission to use your camera so it can scan your contact's QR code. Briar will also ask for permission to access your location so it can connect to your contact via Bluetooth. Briar doesn't store, share, or upload your location, but this permission is needed for discovering nearby Bluetooth devices. Finally, Briar will ask for permission to turn on Bluetooth and make your device visible to nearby Bluetooth devices for a short time.

After granting all these permissions, Briar will show a QR code and a camera viewfinder. Scan your contact's QR code and let them scan yours. After about 30 seconds your devices should connect to each other and your contact should be added to your contact list.

If your devices fail to connect to each other, both of you should go back to the contact list and start the process again.

Adding a Contact at a Distance

When you choose "Add contact at a distance", Briar will show a link that needs to be sent to the person you want to add. You can send the link via another app such as Signal. Your contact also needs to send you their link. Paste your contact's link and choose a nickname for them. If you and your contact are both signed into Briar and both have Internet access then your contact should be added to your contact list within a few minutes.

Send a Message

After adding your first contact, tap their name in the contact list to send your first message. The circle next to your contact's name will be green when Briar is connected to your contact via Internet, Wi-Fi or Bluetooth.

Introduce Your Contacts

You can use the introduction feature to introduce your contacts to each other so they don't have to meet up in person to add each other.

Write a blog post

You can use the blog feature to write posts that all your contacts can see. You can also reblog other people's posts to let all your contacts see them.

Bear in mind that you can't delete blog posts after they've been sent.

Create a forum

You can use the forum feature to create group discussions and invite your contacts to join. Anyone who belongs to a forum can invite their own contacts to join.

Tips for offline communication

The range of Bluetooth and Wi-Fi is around 10 metres, depending on obstacles. Clearly this isn't enough for communicating across a city or even a large building. So when Briar receives a message from a nearby contact, it stores the message and can later pass it on to other contacts when they come within range (for example, when you move from one place to another).

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.

A forum is a good way for a group of people to keep in touch without Internet access. To make sure that forum posts are synced between all members of the forum, introduce all the members so they become contacts, and make sure that everyone invites everyone else to the forum and accepts the invitations, even if they already belong to the forum. This will ensure that whenever two members are within Bluetooth or Wi-Fi range they synchronize all the forum messages they've received.

If lots of people within Wi-Fi range want to communicate, it can be useful to create a Wi-Fi hotspot on one person's phone. Even if the hotspot doesn't have Internet access, Briar can use it to communicate with contacts who are connected to the same hotspot.

If it's too risky to carry your phone from place to place (eg checkpoints), you can sync encrypted messages using a USB stick or SD card to carry them more discreetly.