[WIP][DOWNLOADS] A new take on a graphical installer for LineageOS

Search This thread
Hello!
Usually I mainly consult this forum to get unofficial builds of LineageOS or look for support when occasionly something goes wrong. Some time ago I wondered, why it has to be so annoying to install LineageOS (or most of the other custom ROMs). There have been several attempts to create a graphical installer for LineageOS (most famously this one) and some installers for specific ROMs like calyxos. But support for devices is rather limited and hard to extend.

So I decided to give it a try myself and create a new attempt to build a graphical installer for alternative Android ROMs.

Repository: https://github.com/openandroidinstaller-dev/openandroidinstaller
Screenshot-openandroidinstaller.png

Features:​

- Graphical installer with instructions.
- onefile executable.
- adb, fastboot, heimdall and some drivers included.
- Works on Linux (mainly tested on Ubuntu 20.04), MacOS (not on ARM, M1, M2) and windows (you might need to install some drivers manually).
- some checks if the selected LineageOS image and recovery works for your device.
- Installation steps are based on config files to add support for new devices.
- written in python

Supported devices:​

- Currently, the alpha version mainly supports Google, Samsung, Fairphone and Sony devices, but should be fairly easy to extend to other devices.

Alpha version release download:​


How can you help?​

All kinds of feedback are useful! Let me know what you think in this thread.
If you have a unused device that supports LineageOS, perhaps you could try out this tool and report your results in this thread! I bought a bunch of different android devices, but more testing on all kinds of devices is needed and very welcome! Also testing the tool on different platforms (windows, macos, etc.) would be super helpful.

Note that:
- It may screw up your device. No automatic restore process is implemented yet, so make sure to have some sort of recovery tool handy.
- When you report back, please include the version of the program you used (as identified in the Downloads section), along with your device.
- Read the repository's README for further details!
- This installer is not associated with official LineageOS.
 
Last edited:
Devices that should work out of the box now:
VendorDevice NameCodeNameModelsStatus
SamsungGalaxy A3 2017a3y17lteSM-A320FLtested
SamsungGalaxy A5 2016a5xelteSM-A510Ftested
SamsungGalaxy S7herolteSM-G930Ftested
SamsungGalaxy S9starlteunder development
GooglePixel 3asargosargotested
SonyXperia ZyugaC6603tested
SonyXperia Z3z3under development
FairphoneFairphone 2FP2under development
FairphoneFairphone 3FP3under development
Motorolamoto g7 poweroceanunder development

In general, it should be pretty easy to use the tool for all kinds of Samsung, Pixel, Sony Xperia, Fairphone and Motorola devices. Let me know if you need help with your devices.
 
Last edited:
  • Like
Reactions: SigmundDroid

SigmundDroid

Senior Member
Sep 25, 2015
225
101
Fairphone
Samsung Galaxy S5
20221106 203704.png


OK, it works with FP3! Awesome! Actually, that might become a nice little helper for flashing LOS!

Ran into some problems:
  1. Had to OEM-unlock first. Could be little bit more elaborate (I usually forget to reboot the phone after that and authorize my PC, lol)
  2. First 2 times it hang, only the console told me it looks for https://lineageosroms.com/fp3/ (not official, is it?)
  3. Had to unlock with fastboot flashing unlock
    That can be a big problem for beginners if you face it the first time
  4. A little bit more feedback during flashing would be nice, console (and phone) showed more than the installer
Overall very good approach! Well, except for the lack of feedback (errors/progress from console). Is there any logging?

PS: Used it on Debian Bullseye with KDE.

PSPS: Perhaps an overview of the steps would fit in there as well (so one can see past, current and future steps)?
 
Awesome! Thanks for giving it a try! :)

Had to OEM-unlock first. Could be little bit more elaborate (I usually forget to reboot the phone after that and authorize my PC, lol)
Very good point! :)
First 2 times it hang, only the console told me it looks for https://lineageosroms.com/fp3/ (not official, is it?)
In the next release it will point to the official page. I wasn't aware that this page is not at all related to LOS and not so well perceived in the community as some of the devs pointed out to me. The check is done, to find out if there is an official release of LOS and then recommend the download. There might be a better way to guide users to find an appropriate image for their device, but that was simple.
Had to unlock with fastboot flashing unlock
That can be a big problem for beginners if you face it the first time
That was my bad... I didn't read the "unlock bootloader" instructions of the FP-support page carefully enough and stopped after part 1. This should be easy to address by updating the config. It will be fixed in the next release.
A little bit more feedback during flashing would be nice, console (and phone) showed more than the installer
That's very true! I'm trying to figure out, what kind of feedback is appropriate to keep people informed, but not scare them. A progress bar for flashing is in the making. Optimally, the installer can also show images of what should be going on on the phone. But that will mostly rely on community contributions for phones I don't own.

