How to set up UC
 

I found this awesome TuT on setting up UC by Slueth225 over at XDA This will help you to set up User Customization. So, whenever you flash a new rom, everything you want to install and change will be done so automatically. Making it even easier to make your phone yours again. I will be posting a video Tutorial on this either tonight or tomorow, for those that need some visual assistance. I have attached a tool to create a sdconfig.txt for those that do not wish to do it manually. Enjoy and have some fun!!!

What is UC? It is a feature contained in UC capable ROMs. A UC capable ROM extends initial customization to your SD card so you can load cabs and install XML files that are located there too. What this means is that once you get your customization scripts right, you can flash any UC capable ROM and all your apps and settings will be restored as part of the initial customization process whenever your SD card is inserted in the slot.

If you are a ROM chef and want to make your own ROM UC capable, then go here to learn how. The effort is trivial btw.

Ok, on to creating scripts!

First you need to read a short WiKi article on customization that's located here

How do you set up UC? By placing a file called "SDConfig.txt" in the root directory of your storage card. The best way to illustrate this is to show examples. Here is my SDConfig.txt:

This is mine, Superman369
Here are some important facts to remember:

• end your file with the "RST: Reset" command
• The file cannot be UNICODE
• All commands must be in UPPER CASE. CAB: is valid but Cab: is not. Case is not important in the parameter portion however: \Storage Card\CABS\myCAB.cab is the same as \storage card\cabs\mycab.cab.
• Cabs that specifically wait for additiional user input (other than the initial location) can be loaded but require special grouping. An example of this is the 1-calc installation which stops and makes you accept a license agreement. Go here to find out how to load these. Thanks booda!
• Tabs/Spaces at the end of a line are not allowed and will cause SDAutoRun to abort on a file not found error.
• The first 5 characters of a line are reserved for the command. The parameter for the command must begin on the 6th character That means to add one space to 4 character commands like "CAB:" and no spaces to 5 character commands like "HIDE:".

++++++++++++++++++++++++++++++++++++++++++++++++++ +++++++++++++++++++++++++
Settings customization is pretty advanced stuff. You might want to get going first by simply using User Customization to install some cabs. If I were first starting out, I'd install cabs that customize my device. For example, I have a Tilt, so I would install a Keyboard patch cab for the Tilt layout and another cab that disables the AT&T hidden proxy. This would require two CAB: statements in SDConfig.txt.

However, if you're yearning to do more settings customization, then the "XML:" config statement is the key. Here's my XML provisioning file called SleuthProvisioning.xml. It initializes me in cleartype mode, changes my notification settings, initializes the default SIP to Block Recognizer, sets power and backlight timeouts, re-arranges my today screen and updates my Owner Name.
Lets take a look at this more closely. The XML itself sets up two Configuration Service providers. One is used for registry operations and one for file operations. both are enclosed by the wap-provisioning tags. Here they are shown without any operations:
Registry CSPs

Within the registry type, I set a lot of cool stuff. You should be able to firgure out how it works if you have basic registry skills. Essentially, setting values for any registry key looks like this:
First you set the key with the <characteristic type> tag, then you set values with the <parm name> tags. Binary values are a PITA since they're encoded Base 64 (see my entry for Owner Information above). If you want to set owner information as I did in the example, then you need to convert Unicode to Base64. Post here if you want to learn how and I'll show you how I do it.

Special characters within quotes in XML files must be represented using html special character sequences. For instance, the double quote (") character sequence is &quot; so "Today\Items\"Pocket Plus"" would be written as "Today\Items\&quot;Pocket Plus&quot;". The full list of special HTML character sequences can be found here. This is especially important when changing today screen plugin order since some today screen registry entries actually have quotes in the key name. See my provisioning file above under "Today Screen order/enabled preferences" for an example of this.

Re: How to set up UC
 

File Operation CSPs

All the File Operation CSP parameters are described here.

Here's mine:
%CE2% is a shorthand way for saying "\windows". As you can see, the first characteristic types set the working directory to \windows\startup, the destination file to "StartTimeSync.lnk" and the file operation to "Copy". Finally, the source file is set and the CSP copies \windows\SP TimeSync.lnk to \windows\startup\StartTimeSync.lnk.

Here's a great example from booda. It shows shortcut creation, move, directory creation and remove operations:
Couple of things to note - I always use "install" and "MakeDir" commands for folders - if the folder already exists, it won't do anything, and if it doesn't, the folder will be created. Either way, you know the folder will be there to move the shortcuts into.

The MakeDir and RemoveDir commands don't require a closing [/characteristic] tag - just make sure the slash is included as in the examples above.

You have to make sure that 1) any files you're referencing already exist and 2) you have the names exactly right. If you try to move a shortcut that isn't there or has a different name than what you referenced, the whole process bombs out.
Here are all the %CE#% shortcuts (thanks to chainfire)
EMAIL2 CSPs

