How to Customize a Custom Rom: Adding/Removing Programs
 

INTRO
------------------------------------------------------
With this tutorial, I assume you have the correct Rom version and Radio version. If you do not already have
general 'PPCGeeks-Rom-Flashin' knowledge and DO NOT already flash your rom on a regular basis...This may not be for you.

The purpose of this tutorial is to assist you in customizing your choice of custom roms.
This is intended to:
-- Limit the time running UserCustomization when flashing.
-- Show you how to add/remove programs to your favorite roms.
-- Help you become a better PPCGeek!
-- Works with the PPC-6900. It should also work on the ppc-6800, ppc-6700....

This not intended to:
-- Teach you to become a rom chef.
-- Help deviants steal an accomplished chefs rom and call it your own.
-- Make any chef unemployed.
-- Teach you how to make custom regedits, or any other fancy chef stuff.


Why do all this when there is www.ppckitchen.org? The PPCKitchen is nice, but it is...sorta Robotic. While I have no complaints, it is somewhat limited. Quite a few rom chef's have spent month's customizing their rom. This means refining registry entries, picking and choosing what programs to include, maintaining current programs versions. These folks have put countless hours into these. I have my own rom preference. I personally prefer OMJ's rom and his customizations. And honestly, I don't use a couple of programs my chef chooses, and I usually add a couple of my own programs. This tutorial will help you cut down on the time that UserCustomization takes. We all know the benefits of a Custom Rom! This brings the art to the end user level.

Which brings up...USING THIS TUTORIAL IS YOUR CHOICE! I AM NOT RESPONSIBLE FOR ANYTHING THAT MAY HAPPEN TO YOU OR YOUR DEVICE! NOTICE: YOU CAN POSSIBLY BRICK YOUR DEVICE OR LOSE SLEEP ONCE YOU CATCH THE KITCHEN BUG! Ok, let's begin...

Credits
---------------------------------------------------------
I would first like to thank the following:
PPCGeeks.COM and ALL it's members! What I have learned in the past months, I have learned here from fellow PPCGeeks members.
A couple special thanks to:
ImCokeMan - for his Rom unlocker(s)
DogGuy - his kitchen...Bepe - BuildOS...All others involved in the kitchen
Old_Man_Jenkins (& most other recent chefs) - for him unwittingly allowing me to chop up their kitchens!
...and several others, thanks, you know who you are!

Terminology
--------------------------------------------
Here is a brief explanation of some terms I will use.
OEM - In the rom world, this is the same as a cab file so OEM_directory is the same as file.cab.
..\OEM - This is the directory in the kitchen that you will copy your OEM directorys into to add programs to your rom.
..\SYS - This is the directory in the kitchen that you will delete directorys from to delete programs from your donor rom.
..\RUU - This is where your finished flashable NBH file will reside when your done.
NBH - your in the upgrade thread...search...

PREPARE
------------------------------------------------------
Files you will need:
1-Download and install install a kitchen from the FTP. Extract the exe/rar file and install to a directory. This will be your kitchen directory. For this tutorial, we will use c:\kitchens.

2-Locate your favorite chef.nbh file and copy it to your kitchen root directory. I did say copy! (Quick recovery when things go wrong)

