The Bouncing Rabbit

Resources Documentation

Many of hacks on the iPod will involve editing and changing of resources. Here I will post documentation for what each resource controls, how certain aspects of your iPod can be changed, and everything else related to resources. This page will probably be more up to date than the thread in iPodWizard, found here, which I will only update every once in awhile. 

If you have anything to contribute, please contact me via the contact page and let me know.

Credits:
Anything that needs credit will be denoted by an asterisk followed by a number. This number will correspond to a user, listed at the bottom of this page. If there is a large section that is credited to one person or more, I will note this at the bottom of that section.
 

This page was originally laid out by led zeppeman, currently maintained by me.

Thank you.

Basics

The Layouts/Resources tab of iPodWizard is a highly useful and highly risky tool to use in iPod modding. Unlike most themes, which just change images, editing resources change the functionality and format of the iPod. Many great hacks, such as the iPod classic hack, the background hack, and so forth, depend on editing resource values to change how the iPod behaves. However, if you change the wrong value, you can potentially cause problems for your iPod. These range in severity from incorrect formatting to reboot loops, and in the worst case they can brick your iPod and make it unrecoverable. The latter happens very rarely, but it is possible.

 There are four main types of resources:

Scheme layouts- These resources determine which images, strings, fonts, and menus are displayed where and when.

Menus- The contents of all menus on the iPod and how they react. These can be modified to change the function of certain menus.

Font Types- How characters are displayed. These control font color, text size, alignment, etc.

Command Tables- At the current moment, it is not completely configured but decides the basic reactions of actions. 

The Hexadecimal System

Everything in a firmware binary is made of hexadecimal numbers. The hex system contain the numbers 0 – 9 and the letters A – F, in which A is 11 and F is 15. Hex is generally used as shorthand for binary, which is simply zeros and ones.

For more information

Hex Colors

A hex color code is made up of red, green, blue, and opacity components. it is composed of 32 bits (4 bytes) it is displayed like this:

AA BB CC FF

The AA is an example of how much red is shown in an image. The higher the # the more of that color there is. You have to blend the three primary colors together to make your color.

For all hex color codes:
The first byte (AA) is the red component.
The second byte (BB) is the green component.
The third byte (CC) is the blue component.
The fourth byte (DD) is the opacity component.

Black is: 00 00 00 FF. This is a special case.

Finally, the iPod does not seem to support varying degrees of opacity. Therefore, it is advisable to always end your hex color codes in FF.

Here is a link to a basic hex color chart: http://www.johncfish.com/bggallery/o...t/hextable.gif

Thanks to vettefan for corrections.

Values

ID: This determines what the resource is and what it refers to.

Type: determines the type of resource, such as an image, another resource, a string, a command, etc.
paMB: image
rtS: string
lntC: command/control
enoN: resource
stsT: collection of strings *1
mtD: currently unknown
Notice how the words are reversed (paMB -> BMap, rtS -> Str, etc)

top- Refers to how far from the top of the screen that an image is placed

left- Refers to how far from the right side of the screen an image is

bottom/right- How much room an image is allowed to take up in that direction.

z values: The function of these values varies according to the type of resource that is concerned. Currently only a few of these functions are known.

For all rtS resources:

The z7 value controls the font type resource used by the string. This value is not displayed correctly in iPW yet; it appears in hexadecimal form.  *1, *4, *8

Layering:

This tricky concept is controlled by z0 and z4 values.  *8

The titlebar text:
While the top and left values control the positioning of the titlebar image, the bottom and right values control the positioning of the titlebar text. It is based on an (x, y) coordinate system. The top right hand corner is the origin. Therefore:
bottom: how far from the top the text is
right: how far from the left the text is

Corrections thanks to Ledhendrixman

The Selector Bar

Any resource that has a z3 value ending in 4 is a selector bar resource.

bottom - Size of selector bar (vertically)

z5- Main color of selector bar

z6- Gradient color of selector bar

Right- Refers to how far from the left side of the screen the selector bar and text is for a particular menu

Left- (mostly theory) Refers to the distance between lines of characters are in complete pixels, not just from top to bottom. The number must be divisible by three. Primarily, the number is 3. When altered, it gaps up the background. There is currently no practical use for this value

Top (needs correction): May refer to the distance the scroll bar moves down the screen before it shifts the menus up.

I know that the selector bar hack tutorial has different resources highlighted here, but if you are using iPW 1.3.0.7, these values are correct.

Credit for the selector bar hack goes to the people in this thread:

http://www.ipodwizard.net/showthread.php?t=26970 

