README.md

Briar Desktop

A desktop program for Briar, bringing secure messaging to your desktop and mobile devices.

Installation

We plan to ship Briar as Flatpak and in Debian (and related distributions) as .deb, but until now, there are only semi-official installation methods available. You might want to use them now in order to not having to wait, but please note that those installation methods will be deprecated once Briar is officially available.

Beta releases

From Briar's website you can download different binaries: briarproject.org/download-briar-desktop

Nightly builds

Each night a new build is compiled by Briar's GitLab CI.

Self-contained Java .jar

The simplest way is to download the nightly briar-desktop-linux.jar or briar-desktop-windows.jar and execute it from the command-line with java -jar briar-desktop-linux.jar or java -jar briar-desktop-windows.jar respectively. Note that you need at least version 17 of the Java Runtime Environment.

Self-contained .deb

For Debian- and Ubuntu-based Linux distributions, a set of .deb files is available. Depending on which version of Debian/Ubuntu your OS is based on, you can choose the right .deb file:

• Ubuntu 20.04
• Debian stable (bullseye)
• Ubuntu 18.04

Here are some examples of popular distributions and their respective .deb file:

• Ubuntu 20.04 and compatible: Linux Mint 20.X (Ulyana, Ulyssa, Uma, Una), elementaryOS 6.X (Odin, Jólnir), Trisquel 10 (Nabia)
• Debian stable (bullseye) and compatible: MX Linux MX-21
• Ubuntu 18.04 and compatible: Linux Mint 19.X (Tara, Tessa, Tina, Tricia), elementaryOS 5.X (Juno, Hera), Trisquel 9 (Etiona)

Windows installer .msi

For Windows, an .msi installer package is available:

• Windows MSI

Developers

Download Source Code

Briar dependencies are included as Git Submodules. To be able to build Briar Desktop, download the source code and the submodules using

git clone --recurse-submodules git@code.briarproject.org:briar/briar-desktop.git

or

git clone --recurse-submodules https://code.briarproject.org/briar/briar-desktop.git

Intellij IDEA

The easiest and most convenient way to build Briar Desktop is by using Intellij IDEA.

UI Previews

Briar Desktop makes use of Compose for Desktop to build its UI. The Intellij IDEA plugin Compose Multiplatform IDE Support provides static previews of composable functions without parameters which are annotated with @Preview.

Building and Running

In order to build and run the application from the command line, execute this:

./gradlew pinpitRun

You can specify arguments to the app using the --args option of the Gradle task. For example to show the usage info:

./gradlew pinpitRun --args="--help"

To specify a different data directory and enable the debug output:

./gradlew pinpitRun --args="--debug --data-dir=/tmp/briar-tmp"

In case you want to build a self-contained Debian packages and an MSI installer, note that you need at least JDK 17:

./gradlew pinpitPackageDefault

If you want to use the JDKs downloaded by Intellij IDEA, you can for example specify the path like this: