# 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. Execute from terminal:
    fdroidcl install org.dmfs.tasks at.bitfire.davdroid org.birthdayadapter com.zegoggles.smssync com.moez.QKSMS
    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


### Use your phone

Your phone is now ready for use.

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/>