Post Reply

[MOD][SEP 14] MultiROM v28 (Redesigned GUI!)

24th September 2013, 07:44 PM   |  #1  
Tasssadar's Avatar
OP Recognized Developer
Flag Brno
Thanks Meter: 4,673
 
703 posts
Join Date:Joined: Dec 2010
Donate to Me
More
Introduction
MultiROM is one-of-a-kind multi-boot mod for Nexus 7. It can boot any Android ROM as well as other systems like Ubuntu Touch, once they are ported to that device. Besides booting from device's internal memory, MultiROM can boot from USB drive connected to the device via OTG cable. The main part of MultiROM is a boot manager, which appears every time your device starts and lets you choose ROM to boot. You can see how it looks on the left image below and in gallery. ROMs are installed and managed via modified TWRP recovery. You can use standard ZIP files to install secondary Android ROMs and MultiROM even has its own installer system, which can be used to ship other Linux-based systems.

Features:
* Multiboot any number of Android ROMs
* Restore nandroid backup as secondary ROM
* Boot from USB drive attached via OTG cable

You can also watch a video which shows it in action.


Warning!
It _is_ dangerous. This whole thing is basically one giant hack - none of these systems are made with multibooting in mind. It is no longer messing with data partition or boot sector, but it is possible that something goes wrong and you will have to flash factory images again. Make backups. Always.


Installation
1. Via MultiROM Manager app
This is the easiest way to install everything MultiROM needs. Install the app and select MultiROM and recovery on the Install/Update card. If the Status card says Kernel: doesn't have kexec-hardboot patch! in red letters, you have to install also patched kernel - either select one on the Install/Update card or get some 3rd-party kernel here on XDA. You are chosing kernel for your primary ROM, not any of your (future) secondary ROMs, so select the version accordingly.
Press "Install" on the Install/Update card to start the installation.
2.Manual installation
Firstly, there are videos on youtube. If you want, just search for "MultiROM installation" on youtube and watch those, big thanks to all who made them. There is also an awesome article on Linux Journal.

Note 1: Your device must not be encrypted (hint: if you don't know what it is, then it is not encrypted).

MultiROM has 3 parts you need to install:
  • MultiROM (multirom-YYYYMMDD-vXX-flo.zip) - download the ZIP file from second post and flash it in recovery.
  • Modified recovery (TWRP_multirom_flo_YYYYMMDD.img) - download the IMG file from second post and use fastboot or Flashify app to flash it.
  • Patched kernel - You can use either one of the stock ones in second post or third-party kernels which include the patch, you can see list in the second post. Download the ZIP file and flash it in recovery.
You current rom will not be erased by the installation.
Download links are in the second post.
MultiROM is compatible with both flo and deb.


Adding ROMs
1. Android
Go to recovery, select Advanced -> MultiROM -> Add ROM. Select the ROM's zip file and confirm. As for the space, clean installation of stock 4.2 after first boot (with dalvik cache generated and connected to google account) takes 676mb of space.
2. FirefoxOS
Download FirefoxOS ZIP package from this thread. The installation is completely the same as Android ROMs.
3. Ubuntu Touch
Use the MultiROM Manager app to install Ubuntu Touch.

Ubuntu Touch is in development - MultiROM will have to be updated to keep up with future changes in Ubuntu, so there's a good chance this method stops working after a while and I'll have to fix it.

Using USB drive
During installation, recovery lets you select install location. Plug in the USB drive, wait a while and press "refresh" so that it shows partitions on the USB drive. You just select the location (extX, NTFS and FAT32 partitions are supported) and proceed with the installation.
If you wanna use other than default FAT32 partition, just format it in PC. If you don't know how/don't know where to find out how, you probably should not try installing MultiROM.
If you are installing to NTFS or FAT32 partition, recovery asks you to set image size for all the partitions - this cannot be easilly changed afterward, so choose carefully. FAT32 is limited to maximum of 4095MB per image - it is limitation of the filesystem, I can do nothing about that.
Installation to USB drives takes a bit longer, because the flash drive is (usually) slower and it needs to create the images, so installation of Ubuntu to 4Gb image on my pretty fast USB drive takes about 20 minutes.
Enumerating USB drive can take a while in MultiROM menu, so when you press the "USB" button in MultiROM, wait a while (max. 30-45s) until it searches the USB drive. It does it by itself, no need to press something, just wait.


Updating/changing ROMs
1. Primary ROM (Internal)
  • Flash ROM's ZIP file as usual, do factory reset if needed (it won't erase secondary ROMs)
  • Go to Advanced -> MultiROM in recovery and do Inject curr. boot sector.
