Tutorial  Updated

HOMEBREW MENU THEME CUSTOM IMAGES

Good news everyone! I decided to make a

IKBp8jq.png


The Switch brew page has information on theming the homebrew menu.
https://switchbrew.org/wiki/Homebrew_Menu

I figured I would write up a way to just change the Background and asset images, For full theming see above link.

REQUIREMENTS

  1. HBtheme PAK Zip (Attatched Below) I included My Skeletal theme. And 2 .bat files to make this easier!
  2. Download latest HACTOOL! Used to extract and repack the theme you are altering. This tutorial uses this version. The switchbrew tutorial uses a different tool.
  3. Images to replace the existing ones! I believe JPG is supported however, the wiki says if you want transparency use PNG images.The files and types I typically see are:
    • background.png. It's the wallpaper, It should be PNG in Size:720 x 1280
    • icon.jpg - This is what appears in HBmenu's Theme Menu Size: 256 x 256
    • wifi1_icon.png. wifi2_icon.png and wifi3_icon.png These are the different connection levels for the WIFI indicator.(3 bars, 2 bars, 1 bar respectively) PNG format to support transparencies and 50 x 50 resolution.
PREPARATION
  1. Make a working directory. I like it easy type so I go for C:\hbtheme
  2. Extract the hactoolnet archive in to the hbtheme directory
  3. Extract hbtheme stuff.zip in to the hbtheme directory
  4. Place your source.romfs (Skeletal v420 white.romfs from the zip or whatever you have!) in the hbtheme directory
Now that everything is there lets extract the source theme.

EXTRACT THE SOURCE

I INCLUDED AN EXTRACTED FOLDER IN THE ZIP. CONTAINING THE FILES FOR MY SKELETAL THEME. YOU CAN USE THAT AND SKIP TO "BUILD YOUR NEW THEME" OR EXTRACT YOUR OWN THEME!.....

  1. Drag the theme .romfs file you are extracting on to the "Extract Theme - Drop Theme Romfs Here.bat"
  • Type a directory name in to extract the Theme to and press ENTER. Leave blank to extract to a folder named EXTRACTED in the current directory
Your Theme Is EXTRACTED Joy!

The theme files that will be used to build your new theme are all in the EXTRACTED folder or wherever you told it to put them. Editing these files will change your theme.

You can change any of the image files by replacing them with any image named the same and the same size!

Edit the CFG file to alter theme elements color and positioning. Instructions at SwitchBrew



Make sure your replacement images are the same size, file name and type as the original ones and overwrite the originals!.
If you use a different name or image type the CFG file MUST be altered to reflect the new name and type Best to stick with what's there.

BUILD YOUR NEW THEME


Once you have swapped out the desired images in the C:\hbtheme\extracted\ and C:\hbtheme\extracted\assets\ folders (and altered the CFG if you are brave and or knowledgeable.) Do the following to build your theme!:

  1. Drag N Drop the entire Theme Folder on to "Build Theme - Drop Theme Folder Here.bat" (Theme folder is the folder you changed the pictures in..hbtheme/extracted if you left defaults)
  2. Type in a Name for your new theme's romfs file. (example new.romfs)
  3. Type a path to the folder you want the new theme file to output to. Leave it blank to put file in to current folder! (HBtheme if you are following) Then press ENTER.
This should pack all the files back in to a romfs file.

INSTALLING YOUR NEW THEME
  1. Put your theme.romfs in to SD "\config\nx-hbmenu\themes\
  2. Put the SD in your Switch, boot and open HBMenu
  3. Press Minus Button (-) to open the "Theme Menu"
  4. Select your new theme!
That's about it! If you want to get more in depth please check out the original tutorial on Switchbrew. There are many other customizations possible. I was just writing this so you can change the background. Please let me know if there is anything I can help with. I will try.

CHEERS!


rRqG141.jpg
Good news everyone! I decided to make a quick and dirty...

HOMEBREW MENU THEME CUSTOM IMAGES GUIDE!!!
The Switch brew page has information on theming the homebrew menu.
https://switchbrew.org/wiki/Homebrew_Menu

I figured I would write up a way to just change the Background and asset images, For full theming see above link.

REQUIREMENTS

