[PC/MAC/LINUX] The official, full Andromeda thread for Substratum [Android 8.0.0+]

Search This thread

nicholaschum

Substratum Development Leader / Inactive Recognize
Feb 3, 2011
6,079
13,838
University of Toronto
plus.google.com
Instructions for Windows

Step 1 - Download your file for your current operating system!

Andromeda App 6.0.0 (Windows): https://www.androidfilehost.com/?fid=1395089523397937511

Step 2 - Install the mobile clients from the Play Store

Play Store (Substratum v839+): If you have not yet, please install the main app! https://play.google.com/store/apps/details?id=projekt.substratum

Play Store (Andromeda): You can install the latest Substratum on Android Oreo, unrooted, and it will prompt you directly (can't link due to paid addon)

Step 3 - Load up the Andromeda Desktop Client or Script!

  1. Enable "USB debugging" on your device
  2. Install systemwide ADB drivers on your PC
  3. Connect your device to your PC
  4. Download the desktop client ZIP archive from the link below
  5. Extract the downloaded archive file and open the extracted app
  6. Press any button to start/stop server
  7. Wait for the process to finish, then you can disconnect your device from your PC
    You will need to do the instructions above every time you reboot your device.
 
Last edited:

nicholaschum

Substratum Development Leader / Inactive Recognize
Feb 3, 2011
6,079
13,838
University of Toronto
plus.google.com
LbFy9Gg.png




Requirements

  1. Android Oreo (8.0.0)
  2. Unrooted
  3. Developer Options enabled and Enable USB debugging enabled
  4. Some reading skills

Read the following three posts for instructions per operating system!



Frequently Asked Questions (FAQs)



Q: What will I have to do if I get an update to Andromeda from Play Store?

A: Reboot your device, then rerun your desktop client. This ensures the background service is using the latest code!



Q: What happens if Substratum loads up to a blurry window saying "falling back to rooted mode"?

A: This means that Andromeda's client does not want to serve you, meaning that you probably are running an unlicensed/modified copy.


Q: I am pressing the Substratum icon but it closes immediately! What gives?!

A: Rerun the Andromeda client and try again.


Q: If I reboot, will I lose this connection with the Andromeda Desktop client?

A: Yes, to keep the device safe, Google has ensured that elevated privileges using the shell will be completely disabled at boot.


Q: If I reboot, will my overlays remain enabled/disabled as I left them before I rebooted?

A: Yes


Q: Are systemwide fonts supported?

A: No


Q: Are bootanimations themable?

A: No


Q: What does it mean if it says "Connected" but Substratum keeps closing abruptly?

A: Your connection is not fully opened, so a reboot will be required. Reboot, and then rerun Andromeda to fix this!


Q: Sometimes when I unplug, it will disconnect Andromeda! What gives?

A: This is a bug with ADB and certain devices and computers. You can try another architecture like Windows 10, or Mac OS X, but some custom ROMs may interfere with this, as @MishaalRahman confirmed, certain hacked together ROMs may cause the shell to close almost every time.


Q: What will I need to provide if I run into a crash?

A: A full logcat, obtainable using this guide (unrooted): https://www.xda-developers.com/guide-sending-a-logcat-to-help-debug-your-favorite-app/



Special Thanks

  1. Jeff Corcoran @blk_jack
  2. Ivan Iskandar @iskandar1023



XDA Portal Tips and Tricks! (Thanks to @MishaalRahman!)


We would like to personally reach out and thank Mishaal and the whole XDA Portal team for allowing us to promote our new app on the Portal, multiple times!


Announcement Post: https://www.xda-developers.com/andromeda-substratum-custom-themes-oreo/
Demonstration of Andromeda Running Rootless (FAQs): https://www.xda-developers.com/video-rootless-substratum-theme-engine-android-oreo/#faqs
How to use tutorial: https://www.xda-developers.com/custom-themes-android-oreo-substratum/
Full Directory: https://www.xda-developers.com/tag/substratum-tutorials/



Other news reports!


As a team, we would like to give huge thanks for the support from other popular blogs that Android has and their promotion of our new app!


Android Police: http://www.androidpolice.com/2017/0...um-theming-unrooted-android-8-0-oreo-devices/
Android Authority: http://www.androidauthority.com/android-8-oreo-themes-795725/
9to5Google: https://9to5google.com/2017/09/12/h...-themes-on-android-oreo-devices-without-root/

 
Last edited:

nicholaschum

Substratum Development Leader / Inactive Recognize
Feb 3, 2011
6,079
13,838
University of Toronto
plus.google.com
Instructions for Mac

Step 1 - Download your file for your current operating system!

Andromeda App 5.0 (Mac): https://www.androidfilehost.com/?fid=11410963190603904642

Step 2 - Install the mobile clients from the Play Store

Play Store (Substratum v839+): If you have not yet, please install the main app! https://play.google.com/store/apps/details?id=projekt.substratum

Play Store (Andromeda): You can install the latest Substratum on Android Oreo, unrooted, and it will prompt you directly (can't link due to paid addon)

Step 3 - Load up the Andromeda Desktop Client or Script!

  1. Enable "USB debugging" on your device
  2. Connect your device to your Mac
  3. Download the desktop client DMG image from the link below
  4. Open the downloaded image file and drag the app icon to the Applications folder
  5. Open the desktop client on the Applications folder
  6. Select your device
  7. Click Start Server
  8. Wait for the process to finish, then you can disconnect your device from your Mac
  9. You will need to do the instructions above every time you reboot your device.
 
Last edited:

nicholaschum

Substratum Development Leader / Inactive Recognize
Feb 3, 2011
6,079
13,838
University of Toronto
plus.google.com
Instructions for Linux

Step 1 - Download your file for your current operating system!

Andromeda Script (Linux Script): https://www.androidfilehost.com/?fid=12420606652095399031

Step 2 - Install the mobile clients from the Play Store

Play Store (Substratum v839+): If you have not yet, please install the main app! https://play.google.com/store/apps/details?id=projekt.substratum

Play Store (Andromeda): You can install the latest Substratum on Android Oreo, unrooted, and it will prompt you directly (can't link due to paid addon)

Step 3 - Load up the Andromeda Desktop Client or Script!

  1. Enable "USB debugging" on your device
  2. Connect your device to your computer
  3. Download the desktop client ZIP archive from the link below
  4. Extract the downloaded archive file and open a terminal on the same folder as the extracted files
  5. Run ./start_andromeda.sh on the terminal
  6. Wait for the process to finish, then you can disconnect your device from your computer
  7. You will need to do the instructions above every time you reboot your device.
 
Last edited:

FloL00L

New member
Feb 6, 2017
3
3
Tests with Pixel?

Thank you so much. Has anyone tried this with the Google Pixel yet?
I really want to try it out but don't want to kill my phone.
Thanks in advance :)
 
  • Like
Reactions: joonas72

Marco_2017

New member
Sep 8, 2017
3
2
Thanks for this job, for people who does not want root our devices.

I have some doubt. I can not install andromeda on my nexus 5x, relly i dont know how make it. I installed substratum, but app tell me i am not root.

And other question, version of Substratum in google play is 823, but i see you have version 839+. How is possible?
 
Last edited:
  • Like
Reactions: joonas72
Feb 7, 2017
5
1
I've got a pixel as well.

---------- Post added at 12:51 PM ---------- Previous post was at 12:09 PM ----------

Just a question. I installed substratum but wasn't promoted to install Andromeda. On Android Oreo, Pixel Xl
 

neekless

Senior Member
Sep 1, 2014
473
481
Singapore
I've got a pixel as well.

---------- Post added at 12:51 PM ---------- Previous post was at 12:09 PM ----------

Just a question. I installed substratum but wasn't promoted to install Andromeda. On Android Oreo, Pixel Xl

The substratum on the play store is currently v823. Andromeda requires v839, which isn't released yet.
 

roboots21

Senior Member
Aug 25, 2010
323
109
Alright, we need some Pixel users (non XL and XL) on a Mac machine!

If you fit this criteria, please hit me up on Telegram (@nicholaschum)

If not, we won't be accepting anymore, sorry!

Message sent on telelgram .. (pixel XL, oreo, unrooted, Mac OS X)
 
Last edited:

BossNexusS

Senior Member
May 25, 2011
1,261
247
I have a pixel XL also would love to help out in beta or any way.. I have been waiting ages since its first been announced by XDA!

Edit: I guess NVM :crying:
 

Top Liked Posts

  • There are no posts matching your filters.
  • 186
    Instructions for Windows

    Step 1 - Download your file for your current operating system!

    Andromeda App 6.0.0 (Windows): https://www.androidfilehost.com/?fid=1395089523397937511

    Step 2 - Install the mobile clients from the Play Store

    Play Store (Substratum v839+): If you have not yet, please install the main app! https://play.google.com/store/apps/details?id=projekt.substratum

    Play Store (Andromeda): You can install the latest Substratum on Android Oreo, unrooted, and it will prompt you directly (can't link due to paid addon)

    Step 3 - Load up the Andromeda Desktop Client or Script!

    1. Enable "USB debugging" on your device
    2. Install systemwide ADB drivers on your PC
    3. Connect your device to your PC
    4. Download the desktop client ZIP archive from the link below
    5. Extract the downloaded archive file and open the extracted app
    6. Press any button to start/stop server
    7. Wait for the process to finish, then you can disconnect your device from your PC
      You will need to do the instructions above every time you reboot your device.
    13
    Andromeda v20 has been rolled out, and we have a key few things that need to be noted!

    I would like to clarify that the sneak peek of Andromeda and root a few days ago was not designed to be a way to replace rooted substratum builds, or to convince that root + Andromeda is the way to go.

    As a small number of users seem to be using Andromeda on a rooted device, it is simply just one rooted call that executes the same environment as if you plugged your device into the computer. Just like the current rooted Magisk plugins/scripts that require you to execute "su andromeda" by the community in XDA.

    To those who used to run masquerade and substratum back in the day, the calling package usually suffered the most because it caused a heavy configuration change due to "assetSeq" code from CMTE. As we are now using direct shell calls, the configuration change is lighter than the previous implementation but still exists, thus, a more reliable way for us was to "offload" the configuration change from the main substratum app.

    You do NOT need to (re)purchase Andromeda, and I would personally just stick with rooted mode on substratum for free if you are on Oreo, despite the configuration change explanation above, as Android O's Dynamic Overlays are faster than "assetSeq" and more reliable.

    However if you're unrooted, the recommended method is to definitely give Andromeda a try!

    One more thing, running the script no longer automatically runs substratum. As we have new plans of the app very soon and it shouldn't just be reserved for substratum!
    12
    As promised, this is the major Substratum update that will prompt you guys to download Andromeda.

    11AM EST is the rollout time for the articles and the Andromeda addon APK!

    https://forum.xda-developers.com/showpost.php?p=73748157&postcount=15


    For those impatient: https://time.is/EST
    9
    I'm glad that a lot of people are interested. Unfortunately I'll apologize in advance if I couldn't get to your PM. My inbox just flooded like no tomorrow! Haha

    Mac, Windows and Linux clients are all done, including the universal UI (alpha). So if the universal UI doesn't work, there will be a fallback.

    The Andromeda app is also done and privately tested ATM. Substratum is getting patches up and ready and will be done today or tomorrow, then the full announcement for the huge update will be pushed AFTER our scheduled XDA portal post is done :)
    9
    Hi all, this is a simple series of clean up commands for when you migrate to the new version of Substratum 990+, AND are on a Samsung device.

    Newly compiled overlays will be readily visible on 990+ on Samsung + Andromeda users.

    These commands are to be run INSIDE adb shell!

    Uninstall all INACTIVE overlays:

    Code:
    for item in $(cmd overlay list | grep '\[ \]' | sed 's/\[ \]//');do echo ${item} && pm uninstall ${item};done

    Uninstall all ACTIVE overlays:

    Code:
    for item in $(cmd overlay list | grep '\[x\]' | sed 's/\[x\]//');do echo ${item} && pm uninstall ${item};done

    Uninstall all INVALID overlays:

    Code:
    for item in $(cmd overlay list | grep '\-\-\-' | sed 's/---//');do echo ${item} && pm uninstall ${item};done
Our Apps
Get our official app!
The best way to access XDA on your phone
Nav Gestures
Add swipe gestures to any Android
One Handed Mode
Eases uses one hand with your phone