2. Secondary Android ROMs
If you want to change the ROM, delete it and add new one. To update ROM, follow these steps:
  • Go to Advanced -> MultiROM -> List ROMs and select the ROM you want to update.
  • Select "Flash ZIP" and flash ROM's ZIP file.


Source code
MultiROM - https://github.com/Tasssadar/multirom/tree/master (branch master)
Modified TWRP - https://github.com/Tasssadar/Team-Win-Recovery-Project (branch master)
Kernel w/ kexec-hardboot patch - https://github.com/Tasssadar/android_kernel_google_msm


Crowdfunding campaign
A crowdfunding campaign to get test devices took place from July 28th to August 27th 2013. Thanks all contributors, the campaign was successful, raising a total of $562. This enabled a purchase of flo and resulted in MultiROM being ported to said device and the code became much more portable.

These people pledged $10 or more and got perk "The Thread" or "The Code":If you supported this campaign, either by pledging money or promoting it, I thank you, doesn't matter if you're on the list or not. This wouldn't be possible without you.


Donations
I'd be glad if you could spare a few bucks. You can use either paypal or Bitcoins, my address is 172RccLB2ffSnJyYwjYbUD3Nx4QX3R8Ris
Thanks to all donors, it is much appreciated
Attached Thumbnails
Click image for larger version

Name:	mrom_screenshot_000.png
Views:	1242
Size:	43.5 KB
ID:	2889523   Click image for larger version

Name:	mrom_screenshot_001.png
Views:	1293
Size:	72.8 KB
ID:	2889524   Click image for larger version

Name:	mrom_screenshot_002.png
Views:	1191
Size:	76.2 KB
ID:	2889525   Click image for larger version

Name:	mrom_screenshot_003.png
Views:	1130
Size:	26.8 KB
ID:	2889526   Click image for larger version

Name:	mrom_screenshot_004.png
Views:	1100
Size:	40.8 KB
ID:	2889527  

Click image for larger version

Name:	mrom_screenshot_006.png
Views:	1111
Size:	42.3 KB
ID:	2889528   Click image for larger version

Name:	mrom_screenshot_007.png
Views:	1079
Size:	44.6 KB
ID:	2889529   Click image for larger version

Name:	mrom_screenshot_008.png
Views:	1089
Size:	43.5 KB
ID:	2889530   Click image for larger version

Name:	mrom_screenshot_009.png
Views:	1091
Size:	76.8 KB
ID:	2889531   Click image for larger version

Name:	mrom_screenshot_010.png
Views:	1066
Size:	51.3 KB
ID:	2889559  

Click image for larger version

Name:	mrom_screenshot_013.png
Views:	1035
Size:	54.7 KB
ID:	2889560  
Last edited by Tasssadar; 16th September 2014 at 01:44 PM.
The Following 124 Users Say Thank You to Tasssadar For This Useful Post: [ View ]
24th September 2013, 07:45 PM   |  #2  
Tasssadar's Avatar
OP Recognized Developer
Flag Brno
Thanks Meter: 4,673
 
703 posts
Join Date:Joined: Dec 2010
Donate to Me
More
Downloads
1. Main downloads

