Custom Home Menu Manager 2 3DS: Difference between revisions

CHMM2 - Custom Home Menu Manager 2
CHMM2 - Custom Home Menu Manager 2
General
Author	Rinnegatamante
Type	Utilities
Version	2.8
License	Mixed
Last Updated	2016/07/05
Links
	Download
	Website
	Source
	Support Author

Latest revision as of 04:11, 17 Mayıs 2024

Custom Home Menu Manager 2, also named CHMM2, is an open source theme manager for 3DS for custom themes based on Lua Player Plus 3DS. It is available in English, Spanish, Portuguese, Italian, French and Dutch.

It is a continuation of CHMM with a new graphical UI fully animated and new features. Both projects are no longer in development.

Features

Themes auto-placer if you install it in the wrong directory.
Theme Downloader linked with 3DSThem.es database.
Support for custom themes.
Support for BGM previews (BGM.ogg file) and screens previews (PNG, BMP, JPG files).
Support for multiple themes with shuffle system overwriting Nintendo ones.
Integrated network theme receiver.
Multiple UI colors for customization.
Beautiful and animated graphic.
Faster if compared to CHMM.

Installation

Available in CIA, 3DSX and 3DS formats.

3DSX - Copy .3dsx and .smdh to the /3ds/CHMM2/ folder on your SD card and launch it via Homebrew Launcher.
CIA - Copy .cia to your SD card and install it with the CIA manager of your choice.
3DS - Copy .3ds to your SD card.

Then download your preferred custom themes and put them in the /Themes/ folder (one folder for each custom theme, you can find then from Theme Plaza or create your own).

User guide

Create a theme

A theme is composed by several files:

body_LZ.bin - Contains background images and some theme settings.
BGM.bcstm - Contains theme BGM sound.
Preview.png/.jpg/.bmp - Screenshot used by CHMM2 for preview system.
BGM.ogg - Contains theme BGM preview sound, used by CHMM2 for preview system.
info.smdh - Contains icon, author, description and title of the theme.

Recommended tools:

For the theme, you can use 3DS Theme Editor (theme editor), YATA+ (no .smdh) and The SMDH Creator 3DS (.smdh only).
For the audio, you can use Audacity (music editor) and Looping Audio Converter (converter to .bcstm).

FAQ

Q. Where I can find the DSP firmware (dspfirm.cdc) required by CHMM2?

You can dump it with several tools like DSP Firmware Dumper, uncart, braindump or Decrypt9.

Q. I get "cannot initialize Sound module" error when using CIA/3DS version.

Update CHMM to v.2.6 or upper.

Q. My theme is not installed properly and says Menuhax Mode: ON when it is not in use.

Update CHMM to v.2.6 or upper.

Q. I get "Error: [string "?"]:1: syntax error near '<\187H" when starting CHMM2, what can i do?

You must delete config file in Themes folder.

Q. I installed a new theme but I still get the BGM from the old ones, how can I fix?

The theme you're using is corrupted. Read this post to fix it.

Controls

Base System:

A - Install theme

B - Install theme without BGM

Y - Show theme preview

X - Go to Shuffle System

L - Extract a ZIP theme

R - Switch to Theme Downloader

Left/Right - Navigate through themes

Select - Change UI color

Start - Open Options Menu

Touch - Open Help Panel

Shuffle System:

A - Add theme to themeset as current index

A (Hold) - Add theme to themeset as current indec without BGM

B - Erase current index from themeset

Y - Show theme preview

X - Install themeset and go to Base System

L/R - Change current index in themeset

Left/Right - Navigate through themes

Select - Change UI color

Start - Exit CHMM2

Touch - Open Help Panel

Theme Downloader:

A - Execute selected option

Y - Open theme preview

R/Start - Swap to Base System

Left/Right - Navigate through themes

Up/Down - Navigate in Actions Menu

Select - Change UI color

Touch - Open Help Panel

Screenshots

Media

How to install Custom Themes with CHMM2 (toXicBits)

Changelog

v2.8

Bugfix for some graphical glitches with preview system and listmenu mode.
Refactored the whole code, now homebrew runs a lot smoother.
Bugfix in Theme Downloader when a space was inserted in the keyword, it produced an interpreter crash.
Replaced Danzeff Keyboard in Theme Downloader with a touchscreen QWERTY keyboard.
Now Power button pression at startup is no longer required for CIA/3DS users.
Now CHMM Localization is no longer required (english localization is builtin with the executable).
Added Usagi 3DS Theme Editor previews native support in Preview System.
Now if a theme doesn't use a BGM.bcstm file, it won't use BGM from previous installed theme.
Added possibility to install themes without using BGM file.
Added Spanish localization (thanks to DrkBeam).

v2.7

