# Phone Administration

## Install

You will completely wipe everything on the phone,
install rescue system "TWRP", system "LineageOS",
and apps from repository "F-droid".


### Install rescue system

Rescue system is installed using the tool Heimdall,
and apps are initially installed using fdroidcl.
First install those tools onto your Debian system:

    sudo apt install heimdall-flash fdroidcl

Next, locate newest rescue system for your phone:

    https://twrp.me/Devices/

Downloading newest rescue system needs faking the refererhint
(here using Samsung Galaxy S3 International Exynos as example):

    wget --referer=https://eu.dl.twrp.me/i9300/twrp-3.2.1-0-i9300.img.html https://eu.dl.twrp.me/i9300/twrp-3.2.1-0-i9300.img

Install rescue system onto phone using Heimdall:

 1. Fully charge the phone.
 2. Disconnect any cables and turn off the phone.
 3. Press and hold keys VOL-DOWN and SELECT (and keep them held down!),
    press key POWER and release it (only that one key!) when logo appears (~2 seconds),
 4. When a warning screen appears, release keys VOL-DOWN and SELECT,
    and press key VOL-UP.
 5. Connect USB-to-PC data cable.
 6. Execute from terminal:
    heimdall flash --no-reboot --RECOVERY twrp-[TAB...].img

Phone screen tells you to not turn off,
but when terminal is done you can ignore that
and either turn off the phone go directly to next section.


### Reset storage

When taking over a phone from someone else,
or loosing full-disk-encryption password and needing to start over,
reset most possible before installing a fresh system onto phone:

 1. Disconnect any cables and turn off the phone.
 2. Press and hold keys VOL-UP and SELECT (and keep them held down!),
    press key POWER and release it (only that one key!) when logo appears (~2 seconds),
 3. When TWRP intro screen appears, release keys VOL-UP and SELECT,
    and [Swipe] to enter home screen.
 4. Select Wipe, Format Data; type "yes"
 5. Select HOME, Reboot, Recovery (avoid installing any addons if offered!)
 6. [Swipe] to enter rescue mode
 7. Select Wipe, Advanced wipe, check all except "Micro SD card" and "USB OTG", [Swipe]
 8. Select HOME, Reboot, Poweroff (avoid installing any addons if offered!)

To install system after this (and phone is fully charged!),
you can skip step 8 above and go directly to step 5 below.


### Install system

Locate and download newest system for your phone
(use menu icon in top left corner):

    https://download.lineageos.org/

Install system onto phone:

 1. Fully charge the phone.
 2. Disconnect any cables and turn off the phone.
 3. Press and hold keys VOL-UP and SELECT (and keep them held down!),
    press key POWER and release it (only that one key!) when logo appears (~2 seconds),
 4. When TWRP intro screen appears, release keys VOL-UP and SELECT,
    and [Swipe] to enter home screen.
 5. Select Wipe; [Swipe]
 6. Select Home, Advanced, ADB Sideload; [Swipe]
 7. Connect USB-to-PC data cable.
 8. Execute from terminal:
    adb sideload lineage-[TAB...]-signed.zip (takes ~2 minutes)
 9. Select HOME, Wipe; [Swipe]
 10. Select HOME, Reboot, System (avoid installing any addons if offered!)

Initial boot after fresh install takes ~3 minutes.


### Add F-droid appstore integration

 1. Disconnect any cables and turn off the phone.
 2. Press and hold keys VOL-UP and SELECT (and keep them held down!),
    press key POWER and release it (only that one key!) when logo appears (~2 seconds),
 3. When TWRP intro screen appears, release keys VOL-UP and SELECT,
    and [Swipe] to enter home screen.
 4. Select Home, Advanced, ADB Sideload; [Swipe]
 5. Execute from terminal:
    fdroidcl update
    fdroidcl download org.fdroid.fdroid.privileged.ota
 6. Connect USB-to-PC data cable.
 7. Execute from terminal:
    adb sideload ~/.cache/fdroidcl/apks/org.fdroid.fdroid.privileged.ota_[TAB...].zip
 8. Select HOME, Reboot, System (avoid installing any addons if offered!)

Boot takes ~30 seconds


### Add selected apps, including F-droid appstore

 1. Enable developer setting:
    At Settings -> About phone,
    Tab many times on Build number.
 2. at Settings -> Developer options,
    enable Android Debugging.
 3. Execute from terminal:
    fdroidcl install org.dmfs.tasks at.bitfire.davdroid org.birthdayadapter com.zegoggles.smssync org.smssecure.smssecure
    fdroidcl install org.sufficientlysecure.viewer com.llamacorp.equate com.gabm.screenrotationcontrol
    fdroidcl install net.kismetwireless.android.smarterwifimanager
    fdroidcl install com.fsck.k9 org.sufficientlysecure.keychain eu.siacs.conversations
    fdroidcl install net.osmand.plus com.vonglasow.michael.satstat com.rareventure.gps2 de.grobox.liberario org.ametro

If terminal commands fail,
you can test if permissions for doing ADB connections work
with the more generic command "adb shell".


## Customize

Before you add anything personal - e.g. passwords,
you are recommended to activate full-disk encryption
at Settings -> Security -> Encryption -> Encrypt phone.

Ideas for further customization and use:
<https://couchdesign.dk/phone/android/init/>