A quick guide to porting X5 themes to X5II
(Before the X5II is released)
It can be done in as little as an hour
Usually, it will take anywhere between 1.5 to 3 hours.
1. Download the X5II firmware 1.0 from
this post
2. Download the latest firmware tools from
this thread, just in case they have changed
3. Unpack the X5II firmware: (Replace the text following -i with the downloaded firmware name if different, and replace text following -o to change the created folder name)
packtools --unpack -i X5II.fw -o YourThemeName_X5II
4. Open the X5II theme and the X5 theme to port, if possible side-by-side so it's easy to compare files.
5. Open the Coordinate folder. If you have made any coordinate changes to any file
other than launcher.ini in the original X5 firmware, make the changes in X5II. The coordinate files haven't changed too much, but have caution when copying. I suggest that the contents be copied, and not entire files, to prevent losing a few new lines.
6. To get the full-screen single images for the launcher, this should be the launcher.ini's contents in the X5II theme (Delete everything else). If not using fullscreen images for launcher, ignore this.
<big_icon_x>0<big_icon_x>
<big_icon_y>0<big_icon_y>
7. If you have a boot splash (logo.bmp), copy-paste that to the X5II firmware. As long as it's 32 bit and 400x360, it will work.
8. Go to litegui > boot_animation. Here you have a few choices:
a. Slow down the animation to make it longer (The new animation is 46 frames)
b. Make a brand new animation (Will take a while)
c. Simply copy-paste the current bootanimation and fill the remaining frames with a copy of the last frame (Animation will be fast and will be stuck at the last frame for a while, but it's the fastest way)
9. Open theme1 on both firmwares.
10. Here is a giant table of things to copy, things to edit, things to remove, etc:
Folder name[size=inherit] [/size]
|
Things to cop[size=inherit]y[/size][size=inherit] [/size]
|
Things to not copy[size=inherit] [/size]
| Things to modify |
[size=inherit]Things to make new [/size]
| Notes |
about_dev | fiio.png | | | | |
adjust_bar | ticks.png | | There are many adjust bar backgrounds. Choices:
a. Ignore the tick marks and make all backgrounds adjust_bg from old theme
b. Manually add tick marks for each background
| cursor.png (Slight difference, so it's best to make it new) | The adjust_bg size is 10 pixels taller in the new theme |
bg | | | wallpaper.png is now 400x360 | | Top 32 pixels of wallpaper behind topbar |
boot_language | | Everything | | | Entire folder removed |
charge | | bg.png | All battery icons 2px wider | | |
collect | collect0.png
collect1.png
| box0.png
box1.png
| menu_bg is 5 pixels shorter now
For the selectable buttons:
a. Redo them
b. Empty them and place the old image in the center of them
| | It might be a good idea to go with option b for now, and redo them later |
dock | | | | dock_insert.png
dock_remove.png
| |
eq | cursor_arrow.png
all arrows
slider_gray.png
slider_orange.png
option_box_bg.png
| slider_stick.png
scale.png
scale_num.png
| | bg.png
See this paint.net layered image for making one
| bg.png is basically slider_stick, scale, scale_num, and the background combined. |
explorer | dir_bg.png (May be pointless)
| | box0/1.png
(They may be pointless)
TF_bg.png (Slight size diff)
Selectable buttons, see collect folder for info on how to change them.
| | |
fast_picking | fp_focus_bg.png
fp_playing.png
fp_topbar.png
fp_topbar_shadow.png
fp_white_line.png
fp_white_point_1/2/3/4.png
| fp_bg.png
| | | fp_white_line could possibly be made opaque to have a fast picking background |
fs_ui | Anything you changed | bg.png | | | |
launcher | | | If you were using the full-screen image trick before (with the single image for each item):
Step 1. Remove or empty all of the images except for big_anything.png files.
(In my case, I emptied them + resized them to 1x1)
Step 2. Copy the respective files, I.E. category_I_1 will now be big_category, etc.
| | If not using fullscreen images, make sure you didn't edit out the coordinates file for the launcher before. |
list | All of the small icons
Toggles (on/off.png)
select.png
| | bg.png
bg1.png
They both have the extra 32 pixels up top that goes behind the topbar.
bg1's line spacing may have changed slightly.
| select2.png (No clue what it is used for. Maybe it appears when clicking with central button.) | |
msg | button.png
button_sel.png
lock.png
ok.png
warning.png
| | bg.png size change
| | You may want to redo the button images later |
music_update | All the number images | bg.png | | | |
number | Everything | | | | |
play_settings | Everything | | | | |
playing | box0.png
box1.png
All icons like collec0, cycle0, etc
All menu images
process0/1.png
| black.png (Unless you modified it) | menu_short_bg size change
shade_bg/bg1 size change (400x360 with 32 pixels behind topbar)
| | |
playlist | Small icons | box.png | bg.png size change. Best to copy from the list folder if you have already modified it there.
menu_bg.png size change
menu_remove.png size change
| box0/1.png (But they're empty, so most likely no need) | |
powerlow | Everything | | | | |
scrollbar | Everything | | | | |
sys_set | Everything except what not to copy | bg.png
key_lock_bg.png
| | | |
topbar | All the icons
shade.png
| | topbar_bg.png (See notes)
| | topbar_bg has transparency now. This means that making topbar_bg opaque will have it block off part of album art in playing screen. |
usb | connect.png
disconnect.png
| bg.png | | | |
usb_dac | | Everything except dac_play_bg.png | dac_play_bg.png. Size change, again, 32 pixels up top | | |
volume | Basically everything | Potentially v_arc.png? It's empty in the II firmware. | | | |
config.ini | Don't copy it whole; a line of config will be lost | | There is a new line in the file. Make sure you take a look and copy what you need. | | |
11. If you are going to theme the remaining themes, do so:
a. Delete the other theme folders, copy-paste the already themed theme1 to be the remaining themes, and work from there
b. Go back to step 10 and redo it from scratch
If you changed any coordinates, they will apply to all themes. This includes the launcher fullscreen mod.
12. Pack up the firmware: (Replace the text following -i with your actual theme folder name, and replace text following -o to change the product firmware name)
packtools --pack -i YourThemeName_X5II -o YourBrandNewX5IITheme.fw -m x5ii
The x5ii needs to be lowercase. (The part following -m)
13. Test the firmware if you have a X5II
14. Upload it/post it to the new X5II themes thread/etc.