MultiROM: multirom-20140821-v28-flo.zip
Modified recovery (based on TWRP): TWRP_multirom_flo_20140914.img (flo) or TWRP_multirom_deb_20140914.img (deb)
MultiROM Manager Android app: Google Play or link to APK

Kernel w/ kexec-hardboot patch (Stock 4.3): kernel_kexec_flo_430-2.zip
Kernel w/ kexec-hardboot patch (Stock 4.4): kernel_kexec_flo_440.zip
Kernel w/ kexec-hardboot patch (Stock 4.4.1 and 4.4.2): kernel_kexec_flo_441.zip
Kernel w/ kexec-hardboot patch (Stock 4.4.3 and 4.4.4): kernel_kexec_flo_443.zip
Kernel w/ kexec-hardboot patch (Stock L preview): kernel_kexec_flo_L.zip
Kernel w/ kexec-hardboot patch (CM 10.2 - old): kernel_kexec_flo_cm102-3.zip
Kernel w/ kexec-hardboot patch (CM 10.2 - new): kernel_kexec_flo_cm102_new.zip
Kernel w/ kexec-hardboot patch (CM 11 (4.4 - 4.4.2)): kernel_kexec_flo_cm11-5-a7e944881c.zip
Kernel w/ kexec-hardboot patch (CM 11 (4.4.3 - 4.4.4)): kernel_kexec_flo_cm11-8-56220eb2ca.zip
You need to have kernel with kexec-hardboot patch only in your primary ROM!

Mirror: http://d-h.st/users/tassadar
2. third-party kernels with kexec-hardboot patch
Glitch kernel (13/10/2013 or newer!) - http://forum.xda-developers.com/show....php?t=2449919
ElementalX - http://forum.xda-developers.com/show....php?t=2389022
franco.Kernel - http://forum.xda-developers.com/show....php?t=2446431
TinyKernel - http://forum.xda-developers.com/show....php?t=2383083

Nicely ask your kernel developer to merge kexec-hardboot patch.
3. Uninstaller

MultiROM uninstaller: multirom_uninstaller-flo-2.zip
Flash this ZIP file to remove MultiROM from your device. It will erase all secondary ROMs. If you don't want MultiROM menus in recovery, re-flash clean TWRP, but it is not needed - those menus don't do anything if MultiROM is not installed.


Changelog
Code:
MultiROM v28
=====================
* Fix freezes in the boot manager
* You can now swipe between the tabs in the boot manager
* Minor UI adjustments
* SailfishOS support (for certain devices)

MultiROM v27
=====================
* Redesign the boot manager GUI. Looks much better now.
* Fix separate radio.img not working on Android L preview ROMs
* Fix issues with unaccessible /sdcard on Android L preview. Do NOT run
  restorecon manually on /data/media, ever - it breaks MultiROM!
* Workaround bug which caused franco.Kernel on N5 to break secondary ROM's
  boot
* Update Ubuntu Touch init scripts
* Use power+volume down (you have to press power first!) to save screenshots.
  They are now PNG images and are saved to /sdcard/Pictures/Screenshots/.

MultiROM v26
=====================
* Fix boot into secondary ROM from the MultiROM Manager app broken in v25

MultiROM v25
=====================
* Add support for the Android L preview

MultiROM v24
=====================
* Add F2FS support
* Show icons in ROM list, configurable via MultiROM Manager app
* Improve compatibility with different ROMs and kernels when booting a ROM
  from the Android app

MultiROM v23
=====================
* Fix compatibility with Ubuntu Touch rev 290 and higher. If your Ubuntu
  installation won't boot, go to recovery and use "Re-patch init" option in
  Advanced -> MultiROM -> List ROMs -> *ubuntu*.

MultiROM v22b
=====================
* Fix excessive battery drain (~1%/hour, about 5x more) while in primary ROM
  caused by a bug in kernel drivers triggered by MultiROM. Read post #465 on
  XDA forums for more info - http://bit.ly/xda-flo-drain