Font Color Change

Values:

fontID: ID of the font
z1: Unknown
Font Size: Size of the font. Make sure the font being used is available in that size.
z2: Hex color
z3 – Justification
    0x0: Left
    0x1: Center
    0x2: Right

To change font color:

Click on the RGB value of the font, type in the hex color in the input box, and click replace. Make sure your entry mode is set to “Hex”

This hack was created by omgfkm.

Sponsors

Basic Tutorials

To make area around progress bar transparent:
For resources -346 and 24541:
Change the first enoN’s value from 2560 to 2561.
Change all z1’s and z4’s to 0
In 24541: change all paMB ID links to 0
Tutorial contributed by cheeseofdoom86

To change menu alignments:
-279: The second resource. Top value is distance of menu from top of the screen. Bottom value is the distance of the menu from the bottom. This value must be negative. Left and right values control the distances from the sides, but right values must be negative as well.
Contributed by led zeppeman

To change the font of a certain string:
z7: For all rtS resources, this value controls the ID of the font type resource used. Currently, iPW does not display this value correctly; it displays it in hex, rather than in a decimal.
Tutorial contributed by bounci.rabbit.123, matthew98, and xxDriveNxx

To resize images:
http://austinche.name/ipod/index.html
There is currently no clear tutorial for resizing images. Only attempt to do so if you are experienced with compiling programs, using the command line, and iPod modding.
Contributed by InvaderZim

To change font color:
Click on the RGB value of the font, type in the hex color in the input box, and click replace. Make sure your entry mode is set to “Hex”
Tutorial by omfgkm

Resource List

Scheme Layouts

Code:
24506: everything in title bar
-279: general menus
14020: titlebar image *2, *5
15360: Solitaire background *3
25529: Now Playing screen layout for songs without album art. *4
25530: Now Playing screen layout for songs with album art. *4
25525: Album art enoN *4
24508: Titlebar text *4
25543: Small album art *4
25544: Large album art *4
25522: Now Playing background *3
24440: Music menu *6 *7
24598: Extras menu *6 *7
24094: Main menu *6 *7
24437: Extras menu *6 *7
24598: Settings menu *6 *7
24614: Select language menu *6 *7
24541: Main progress bar *4
24544: Volume bar *4
24547: Seek progress bar *4
24549: Rating stars *4
13957- Calendar
16768- Notes Menu
16780- Instructions Menu
19328- Full Titlebar Setup
20617- Brick your iPod
20634- Photo Library
20630- Photos
24540- About
24658- Volume Limit
24662- Brightness
24085- All menus
24529- Charging menu
25600- Charging menu
27905- Contacts
-570- Time Menu
-399- Language menu
-355- Do Not Disconnect
Contributed by xxDriveNxx
 
25550: Play/pause/lock icons *9
25563: Progress icons *9
Menus Resources
Code:
13698: Testing results
15635: Voice notes
15642: hear voice notes
17055: Import voice note
17084: Stop voice note
17096: Unknown
17098: Unknown
20518: Photos - TV out
20519: Photos - Slideshow Settings
20521: Photos - Time per Slide
20522: Photos - Transitions
20617: Photos - TV Off
22008: Video
22013: Video Settings
22014: Video - TV Out
22149: Video - TV Off
22407: Screen Lock
22414: Lock Screen
22556: Radio
24094: Main menu
24437: Extras
24439: Games
24440: Music
24441: Unknown
24598: Settings
24600: Settings - Main menu
24604: Settings - Date & Time
24608: Settings - Contacts
24610: Unknown
24614: Settings - Languages
24660: Unknown
24852: Time zone
24961: Clock menu ( with DST)
24974: Clock menu (without DST)
25049: Alarm
-265: Unknown
-253: Unknown
-188: Reset All Settings
-158: Reset Main menu
-147: Audiobooks
-139: Backlight timer

Contributed by wirmslayer, bounci.rabbit.123, and H3X

Font Types

Note that font type resources are often changed to suit a hack. These numbers are for the original iPod firmware.

Code:
16793: Notes and Lyrics Text *Unknown
24222: Menu Text
24223: Title Bar , "Do not disconnect", "Song # of #"
24224: Titlebar Text Shadow - Text shadow in Stopwatch, Screen Lock, etc. Alignment has no effect.
24225: Secondary Text - Settings options, On/Off strings, and right justified strings.
Contributed by omfgkm