Thanks a lot for the detailed feedback! I will try to address most of them in the next release, especially more information and feedback for the user.

PS: Are you using the FP3 as your daily driver now, or would you be open to test the installer again in a few weeks or so?

PPS: I'm thinking about moving away from LOS recovery all together and only support TWRP since it allows for much more automation. What are your thought on that?
 
  • Love
Reactions: SigmundDroid

SigmundDroid

Senior Member
Sep 25, 2015
225
101
Fairphone
Samsung Galaxy S5
official release of LOS
Would that link do it?
https://download.lineageos.org/FP3
That was my bad... I didn't read the "unlock bootloader" instructions of the FP-support page carefully enough
:ROFLMAO: Hmm, I vaguely remember the exact same thing happened to me as well at my first manual flashing. Don't other phones do that as well nowadays? I could swear the S5 i flashed 2 weeks ago did it also...
what kind of feedback is appropriate to keep people informed, but not scare them
Hmm, I would certainly appreciate the "real" output as provided in console. Without it I wouldn't have really known what your installer is trying to do.

Putting some pictures wouldn't hurt but I really think that a "map" of steps is useful, too. Besides, one can see the whole progress at once (so far it's a somewhat nebulous process in my mind... and I always! tend to forget something).
using the FP3 as your daily driver now
Nah, not yet... that's actually why I got this second phone, so can test stuff without killing off my daily driver (after some horrible experiences I am insisting to try a new phone/ROM for some weeks before I switch).

So, yes, keep it coming :cool: Your idea is awesome (and saves me some time as well).
moving away from LOS recovery all together and only support TWRP
Awesome! A recovery without backup (like LOS) seems moot anyway (seems like a must have to me). Was thinking to switch already but wasn't sure about any implications (A/B vs TWRP, didn't fully grasped the A/B stuff yet)...

Uhm, rooting wouldn't be on your agenda, too? That is a thing still causing me trouble (I have to read up on it every single time).
 
Yes :) And probably also to the relevant TWRP page soon.
:ROFLMAO: Hmm, I vaguely remember the exact same thing happened to me as well at my first manual flashing. Don't other phones do that as well nowadays? I could swear the S5 i flashed 2 weeks ago did it also...
No, other phones also require this step. Since the fairphone 2 doesn't require it (as far as I know the bootloader is already unlocked), I assumed that could be similar for the Fairphone 3.
Hmm, I would certainly appreciate the "real" output as provided in console. Without it I wouldn't have really known what your installer is trying to do.
Thanks for the suggestion, I'm working on an "advanced output mode" that lets you see all the terminal input and output.
Putting some pictures wouldn't hurt but I really think that a "map" of steps is useful, too. Besides, one can see the whole progress at once (so far it's a somewhat nebulous process in my mind... and I always! tend to forget something).
yeah, I'm thinking about how to integrate this in a useful way. A bit more overview would be nice.
Nah, not yet... that's actually why I got this second phone, so can test stuff without killing off my daily driver (after some horrible experiences I am insisting to try a new phone/ROM for some weeks before I switch).

So, yes, keep it coming :cool: Your idea is awesome (and saves me some time as well).
Perfect! Thanks a lot, I'm already working on a new release and hopefully there will be much more automation and more user information (and a fully working config for the fairphone 3). I keep you updated! :)
Awesome! A recovery without backup (like LOS) seems moot anyway (seems like a must have to me). Was thinking to switch already but wasn't sure about any implications (A/B vs TWRP, didn't fully grasped the A/B stuff yet)...
So far, it works kind of okay with TWRP I would say, but I'm having weird issues on the Google Pixel with it and wasn't able to find anyone who might know anything about it. Using twrp commands in the adb shell seems to be not so common...
Either way, I would try to get away with just booting into TWRP, wiping and flashing from there. This is an approach that seems to work fine with A/B-partitioned phones as far as I can tell.
Uhm, rooting wouldn't be on your agenda, too? That is a thing still causing me trouble (I have to read up on it every single time).
It's not on the short-term agenda. But definitely something I'm thinking about. I should probably put a proper roadmap on github 😅
 
  • Love
Reactions: SigmundDroid
Soooo, now there is a new alpha Release 🥳

  • This time mainly visual improvements and more automation. This is mainly achieved by switching recovery support completely to TWRP (currently only booted, only flashed on samsung devices).
  • There is now an option to get advanced output, printing commands run and terminal output in the tool. This is still early stage and needs a fair amount of improvements, but gives some more hints about whats going on.
  • Logs are written in the same directory you run the tool in.
  • ...and support for quite some new devices! :cowboy:

@SigmundDroid : Now the support for the Fairphoen 3 should be fixed and TWRP should work A/B devices (tested with google pixel 3a). Give it a try, if you want! :)