Bugfix for the Theme Downloader: now it works as intended.
Added possibility to dump current in use theme from Options menu.
Added an Help screen which shows all possible controls viewable by tapping the touchscreen.
Enabled 804 Mhz mode. Homebrew will run a lot smoother (N3DS only).
Bugfix in Themes Receiver, now it won't currupt themes list anymore.
Added a panel showing themes info on top screen when using Textlist as Listing mode.
Added localization in different languages (Currently available: English, Italian, Dutch, Portuguese, French).
Changed Unique ID to 0xCE1CC for compatibility reasons.

Credits

Thanks to:

Apache Thunder for the 3D banner for 3DS/CIA builds.
Zerousen for the 2D texture used for 3DS/CIA builds banner.
ihaveamac for testing new UI and shuffle theme system.
~Poke~ for the buttons icons used by the UI.
MarioErmando for 3DSThem.es and API.
gnmmarechal for the Portuguese localization.
dimmidice for the Dutch localization.
Omegadrien and @Asia81 for the French localization.
DrkBeam for the Spanish localization.

External links

Author's site - http://rinnegatamante.it
GitHub - https://github.com/Rinnegatamante/CHMM2
GBAtemp - https://gbatemp.net/threads/release-chmm2-custom-home-menu-manager-2.397543

@@ Line 1: / Line 1: @@
-{{Infobox 3DS homebrew
+{{Infobox 3DS Homebrews
-| title = Custom Home Menu Manager 2
+|title=CHMM2 - Custom Home Menu Manager 2
-| image = https://dlhb.gamebrew.org/3dshomebrew/CHMM2-01.png|250px
+|image=Chmm22.png
-| type = Utilities
+|description=A theme manager for Nintendo 3DS for custom themes.
-| version = v2.8
+|author=Rinnegatamante
-| licence = Mixed
+|lastupdated=2016/07/05
-| author = Rinnegatamante
+|type=Utilities
-| website = https://github.com/Rinnegatamante/CHMM2
+|version=2.8
-| download = https://dlhb.gamebrew.org/3dshomebrew/CHMM28-3DS.rar
+|license=Mixed
-| source = https://dlhb.gamebrew.org/3dshomebrew/CHMM28-3DS.rar
+|download=https://dlhb.gamebrew.org/3dshomebrews/chmm2.7z
+|website=https://github.com/Rinnegatamante/CHMM2
+|source=https://github.com/Rinnegatamante/CHMM2
+|donation=https://www.patreon.com/Rinnegatamante
 }}
-<youtube>zBKojw59nlQ</youtube>
+Custom Home Menu Manager 2, also named CHMM2, is an open source theme manager for 3DS for custom themes based on [[Lua Player Plus 3DS]]. It is available in English, Spanish, Portuguese, Italian, French and Dutch.
+It is a continuation of CHMM with a new graphical UI fully animated and new features. Both projects are no longer in development.
+==Features==
+* Themes auto-placer if you install it in the wrong directory.
+* Theme Downloader linked with 3DSThem.es database.
+* Support for custom themes.
+* Support for BGM previews (BGM.ogg file) and screens previews (PNG, BMP, JPG files).
+* Support for multiple themes with shuffle system overwriting Nintendo ones.
+* Integrated network theme receiver.
+* Multiple UI colors for customization.
+* Beautiful and animated graphic.
+* Faster if compared to CHMM.
+==Installation==
+Available in CIA, 3DSX and 3DS formats.
+* 3DSX - Copy .3dsx and .smdh to the /3ds/CHMM2/ folder on your SD card and launch it via Homebrew Launcher.
+* CIA - Copy .cia to your SD card and install it with the CIA manager of your choice.
+* 3DS - Copy .3ds to your SD card.
+Then download your preferred custom themes and put them in the /Themes/ folder (one folder for each custom theme, you can find then from [https://themeplaza.eu/ Theme Plaza] or create your own).
+==User guide==
+===Create a theme===
+A theme is composed by several files:
+* body_LZ.bin - Contains background images and some theme settings.
+* BGM.bcstm - Contains theme BGM sound.
+* Preview.png/.jpg/.bmp - Screenshot used by CHMM2 for preview system.
+* BGM.ogg - Contains theme BGM preview sound, used by CHMM2 for preview system.
+* info.smdh - Contains icon, author, description and title of the theme.
+Recommended tools:
+* For the theme, you can use [[Usagi 3DS Theme Editor|3DS Theme Editor]] (theme editor), [[YATA Plus 3DS|YATA+]] (no .smdh) and [[The SMDH Creator 3DS]] (.smdh only).
+* For the audio, you can use [http://audacityteam.org Audacity] (music editor) and [https://github.com/libertyernie/LoopingAudioConverter/releases Looping Audio Converter] (converter to .bcstm).
+===FAQ===
+'''Q. Where I can find the DSP firmware (dspfirm.cdc) required by CHMM2?'''
+You can dump it with several tools like DSP Firmware Dumper, uncart, braindump or Decrypt9.
+'''Q. I get "cannot initialize Sound module" error when using CIA/3DS version.'''
+Update CHMM to v.2.6 or upper.
+'''Q. My theme is not installed properly and says Menuhax Mode: ON when it is not in use.'''
+Update CHMM to v.2.6 or upper.
+'''Q. I get "Error: [string "?"]:1: syntax error near '<\187H" when starting CHMM2, what can i do?'''
+You must delete config file in Themes folder.
+'''Q. I installed a new theme but I still get the BGM from the old ones, how can I fix?'''
+The theme you're using is corrupted. Read [http://gbatemp.net/threads/release-chmm2-custom-home-menu-manager-2.397543/page-100#post-6610339? this post] to fix it.
+==Controls==
+'''Base System:'''
+A - Install theme
+B - Install theme without BGM
+Y - Show theme preview
+X - Go to Shuffle System
+L - Extract a ZIP theme
-CHMM is coming back with a new, wonderful graphical UI fully animated and new features!
+R - Switch to Theme Downloader
-CHMM2 is a theme manager for 3DS for custom themes; it works under lpp-3ds and it is completely opensource.
-TODO List:
+Left/Right - Navigate through themes
-Do you want to suggest a new feature or an improvement for the homebrew?
-Take a look a this: https://docs.google.com/document/d/1WL-y-Vh5X2gxUdWb0xsfIr4CnH1wAdbrzqLvHnzeaGA/edit
-If what you want to suggest is not yet listed here you can reply to the thread or just push a comment to the document.?
-FEATURES
+Select - Change UI color
-- Themes auto-placer if you install it in the wrong directory.
-- Theme Downloader linked with 3DSThem.es database.
-- Support for custom themes.
-- Support for BGM previews (BGM.ogg file) and screens previews (PNG, BMP, JPG files).
-- Support for multiple themes with shuffle system overwriting Nintendo ones.
-- Integrated network theme receiver.
-- Multiple UI colors for customization.
-- Beautiful and animated graphic.
-- Faster if compared to CHMM.
-CONTROLS
+Start - Open Options Menu
-Base System
+Touch - Open Help Panel
-A = Install theme
+'''Shuffle System:'''
-B = Install theme without BGM
-Y = Show theme preview
-X = Go to Shuffle System
-L = Extract a ZIP theme
-R = Switch to Theme Downloader
-Left / Right = Navigate through themes
-SELECT = Change UI color
-START = Open Options Menu
-Touch = Open Help Panel
-Shuffle System
+A - Add theme to themeset as current index
-A = Add theme to themeset as current index
+A (Hold) - Add theme to themeset as current indec without BGM
-A (Hold) = Add theme to themeset as current indec without BGM
-B = Erase current index from themeset
-Y = Show theme preview
-X = Install themeset and go to Base System
-L / R = Change current index in themeset
-Left / Right = Navigate through themes
-SELECT = Change UI color
-START = Exit CHMM2
-Touch = Open Help Panel
-Theme Downloader
+B - Erase current index from themeset
-A = Execute selected option
+Y - Show theme preview
-Y = Open theme preview
-R / Start = Swap to Base System
-Left / Right = Navigate through themes
-Up / Down = Navigate in Actions Menu
-SELECT = Change UI color
-Touch = Open Help Panel
-USAGE
+X - Install themeset and go to Base System
-Download your preferred custom themes and put them in Themes folder.
+L/R - Change current index in themeset
-HOW TO CREATE A THEME
+Left/Right - Navigate through themes
-A theme is composed by several files:
+Select - Change UI color
-body_LZ.bin - Contains background images and some theme settings.
-BGM.bcstm - Contains theme BGM sound.
-Preview.png/.jpg/.bmp - Screenshot used by CHMM2 for preview system.
-BGM.ogg - Contains theme BGM preview sound, used by CHMM2 for preview system.
-info.smdh - Contains icon, author, description and title of the theme.
-- To create first three files i recommend to use YATA+ ( http://gbatemp.net/threads/release-yet-another-theme-application-plus-yata-3ds-theme-editor.393355/ )
+Start - Exit CHMM2
-- To create BGM.ogg file i recommend to use Audacity ( http://audacityteam.org )
-- To create info.smdh file i recommend to use SMDH Creator ( https://gbatemp.net/threads/release-the-smdh-creator-make-your-own-icon-pack.396765/ )
+Touch - Open Help Panel
-CREDITS
+'''Theme Downloader:'''
-@Apache Thunder for the awesome 3D banner for 3DS/CIA builds.
-@Zerousen for the 2D texture used for 3DS/CIA builds banner.
-@ihaveamac for his awesome work testing new UI and shuffle theme system.
-@~Poke~ for the buttons icons used by the UI.
-@MarioErmando for 3DSThem.es and his awesome API.
-@gnmmarechal for the portuguese localization.
-@dimmidice for the dutch localization.
-@Omegadrien and @Asia81 for the french localization.
-@DrkBeam for the spanish localization.
-FAQ
+A - Execute selected option
-Q) Where i can find the DSP firmware (dspfirm.cdc) required by CHMM2?
+Y - Open theme preview
-A) You can dump it with several tools like DSP Firmware Dumper, uncart, braindump or Decrypt9.
-Q) I get "cannot initialize Sound module" error when using CIA/3DS version, how can i solve?
+R/Start - Swap to Base System
-A) Update CHMM to v.2.6 or upper.
-Q) CHMM2 doesn't install properly my theme and it says Menuhax Mode: ON when i'm not using it, what can i do?
+Left/Right - Navigate through themes
-A)Update CHMM to v.2.6 or upper.
-Q) I get "Error: [string "?"]:1: syntax error near '<\187H" when starting CHMM2, what can i do?
+Up/Down - Navigate in Actions Menu
-A)You must delete config file in Themes folder.
-Q) I installed a new theme but i still get the BGM from the old ones, how can i fix?
+Select - Change UI color
-A)The theme you're using is corrupted. Read this post to fix it:
-http://gbatemp.net/threads/release-chmm2-custom-home-menu-manager-2.397543/page-100#post-6610339?
+Touch - Open Help Panel
+==Screenshots==
+https://dlhb.gamebrew.org/3dshomebrews/chmm23.png
-LINKS
+==Media==
-Github Repository: https://github.com/Rinnegatamante/CHMM2?
+'''How to install Custom Themes with CHMM2''' ([https://www.youtube.com/watch?v=zBKojw59nlQ toXicBits]) <br>
+<youtube>zBKojw59nlQ</youtube>
-Download (Mirror): http://rinnegatamante.it
+==Changelog==
+'''v2.8'''
+* Bugfix for some graphical glitches with preview system and listmenu mode.
+* Refactored the whole code, now homebrew runs a lot smoother.
+* Bugfix in Theme Downloader when a space was inserted in the keyword, it produced an interpreter crash.
+* Replaced Danzeff Keyboard in Theme Downloader with a touchscreen QWERTY keyboard.
+* Now Power button pression at startup is no longer required for CIA/3DS users.
+* Now CHMM Localization is no longer required (english localization is builtin with the executable).
+* Added Usagi 3DS Theme Editor previews native support in Preview System.
+* Now if a theme doesn't use a BGM.bcstm file, it won't use BGM from previous installed theme.
+* Added possibility to install themes without using BGM file.
+* Added Spanish localization (thanks to DrkBeam).
-QR Code (FBI) [This is available only if adf.ly monetization is OFF here: http://rinnegatamante.it/site/donate.php ]:
+'''v2.7'''
+* Bugfix for the Theme Downloader: now it works as intended.
+* Added possibility to dump current in use theme from Options menu.
+* Added an Help screen which shows all possible controls viewable by tapping the touchscreen.
+* Enabled 804 Mhz mode. Homebrew will run a lot smoother (N3DS only).
+* Bugfix in Themes Receiver, now it won't currupt themes list anymore.
+* Added a panel showing themes info on top screen when using Textlist as Listing mode.
+* Added localization in different languages (Currently available: English, Italian, Dutch, Portuguese, French).
+* Changed Unique ID to 0xCE1CC for compatibility reasons.
+==Credits==
+Thanks to:
+* Apache Thunder for the 3D banner for 3DS/CIA builds.
+* Zerousen for the 2D texture used for 3DS/CIA builds banner.
+* ihaveamac for testing new UI and shuffle theme system.
+* ~Poke~ for the buttons icons used by the UI.
+* MarioErmando for 3DSThem.es and API.
+* gnmmarechal for the Portuguese localization.
+* dimmidice for the Dutch localization.
+* Omegadrien and @Asia81 for the French localization.
+* DrkBeam for the Spanish localization.
-https://docs.google.com/document/d/1WL-y-Vh5X2gxUdWb0xsfIr4CnH1wAdbrzqLvHnzeaGA/edit
+==External links==
+* Author's site - http://rinnegatamante.it
+* GitHub - https://github.com/Rinnegatamante/CHMM2
+* GBAtemp - https://gbatemp.net/threads/release-chmm2-custom-home-menu-manager-2.397543