MultiROM v22a
=====================
* Mount the real /data partition to folder /android/realdata in Ubuntu Touch,
  enabling sharing data between Android and Ubuntu Touch. See
  http://bit.ly/ut_sharing for more info.

MultiROM v22
=====================
* Fix linux-type ROMs (Ubuntu Touch) failing to boot for some users

MultiROM v21a
=====================
* Add support for testing builds of Ubuntu Touch (see XDA thread, post #308)

MultiROM v21
=====================
* Revert "mount /system in secondary ROMs read-only" - if done so, SuperSU
  breaks the boot.

MultiROM v20
=====================
* Support booting ROMs directly from Manager App
* Fix FCs on CyanogenMod-based ROMs
* Fix support for USB drives formatted with NTFS, broken in v17
* Mount /system in secondary ROMs read-only

MultiROM v19
=====================
* Implement "boot the last ROM" auto-boot type

MultiROM v18
=====================
* Fix silent-but-unpleasant crash with exFAT

MultiROM v17
=====================
* Changes to support MultiROM Manager app
* Add support for exFAT

MultiROM v16
=====================
* Add overscroll bounceback effect to rom list
* Add support for controling via physical keys
* Bunch of under-the-hood changes for mako and m7 support

MultiROM v15a
=====================
* Fix bootloop after flashing on certain kernels. Update your kexec-hardboot
  kernel!

MultiROM v15
=====================
* Initial version

Recoveries:
Code:
14.9.2014
=====================
* Update with changes from 2.8.0.1 upstream version: fix a bug that causes
  weird graphics glitches and touch issues

11.9.2014
=====================
* Update to TWRP 2.8.0
* Fix adding ROMs from backup to a FAT32 USB drives
* Remove "share kernel with internal?" from "Add ROM" page, there is usually
  no reason to use it anymore and it might be confusing to figure out what it
  actually does. You can still get the same behavior by clicking "Remove
  boot.img" on the List ROMs -> *rom name* page.

21.8.2014
=====================
* Remove Ubuntu Touch installation, installing via recovery is deprecated
* Add SailfishOS installation (only for supported devices)

8.8.2014
=====================
* Show secondary ROM's name in the title bar while executing it's script (e.g.
  during OTA update)
* Update Ubuntu Touch updater
* Fix failure to swap ROMs if it contains filenames starting with a dot
* Fix add ROM from a backup producing unbootable ROM with Android L preview
* Add option to remove radio.img from secondary ROMs
* Add config options for MultiROM v27

5.6.2014
=====================
* Update to TWRP 2.7.1
* Hide misleading "Mount: Unable to find partition for path '/data'" message
  which appeared during secondary ROM installation, it is not _actually_ an
  error.

4.6.2014
=====================
* Fix installation of bigger (>350MB) ZIPs as secondary ROMs

12.5.2014
=====================
* Fix crash during settings loading, causing a bootloop with certain settings

11.5.2014
=====================
* Add F2FS support
* Add tool to switch F2FS<->ext4 to Advanced menu
* Fix problems with backups introduced by TWRP 2.7.0

8.3.2014
=====================
* Update to TWRP 2.7.0
* Remove "save" button from MultiROM settings page, it is saved automatically
  now

27.2.2014
=====================
* Support for system-image based (from the Manager app) Ubuntu Touch
  installation
* Some rendering optimizations, resulting in noticeably higher FPS in recovery

4.2.2014
=====================
* Update to support latest Ubuntu Touch testing builds
* Add support for mice connected via USB-OTG
* Fixup scrollbar behaviour in file list

24.12.2013
=====================
* Fix installing ROMs to USB drive
* Fix ZIP verification
* Support ZIP verification for secondary ROMs

15.12.2013
=====================
* Support OTA updates on secondary ROMs (tested with omni)
* Add "Swap ROMs" feature
* Implement "boot the last ROM" auto-boot type
* Many bugfixes

2.12.2013
=====================
* Fix support for abootimg-based kernel installers
  (fixes ElementalX and Glitch kernels)

10.11.2013 - 01
=====================
* Fix some mounting issues when using ntfs or exFAT

10.11.2013
=====================
* Add exFAT support
* Support system-image based Ubuntu Touch installation
* Support Ubuntu Touch OTA updates, if Ubuntu is installed
  via MultiROM manager app

22.10.2013
=====================
* Fix SuperSU reporting "failed" when flashed to secondary ROM
  and completely borking the MultiROM part for any subsequent
  uses of "Flash ZIP" or "Backup" option

16.10.2013
=====================
* Automatically inject boot sector with MultiROM
  after ZIP installation or ADB sideload. Can be
  turned off on "confirm flash" or "ADB sideload"
  pages.

12.10.2013
=====================
* Support 'adb sideload' when adding ROMs
* Support rotation while using custom recovery theme

5.10.2013
=====================
* Don't display unsupported systems in "Add ROM" menu

28.9.2013
=====================
* Fix instalation of some ROMs with AROMA installer

25.9.2013
=====================
* Don't unmount /usb-otg after Adding ROM
* Fix bootloop after injecting boot on certain kernels

24.9.2013
=====================
* Initial flo release
Last edited by Tasssadar; 16th September 2014 at 01:44 PM.
The Following 47 Users Say Thank You to Tasssadar For This Useful Post: [ View ]
24th September 2013, 07:45 PM   |  #3  
Tasssadar's Avatar
OP Recognized Developer
Flag Brno
Thanks Meter: 4,673
 
703 posts
Join Date:Joined: Dec 2010
Donate to Me
More
FAQ and other notes
About security
In order to make multi-booting possible, MultiROM has to sacrifice some security measures. Firstly, on secondary Android ROMs, /system is not mounted read-only. While there are other things preventing malicious software from messing with /system, this might potentialy make it easier for such software to attack that system.
Next, MultiROM doesn't work with /data encryption. Not many people who use custom ROMs also use encryption anyway, so that isn't much of a concern.
What do the ROMs share?
All ROMs are separate, except /sdcard, which is shared between all Android ROMs.
How many ROMs can I have?/Where are the ROMs stored?
You can have as many ROMs as you can fit in your /sdcard. All the ROMs are stored in /sdcard/multirom/roms or on an USB drive. This folder is unaccessible in Android, to prevent mediascanner from scanning it. You can either in recovery, or obtain root and go to /data/media/0/multirom/roms.
Can I have different versions of Android working alongside
Yes. As long as you select "Don't shere kernel" when installing the secondary ROM, the systems are separated.
MultiROM recovery says it's 2.6.3.0. Why isn't it updated to 2.6.3.*highernumber*?
It is, it just shows wrong version.
The menu with all the ROMs won't show up during boot, how to fix it?
Either re-flash the MultiROM zip or go to recovery, Advanced -> MultiROM -> Inject curr. boot sector.

The reason for this is that something rewrote your boot.img, which happens for example when you flash a kernel. MultiROM's boot menu is part of the boot image, so it has to be added into it again.
Will you port MultiROM to device X?
No, probably. I won't port MultiROM to any device I don't own, because it is very difficult to provide the level of support I want to provide if I can't test things myself, as proven by the Nexus 4 port. I'd like to support more devices, but it is also very unsatisfying to work on code for device I don't have - I invest hours upon hours of time for free into it, and then I can't even see it running on the device, so...why..bother..?
I'll probably keep buying Nexus devices and keep porting MultiROM to those myself, but I can't buy every single device - I'm still a student, all my existing devices were bought using some kind of money grant or donations from users.
But, you can port it yourself, the wiki should give you at least some idea how to do that: https://github.com/Tasssadar/multiro...rting-MultiROM
Last edited by Tasssadar; 8th August 2014 at 05:43 PM.
The Following 30 Users Say Thank You to Tasssadar For This Useful Post: [ View ]
24th September 2013, 08:30 PM   |  #4  
Chmeleon's Avatar
Member
Flag Zwolle
Thanks Meter: 10
 
35 posts
Join Date:Joined: Jun 2013
More
Awesome work Tassadar!

I'm going to check it out right away

edit:

Got it up and running, no problems, thanks for the extra help
Last edited by Chmeleon; 24th September 2013 at 09:03 PM.
24th September 2013, 08:42 PM   |  #5  
Vaykadji's Avatar
Member
Flag Namur, Belgium
Thanks Meter: 22
 
76 posts
Join Date:Joined: Jan 2013
More
This is awesome ! With Ubuntu Touch coming in october, there'll be a party on my N7

A question though, why do we have to use a patched kernel, doesn't the kernel runs AFTER the multirom part ? I'm asking mainly because I fear for the upcoming Ubuntu Touch and maybe his brand-new kernel. If it's not compatible or will have to be patched, isn't there a risk that we have to "always" use a custom-kernel after every little update? (and Canonical knows his way in kernel updating every 2 weeks on desktop computer, especially with a new product...)
But I'm also asking to satisfy my curiosity ^^

Thank you very much, anyway, I'm glad your funding campain was a success. I can't hit the "Thanks" button enough.
24th September 2013, 08:49 PM   |  #6  
Tasssadar's Avatar
OP Recognized Developer
Flag Brno
Thanks Meter: 4,673
 
703 posts
Join Date:Joined: Dec 2010
Donate to Me
More
MultiROM starts immediately _after_ kernel. When you select secondary ROM with different kernel, it needs to load it, somehow - that's what kexec is for. Only the kernel for primary ROM has to be patched though, so if you'd install Ubuntu Touch as secondary, it can live with it's own, unpatched kernel.

By the way, as far as I know, Canonical does not plan to support flo. Ubuntu Touch is planned to release in October, but that means it's going to get "stable" version for those 4 nexus devices (mako, manta, grouper and maguro) and possibly some new devices, which will be running Ubuntu Touch out of the box. I think flo needs a community port.
The Following 5 Users Say Thank You to Tasssadar For This Useful Post: [ View ]
24th September 2013, 08:53 PM   |  #7  
GSLEON3's Avatar
Retired Senior Moderator
Flag NSA Black Site Whiskey Tango Foxtrot One Niner
Thanks Meter: 1,323
 
2,453 posts
Join Date:Joined: Dec 2006
Donate to Me
More
@Tasssadar

Looks awesome! I can't wait to give it a try! Hopefully Flar will inegrate the patch into her Kernel. Thanks a lot for the port!
24th September 2013, 09:05 PM   |  #8  
Senior Member
Thanks Meter: 31
 
114 posts
Join Date:Joined: Dec 2010
Are the roms able to share apps/data like Modaco switch or is each rom independent?
24th September 2013, 10:24 PM   |  #9  
Tasssadar's Avatar
OP Recognized Developer
Flag Brno
Thanks Meter: 4,673
 
703 posts
Join Date:Joined: Dec 2010
Donate to Me
More
Quote:
Originally Posted by chadamir

Are the roms able to share apps/data like Modaco switch or is each rom independent?

Each ROM is independent.
The Following 2 Users Say Thank You to Tasssadar For This Useful Post: [ View ]
24th September 2013, 11:14 PM   |  #10  
Senior Member
Thanks Meter: 32
 
137 posts
Join Date:Joined: Apr 2011
Quote:
Originally Posted by chadamir

Are the roms able to share apps/data like Modaco switch or is each rom independent?

In addition to this, what about files like docs, pics, etc? How is space alloted per rom? Is it adjustable after install?

Never tried this with my original N7 but I think I'll be trying it on the new one.

Post Reply Subscribe to Thread

Tags
dual boot, multiboot, multirom
Previous Thread Next Thread
Thread Tools Search this Thread
Search this Thread:

Advanced Search
Display Modes


Top Threads in Nexus 7 (2013) Original Android Development by ThreadRank