3- Download OEM_PPCGeeks.rar (EDIT: This archive is now called PPCKitchen_OEM.rar as of July 2008 ) Extract this file to your drive be sure to extract using original directorys. Look through it and familiarize yourself with the directory names. (These are your OEM's) Later I will refer to this location as your PPCGeek_OEM folder.
Again they were, the kitchen, donor rom, and oem packages.

Getting aquainted with the kitchen structure
------------------------------------------------------
Now lets take a quick look at the Kitchens directory structure. Everything will reside in the c:\kitchen directory. There are six directorys inside the Kitchen
..\
..\Logs
..\OEM
..\ROM
..\RUU
..\SYS
..\tools
There are only two directorys that we are concerned with. The only two we will be working with is ..\OEM and ..\SYS. The OEM directory is what you add your OEM_Programs to, and the SYS directory is where you can delete files from. Be carefull what you delete! Unless you can identify a directory as an OEM, DO NOT DELETE IT!

Getting to know the kitchen programs...the basics
--------------------------------------------------------
There are three files in the kitchen root directory you will use.

PrepIt.bat - Deconstructs the Donor Rom
BuildOS.exe - Builds the operating system portion. Combines the OEM's and System files.
BuildIt.bat - Builds your rom. Packages everything together and copies your new rom to the RUU directory.

That's right. Five easy steps:
1- PrepIt
2- Add/Remove Programs, I mean OEM's
3- BuildOS
4- BuildIt
5- Flash your Rom

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

1- Deconstruct donor rom
-----------------------------------------
By now you have installed the kitchen, copied the donor rom and had a few quick pointers.
Let's get started...

Run PrepIt.bat

Some click on it out of windows explorer, and some run it from the dos command prompt. I have only had issues with ..\Tools\OEMizer.exe not doing it's thing in the proper directory. (which I never use...btw) Maybee that could be another tutorial. Windows seems to handle either for me just fine.

Tip: Contrary to popular myth, when you deconstuct a rom, the directory names for the OEM's stay the same and are easily identified!

Note: (Added 2/2/2009)
Here are some additional notes on Carrier Released Roms and how to get the NBH from the EXE:
Install WinRar. The rom is actually a self-extracting archive. Right click on the leaked rom (exe) and click on "Open with Winrar". From here, click on and drag the LARGER of the 2 NBH's (the big one is the rom as we know it) inside the exe and drop that into your kitchen. Then your good to go after you close winrar...


2- ADD/Remove Programs...OEM's
-----------------------------------------------
This is the way I start.
Open up two copies of Windows Explorer.exe. I split my screen with one window on the left side, and one on the right side. On the left is the c:\kitchens directory, and of course the right window is your PPCGeeks_OEM folder.

ADD PROGRAMS- simply drag your OEM from the right PPCGEEKS_OEM directory and drop it into the c:\kitchen\OEM folder

REMOVE PROGRAMS - This is a little more complicated...

Here is the best way to approach it. In the left window, open the c:\kitchen\SYS folder, and the right window should still be your PPCGeeks_OEM directory. When you see a program you want to delete, simply delete the whole directory or folder.

IF YOU DON"T SEE THE FOLDER NAME IN THE LEFT AND RIGHT WINDOWS...IT MAY NOT BE SAFE TO DELETE!!!

I can't cover each and every OEM here, but from what I have seen, most everyone has the same stuff as far as OEM's go. Did I say pretty much the same stuff? Good. Once you have added and deleted what you want move on to step 3.

3- BuildOS
----------------------------------------------------
This step adds/removes OEMS that you selected in step two.
In your left window, change back to the root c:\kitchens directory and run BuildOS.exe
This should have brought up a new window, this is the BuildOS program. In the window you should see most of the OEMS that you added. YOU WILL NOT SEE OEM's THAT WERE ALREADY IN THE DONOR ROM, and they will be added for you. Place a check mark to the right of the program that you have added. Please check all the programs you want included in the build. Next click that green arrow in the upper left of the window. This will create the OS. You will see the green progress bar to the bottom right. When it is done, BuildOS will say "Done." in the lower left corner. Now you can close BuildOS.

Things that can go wrong....
Most common are duplicate files in OEM's. In this case, BuildOS will display an error. I am not prepared in this tutorial to outline every duplicate. Normally you search your C:\kitchens directory for the offending filename and delete one of the two. This is the reason I suggest using the PPCGeeks_OEM package, the nice folks at ppckitchen.org have done this for you.

4- BuildIt
-----------------------------------------------
In your left window, got to the kitchen root directory and run BuildIt.bat

When this is finished, so are you! You will find your new rom in the ..\RUU folder. It is named...

..\RUU\RUU_Signed.nbh

...This file is what most of you are used to downloading and flashing. You can now run ROMUpdateUtility.exe and test your new creation, change your pagepool, etc...

5- Flash It
-----------------------------------------------
Congratulations! You have successfully Customized your Custom Rom!


Edit: If at any time you do something wrong...

1 - The kitchen renames your donor rom to Input.nbh in the root directory. So all you have to do is go back to step one and start over.

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

Awesome tutorial. This is really handy to tweak the really good roms out there to your own preference. Much appreciated.

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

Very nice tutorial Rstoyguy!

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

Nice and straight forward. Good job. Maybe this'll get stickied.

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

I really like JD's sprint2921 ROM, and I'd like to have the gps and revA like the Hybrid ROM. If I use prepit to extract the nbh of each rom can I simply mix and match certain files to get gps and Reva on a stock like ROM? I'm sure that's over simplified but I really don't know. Can I turn one of the ROMS into a kitchen?

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

The GPS and Rev-A is actually in the Radio. That topic on converging roms should be left to the chefs. This thread is for taking jd's rom and adding a few programs to it and taking out a few you don't want. Maybee you can request to have the features you liked in his 2921 rom installed in his current rom.

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

There have been numerous requests of him already. I'd hoped it was something I could pull off. Do you think if I have the 3.xx radio installed I can run an older rom and get gps if I add the driver's?

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

Flashing an older rom on the new radio would not be wise. The new rom had to be ported from alltel to work with the new radio. You might try the PPCKitchen so you can create your own rom. It is fairly easy to use and has a support forum for it if you run into any problems. This tutorial is only for minor changes to an existing rom.

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

Anyone know if the 'better' gps drivers that JD uses in his roms are being used in OMJ's roms? I'd like to try out his rom, but I've noticed a bit of a difference with JD's updated drivers.

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

Um, no. It's actually less limited. What led you to think it was more limited?
If you really want to cut down on User Customization time, learn to use PPCkitchen.org's kitchen. It can be used as a drop in replacement for bepe's buildos, but it's real power lies in it's additional features for end user rom customization. There is no substitute.

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

please sticky good work

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

I probably removed something important just now on my first time editing. My edited ROM didn't want to load up(just blank screen after the HTC screen). Good thing I was able to reflash my phone using the SD method. :P

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

Same problem here. But I didn't remove anything... I just ran throught the process to see how it works. I did notice that the newly created rom is 10mb smaller then the input even though I didn't remove anything...Does anyone have ideas...

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

I have noticed shrinkage of about 1-2mb in the past, but 10mb is significant. When you run PrepIt.bat are you waiting until it says complete? Same with BuildIt.bat. Both of these processes pop up several dos windows and it does take a while.

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

Yes I some roms work fine others don't. I happen to be using derek's new 19.1 vista/ gpsd rom and just tried it with that one. The input file is 73mb and the signed ruu is only 60mb. All I did was prepit, then buildos, then builtit and flash it. I make to the 2nd splash and then black screen. So I then flash from the card.... Any advice????

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

Noob question - is a kitchen the same as a ROM....i dont think so, so can someone tell me the difference.

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

How do you change the picture when you first power on the phone. I would like to have the black HTC screen back. can anyone post a link to the picture to be used?

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

I'll look into that tonight. Are you sure he isn't packaging his RUU folder with his rom in the exe? That is between 8-19mb.

A kitchen is what you use to build and package a Rom.

How about this link...post 134
http://forum.ppcgeeks.com/showthread.php?t=25335&page=4

There are 3 boot up images. I think we were introduced to the first (change) one with the PPCKitchen. Most roms never messed with changing this one, so we never noticed it before.

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

I did the 5 steps, and here is what I got...Exactly the same.

The kitchen in the link utilizes "BigStorage" technology that saves you on average 10megs when you flash your rom. Giving you more room on your
device. :)

