
|--------------------------------------------------------------------
| Flex Guide v1.2                                                   |
| Guide for creating an additional skin directory                   |
| Applies to V3, E398, and VXXX-Triplet Motorola Phones 
| Author: Chris Davis chris@pagefusion.com                          |
| Credits: s5vi, Netuddki                                           |
--------------------------------------------------------------------|

---
- About

  a. In this guide, you will be using PST 6.7 GENERAL (must be installed and patched) to flex your
     phone with an additional skin directory. Until recently, it was only possible to
     replace the Moto, Scarlet, or Silver (V3-specific) skin directories with *.dat and
     *.ski files that started with that skin's name.

  b. Now, due to the h4x0r abilities of s5vi and Netuddki (users on www.howardforums.com),
     it is possbile to add skin directories, thus adding new skins to your phone's
     Settings > Personalize > Skin menu. Quite neat indeed.

  c. DO NOT ASK me or any civilized person WHERE to get PST 6.7 GENERAL and its patch/crack. It is considered
     illegal warez and cannot be provided for public download on http://skins.pagefusion.com. Use Google to find
     it. (Might I suggest a domain that ends in .ru? haha) YEAH RUSSIA ROCKS!!!! W00t w00t!

  d. Alternative: You DON'T have to flex your phone to be able to install those skins based on the Scarlet skin (most are).
     Just rename the /skins/[skinname].ski and /skins/[skinname].dat files (from the zip archive) to Scarlet.ski,
     Scarlet*.dat, etc. and then upload the skin to your /a/mobile/skins/Scarlet directory. Of course, it's always
     cool to know that you have 12+ skins on your phone...

---
- Warning

  a. Flexing your phone can be a dangerous process. It can render your phone useless and unusable. Please DO NOT
     disturb the communication process between PST and your phone when the flexing procedure is underway.

  b. Those responsible for this guide, PST, and other hacks used to modify your phone are provided without
     warranty. The respective authors are held blameless if you proceed.

  c. Also, DO NOT DELETE YOUR Moto skin. It is the default skin that provides icons for every other skin that
     doesn't have icons embedded. Deleting your Moto skin will cause many problems and the only remedy is to
     re-flash your phone.

 
---
- The Flex Guide (FOLLOW CAREFULLY)

  Understand the difference between CREATE and DELETE Flexes
  ---------------------------------------------------------------------------------------------------
  Most skin developers with brains will provide both a CREATE Flex and DELETE Flex for the
  skin they've produced.

  These two files should adhere to the following naming convention:

  [skinname].hs (e.g. XPBLue.hs)
  d[skinname].hs (e.g. dXPBlue.hs)

  For convenience, the CREATE flex SHOULD NOT have a proceeding 'c' in the filename (e.g. cXPBlue.hs)
  because this forces users to rename the flex file to the exact name of the skin (an additional step
  we can do without during skin installation).

  When flex files are opened and processed, THE FILENAME SHOULD BE THE SAME NAME AS THE SKIN
  DIRECTORY (CASE SENSITIVE).


        Zip Archive      Phone Directory           Phone Menu
  (e.g. flex/XPBlue.hs = /a/mobile/skins/XPBlue/ = Settings > Personalize > Skin > XPBlue)
             ------                      ------                                    ------

  ---------------------------------------------------------------------------------------------------
  
1. Open Motorola PST (6.7_GENERAL)

 - Go to File > Open > pFlex
 
 - Browse to directory containing *.hs files, select [skinname].hs and press the "Open" button.
 
 - A dialog entitled "pFLEX" will open. Just hit the "Run" button.

(PST will suspend your phone, and the flex will be added. DO NOT DISTURB THIS PROCESS.)

3. When success message displays, close PST.

4. Open P2KTools:
 - Change to P2K Mode (if necessary)

 - Connect (press the "Connect" button.)

 - Optional: Press the "Refresh" button (left side, below) to view phone's directory tree.

 - Using the "Use upload path" field (at the lower left), type "/a/mobile/skins/[skinname]/"
   (e.g. "/a/mobile/skins/XPBlue/" without quotes. "XPBlue" obviously refers to the skin that you're
    installing.) BE SURE TO HAVE THE SLASH ("/") AT THE END OF THE PATH.

 - Press "Upload" button (left, middle)

 - (Browse dialog opens.) Select all skin (*.ski, *.dat) files in the /skins directory from your skin's Zip archive
   and press the "Open" button.

 - P2KTools will automatically create the "[skinname]" (e.g. "XPBlue") folder under your phone's "/a/mobile/skins"
   directory and upload the skin files (all with file attribute 70000; world readable/writeable) within.

5. (Optional) Bring your phone out of suspend mode, re-connect to P2KTools, and refresh the directory
   tree to verify that the new skin directory now exists and that the skin files (*.dat, .ski) exist
   within.

6. Bring your phone out of suspend mode (if necessary), go to Settings > Personalize > Skin
   Your new skin should be listed and you should be able to select it.


---
Use this same process to add other skins to your phone. REMEMBER, the skin directory (XPBlue) must have the same
name as the *.hs file ("XPBlue.hs") and new skin directory ("/a/mobile/skins/XPBlue"). The number of skins is 
limited to the file space available on your phone.

The utility used to output CREATE and DELETE flexes is called dir2flex, developed by s5vi using Netuddki's flex
translation algorithm. You may download this utility from http://skins.pagefusion.com.

Much thanks goes to our Hungarian friend Netuddki and s5vi who posted this incredible insight at the following
original thread: http://www.howardforums.com/showthread.php?s=&postid=4481156
