____      ________       
                                               ,^.__.>--"~~'_.--~_)~^.    
                                              _L^~   ~    (~ _.-~ \. |\   
                                           ,-~    __    __,^"/\_A_/ /' \  
   Welcome to. . .                       _/    ,-"  "~~" __) \  ~_,^   /\ 
    ___  ___   ___  __________  ___     //    /  ,-~\ x~"  \._"-~     ~ _Y
   / _ \/ _ | / _ \/_  __/ __ \/ _ \    Y'   Y. (__.//     /  " , "\_r ' ]
  / , _/ __ |/ ___/ / / / /_/ / , _/    J-.__l_>---r{      ~    \__/ \_ _/
 /_/|_/_/ |_/_/    /_/  \____/_/|_|    (_ (   (~  (  ~"---   _.-~ `\ / \ !
                   Android Linux        (_"~--^----^--------"  _.-c Y  /Y'
         by Wizardry and Steamworks      l~---v----.,______.--"  /  !_/ | 
                                          \.__!.____./~-.      _/  /  \ ! 
                                           `x._\_____\__,>---"~___Y\__/Y' 
                                               ~     ~(_~~(_)"~___)/ /\|  
                                                      (_~~   ~~___)  \_t  
                                                      (_~~   ~~___)\_/ |  

raptor is a Linux distribution for Android that aims to be side-loaded along SuperSU in order to provide open source software such as daemons and tools natively. raptor does not replace the Android operating system, nor does raptor run contained within an image but rather consists in a set of tools that can be downloaded and installed.

The current restriction set is rather specific - but may change in the future:

• AArch64 processor (64 bit ARM).
  • can be checked in a terminal on the device by issuing the command cat /proc/cpuinfo and reading the Processor line - if the line contains AArch64 then raptor is compatible.
• A device capable of being rooted by SuperSU. Raptor uses a modified SuperSU 2.822 package that must be used to re-root the device.
• Android SDK Platform Tools
  • On Windows, download Android SDK Platform Tools from Google.
  • On OSX with Homebrew installed, issue brew install caskroom/cask/android-platform-tools.

As stated, the device must be rootable by the official SuperSU - you do not need to root with SuperSU first, you can just use the one provided on this page. You must download the modified SuperSU 2.822 package from Wizardry and Steamworks and boot in TWRP (or whatever modified recovery system you have used) and the just re-install the supersuv2.822-raptor-signed.zip file on top of SuperSU.

You do not need to wipe the Data partition and you will not lose your data - however, a backup is always recommended. SuperSU cleans up after itself so you will not end up with a messy system if you install the modified package on top.

After the package has been installed, wipe the Cache/Dalvik and then reboot the device. If executed correctly, you will not have to setup anything additional and your system is prepared for raptor.

raptor needs to be bootstrapped on your device before being able to install packages. In order to do this, you will need a rooted device using SuperSU and then follow the mentioned steps:

Download the bootstrap file (base.tar) and save it on your PC. If you want, you can also perform a SHA1 check against base.tar.sha1 also on the same link to make sure that you downloaded an original file distributed by Wizardry and Steamworks.

Enable the devleloper options on your device and connect via cable to your PC. It is also wise to open the SuperSU utility on your device and set Settings→Default access to Grant so you will not be pestered by su commands as you proceed with the rest of the install.

Open a command prompt or a terminal on your PC and issue the following commands to push the base.tar file to your Android device:

adb push PATH_TO_BASE /data/local/tmp

where:

• PATH_TO_BASE is the full path to the previously downloaded base.tar

Now that the bootstrap package is deployed, issue:

adb shell

to log-in to your device.

Become the super-user by issuing:

su

Now, remount the filesystems in read-write mode:

mount -o remount,rw /
mount -o remount,rw /system

Finally, the bootstrap package can be deployed - change directory to the /system partition:

cd /system

and unpack the bootstrap package:

tar -xpvf /data/local/tmp/base.tar

on top of the existing files - no files will be replaced. The base.tar archive contains a preliminary staging system that allows you to access the opkg tool.

That is it, you can now begin installing packages!

raptor uses Open PacKaGe management (opkg) system as the package manager and the system should already be configured to search and install available packages.

First, update the sources:

opkg update

and install the base package via opkg:

opkg install --force-overwrite base

by doing so you will automatically receive updates to the bootstrap system without having to unpack anything manually anymore.

Log-in via adb to the Android command shell and issue the commands:

mount -o remount,rw /
mount -o remount,rw /system

to mount the relevant filesystems as read-write.

Then, to remove all raptor packages, issue:

opkg remove --force-removal-of-dependent-packages base

and reboot your device.

New packages will be added in due course; the intent is to cover most of the popular open source software. To check what packages are available, issue:

opkg update

this command pulls the available packages in the repositories and should be repeated every time before installing packages to check what is available and what can be upgraded.

To upgrade raptor, issue:

opkg upgrade

and all new packages should be upgraded.

In order to see a list of packages, issue:

opkg list

This list contains all available packages from the repository, but perhaps you may wish to list all the installed packages and, in order to do that, issue:

opkg list-installed

Finally, to install a package, issue:

opkg install PACKAGE_NAME

where:

• PACKAGE_NAME is the short name of the package.

For example, the following command:

opkg install ncurses

will install the ncurses library and tools.

Note that some packages depend on other packages and, by default, all packages depend on the base package.

A list of software provided by raptor is listed on the available packages page.

The following pages list the changes and explain the technicalities behind raptor:

• modifications made to SuperSU.