Custom Themes

3DS custom theme FAQ

There seems to be a lot unclear about this subject, so I thought it could be useful to make a FAQ about it.
If you have any questions ask them here, if you have an answer for a question you've seen a lot also post it (with the question) and I will add it to the list!

Q: How do I install a theme?
A: Download https://github.com/yellows8/3ds_homemenu_extdatatool/releases
Copy the body_LZ.bin (and bg.btstm) from the theme into /3ds/3ds_homemenu_extdatatool or to the root if you're using gateway.
Use the tool to enable cache (If you had a DLC theme selected it's already on but it doesn't hurt to check!) and then copy SD theme cache to extdata.
You can now go to the menu and the theme should appear

Q: Do I need a DLC theme for this?
A: No, but having one does have benefits! If you have a DLC theme selected and then install a custom theme it will stay after a reboot without it you'll have to enable the cache and re-install the theme every time. If you're using a gateway it should't matter as soon as gateway allows for unsigned cia's!

Q: What files should be included with a theme?
A: Most themes will come as body_LZ.bin and if it has background music with a bg.bcstm file (but they can have a ThemeManager.bin file though not common nor needed)
Cache dumps (most likely for pirated themes) will have 3 files:
- BodyCache.bin
- ThemeManager.bin
- bg.bcstm
Cache dumps of mulitible themes at once (9.3+) will have these files:
- BodyCache_rd.bin
- ThemeManger.bin
- bg.bcstm
Gateway themes will be in .cia format (but won't work unless signed!)

Q: Does this overwrite my theme?
A: No, you can choose another theme and then the original one and it will turn back to normal. This is because the tool (by Yellows8) only overwrites the cache witch is replaced when another theme is chosen!

Q: Can you pirate themes with this tool?
A: Yes. (Anyone's cache dump of a DLC theme will work (They are not version specific but BodyCache_RD.bin only works on 9.3+ all others work with any 9.x+ firmware))

Q: Are themes region locked?
A: No.

Q: How long will it keep my own custom theme?
A: If you have a DLC theme (and have it selected) before injecting cache it will stay until you either replace it or load another theme, if you don't it will stay until you close your 3DS, open a game/app or reboot your 3DS (basically useless).

Q: Can I make my own themes?
A: Yes, if you want to know how here is a simple guide by ChrisCerne:
If anyone of you is having trouble making your own theme, here's how.
  1. Download the tool here (https://gbatemp.net/threads/release-theme-customization-tools.374206/)
  2. Create a new BLANK BMP image with the dimensions 512 x 256 pixels for the top screen.
  3. At the coordinates (0, 0) of that new image, insert the picture you want with the dimensions of 400 x 240. This will be the top screen.
  4. Create a new BLANK BMP image with the dimensions 1024 x 256 pixels for the bottom screen.
  5. Starting at coordinates (0, 0) of that new image, insert the three different images you want to transition on the bottom screen.
  6. These three images should be each 320 x 240 pixels, and at coordinates (0, 0), (320, 0), and (640, 0) respectively.
  7. Remember that these images will not fill up all of the white-space within the container BMP images. This is supposed to happen.
  8. In the 3DS Theme Editor that you downloaded in step one, import the default theme by pressing File>Open and navigating to data/body_BZ.bin.
  9. For slide 0, press File>Import and select the BMP Image you need for the top screen.
  10. For slide 1, press File>Import and select the BMP Image you need for the bottom screen.
  11. Once you're done importing, press simulator to do a test-run of your theme thus far.
  12. If you're happy with your results, press File>Save to save your body_BZ.bin file.

Q: How do I add sound to my theme?
A: First make a .wav file with a piece of music (The file must have a size of 0x337000 or 3.371.008 bytes you can fill up extra space with 0 bytes using a HEX editor)
Use Every File Explorer (https://gbatemp.net/threads/release-every-file-explorer.373615/) to convert it to .bcstm (File -> New from File -> Nintendo 3DS Plugin -> CTR Stream -> open .wav -> save icon -> save as bgm.bcstm)

Q: Why do some themes have a white box at the top left?
A: This is most likely a small bug in the theme maker! You'll probably have to live with it for now.

Q: Why do many themes have folders with a mario bullet on them?
A: This is the default folder for the custom theme tool, this means that many theme makers didn't change it.

Q: Can themes have custom icons for games?
A: Most likely yes, but none have at the moment (and it's unsure when the tool will support this (and if we can even do this!))
For documentation on the cached icons that could be edited: http://3dbrew.org/wiki/Home_Menu#Cache.dat_.26_CacheD.dat

Q: Does this mean NINJHAX has kernel?
A: No, however it is able to read and write both NAND and SD extdata which is still cool (and might be useful)
 

c4655362

Well-Known Member
Newcomer
Joined
Jan 19, 2014
Messages
68
Trophies
0
Age
37
XP
138
Country
United States
I don't think the tutorial works correctly for my 3DS XL, I have WAAAAY more pages than just the 3 shown in the simulator, and the theme following a tutorial makes the theme look all weird compared to the simulation
EDIT: I have 8 pages of 4 rows and 7 collumns
 

ieatpixels

Well-Known Member
Member
Joined
Nov 1, 2008
Messages
371
Trophies
1
XP
479
Country
I don't think the tutorial works correctly for my 3DS XL, I have WAAAAY more pages than just the 3 shown in the simulator, and the theme following a tutorial makes the theme look all weird compared to the simulation
EDIT: I have 8 pages of 4 rows and 7 collumns

the pages loop. it's the same on official themes.
 

Intronaut

A star maker
Member
Joined
Nov 18, 2014
Messages
772
Trophies
0
Age
30
XP
1,005
Country
Chile
Where are the Hexadecimal offsets for the colors of both screens in the body_LZ.bin file?
Are the colors encrypted in RGBA8888? If this is true, Do you have a converter to, at least, know the color through these codes?
 

loco365

Well-Known Member
Member
Joined
Sep 1, 2010
Messages
5,457
Trophies
0
XP
2,927
MRJPGames Instead of using EFE for audio (Which does not support loops yet), brawlcustommusic has an optional BCSTM exporting option that generates BCSTM files that are compatible with themes. However, word of the wise: Keep the songs under 3.3MB, or they cannot be imported.
 

Necrojinsei

Well-Known Member
Member
Joined
Jan 1, 2015
Messages
116
Trophies
0
Age
27
Location
Michigan
XP
138
Country
United States
So after a little bit of fidgeting I found I found out how to have a relatively lined up image. Just offset the top image by about 32 pixels to the right, this allows for the difference between the top and bottom to (at least seemingly) be fixed. The only thing is that it appears to get slightly worse as it goes on.

If anyone knows how to fix that problem I would like to hear.

For an example I put together a simple earth map

ZRLyAPE.jpg


---------
lvKbUyG.jpg


And another view from a little later on.
dK14eEa.jpg


--------
n0tQp15.jpg


For use as a reference or if you just like the theme:
https://app.box.com/s/5lidiinl54x0yzdqoprw
 

Chrisser_75

Well-Known Member
Member
Joined
Dec 12, 2014
Messages
264
Trophies
0
Location
Germany
XP
321
Country
Germany
What can i do if i dont have a DLC theme?-> for permanent custom themes...
When i go to the eShop, my 3DS wants to start a firmwareupdate, but then would ninjhax no longer work ? :(
 

Ryft

Well-Known Member
Member
Joined
Nov 21, 2013
Messages
617
Trophies
1
Age
38
Location
Illinois
XP
1,010
Country
United States
So I'm assuming you have to have Ninjhax access to do this? You can't do this with just Gateway (above 9.2 EmuNAND) or am I misunderstanding something?
 

Askedforthis

Well-Known Member
Member
Joined
Oct 15, 2013
Messages
117
Trophies
0
Age
32
XP
170
Country
Norway
What can i do if i dont have a DLC theme?-> for permanent custom themes...
When i go to the eShop, my 3DS wants to start a firmwareupdate, but then would ninjhax no longer work ? :(


You're screwed until Gateway comes out for 9.2 and EmuNAND becomes a possibility. Updating will fix the Ninjhax exploit.

So I'm assuming you have to have Ninjhax access to do this? You can't do this with just Gateway or am I misunderstanding something?

You can do it with Gateway without Ninjhax.

Just install the pre-compiled cia version using the DevMenu and put body_LZ.bin and bgm.bcstm in the root directory of your regular SD card.
 

Site & Scene News

Popular threads in this forum

General chit-chat
Help Users
  • No one is chatting at the moment.
    SylverReZ @ SylverReZ: https://www.youtube.com/watch?v=pnRVIC7kS4s