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

Search This thread
By:
Advanced…
nicholaschum

nicholaschum

Substratum Development Leader / Inactive RT
Feb 3, 2011
6,076
13,841
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:
  • Like
Reactions: Daiwoz, mustafaparlaq, jfreitas1220 and 185 others
nicholaschum

nicholaschum

Substratum Development Leader / Inactive RT
Feb 3, 2011
6,076
13,841
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:
  • Like
Reactions: aliakharbi, agentsandy007, MMarc and 4 others
nicholaschum

nicholaschum

Substratum Development Leader / Inactive RT
Feb 3, 2011
6,076
13,841
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:
  • Like
Reactions: agentsandy007, spiral777 and Gandalforce
nicholaschum

nicholaschum

Substratum Development Leader / Inactive RT
Feb 3, 2011
6,076
13,841
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:
  • Like
Reactions: aliakharbi, agentsandy007, spiral777 and 1 other person
F

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
M

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
ATalkingRock

ATalkingRock

Senior Member
Jul 28, 2014
197
15
I too would love to test with the pixel if this isn't already available!

P.S. I'm fairly new to telegram, so I can't quite figure out where to DM you... haha
 
Last edited:
  • Like
Reactions: joonas72 and markt0830
B

BossNexusS

Senior Member
May 25, 2011
1,263
249
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:
 
You must log in or register to reply here.

Similar threads

nicholaschum
  • Sticky
[Q&A] Issues with Substratum? Post here!
Replies
5K
Views
644K
N
nilaytagde57
nicholaschum
Samsung Integration for Substratum (Nougat) Support Thread
Replies
1K
Views
286K
5
5taavenida
bohrabhijeet
  • Sticky
[OFFICIAL][GUIDE] Starting with Substratum! - Andromeda, Samsung, Pie & OMS!
Replies
487
Views
194K
Sant Jacobin
Sant Jacobin
nathanchance
  • Locked
[REFERENCE] LineageOS with full Substratum support - Closed until Oreo
Replies
146
Views
92K
nathanchance
nathanchance
nicholaschum
  • Locked
Release Announcement Thread [release:983] (19/04/2018)
Replies
18
Views
70K
nicholaschum
nicholaschum

Top Liked Posts

24 Hours All time
  • There are no posts matching your filters.
  • 188
    nicholaschum
    nicholaschum
    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.
    View
    13
    nicholaschum
    nicholaschum
    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!
    View
    12
    nicholaschum
    nicholaschum
    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://xdaforums.com/showpost.php?p=73748157&postcount=15


    For those impatient: https://time.is/EST
    View
    9
    nicholaschum
    nicholaschum
    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 :)
    View
    9
    nicholaschum
    nicholaschum
    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
    View

New posts