Easy and Complete Instructions for Installing Maru OS
Alan Upson
Could you kindly consider the following suggestions relating to the Maru OS “Easy installers” part of the guide? I hope they will make the installation easier for less experienced persons. The text in blue italics that follows is the text from your updated guide at https://github.com/maruos/maruos/wiki/Installation-Guide. The text in red provides my suggestions, which are based upon my learning to date as an enthusiastic (but not particularly competent or experienced) Linux user experimenting with Linux and Nexus 5 operating systems. My main way of learning has been by trial and error and by following other (more detailed) instructions such as your "Maru OS Guide - Restoring Google Apps" and the Lineage OS Wiki instructions for installing Lineage OS at https://wiki.lineageos.org/.
Option 1: Easy installers
“Basically, if you don't know much about installing custom software on your phone and want something really easy, use this approach!”. “All you need to do is run a script and follow along. The installer includes adb and fastboot tools and is capable of unlocking your bootloader and flashing Maru in a few steps”. “WARNING: Installing Maru will wipe all of your personal data so please back up anything important first!”.
0.
Download the latest installer zip for your device and OS from the
latest
release
to
your computer.
Each
installer zip is tagged with the device and OS it's meant for, e.g.
maru-v0.4-installer-hammerhead-windows-0db8cdcb.zip
is the v0.4 installer for hammerhead on windows.
1. Extract the installer zip to a convenient location (e.g. Downloads directory).
2. Connect your device to your computer using a USB cable.
2.
3.
Run
the installer script by referring to the instructions below for your
OS.
Linux
i. Open a terminal.
ii. Change directory to the unzipped installer (e.g. cd Downloads/maru-v0.4-installer-hammerhead-linux-6b1b3aeb).
iii.
Run
the
installation
script
by
typing
./install.sh
into
the terminal. Enable USB debugging if the installation script
requests this.
iv.
Wait a few minutes for Maru OS to install on your device. You should
see a Maru logo and moving dots to indicate that the installation is
in progress .
v.
To reinstall Google Apps (Play Store) to your device, follow the
instructions on the MaruOS forum at
https://groups.google.com/forum/#!topic/maru-os/S8PUEqqK10M.
PS:
I have not tried Option B or Option A2,
but a quick glance makes
me think that
it
would be beneficial for less experienced users if you explained
what “adb
in your PATH”
means (I can only guess), and provide a link to instructions
that explain how to install the TWRP custom recovery (in a similar
way that Lineage OS does).
Ian Kelling
Alan Upson <al...@upsons.com> writes:
> Could you kindly consider the following suggestions relating to the Maru OS “Easy
> installers” part of the guide?
editable by anyone logged in to github. Btw, if you are confident of a
change being an improvement, you do not need to run it by the mailing
list. If you are unsure, of course, feel free to ask.