So your problem is no problem at all right? You gain 10 megs thanks to compression! I've used this kitchen for so long, I almost forgot about it....

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

No, it was always compressed. Bigstorage repartitions, sizing the OS partition to exactly what it needs, placing the rest in "storage memory". Most (all?) non-stock ROMs have had this done to them for Titan and later devices.

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

Thank you for the clarification. I don't recall where I got my answer from, but that definately makes more sense. :)

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

In step 3 I can not download the OEM_PPCGeeks.rar file, can someone tell me where I can find it. Thanks

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

It used to be on the ftp.... You can use the one from the PPCKitchen

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

[quote=rstoyguy;270614]I did the 5 steps, and here is what I got...Exactly the same.

The kitchen in the link utilizes "BigStorage" technology that saves you on average 10megs when you flash your rom. Giving you more room on your
device. :)

So your problem is no problem at all right? You gain 10 megs thanks to compression! I've used this kitchen for so long, I almost forgot about it....
-----------------------------------------------------------------------------------------------------------------------------------------------------------



Yeah but when you try to flash it it doesn't work. Some roms I have tried this with aren't reduced in the same fashion....The big problem occures after the phone starts to boot. You will get past the 2nd splash and enter a never ending black screen. But active sync will still connect and I can reflash a different rom.. If I install the same rom via his .exe then all is well. So something has to be going on during the breakdown and rebuild.....

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

