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

Overview

Briar Desktop

pipeline status coverage report

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

Note that Briar Desktop is still in a very early prototype stage and not yet functional.

Installation

We plan to distribute Briar for Debian (and related distributions) as .deb and via Flathub.org as flatpak, but until now, there are only semi-official installation methods available. You might want to use them now for not having to wait, but please note that those installation methods will be deprecated once Briar is available for Debian and on Flathub.org.

Self-contained Java .jar

The simplest way is to download the nightly briar-desktop.jar and execute it from the command-line with java -jar briar-desktop.jar. Note that you need at least version 11 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:

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)

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 [email protected]: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 run

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

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

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

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

In case you want to build a self-contained Debian package, note that you need at least JDK 17 and that you might need to install binutils and fakeroot before running the respective task:

./gradlew packageDeb

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

./gradlew packageDeb -Dorg.gradle.java.home=$HOME/.jdks/openjdk-17.0.2

Take a look at .gitlab-ci.yml if you have problems with Kotlin and JDK 17.

Translations

See TRANSLATION.md for more information.

Hacking

See HACKING.md for useful information when trying to work with the source code.

Maintenance

From time to time, translations and Flatpak's dependencies should be updated. The former can be done with tools/update-translations.sh, the latter using flatpak-builder-tools.

Design Goals

  • Intuitive UI, similar to Briar Android client
  • Main platform is GNU/Linux, but also support (at least) Windows and macOS
  • Analogously, main platform is x86, but also support (at least) arm
  • Adaptive to different screen sizes (desktop and mobile devices)
  • Has phone constraints in mind

FAQ

How can I delete my account?

Until #166 is implemented, you can delete your Briar Desktop account by deleting the .briar/desktop/ folder in your home directory.

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You might also like...
STG mobile game made in Android
STG mobile game made in Android

Neon Info This project is STG mobile game made in Android. It is a fun project I

Aplicação Mobile desenvolvida em Android utilizando Jetpack Compose
Aplicação Mobile desenvolvida em Android utilizando Jetpack Compose

DevHub - Compose 📱 Aplicação Mobile desenvolvida em Android utilizando Jetpack Compose Sobre o projeto 💡 Esse projeto foi desenvolvido durante o eve

(another?) UNOFFICIAL Steam mobile client project

Jetisteam an unofficial Steam client for Android While being based on the protobuf-based WebUI-oriented RPC/API, this app will miss a lot of features

⌨️ A tool that gives you a massive head start when building Compose Desktop apps. It saves you from time-consuming setup and configuration
⌨️ A tool that gives you a massive head start when building Compose Desktop apps. It saves you from time-consuming setup and configuration

💻 create-compose-app A tool that gives you a massive head start when building Compose based apps. It saves you from time-consuming setup and configur

💻 A Compose Desktop project template with MVVM, Dagger, Decompose, tests, and more...
💻 A Compose Desktop project template with MVVM, Dagger, Decompose, tests, and more...

compose-desktop-template A compose desktop project template with MVVM, Dagger, Decompose and more ✨ Demo What's included? Architecture (MVVM) with And

⌨️ A tool that gives you a massive head start when building Compose Desktop apps. It saves you from time-consuming setup and configuration
⌨️ A tool that gives you a massive head start when building Compose Desktop apps. It saves you from time-consuming setup and configuration

💻 create-compose-app A tool that gives you a massive head start when building Compose based apps. It saves you from time-consuming setup and configur

Resume of Louis CAD, made with Jetpack Compose. Supports the Web, Desktop, and Android.
Resume of Louis CAD, made with Jetpack Compose. Supports the Web, Desktop, and Android.

ResumeComposition What This project is the source code of the resume/CV of Louis CAD. The latest PDF export is available here, it is ready to print. H

JetBrains style controls and UI for Compose Desktop
JetBrains style controls and UI for Compose Desktop

JetBrains UI Kit for Compose Desktop JetBrains style controls and UI for Compose Desktop. Quick Start 1. Add dependency dependencies { implementat

A compose desktop project template with MVVM, Dagger, Decompose and more
A compose desktop project template with MVVM, Dagger, Decompose and more

compose-desktop-template A compose desktop project template with MVVM, Dagger, D

Notes is a simple and private notes app. Organize your thoughts, discoveries, and ideas and simplify planning important moments in your life with your digital notepad.

Notes Example Download Download the latest version of the Android app from this link. Building Using Android Studio Clone the repo, open it in Android

Dmitry Savin 1 Jan 3, 2022
A desktop code editor app using Jetpack Compose for Desktop and IntelliJ Platform

Compose Code Editor A desktop code editor app using Jetpack Compose for Desktop and IntelliJ Platform. Project Structure The code is contained in the

Alex 73 Dec 19, 2022
Jetpack Compose android app that you can send push notification among devices using KTOR and One Signal

Jetpack Compose android app that you can send push notification among devices using KTOR and One Signal, Clean Architecture, Dependency Injection...

Raheem 2 Nov 15, 2022
💻 A cross-platform desktop application to identify libraries used inside an android application. Made possible by Compose Desktop ⚡

?? stackzy A desktop app to analyse APK. Built using Compose desktop ✨ Demo Watch demo ??️ Usage Show usage ?? Install Platform Download Status Linux

theapache64 876 Dec 24, 2022
Test-compose-for-desktop - Hello World in Compose for Desktop

Testing Run from command line: ./gradlew run Regular build: ./gradlew packageUb

Sebastian 3 Sep 20, 2022
Snake-compose-for-desktop - Snake Game - implemented using Compose for Desktop

A Snake game, built with Compose for Desktop snake-compose-for-desktop is my imp

gnu 5 Feb 17, 2022
A Weather Mobile or Android Native App, in Kotlin built to see the current weather of suggested countries of Europe and in my current position. In this case, Maputo/Mozambique #WitChallenge #Asked #Option1

Witweather_android This is a challenge assigned by Wit, which aimed to build an Android App to visualize the temperature in my current location, in th

Kelton M. Cumbe 1 Nov 22, 2021
Lull is an Android mobile application made with Jetpack Compose, where you can download wallpapers.

Lull Lull is an Android mobile application made with Jetpack Compose, where you can download wallpapers. Table of Contents Features Screenshots Light

Simge Şengün 12 Oct 10, 2022
A simple path finding visualizer mobile app to demonstrate the use of Jetpack Compose UI toolkit in Android.

Path Finding Visualizer App using Jetpack Compose A simple path finding visualizer mobile app to demonstrate the use of Jetpack Compose UI toolkit in

Serge Nino Martin Villasica 33 May 6, 2022
Recipes Mobile App UI Design in Jetpack Compose

Recipes Mobile App UI Design in Jetpack Compose Watch it on YouTube Beautiful android mobile Recipes App designed using Jetpack Compose. Single screen

Juraj Kusnier 21 Oct 14, 2022