All the EMAIL2 CSP provisioning parameters are described here

Elosogrande7076 shows us how to provision a couple of email accounts below. To be safe, use GUID-GEN to generate unique GUIDs. This is because duplicate GUIDs will cause undefined results on your device.
XML Creation FAQ

Quote:
1.- Why Provisioning file is not loaded, I mean, it doen't work nor load any registry or feature that I added to it?
Its probably a syntax error. Here's how I debug syntax:

• first obtain a cab creation utility. For windows I use Cabarc, a free m$ utility
• you can then rename your xml to _setup.xml and double click to load it into a browser. This will verify that your <tag></tag> nesting is correct along with validating tag statements. IE won't load an xml file in display mode if this isn't correct. As an added benefit, the error message will point to the exact line where the error occurs.
• If it looks good, make a cab containing only _setup.xml itself and run it on your device. If the xml is good, installation will be successful & your changes will be made
• if unsuccessful, use successive installs to isolate the part that isn't working.

Quote:
2.- How I convert the HEX values showed at Registry Editor to base64 unicode? (I'm Mac user) It is for Owner registry stuff.
Being a Mac user, ymmv on this, but my technique using Windows is as follows:

• create a Unicode file with your favorite text editor and enter your owner name (I use Windows Notepad for this, not sure what a Mac uses). Then pad it out to 320 characters with "%" characters.
• now open that file with a Hex editor and do a global Hex replace on 25 (the hex representation of a "%") to 00. This produces a file containing the Unicode representation of your Owner name padded with binary zeros. I use WinHex for this btw.
• Now browse to this site and select the file you've just created. Press "Convert the Source data". The Base64 data will appear.
• Copy data to cliwckedoard, paste into your editor (make sure word wrap is off) and remove all the newline characters (go to beginning of each line starting from bottom & press backspace). when complete, you will have one single line of base64 data. Now copy to cliwckedoard & paste into my example.
• Done!

Update: RapiConfig might be faster. See stan23's post located here. Download link is included.

Here's an easier way to create your provisioning XML files!

• get the reg -> xml tool in the first post note: needs .net framework. My computer has .net v3.5 & it works fine.
• load an app that can do registry exports on your device. The one I use is dotfred's task manager
• export the key you want to provision & copy to desktop using activesync
• fire up the tool, give it the .reg and it will create provxml that contains the Registry CSP you need
• open provxml with notepad, cut out key you want & paste this into your provisioning xml within your registry CSP tags
• done!

Re: How to set up UC
 

Although I really dont understand alot of the technical aspects of this, you have done a fabulous job of describing everything! A fanstastic layout! Clear and concise. i look forward to the day when I can read through this and understand more!

Re: How to set up UC
 

Hahaha, its actually alot easier then it looks. Using the tool I attached to the first post to set up your auto cab installs is cake. The other ones are a little more technical though

Re: How to set up UC
 

Updated first post with newer and better SDConfig.txt creator.

Re: How to set up UC
 

Thanks.....I am just not quite to the point of feeling that i can get into the flashing, regedit etc....Although I have spent countless hours reading every flashing tutorial that i can find in here and over at PPC, just dont quite have the confidence level yet. LOL but when I read posts from others, I am beginning to think of how to answer it... "book smart, street stupid" to use a colloquialism.

Re: How to set up UC
 

unlocking and flahing takes all of 3 minutes to do and isnt hard at all.... you will be like wtf was i worried about.... its like installing files if you follow the steps.... cake just like that

Re: How to set up UC
 

Thanks for the encouragement.....Looks like i will be picking up 2 Moguls at a bargain price today....These I will use to learn with...once i get them going, I can hopefully sell them and keep moving onward and upward...

Re: How to set up UC
 

nice or use the one for 30 days and than upgrade to a pro for free.... we have a huge thread on how to do it.... just have to keep checking after your 30 days :)