HACTOOLNET https://github.com/Thealexbarney/LibHac/releases/download/v0.11.3/hactoolnet-0.11.3-win.zip Used to extract and repack the theme you are altering. This tutorial uses this version. The switchbrew tutorial uses a different tool,
An existing theme in .romfs format. (rename it source.romfs for the tutorial) Here's a link to my Skeletal Theme to match the theme I posted on reddit. https://paste.c-net.org/RealmDownload The Zip includes an extracted version of the theme. I edited an existing theme made by NSX (I think it was the PS4 one IDK...) NOTE: Keep in mind that whatever theme you choose for your source will dictate the style of your custom theme. Unless you manually edit the CFG file you'll have the same color text, same placement of any UI elements etc. Also if the theme you alter doesn't have an element,like a wallpaper or a custom WiFi icon there will be nothing to edit in the extracted theme, All these elements must be pre-defined in the CFG file. We are just changing the images, The Switchbrew link at the top is very detailed all the UI elements.
Images to replace the existing ones! I believe JPG is supported however, the wiki says if you want transparency use PNG images. The files and types I typically see are:
background.png. It's the wallpaper, It should be PNG in 720 x 1280
icon.jpg - This is what appears in HBmenu's Theme Menu Also 720 x1280
wifi1_icon.png. wifi2_icon.png and wifi3_icon.png These are the different connection levels for the WIFI indicator.(3 bars, 2 bars, 1 bar respectively) PNG format to support transparencies and 50 x 50 resolution.

PREPARATION

Make a working directory. I like it easy type so I go for C:\hbtheme
Inside the "hbtheme" directory make an "extracted" directory
Extract the hactoolnet archive in to the hbtheme directory
Place your source.romfs in the hbtheme directory

Now that everything is there lets extract the source theme.

EXTRACT THE SOURCE

Open a command prompt (Press Windows+R to open “Run” box. Type “cmd” and then click “OK”)
Then change to the working directory
Code:

cd c:\hbtheme

Run this command:
Code:

hactoolnet -t romfs source.romfs --romfsdir C:\hbtheme\extracted

That should extract your source.romfs in to the \hbtheme\extracted folder. Take a look in the folder.

You can change any of the image files by replacing them with any image named the same and the same size!

The C:\hbtheme\extracted\Assets folder contains all images except icon.jpg.

Make sure your replacement images are the same size, file name and type as the ones in C:\hbmenu\extracted\assets\ and overwrite the original ones. If you use a different name or image type the CFG file MUST be altered to reflect the new name and type Best to stick with what's there.

BUILD THE NEW THEME

Once you have swapped out the desired images in the C:\hbtheme\extracted\ and C:\hbtheme\extracted\assets\ folders (and altered the CFG if you are brave and or knowledgeable.) Do the following to build your theme!:

Open a command prompt if not already open (Press Windows+R to open “Run” box. Type “cmd” and then click “OK”)
Change to the working directory
Code:

cd c:\hbtheme

Run this command:
Code:

hactoolnet -t romfsbuild C:\hbtheme\extracted --outfile NewTheme.romfs

This should pack all the files back in to a file named NewTheme.romfs

INSTALLING YOUR NEW THEME

Put newtheme.romfs in to SD "\config\nx-hbmenu\themes\
Put the SD in your Switch, boot and open HBMenu
Press Minus Button (-) to open the "Theme Menu"
Select your new theme!

That's about it! If you want to get more in depth please check out the original tutorial on Switchbrew. There are many other customization possible. I was just writing this so you can change the background. Please let me know if there is anything I can help with. I will try.

CHEERS!

Preview



/|/|ike



SPECIAL THANKS:To TheAlexBarney for Hactoolnet, to the people at reswitched and all the devs for HBMenu., Also reswitched, qcean and the rest of discord for putting up with the questions and thanks to the great NSX for getting me in to theming again and all his contributions to the scene. Sorry man, I know I am an asshole ;P Thanks for everything!

DON'T FORGET TO PRESS THE LIKE BUTTON!!!
 

Attachments

  • HBThemePAK.zip
    2.6 MB · Views: 779
Last edited by mikefor20,

mikefor20

Well-Known Member
OP
Member
Joined
Jan 12, 2009
Messages
1,717
Trophies
2
Location
Mushroom Kingdom ( o Y o )
XP
3,240
Country
United States
Appreciate you trying to help, however it did not work(even after installing the runtime).
I still keep getting 'file is not compatible with the version of Windows you're running' every time I click on hactoolnet.exe.
Too bad, really. I'll try to run it on my laptop it has Windows 7/64-bit), and hopefully it'll work then.

Try this with the runtime installed.
https://github.com/Thealexbarney/LibHac/releases/download/v0.11.3/hactoolnet-0.11.3-netcore.zip

Maybe check if there is another runtime download that suits your system better here
https://dotnet.microsoft.com/download/dotnet-core/current/runtime

I appreciate the trouble shooting!

--------------------- MERGED ---------------------------



I also just found this, it's not hactoolnet... It's hactool. Might be able to use this
ill look at a command line for.....

https://gbatemp.net/attachments/hactool-zip.133415/
 

FocusedWiiWarrior

Well-Known Member
Newcomer
Joined
Apr 25, 2020
Messages
50
Trophies
0
XP
83
Country
United States
Try this with the runtime installed.
https://github.com/Thealexbarney/LibHac/releases/download/v0.11.3/hactoolnet-0.11.3-netcore.zip

