update : I have improved it … as …
[HOWTO] an Unified Install Guide Project for /e/
.
.
originaly Forked from @manish’s famous howto for fastboot devices… 
namaste
Special thanks to @Superman and @Anonyme
.
(1) Download /e/OS
(2) Download TWRP
(3) install the flashing tools
(4) Allow flashing
(6) Flash the custom recovery TWRP on your device
(7) install /e/ from your computer, with TWRP on your device using the sideload method
or
(8) Install /e/ without computer from your device, with TWRP using the SDcard method
.
Mission :
.
Install /e/OS on the ROM of your compatible Samsung device with a GNU/Linux PC
- from a Terminal on the Computer, using the recommended adb sideload method
or
- from TWRP on the Device, using the alternate SDcard or internal storage method
.
if you are a macrosoft windobe user, try this excellent howto
- You may want to try the /e/asy-installer
.
Prerequisites:
- A compatible Samsung smartyphone or tablet, with more than 80% battery charge.
running Samsung Firmware. upgraded and updated ( if you want, you can first flash a Samsung Firmware with heimdall-CLI or with heimdall-GUI )
Or already running a custom android OS ( or custom recovery )
With complete backup of important data on a PC or an external drive or source.
Without PIN code, or password, or gesture, or connected to a gogol account or SIM lock from a carrier
-
A Computer running GNU/Linux, as example an Ubuntu Studio LTS.
-
Patience to follow steps i.e. unlock the bootloader, flash custom recovery and finally privacy-friendly /e/OS on the ROM of your android Samsung device
.
Preparation :
1) Download /e/OS.zip
.
On your PC ( sideload method ),
or
On your SDcard ( SDcard method ),
.
it take times, so do it first,
you can follow all others steps during the download.
**Download the device specific image of /e/OS
build for the ROM of your specific Samsung device from :**
your model number, avialable in the
“settings menu” → Plus/System → About phone → “Model number”
must be supported by the device code name of the build you choose.
example :
model name : Galaxy s7
code name : herolte
model number : SM-G930F, SM-G930FD, SM-G930S, SM-G930K, SM-G930L, SM-G930W8
(https://github.com/LineageOS/lineage_wiki/blob/master/_data/devices/herolte.yml)
if your device already run another custom OS, you may have TWRP already installed, so go to step .7). or .8)
if your device already run /e/ and you want to update or upgrade without data loss, see this howto
if your device run an Android-Official-Stock-Vendor version ( realised by your Carrier / Samsung / Gogol )
this step by step guide is for you.
Samsung devices comes with three booting modes
boot to system mode.
boot to recovery mode.
boot to download mode. ( similar to fastboot mode )
.
you are decided to try /e/ on your Samsung device,
so, you need to replace the existing system by /e/OS.
-
To modify or change the /system partition of your device, you need to boot into a custom recovery mode that allow you to do that. ( TWRP, from the Team Win Recovery Project ).
-
To modify or change the /recovery of your device, witch is located on the /boot partition, you need to unlock the bootloader. (the heimdall-flash tool )
-
To unlock the bootloader of your device, you need to communicate with the device. ( USB adb, the Android Debugging Bridge )
**there are many /partitions on the phone (depending of the device model), but the install process will only modify /recovery and /system,
NOT ALL THE SAMSUNG FIRMWARE**
if you want to learn more about Samsung Hardware you can read this post
.
2) Download TWRP.img
On your PC,
Download the device codenamed specific .img file to patch the /boot partition of your device, it will to replace the stock-recovery by a custom recovery called TWRP, the Team Win Recovery Projet from :
twrp version 3.4.x-x and 3.5.x-x are designed for android (Q 10), (R 11),
don’t choose it
for installing /e/ android (nougat 7), (oreo 8), (pie 9), download an older version like 3.3.x-x
.
3) install the flashing tools
On your PC
Install ADB the Android Debug Bridge,
( Fastboot for flashing others brand android devices ),
and Heimdall the Open Source Flashing Tool for Samsung devices
Ubuntu is used for the purpose of this guide. Kindly change the commands and package names, if any for your distribution
- open a Terminal app to execute the following command :
$ sudo apt update
$ sudo apt upgrade
$ sudo apt install android-tools-adb
$ sudo apt install android-tools-fastboot (optional)
$ sudo apt install heimdall-flash
$ sudo apt install heimdall-flash-frontend (optional)
- or
$ sudo apt-get update
$ sudo apt-get upgrade
$ sudo apt-get install android-tools-adb
$ sudo apt-get install android-tools-fastboot (optional)
$ sudo apt-get install heimdall-flash
$ sudo apt-get install heimdall-flash-frontend (optional)
- When done check with adb version command to verify.
$ adb version
A result as follows shall appear on your terminal screen.
Android Debug Bridge version 1.0.39
Version 1:8.1.0+r23-5
- You can verify Heimdall is functioning by opening a Terminal and running
$ heimdall version.
.
-
Other method :
-
-
- Download the /e/ heimdall_ubuntu.zip
-
-
-
- open a Terminal and type :
-
-
-
-
$ unzip /path/to/heimdall_ubuntu.zip -d /tmp
-
-
$ cp /tmp/bin/heimdall* /usr/bin/
$ rm -rf /tmp/bin
For others GNU/Linux :
-
adb
-
-
-
cd
-
-
wget https://dl.google.com/android/repository/platform-tools-latest-linux.zip
unzip platform-tools-latest-linux.zip
echo ’
if [ -d “$HOME/adb-fastboot/platform-tools” ] ; then
export PATH=“$HOME/adb-fastboot/platform-tools:$PATH”
fi
’ >> ~/.bash_profile
. ~/.bash_profile
-
Heimdall
-
-
- Extract The Muppets Heimdall suite zip and take note of the new directory containing
heimdall. Now copyheimdallinto a directory in $PATH, a common one on most distros will be /usr/local/bin. For example
- Extract The Muppets Heimdall suite zip and take note of the new directory containing
-
-
-
-
$ cp heimdall /usr/local/bin.
-
-
you may build heimdall, there is a guide…
I did it…for my Linux Mint Debian Edition version 3 cindy
.
4) Allow flashing
On your phone
allow USB debugging
allow OEM unlock (on android 7 nougat or later)
- Go to the >Settings menu >More/System , scroll down, tap on 'About phone’, scroll down,
in android 7 nougat :
in android 5 lollipop
in android 4 jelly bean :
- Tap 7 times on ‘Build number’ until it unlocks the Developer options mode as seen in the images below. Kindly enter password/PIN when asked.
Yay! You are a temporary developer now without any coding experience whatsoever!
-
In Settings, navigate to More/System and scroll down to open Developer options.
-
in Developer options, allow OEM unlocking (on android 7 nougat or later)
in android 9 pie
- In Developer options allow USB debugging under DEBUGGING
in android 5 Lollipop
- There is a disclamer :
- Tap OK to Allow USB debugging and enable it.
-
Connect your smartphone using USB cable to GNU/Linux PC to whitelist USB debugging from it to unlock bootloader .
-
There is a disclamer :
- Tap OK to continue.
.
Let’s roll !
.
5) Unlock the Bootloader
Warning: This process will completely wipe all data in the internal storage of your smartphone, please make sure you have a full backup of critical data on your smart phone
- Tip :
$ adb reboot bootloader
or
-
unplug the device from the PC
-
Power Off the device,
-
Boot to Download mode :
hold Volume Down + Home + Power.
- Now you can plug the device to your PC with a good data USB cable
From the Terminal application on GNU/Linux PC,
fastboot commands don’t work with samsung devices, you must use heimdall commands instead.
- execute the following command to unlock the bootloader :
$ heimdall print-pit
It results that the device reboots
.
Congratulation !
.
the bootloader of your Samsung device is unlocked and the device is factory reseted, now rebooting…
-
Redo the setup quickly. Since all the settings have been wiped from your device.
-
Once done, you have to re-enable the Developer options,
-
re-enable the USB debugging in the Developer options with steps above :
-
Go to the Settings menu , scroll down, tap on 'About phone’ , scroll down,
-
Tap 7 times on ‘Build number’ until it unlocks the Developer options mode as seen in the images below. Kindly enter password/PIN when asked.
-
Yay! You are a temporary developer now without any coding experience whatsoever!
-
In Settings , navigate to System and scroll down to open Developer options .
- In Developer options enable USB debugging under DEBUGGING
- There is a disclamer :
- Tap OK to Allow USB debugging and enable it.
- Connect your smartphone using a good USB cable to your GNU/Linux PC to whitelist USB debugging from it.
There is a disclamer :
- Tap OK to continue.
.
6) Flash the custom recovery TWRP
- Tip :
$ adb reboot bootloader
or
-
Unplug the device from the PC
-
Power Off the device,
-
Boot to Download mode :
hold Volume Down + Home + Power.
-
Now you can plug the device to your PC with a good data USB cable
-
From terminal application on PC, navigate to file path where you have downloaded the TWRP.img, execute the following command to install a custom recovery software called TWRP the Team Win Recovery Project .
$ heimdall flash --RECOVERY twrp-3.3.1-0-herolte.img --no-reboot
- It will result in the following output on PC:
target reported max download size of 536870912 bytes
sending ‘recovery’ (33684 KB)…
OKAY [ 1.048s]
writing ‘recovery’…
OKAY [ 0.346s]
finished. total time: 1.394s
…IT IS THE CRUTIAL STEP !..
- To get out of the Download mode you must Force Power Off your Samsung device,
unplug the device,
hold Volume Down + Power.
release when you see the screen turn off…
…IT IS THE CRUTIAL STEP !..
- immediately Boot to Recovery before any other boot mode attempt,
hold Volume up + Home + Power.
release when you see the very little blue line in the bottom of the screen…
…IT WAS THE CRUTIAL STEP !..
You must see the TWRP flash logo,
and the welcome screen :
if you see something like that :
It FAILED, this is the Official Stock Vendor Samsung / Gogol Firmware Recovery screen !
Please re-read and retry the flashing process of TWRP.
.
6.1) ( only for the Galaxy s9 )
Additional step : Patch the device
-
Download the patch from here
-
Install the patch
-
On the device, go into
Advanced > ADB Sideload,
then swipe to begin sideload
- From the computer, please run
adb sideload no-verity-opt-encrypt-samsung-1.0.zip
.
7) install /e/ !
Now the easiest part,
Install the image of /e/OS on the rom of your Samsung device with TWRP from your GNU/Linux PC using the sideload
this is the Welcome screen of TWRP recovery
- —i> Swipe to Allow Modifications
this is the TWRP main menu
- Tap Wipe from Main Menu.
- Tap Format Data therein to continue.
- Type yes in the text field to continue.
Once done a successful result as seen in the image below appears.
This will remove encryption as well as delete all files stored on the internal storage.
- Tap Back, return to the main menu,
- choose reboot,
- and tap recovery
- unselect “prompt to install TWRP app…”
and “install as a System app”,
- tap on “do not install”.
the device reboot to TWRP
- From the main menu, choose wipe,
and tap Advanced Wipe .
- Select the Cache and System partitions to be wiped and then Swipe to Wipe .
- Once done a successful result as seen in the image below appears.
- tap back to the main menu
- choose Advanced
- Tap ADB Sideload
- Select Wipe Dalvik Cache and Wipe Cache
- then Swipe to Start ADB Sideload
on your PC
- In the Terminal application on your GNU/Linux PC, navigate to file path where you have downloaded the /e/OS.zip to execute the following command:
adb sideload e-0.11-n-2020082970471-dev-herolte.zip
- It will result in the following output on PC when finished:
`
serving: ‘/home/modi/Downloads/e-0.11-n-2020082970471-dev-herolte.zip’ (~47%)
Total xfer: 1.00x
`
- On your smartphone, a successful result as seen in the image below appears.
- Tap Reboot System
- wait several minutes…
…
to boot into freshly installed /e/OS on your Samsung device.
- Voila! Easy, isn’t it?
If you encounter an “error 7”,
refer to this topic .
This could also be due to the fact that :
your TWRP version isn’t compatible with the ROM you are trying to install,
twrp version 3.4.0-0 is designed for android 10/Q don’t choose it
for installing /e/OS 7/nougat, 8/oreo, 9/pie download an older version like 3.3.1-0
Thanks for reading !
Share your feedback.
.
8) Install the image of /e/OS on the ROM of your Samsung device without computer, with TWRP using the SDcard method
(writted by @Anonyme)
Now you’re in TWRP, congratulations, you’ve done the hardest part. Let’s detail the following procedures in several sub-steps.
A) Delete existing smartphone content
-
Before you reach the main menu, a message may ask you if you want to open TWRP read-only (i.e. no risk of deleting or changing anything) or not. This option shouldn’t be chosen (since we want to install a new operating system). Slide the bottom arrow from left to right.TWRP may also ask you for a password, which is your phone password.
-
a)
- Tap Wipe from Main Menu.
- Tap Format Data
- Type yes in the text field to continue.
- Once done a successful result as seen in the image below appears.
This will remove encryption as well as delete all files stored on the internal storage.
- Tap Back, return to the main menu, choose reboot ,
- and tap recovery
the device reboot to TWRP
- b)
- From the main menu, choose wipe ,
and tap Advanced Wipe .
- Select the following items to delete and nothing else :
-
Dalvik / ART Cache
-
Data
-
Internal Storage
-
cache
-
system
- Validate by dragging the “Swipe to Wipe” arrow from left to right.If red error messages show up, your phone is probably encypted but TWRP can’t decrypt the /data partition (it’s a common issue on Samsung phones).To solve that problem, go to Wipe > Advanced wipe, select “data”, click on “Repair or Change File System”, then on “Change filesystem”. Select exFAT (or another one if it doesn’t work, it doesn’t matter), then swipe from the left to the right. Redo the manipulation but this time select ext4 (which is the original file system) then slide from the left to the right.
Go to the 8)A)1. part of the howto.
- Return to the main menu using the virtual buttons at the bottom of the screen.
B) Transfer the /e/ ROM to the internal storage of the smartphone
The previously downloaded /e/ ROM is waiting in the warm on your computer, so you need to transfer it to your smartphone’s internal storage so that TWRP can use it.
-
Connect your smartphone to the computer.
-
Copy the ZIP folder of the /e/ ROM (without unzipping) (right click on it and then “Copy”).
- Paste it into the internal storage of your smartphone. To do this, in the file explorer you are in, click on “This PC” then on your smartphone, then on “Internal storage”. Paste here, next to the “TWRP” folder (not inside).
- Unplug your smartphone once the transfer is complete.
C) Install /e/
Everything is ready, all that remains is to install /e/.
- In the TWRP main menu, click on “Install”.
- Select the .zip file you just copied/pasted. It should appear directly if you have pasted it at the right place.
- To confirm the flash of your smartphone, slide the “Swipe to confirm Flash” arrow from left to right.
- A blue loading bar or a shiny empty bar should appear. After a few minutes at most, the installation is completed.
If you encounter an “error 7”, refer to this topic .
This could also be due to the fact that :
- your TWRP version isn’t compatible with the ROM you are trying to install,
- Click on “Wipe cache/dalvik” at the bottom left, confirm if necessary.
- Click on “Reboot System”. You can choose whether or not to install the TWRP application on /e/ and choose whether or not you want this application to be a system application. Since it’s not useful, I preferred to click on “Don’t install TWRP App” and DO NOT drag the arrow from left to right (this would have resulted in its installation).
9) Enjoy your digital sovereignty
The animation of the /e/ logo should now appear on your screen for several minutes. Wait, then configure your device as you wish.
If you have any problem or correction to make so that this tutorial can be accurate to the word, do not hesitate 