I would be grateful about any feedback! Let me know how it works for you!
 
  • Love
Reactions: SigmundDroid

SigmundDroid

Senior Member
Sep 25, 2015
225
101
Fairphone
Samsung Galaxy S5
Just tried the 2nd version:

+ Nice, comes with log now, good! (y)

- failed at fastboot_oem_unlock twice... but actually it was the "fastboot flashing unlock" (not the oem). Not sure about the proper names for these two unlock (one in dev settings and the other one per fastboot). So, I set both correctly and restarted but it kept hanging here (and no way to skip your test).

20221120 fastboot_oem_unlock.png


The TWRP install worked well... just, how do I start it later? It was installed on A and on B is the LOS recovery - is there some easy way to use TWRP? (really don't have a clue as A/B is fairly new to me)

PS: Shall I drop you the log somewhere?
 
  • Like
Reactions: __sterby__
Just tried the 2nd version:
Great! Thanks a lot!

+ Nice, comes with log now, good! (y)
Thanks! Did you also try the "advanced output" feature?

- failed at fastboot_oem_unlock twice... but actually it was the "fastboot flashing unlock" (not the oem). Not sure about the proper names for these two unlock (one in dev settings and the other one per fastboot). So, I set both correctly and restarted but it kept hanging here (and no way to skip your test).
That's a very good catch, I noticed an issue there. I followed this official tutorial from Fairphone: https://support.fairphone.com/hc/en-us/articles/360048646311-Manage-the-bootloader-of-your-FP3-FP3-
And they used `fastboot oem unlock`, which I noticed now doesn't even exist. I fixed it now.

The TWRP install worked well... just, how do I start it later? It was installed on A and on B is the LOS recovery - is there some easy way to use TWRP? (really don't have a clue as A/B is fairly new to me)
Ah, right now, I just boot to TWRP recovery, not flash it for A/B devices, since I was not sure how to best do it for now (without potentially destroying stuff). For Samsung devices it will be flashed.
Do you think this is an issue in general? I might try to add it as a feature for power users, that can also handle the risk a bit better. What do you think?

PS: Shall I drop you the log somewhere?
For now, it's fine and I guess I know whats the issue.

I'm planning another release next week, probably mostly a bugfixing and user-interface release. I will post it here again :)
 
Hey there!
Today I released the Version v.0.3.0-alpha of the OpenAndroidInstaller with many improvements and newly supported devices! 🥳

Screenshot 2022-11-30 at 14-01-02 Screenshot from 2022-11-30 13-59-23.png (PNG Image 4608 × 14...png
Screenshot 2022-11-30 at 14-01-21 Screenshot from 2022-11-30 13-59-35.png (PNG Image 4608 × 14...png
Screenshot 2022-11-30 at 14-00-57 Screenshot from 2022-11-30 14-00-12.png (PNG Image 4608 × 14...png



The release includes 11 new devices (now 27 officially supported devices):
  • Motorola moto g7 power (ocean)
  • Motorola moto g5 (cedric)
  • Samsung Galaxy Note 9 (crownlte)
  • Samsung Galaxy Note 10 (d1)
  • oneplus 6
  • oneplus 6T
  • oneplus 7
  • oneplus 7 Pro
  • oneplus 7T
  • oneplus 7T Pro
  • OnePlus Nord N200

Give it a try, if you want! :cowboy:

I would be grateful about any feedback! Let me know how it works for you!
 
cowboy-celebrate.gif


:cowboy: Clean shot, eh!


No, really, worked like a charm! No hickups, nothing, just awesome! Thanks! :love:

PS: Fun fact... Yes, one hickup: Was trying to use LOS recovery three times in a row until I realized it should be TWRP 🤪

Great! Thanks a lot for testing again!
Looks like the thing is slowly moving to a more stable state. Maybe moving to beta next year :D

PS: Good point! In the next release I will try to make it clearer. At least you could not use the LOS recovery :LOL:
 
Hey everyone!
I did some work in the last weeks and now the OpenAndroidInstaller is available in alpha version 0.3.1, with improved user experience and newly supported devices. 🎁

New features:
  • new images to guide in the process
  • steps indicator header
  • remove step-progressbar and move the header to different column container to keep it attached to the top
  • pop-up box to explain custom recovery and OS images.
  • dialog to help finding the android or firmware version

5 New devices (now 32 officially supported devices):
  • Sony Xperia 10 (kirin)
  • Sony Xperia 10 Plus (mermaid)
  • Sony Xperia XA2 (pioneer)
  • Sony Xperia XZ3 (akatsuki)
  • Sony Xperia XZ2 (akari)

If you're interested in trying out alternative ROMs on your device, now is the perfect time to give OpenAndroidInstaller a try. Over the holiday season, you might to play with OpenAndroidInstaller on your old or new devices and see what it can do.
Thank you for supporting open source software and giving OpenAndroidInstaller a chance. Happy holidays and happy installing! 🎅

PS: There is a brand new, shareable website now! 🥳 https://openandroidinstaller.org/ 🥳

screenshot-get-ready-v0.3.1-alpha.png
screenshot-requirements-v0.3.1-alpha.png
Screenshot 2022-12-21 at 18-28-35 OpenAndroidInstaller.png
 
  • Love
Reactions: SigmundDroid

Top Liked Posts

  • There are no posts matching your filters.
  • 2
    Hello!
    Usually I mainly consult this forum to get unofficial builds of LineageOS or look for support when occasionly something goes wrong. Some time ago I wondered, why it has to be so annoying to install LineageOS (or most of the other custom ROMs). There have been several attempts to create a graphical installer for LineageOS (most famously this one) and some installers for specific ROMs like calyxos. But support for devices is rather limited and hard to extend.

    So I decided to give it a try myself and create a new attempt to build a graphical installer for alternative Android ROMs.

    Repository: https://github.com/openandroidinstaller-dev/openandroidinstaller
    Screenshot-openandroidinstaller.png

    Features:​

    - Graphical installer with instructions.
    - onefile executable.
    - adb, fastboot, heimdall and some drivers included.
    - Works on Linux (mainly tested on Ubuntu 20.04), MacOS (not on ARM, M1, M2) and windows (you might need to install some drivers manually).
    - some checks if the selected LineageOS image and recovery works for your device.
    - Installation steps are based on config files to add support for new devices.
    - written in python

    Supported devices:​

    - Currently, the alpha version mainly supports Google, Samsung, Fairphone and Sony devices, but should be fairly easy to extend to other devices.

    Alpha version release download:​


    How can you help?​

    All kinds of feedback are useful! Let me know what you think in this thread.
    If you have a unused device that supports LineageOS, perhaps you could try out this tool and report your results in this thread! I bought a bunch of different android devices, but more testing on all kinds of devices is needed and very welcome! Also testing the tool on different platforms (windows, macos, etc.) would be super helpful.

    Note that:
    - It may screw up your device. No automatic restore process is implemented yet, so make sure to have some sort of recovery tool handy.
    - When you report back, please include the version of the program you used (as identified in the Downloads section), along with your device.
    - Read the repository's README for further details!
    - This installer is not associated with official LineageOS.
    2
    Hey there!
    Today I released the Version v.0.3.0-alpha of the OpenAndroidInstaller with many improvements and newly supported devices! 🥳

    Screenshot 2022-11-30 at 14-01-02 Screenshot from 2022-11-30 13-59-23.png (PNG Image 4608 × 14...png
    Screenshot 2022-11-30 at 14-01-21 Screenshot from 2022-11-30 13-59-35.png (PNG Image 4608 × 14...png
    Screenshot 2022-11-30 at 14-00-57 Screenshot from 2022-11-30 14-00-12.png (PNG Image 4608 × 14...png



    The release includes 11 new devices (now 27 officially supported devices):
    • Motorola moto g7 power (ocean)
    • Motorola moto g5 (cedric)
    • Samsung Galaxy Note 9 (crownlte)
    • Samsung Galaxy Note 10 (d1)
    • oneplus 6
    • oneplus 6T
    • oneplus 7
    • oneplus 7 Pro
    • oneplus 7T
    • oneplus 7T Pro
    • OnePlus Nord N200

    Give it a try, if you want! :cowboy:

    I would be grateful about any feedback! Let me know how it works for you!
    2
    20221106 203704.png


    OK, it works with FP3! Awesome! Actually, that might become a nice little helper for flashing LOS!

    Ran into some problems:
    1. Had to OEM-unlock first. Could be little bit more elaborate (I usually forget to reboot the phone after that and authorize my PC, lol)
    2. First 2 times it hang, only the console told me it looks for https://lineageosroms.com/fp3/ (not official, is it?)
    3. Had to unlock with fastboot flashing unlock
      That can be a big problem for beginners if you face it the first time
    4. A little bit more feedback during flashing would be nice, console (and phone) showed more than the installer
    Overall very good approach! Well, except for the lack of feedback (errors/progress from console). Is there any logging?

    PS: Used it on Debian Bullseye with KDE.

    PSPS: Perhaps an overview of the steps would fit in there as well (so one can see past, current and future steps)?
    1
    Getting a new phone this week, will give it a shot :cowboy:
    1
    Getting a new phone this week, will give it a shot :cowboy:
    Thanks a lot! I'm looking forward to your feedback! 🤩
    What phone are you getting? I might be able to help you with support :)