Adding Your ROM to ROM Manager

Update: You can now host your ROM on ROM Manager's high speed server for free using ROM Manager Developer Portal! The following instructions are for advanced users that want fine tuned control over their ROM list, and want to utilize some of the advanced features. ROM Share will automatically host and setup your ROM for you in ROM Manager; all you need to do is upload the update.zip!



First, you'll then want to get yourself listed in the list of developers in ROM Manager:

To do that, create a JavaScript file that looks like this to describe where to find information about your ROMs:

Make sure that the URL you provide for your ROM list above will not ever need to change. I don't like doing extra work! Send me that JavaScript you just created. I'll need to add it to the ROM Manager master manifest (which has the list of all the developers and their respective ROM list URLs) before it will show up in ROM Manager. The best way to send it to me is by opening an issue on ROMManagerManifest on Github. If you are super awesome, you can fork, edit the manifest, and send me a pull request. Do NOT email me your manifest.

Now, you'll want to describe your list of ROMs that the user sees when they click you:

To do that, you need to create another JavaScript file that will live at the URL you provided. It should look something like this:



And that's it! Your ROM is now listed in ROM Manager!

But, if you want to use the more advanced features of ROM Manager, such as download mirroring, and ROM customization, check out this manifest:


Note that you can do cool things that install a sequence of installation zip files. "choices" makes a user choose between several zips (use a URL of "" for no action). Only one of those choices will be installed. You can also have multiple choice selections. And "addons" lets the user choose any number of additional zips to install. You can view my manifest for a full sample.

Finally, to register your ROM for OTA updates, you need to edit your /system/build.prop in your ROM to include your Developer ID ro.modversion (as mentioned above) so ROM Manager can identify the version of your ROM. This is optional as well, but why not get OTA updates if it's just a couple lines of settings!

ro.rommanager.developerid=cyanogen
ro.modversion=CyanogenMod-5.0.5-Droid


And that's it! Once you upload that file, your ROM will now be available to other Premium users! Good luck, and let me know if you encounter any bugs or need help!

25 comments:

Haxzamatic said...

LMAO, I need that KangMod... scratch everything I want to be Kangd! On a serious note, thanks for posting a lot of people should find this useful. You can tell Chris Soyars was here, lol

LrdElderon said...

Hope you read this koush, or ill ask in irc. So if as you mention in the new javascripts for adding other roms to the rom manager where they can add a sequence of selectable zip files for optional things, would this be basically a nice easy replacement for sprecoveries .tgz pick what you want install method? ( i hear that is a real pain to implement).

heck with your examples if I had a rom I think I could even add it LOL.....

LrdElderon said...

Hope you read this koush, or ill ask in irc. So if as you mention in the new javascripts for adding other roms to the rom manager where they can add a sequence of selectable zip files for optional things, would this be basically a nice easy replacement for sprecoveries .tgz pick what you want install method? ( i hear that is a real pain to implement).

heck with your examples if I had a rom I think I could even add it LOL.....

Anonymous said...

Its all about the benjamins, baby. Developers have to buy premium to get listed? Sounds like a win for the koushman!

Koush said...

Developers get a free copy of Premium if they list their ROM.

Anonymous said...

when i back up my roms there is no md5 file in the folder. i cant restore so i cant update my rom because i cant go back if something happens. please fix this!

Anonymous said...

Storing meids in git is a nono.

Full Throttle said...

My current rom doesnt show up when i open up rom manager premium... is there something im missing? The app is great but this is bugging me and also if I wanted to change from 1 rom to the other and I wiped data and cache would google remember my phones settings how they were before I wiped? Answer would be appreciated dont know how to else contact directly, thanks in advance.

Brad said...

I purchased premium, but my list to download has not changed..pls help

Anonymous said...

Can you include the variouse Amer Rom's? Example: http://forum.xda-developers.com/showthread.php?p=7027812&posted=1#post7027812

abe said...

can i use it for RUU HTC HERO HK WWE 3.34.721.1 ? cause now i'm stuck with it, can't downgrade too. pls hlp...

devmatt said...

I've purchased the premium version of Rom Manager but the download list only contains the 2 free options.
Please advise.

sergey said...

It looks like DC's http://dl.damagedroms.com/misc/rom_manager_manifest.js is broken - RM chokes on trailing comas. Can I use local copy of manifests.js that points to again local copy of dc manifest? If yes, how? Thanks.

Tim said...

Same as a couple of other folks have posted above... I purchased ROM Manager Premium. I have a rooted Samsung Vibrant. Clockwork installed just fine. Problem is when i click "Download ROM" in ROM Manager all I see are the two "free stuff" versions of superuser.

I've tried pretty much everything I can think of... I still got nothing.

Any help greatly appreciated!

mcclurej said...

I bought rommanger for samsung vibrant. flashed froyo rom ok. now when I try to flash another rom I get stuck going to recovery at the samsung vibrant screen. I have to remove sim card and sd card and battery to get the unit out of lockup. Any suggestions?

Richard said...

I have only free stuff in my downloads also.......?

Anonymous said...

Hello I purchased the pro verson of Rom Manager, a few days ago and it gave me 2 icons and said I would only have one later. Well there are functions that only pro users can use and that includes me I am not not sure why. I tried to buy it agian from my device and it force closes me. On a side note I partitioned my Sdcard using Rom Manager. I selected 512 and ext 0 the device does not even list the apps when i reinstall back to my sdcard, although there is a list in Rom Manager. How do I use my applications? I am using an HTC EVO 4G running cyanoginmod 6.0 with clockwork recovery. And no phone service yet I am currently in Brazil with limited CDMA network coverage. can you help me? Kindly, Jeffery

PS the Recovery and Rom installation went very well, thanks!!!!

Neil said...

I was wondering how to install your rom manager onto the 1.2 fender edition of the HTC magic

Reuven Mansharoff said...

IN dOWNLOAD Rom the list is empty apart from extras, so I purchaesd the Premium but no luck een after licence upgarde. SGS 2.2
Is there any reason I can't see a rom list available?

Anonymous said...

Pretty useless - the download does not work and no roms are listed. no support from the developer either - why the fuck do you ask for donoations if you do not maintain your junk?

Freyes said...

Using the latest Clockworkmod 3.0.0.0.,I'm seeing some multicolor lines at the bottom 1/3 of my screen after flashing, but before the bootup animation. I;ve not seen this on the last version of CM. This has been confirmed by two others on Myn's Evo warm 2.2 xda-developers forum

ABHI said...

Hi Koushik,
I have samsung galaxy 551,
when I go to clockworkmod recovery,I don't see my phone model listed in it.
so please suggest what to do?

ABHI said...

Hi Koushik,
I have samsung galaxy 551,
when I go to clockworkmod recovery,I don't see my phone model listed in it.
so please suggest what to do?

David said...

you guys are idiots, koush provides a nice easy way for developers to get their roms out to their users, if you dont like it dont use it. ITS UP TO THE ROM DEVS to make sure they are on the list.. i mean hell for the EPIC 4g we just got our first dev team up there, now i just need to figure out where i botched up js file on our side :D

Bernd said...

Maybe stupid question, but in devices, what do I put there. I have the following entries in my build.rc:

ro.product.model=P10AN01
ro.product.brand=nvidia
ro.product.name=harmony
ro.product.device=harmony
ro.product.board=harmony

Is ro.product.device the one to use?