From a685f0973b778348a2199e9653b8b30ba013ec9b Mon Sep 17 00:00:00 2001 From: Nico Alt <nicoalt@posteo.org> Date: Sat, 1 Jun 2019 17:49:17 +0200 Subject: [PATCH] Document instructions to copy database from Android --- README.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/README.md b/README.md index 5bd5ab3..4a14a74 100644 --- a/README.md +++ b/README.md @@ -28,6 +28,26 @@ enter the URL to this Git project. * Has [phone constraints](https://developer.puri.sm/Librem5/Apps/Guides/Design/Constraints.html) in mind * Strictly separates API wrapper from GTK stuff, making former a solid base for other (commandline) clients +## FAQ + +### How can I add contacts? + +Adding contacts isn't yet supported. Instead, you have to copy +the database and keys from a Briar Android installation. The most +convenient way to do so is by using +[_adb_](https://developer.android.com/studio/command-line/adb). +Note that your smartphone needs to be rooted for this. + +1. Start _briar-gtk_ and register a dummy account. This will create +the needed directory structure at _~/.briar/_. Close the program afterwards. +2. Enable _adb_ on your smartphone and give it root permissions. +3. Connect via _adb_ and gain root permissions using `adb root`. +4. Copy all important files using `adb pull`: +_/data/data/org.briarproject.briar.android/app_db/db.mv.db_, +_/data/data/org.briarproject.briar.android/app_key/db.key_, +_/data/data/org.briarproject.briar.android/app_key/db.key.bak_ +5. Replace the respecting files in _~/.briar/db_ and _~/.briar/key_. + ## License This program is free software: you can redistribute it and/or modify -- GitLab