Maybe check if there is another runtime download that suits your system better here
https://dotnet.microsoft.com/download/dotnet-core/current/runtime

I appreciate the trouble shooting!

--------------------- MERGED ---------------------------




I also just found this, it's not hactoolnet... It's hactool. Might be able to use this
ill look at a command line for.....

https://gbatemp.net/attachments/hactool-zip.133415/
I'm on Win 7 (64-Bit), I've ran into a problem. I can't seem to extract anything.
Uploaded a screenshot for reference.
 

Attachments

  • Untitled.jpg
    Untitled.jpg
    95.3 KB · Views: 280
Last edited by FocusedWiiWarrior,

mikefor20

Well-Known Member
OP
Member
Joined
Jan 12, 2009
Messages
1,717
Trophies
2
Location
Mushroom Kingdom ( o Y o )
XP
3,240
Country
United States
I'm on Win 7 (64-Bit), I've ran into a problem. I can't seem to extract anything.
Uploaded a screenshot for reference.

Hard to tell.is hactoolnet in the hbthemes folder?

Install this?
https://download.visualstudio.micro...a84f/windowsdesktop-runtime-3.1.6-win-x64.exe

Try this exact version of hactoolnet?
https://github.com/Thealexbarney/LibHac/releases/download/v0.11.3/hactoolnet-0.11.3-netcore.zip

Need info!

"is not recognized as an internal or external command, operable program or batch file." mostly happens when the program or command file you are trying to run isn't either in path or the working directory.... mostly

I'll try but the app was not really intended to be run on an unsupported 2009 OS to be fair.... I don't have one laying around to test and neither do most of the devs i have talked to. I'll try though. Like to see your art. You could post the pictures and someone might build it for you.
 
Last edited by mikefor20,

mikefor20

Well-Known Member
OP
Member
Joined
Jan 12, 2009
Messages
1,717
Trophies
2
Location
Mushroom Kingdom ( o Y o )
XP
3,240
Country
United States
it's not like there are 10x more guests than members.

Fair enough , guests can't like, That's still 500 or so members glanced and moved on (with 10x more.).. How rude lol. Oh well. I did it to help and possibly see more HB Menu themes. I can honestly say I see more now and I had fun with it too. Win Win. Maybe it worked.
 
Last edited by mikefor20,

BabyMeatClan

New Member
Newbie
Joined
Jan 21, 2021
Messages
2
Trophies
0
Age
33
XP
43
Country
United States
My wifi icons won't work just shows as a white block, its name replaced the ones left in the extracted folder, I resized them, and they are .png. I ended up just using yours that were left in there, but I would like to know why they won't work. I'm thinking its the size of them bc yours are <5kb each, whereas my images are 87kb, 237kb, and 376kb.
 
General chit-chat
Help Users
  • No one is chatting at the moment.
  • Skelletonike @ Skelletonike:
    1H left, such a slow week.
  • Sonic Angel Knight @ Sonic Angel Knight:
    Okay, I had spaghetti :P
  • SylverReZ @ SylverReZ:
    Hope they made lots of spaget
  • K3N1 @ K3N1:
    Chill dog
  • SylverReZ @ SylverReZ:
    Chilli dog
  • Skelletonike @ Skelletonike:
    Damn, I'm loving the new zelda.
  • xtremegamer @ xtremegamer:
    loving the new zelda, i started a game, it was so fucking good, so i
    am waiting on my friend to get home so we can start a new one together
  • Skelletonike @ Skelletonike:
    I just dislike that they don't let me choose the voices before the game starts. Happened with botw as well, had to change to japanese and restart.
  • K3N1 @ K3N1:
    But the important question is can you choose gender
  • Skelletonike @ Skelletonike:
    Same way you can choose Gerald's gender.
  • Skelletonike @ Skelletonike:
    *Geralt, damn autocorrect.
  • Psionic Roshambo @ Psionic Roshambo:
    But can he be trans? Lol
  • K3N1 @ K3N1:
    Zelda transforms into link
  • Psionic Roshambo @ Psionic Roshambo:
    Link I'm not the princess your looking for.... *Pulls a crying game*
  • K3N1 @ K3N1:
    *skirt up* it's exactly what I always wanted
  • Skelletonike @ Skelletonike:
    Just scanned all my zelda amiibos, took a while but didn't get anything that cool, did get the lon lon ranch hylian fabrics though.
  • Skelletonike @ Skelletonike:
    It was pretty funny when I scanned wolf link and got a shit load of meat.
  • K3N1 @ K3N1:
    @Skelletonike, btw I ran that custom for mgs4 on the deck I'm amazed it got that far in game
  • K3N1 @ K3N1:
    Plug in*
  • K3N1 @ K3N1:
    Your favorite activity
  • BentlyMods @ BentlyMods:
    My fav actvity is:

    mario-dancing.gif
    BentlyMods @ BentlyMods: My fav actvity is: