• Introducing XDA Computing: Discussion zones for Hardware, Software, and more!    Check it out!

Free-Droid - One-Click Rom Installation Assistant

Search This thread

imska

Senior Member
Aug 7, 2015
202
71
free-droid.com
Code:
I am not responsible for any damage resulting from the use of the Free-Droid software.

Introduction
Free-Droid is an application designed to help you install custom roms on your Android device. It is supposed to make the process of finding, downloading and installing a rom (with addons like Magisk, F-Droid and microG) as easy as possible. The primary audience is all the folks who do not really know anything about Android, TWRP or roms, but still would like to run a free, open-source and non-bloated Android on their devices. Using a free after-market rom like LineageOS should not be restricted to the few people with enough technical know-how to do the complex installation procedure all by themselves.
Free-Droid is free and open-source and is available for Windows, Mac and Linux. As of now, it should be working fine with Samsung, OnePlus, NVidia, Sony and Motorola devices and with all other devices that already have TWRP installed.

Download
Download from the official website.

Images
screenshot-start.png

screenshot-settings.png

screenshot-expert.png

screenshot-help.png

screenshot-working.png


What it does
  • help you activate USB debugging
  • help you install drivers
  • help you unlock the bootloader
  • download and install TWRP
  • update TWRP if a newer version is available
  • download and install a rom
  • download and install F-Droid and MicroG
  • download and install Magisk (legacy method, off by default)

Features and explanations
Please visit the Gitlab page of the project for more details!

Compatibility
Free-Droid is supposed to work on as many devices as possible. Supported brands as of now are:
  • Samsung
  • Motorola
  • Oneplus
  • NVidia
  • Sony
  • Every device that already has TWRP installed: launch Free-Droid, boot your device into TWRP and connect it with USB to your computer
For the support status of a specific device, you can enter its model name here to check the compatibility.
The Free-Droid application itself will tell upon device connection if it is compatible. If it says that your device is not supported, you can be sure that it will not work. As of now, Free-Droid will display device untested for most devices, because I will only mark a device as supported if a few people tested it and confirmed it is actually working fine.

Changelog
For a changelog please just have a look at the commits on gitlab.

Beta
Although Free-Droid already runs very well, I was not able to test it on a lot of computers and with many different devices. Therefore, consider Free-Droid to be beta software for now.
Besides, there are a few things that still need to be implemented. What is not working yet:
  • project treble roms
  • devices that need special treatment like storage repartitioning
Finally, in order to lead Free-Droid out of the beta phase of development, a lot of testing needs to be done. This way, Free-Droid will know more reliably which devices can be expected to be workable without issues and which ones it should deny to work on.

Further development plans
  • add support for more brands that can be easily unlocked
  • handle project treble GSI roms
  • add a button to abort a running installation procedure
  • create packages for 32 bit computers
  • add MoKee rom
  • add /e/ rom
  • add possibility to install openGapps instead of microG ?
  • add possibility to select an additional zip to flash after the rom ?
  • fix crash on windows if changing folder on rom selection dialog
  • add a way to backup and restore using TWRP ?
  • add more documentation to the gitlab page ?
A note about Magisk installation
Installing magisk is getting more and more difficult. The installation method employed by Free-Droid is now discouraged and called a legacy installation method, because it can cause trouble and break the ability of the system to boot. For that reason, the installation of Magisk is turned off by default now in Free-Droid and a warning is issued to the user when turning it on.
You can still try to install Magisk with Free-Droid during the normal installation procedure. But if your system does not boot afterwards, you will have to try again without Magisk. On some devices, you might need to know how to manually boot into recovery in order to retry the installation (device-specific hardware key combination).
Free-Droid now also provides an easy way to try and install Magisk later on. The same ("legacy") installation method is used, but you can try the installation after the first boot of your newly installed system. I've seen a case where this would work while installing Magisk before the first boot would not work. This assumes that TWRP is connected or at least still installed.

I need you
Please test Free-Droid on your computer and with your device.
In case of issues: use the button in Free-Droid to pack a bug report and either send it with an email or create an issue on the gitlab issue tracker.
If you have a device of a supported brand for which Free-Droid does not find a rom by itself, please leave me a message with a link to a working rom (and/or TWRP image). If you can confirm that the rom is stable and fully working, I will add it to the Free-Droid unofficial archive and it will become available in Free-Droid.
If you know about a faulty official release of TWRP or a rom, please also leave me a message. Example: the latest few official releases of TWRP for i9305 (Samsung Galaxy S3 LTE) are faulty and fail when trying to install a rom with sideload. Free-Droid uses a specific version of TWRP in that case and can automatically handle cases like that in general. I just need to know which devices need a workaround.

Thanks To/Credits

XDA:DevDB Information
Free-Droid, Tool/Utility for all devices (see above for details)

Contributors
imska
Source Code: https://gitlab.com/free-droid/free-droid


Version Information
Status:
Beta

Created 2019-07-01
Last Updated 2021-04-09
 

Attachments

  • screenshot-start.png
    screenshot-start.png
    35.2 KB · Views: 909
  • screenshot-working.png
    screenshot-working.png
    17.3 KB · Views: 904
  • screenshot-expert.png
    screenshot-expert.png
    29.3 KB · Views: 904
Last edited:

imska

Senior Member
Aug 7, 2015
202
71
free-droid.com
Ladies and Gentlemen,

Mac support has landed. You can now download Free-Droid for MacOS.

Depending on your Gatekeeper settings, you might need to launch Free-Droid by right-clicking on it and selecting Open. If it still fails to start, try to start the file called "right-click open" in the same way.
 
  • Like
Reactions: fxo

Broked

New member
Oct 31, 2018
2
3
This is beatiful! I wasted probably 2 hours this morning to get a android 9 on my old s5 since i need it for a project, i'm not a complete newby, i rooted and changed rom many time in the last 8 years but i do it every once in a while, so i always have to check for tutorials again and there is alwasy some step that don't go as planned, as today the rom was not installing, was almost ready to give up to not lose more time, saw this, was almost sure this would gone wrong somewhere as all automated stuff while after a couple of clics and 5/10m my s5 was ready with android 9 on it. THIS IS JUST BEATIFUL and great, hope it gain the visibility it deserve!
Really GREAT job!
 

imska

Senior Member
Aug 7, 2015
202
71
free-droid.com
Ladies and gentlemen,
Support for OnePlus devices has landed.!
Assuming that the bootloader unlock procedure is the same on all OnePlus devices, Free-Droid should work perfectly with them now. Still, any bug report is welcome.
Developed and tested with a OnePlus X (onyx).
Happy flashing to everyone!
 
  • Like
Reactions: fxo

imska

Senior Member
Aug 7, 2015
202
71
free-droid.com
Sorry for the server downtime over the last days. Everything is back online again and running.
Update to be released soon with support for nvidia shield tablet (will need testing though).
 
  • Like
Reactions: fxo

imska

Senior Member
Aug 7, 2015
202
71
free-droid.com
0.7.3 update released
-Better device detection using a database from here. This should result in less devices not recognized at all. Still, a lot of devices may be recognized, but have no working TWRP or rom known to free-droid.
-a lot of refactoring done in the code
-initial support for NVidia devices. Sould work in theory, but I couldn't test it by myself yet.
 
Last edited:
  • Like
Reactions: fxo

imska

Senior Member
Aug 7, 2015
202
71
free-droid.com
Says Device Supported. Then Says "Sorry, I don't know how to work with your device." Samsung Galaxy S5 SM-G900V.
Thanks for reporting this. Maybe you can help me sort this out... The G900V is the Verizon variant if I'm not mistaken. Can you confirm that it *should* work with the official lineageOS for the S5 (klte)? Besides, it would be of great help for me to diagnose and fix the error if you could send me the logs of free-droid. You can hit export logs in the help page of the application and drop the zip either here or send to [email protected]
 
  • Like
Reactions: fxo

imska

Senior Member
Aug 7, 2015
202
71
free-droid.com
You already can install any ROM you have downloaded. Just select "use my own ROM" and choose the zip.
But I think you can use magisk and the module called tai chi to install and use xposed stuff
 

Top Liked Posts

  • There are no posts matching your filters.
  • 17
    Code:
    I am not responsible for any damage resulting from the use of the Free-Droid software.

    Introduction
    Free-Droid is an application designed to help you install custom roms on your Android device. It is supposed to make the process of finding, downloading and installing a rom (with addons like Magisk, F-Droid and microG) as easy as possible. The primary audience is all the folks who do not really know anything about Android, TWRP or roms, but still would like to run a free, open-source and non-bloated Android on their devices. Using a free after-market rom like LineageOS should not be restricted to the few people with enough technical know-how to do the complex installation procedure all by themselves.
    Free-Droid is free and open-source and is available for Windows, Mac and Linux. As of now, it should be working fine with Samsung, OnePlus, NVidia, Sony and Motorola devices and with all other devices that already have TWRP installed.

    Download
    Download from the official website.

    Images
    screenshot-start.png

    screenshot-settings.png

    screenshot-expert.png

    screenshot-help.png

    screenshot-working.png


    What it does
    • help you activate USB debugging
    • help you install drivers
    • help you unlock the bootloader
    • download and install TWRP
    • update TWRP if a newer version is available
    • download and install a rom
    • download and install F-Droid and MicroG
    • download and install Magisk (legacy method, off by default)

    Features and explanations
    Please visit the Gitlab page of the project for more details!

    Compatibility
    Free-Droid is supposed to work on as many devices as possible. Supported brands as of now are:
    • Samsung
    • Motorola
    • Oneplus
    • NVidia
    • Sony
    • Every device that already has TWRP installed: launch Free-Droid, boot your device into TWRP and connect it with USB to your computer
    For the support status of a specific device, you can enter its model name here to check the compatibility.
    The Free-Droid application itself will tell upon device connection if it is compatible. If it says that your device is not supported, you can be sure that it will not work. As of now, Free-Droid will display device untested for most devices, because I will only mark a device as supported if a few people tested it and confirmed it is actually working fine.

    Changelog
    For a changelog please just have a look at the commits on gitlab.

    Beta
    Although Free-Droid already runs very well, I was not able to test it on a lot of computers and with many different devices. Therefore, consider Free-Droid to be beta software for now.
    Besides, there are a few things that still need to be implemented. What is not working yet:
    • project treble roms
    • devices that need special treatment like storage repartitioning
    Finally, in order to lead Free-Droid out of the beta phase of development, a lot of testing needs to be done. This way, Free-Droid will know more reliably which devices can be expected to be workable without issues and which ones it should deny to work on.

    Further development plans
    • add support for more brands that can be easily unlocked
    • handle project treble GSI roms
    • add a button to abort a running installation procedure
    • create packages for 32 bit computers
    • add MoKee rom
    • add /e/ rom
    • add possibility to install openGapps instead of microG ?
    • add possibility to select an additional zip to flash after the rom ?
    • fix crash on windows if changing folder on rom selection dialog
    • add a way to backup and restore using TWRP ?
    • add more documentation to the gitlab page ?
    A note about Magisk installation
    Installing magisk is getting more and more difficult. The installation method employed by Free-Droid is now discouraged and called a legacy installation method, because it can cause trouble and break the ability of the system to boot. For that reason, the installation of Magisk is turned off by default now in Free-Droid and a warning is issued to the user when turning it on.
    You can still try to install Magisk with Free-Droid during the normal installation procedure. But if your system does not boot afterwards, you will have to try again without Magisk. On some devices, you might need to know how to manually boot into recovery in order to retry the installation (device-specific hardware key combination).
    Free-Droid now also provides an easy way to try and install Magisk later on. The same ("legacy") installation method is used, but you can try the installation after the first boot of your newly installed system. I've seen a case where this would work while installing Magisk before the first boot would not work. This assumes that TWRP is connected or at least still installed.

    I need you
    Please test Free-Droid on your computer and with your device.
    In case of issues: use the button in Free-Droid to pack a bug report and either send it with an email or create an issue on the gitlab issue tracker.
    If you have a device of a supported brand for which Free-Droid does not find a rom by itself, please leave me a message with a link to a working rom (and/or TWRP image). If you can confirm that the rom is stable and fully working, I will add it to the Free-Droid unofficial archive and it will become available in Free-Droid.
    If you know about a faulty official release of TWRP or a rom, please also leave me a message. Example: the latest few official releases of TWRP for i9305 (Samsung Galaxy S3 LTE) are faulty and fail when trying to install a rom with sideload. Free-Droid uses a specific version of TWRP in that case and can automatically handle cases like that in general. I just need to know which devices need a workaround.

    Thanks To/Credits

    XDA:DevDB Information
    Free-Droid, Tool/Utility for all devices (see above for details)

    Contributors
    imska
    Source Code: https://gitlab.com/free-droid/free-droid


    Version Information
    Status:
    Beta

    Created 2019-07-01
    Last Updated 2021-04-09
    3
    This is beatiful! I wasted probably 2 hours this morning to get a android 9 on my old s5 since i need it for a project, i'm not a complete newby, i rooted and changed rom many time in the last 8 years but i do it every once in a while, so i always have to check for tutorials again and there is alwasy some step that don't go as planned, as today the rom was not installing, was almost ready to give up to not lose more time, saw this, was almost sure this would gone wrong somewhere as all automated stuff while after a couple of clics and 5/10m my s5 was ready with android 9 on it. THIS IS JUST BEATIFUL and great, hope it gain the visibility it deserve!
    Really GREAT job!
    2
    2
    download for linux coming soon ?
    2
    0.8.2
    • The data partition is now formatted by default instead of just wiped (can be switched off in the expert options, though it means the data partition would not be touched at all). This somehow helped make the installation of Lineage 18.1 work on pioneer.