Skip to content

Latest commit

 

History

History
53 lines (49 loc) · 3.66 KB

README.md

File metadata and controls

53 lines (49 loc) · 3.66 KB
Raw

Home Menu Rebuilding Tool (HMRT) v0.8.1

Use it with this guide

NOW FOR GNU/LINUX!

This is WIP but useable!
Feel free to contribute (e.g. code or tutorials)
[29th March 2021]: Fixed full rebuild. Problem was that the variable content changed cause at some point I switched from numbers to strings in the case.
However, I did not test the created HomeMenu after this change but don't think something broke. Btw. those errors at the last step — the BUILD step — are normal cause WINE is still used there!
[14th November 2020]: Broke full rebuild with some changes. Choose previous commit or call each step individually until I fix it.
Added bclimtool and darctool and a script extractLZ so that GNU/Linux users don't need to wait until Kuriimu2 (which uses dotnetcore!) finally works to be able to view PNG files within bclim files..
Useful tip: Use magick display 'vid:*.png' (needs imagemagick) to view all png files in a folder at once.
[2nd September 2020]: A full rebuild COULD work (on GNU/Linux after a few tries) and IF it builds a edited CIA then it SHOULDN'T lead to a softbrick.
It should be possible to exchange files between Windows and GNU/Linux regardless of the steps that were executed
(Design choice: for files extracted from or modified on linux the LZ extension is lowercase -> we won't need to ask which plattform people use)
I don't plan to test the xorpad parts soon and I would be glad if you could test them for me.
Next steps for GNU/Linux include

  • moving away from wine
  • improving a few parts of the script (e.g. don't rm *.0000.* if it doesn't exist; ignore_3dstool.txt warning)
  • Give people more information e.g. if BUILD (step 6) gets called and it can't do anything now, then say so!
  • Move or get rid of a few pauses especially in BUILD (step 6) – do they exist because of missing pauses in previous steps?
  • Use dialog for a better UI
  • Try it on Android.. Maybe rewrite in C if it doesn't work?
  • Replace parameters like --content with the correct ones. ctrtool expands, so we could e.g. use --co instead of --contents, but we shouldn't.
  • Maybe add log for EXTRACT
  • Make finished steps more clear (Maybe put strings in array and display the step name?)
  • Integrate extractLZ.sh into HMRT.sh
  • Option to re-inject bclim files
  • Options to quickly replace files (like bclim) in LZ compressed archives by using some syntax like hud.lz/timg/HudBatBase_01.bclim newHudBatBase_01.png
  • Call HMRT options directly from command line
  • Add a tool that lets users easily search for Strings, Offsets, Hex values, Words (from a dictionary; regex?) within all files
  • Add an option to patch files with new values (mass replace matching values; individual values written in a file; presets written in a file like "Background" or "BtnBase")
  • Option to inject compressed lz files like in https://cdn.discordapp.com/attachments/265917056837353472/600180023986487296/Modded_Home_Menu_3DS.zip. Either by a file structure that is written in a file or by searching, if that file doesn't exist)
  • If possible, run generated cia in citra?
  • Rewrite some of the used tools or turn everything into a single C project. e

Credits:

3dstool
https://github.com/dnasdw/3dstool Didn't know there was a linux version. MIT in /HMRT
ctrtool & makerom
https://github.com/jakcron/Project_CTR MIT license copied to /HMRT
sockfile
https://github.com/Steveice10/
ncchinfo_gen
https://github.com/d0k3/3DS-Tools-Collection/tree/master/Decrypt9%20Scripts
bclimtool
https://github.com/dnasdw/bclimtool
darctool
https://github.com/yellows8/darctool/