14034: Dates belonging to the current month in the calendar
14035: Dates not belonging to current month in the calendar
14039: Event info field labels
14040: Time of events in calendar
22199: Buttons in Stopwatch
27971: Contact # of ##
27972: Contact info field value
27973: Contact info field label
-592: Title of calendar events in summary
-554: "No Results Found"
-548: Search term in input box
-550: Amount of search results displayed on the input form
-549: List of search results while in input form
-253: 15 minutes/off to 120 minutes
-344: Alphabetical index while scrolling fast through the media library
Contributed by aLtgLasS

Commands:

Code:
17000-nothing
16998-backlight
16996-nothing
16994-nothing
16992-nothing
16990-nothing
16988-nothing
16986-nothing
16984-nothing
16982-Plays music from top of album list
-
16980-nothing
16978-blinks scrollbar 3 times (Like adding song to On-The-Go list)
16976-nothing
16974-Shows artists menu with a few artists (Not all, only those with Alternative in genre)
16972-nothing
16970-Blank screen (Freezes iPod, reboot needed.)
16968-nothing
16966-Genres menu
16964-nothing
16962-Genres menu
-
16960-Nothing
16958-Now Played all of Acceptance (Top artist?)
16956-Nothing
16954-blinks scrollbar 3 times (Like adding song to On-The-Go list)
16952-Nothing
16950-Brought me to As I Lay Dying menu (Random artist?)
16948-Nothing
16946-Blank Artist menu (Frozen)
16944-Nothing
16942-Artists menu
-
16940-Nothing
16938-Artists menu
16936-Nothing
16934-Artists menu
16932-Nothing
16930-Nothing
16928-Nothing
16926-Nothing
16924-Went to Now Playing all (Started at song 8... a few times later 9.)
16922-Now Playing (Plays all songs starting from 1. Genre alphabetical order.)
-
16920-Nothing
16918-Blank Frozen Screen (Hitting play started play all, unfroze)
16916-Nothing
16914-Blank screen (Hitting menu went back to main menu)
16912-Nothing
16910-All songs menu (No titlebar text, strange bullets to the left of some songs)
16908-Nothing
16906-Blank screen (Freezes iPod, reboot required)
16904-Nothing
16902-Blank screen (Hitting menu went back to main menu)
-
16900-Nothing
16898-Podcasts menu
16896-Nothing
16894-Podcasts menu
16892-Nothing
16890-Nothing
16888-Nothing
16886-Now Playing 4 songs
16884-Nothing
16882-Adds to On-The-Go
16880-Nothing
-
16878-All Songs
16876-Nothing
16874-Blank Screen (Freezes iPod)
16872-Nothing
16870-Compiliations menu
16868-Nothing
16866-Albums Menu
16864-Nothing
16862-Album menu with 'iPod' as titlebar text.
16860-Nothing
-
16858-Albums menu with 'iPod' as titlebar text.
16856-Nothing
16854-Compiliations
16852-Nothing
16850-Albums
16848-Nothing
16846-Now Playing (One song by As I lay dying. Completely random?)
16844-Nothing
16842-Add to On-The-Go
16840-Nothing
-
16838-All Albums menu
16836-Nothing
16834-Frozen blank iPod screen (Reboot needed)
16832-Nothing
16830-Composers
16828-Nothing
16826-Composers with "iPod" as titlebar text
16824-Nothing
16822-Composers menu
16820-Nothing
-
16818-Now Playing- Probably by composer?
16816-Nothing
16814-Adds to On-The-Go
16812-Nothing
16810-Adds to On-The-Go
16808-Nothing
16806-Seems to play 1 random song.
16804-Nothing
16802-Now Playing, random song of all.
16800-Nothing
-
16798-Blank iPod screen (Reboot Needed)
16794-Blank iPod screen (Reboot Needed)
16790-Blank iPod screen (Reboot Needed)
16786-All songs arranged in strange order
16782-Songs menu
16778-Nothing
16774-Nothing
16770-Music menu (Behaves strangely)
16766-Music menu
16762-Nothing
-
16758-Nothing
16754-Blank iPod screen (Frozen, reboot needed)
16750-Blank iPod screen (Menu went back)
16746-Blank Audiobooks screen (Menu went back)
16742-Nothing
16738-Nothing
16734-Freezes iPod for a second, HD spins, works again.
16730-Reboots iPod
16726-Save Playlist
16722-On-The-Go menu (Frozen)
Contributed by xxDriveNxx

Credits

*Unknown: Unknown
*1: matthew98
*2: H3X
*3: cheeseofdoom86
*4: bounci.rabbit.123
*5: iAm
*6: Virgul
*7: Dash777
*8: xxDriveNxx

*9: MrMEC