I have no issues. Which nbh file are you flashing? It needs to be the one from the RUU directory. Which rom are you having trouble with? It has to be a rom that matches your radio flashed.

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

I am using radio 3.37. The rom I was using was Dereks 19.1 htc GPS. It flashes fine if I run the exe but if I run the nbh through the tools and then flash the nbh in the ruu folder that is what happens. But only this rom is giving me trouble. Weird...

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

This rom is slightly different than the others. I'll see if I can't finger something out later tonight.

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

After reading his thread, it appears to me that derek is having some issues with that rom.

Edit: This is from his thread, try it now.

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

When I run the PrepIT.bat file it removes the OEM folder, should I manually re-create it and add the OEMs that I want there?

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

Everytime you run PrepIt.bat, it removes most of the folders in your kitchen directory, including OEM and SYS. PrepIt.bat also will recreate these folders by the time it is done. This assures an accurate 'decompilation'. I keep two additional folders with OEMS. One I have all the PPCKitchen OEM's, and another I keep in a folder dons_oems. (both are outside the kitchen folder) This is where I keep the ones I always add to a rom. This saves time and I'm sure to get all the programs I use. You do have to check the SYS folder to make sure there are no duplicates.

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

Learn to use PPCKitchen's buildos, and you won't have to go through so much trouble.

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

I am trying to customize OMJ's latest ROM to remove some programs. All goes well but when I go to flash, my Vogue gets stuck at the PPCGeeks screen. Any ideas?

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

Honestly, I haven't flashed his v2 rom. I am planning on re-flashing tomorrow night, I'll do the steps on that one and see what I can come up with. I'm wanting the ol' HTC screen back myself.

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

I don't mind the Chef screen but I would like to remove some programs that I don't use. It seems everytime i do this (following steps exactly) then reflash with the edited ROM I get stuck at the chef screen and have to reflash with the original OMJ v2 rom (for sprint).

Any help is greatly appreciated.

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

It may have something to do with greloc, but I'll have to look into the addresses and all. I'll find an answer somewhere...or you can let me know. It is pool/bar night.... :)

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

I don't know what greloc is but I'll try and do some research.

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

This gotta be a dumb question, but i have never flashed a rom b4 except for teh official sprint releases, but another damn monday has p*****, and i dont have GPS, so i am gonnna give JDs a shot. My question is, the threads title "add/remove programs" are u guys talking about customising a rom, or just teh regular install/uninstall programs in a rom. i thought installing/uninstalling progs. to any rom wud be same as in the official rom, just crarifying??

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

Customizing a rom before you flash. Just my little tutorial doesn't appear to be working on some the post-GPS roms, I'll verify that this evening.

Re: How to Customize a Custom Rom: Adding/Removing Programs
 

So, if i were to install a custom ROM, i wont be able to install any programs like gsplayer, wisbar advance, etc??? i am confused](*,)