Hakchi Resources! The one stop shop for the latest releases, mods, guides and resources for everything Hakchi.
Hakchi2 CE ‘Community Edition’ v1.2.2 – Hakchi Resources

Hakchi2 CE ‘Community Edition’ v1.2.2

April 19, 2018 | By Advokaten | Filed in: Hakchi Application Tool.

This is v1.2.2 of hakchi2 CE. This is a maintenance release to fix bugs and regressions. As always, if you encounter any bugs, please feel free to open an issue on Github and we’ll try to address it as we can.


hakchi2 CE by @TeamShinkansen and hakchi scripts from @madmonkey1907 have always been experimental software: USE AT YOUR OWN RISK!

Minimal HOW-TO upgrade from v1.1.0

You can upgrade to this release from previous versions and things should continue going well, and hopefully better. If your base kernel or scripts are out-of-date and needs to be upgraded, the system should advise you to do so. You can follow prompts and if everything goes well, you’ll be good to go in no time.

  • If you prefer to do things manually, you can use Kernel > Install/Repair. This will put you up to speed.
  • If you’re experiencing issues and would like to start fresh, you can then try Kernel > Reset. this will effectively erase all customizations and files and settings and put hakchi back to how it’s supposed to be after a fresh install. This option also avoids wear and tear on NAND memory, as it does not flash anything, only reset data.
  • If you want to benefit from the new automatic backup feature of hakchi, you should first do Kernel > Uninstall, and then give the app your existing kernel backup from previous versions of hakchi2 when it asks you to do so, then once everything is back to stock, run the first menu item Kernel > Install/Repair. This should create an internal backup on the NES/SNES mini, and you should not be prompted for a kernel dump anymore. You should always keep it stored safely in case unforeseen problems arise, but you shouldn’t normally need it anymore.

Those are all the choices you should ever need from the Kernel menu. Of course, there are still other capabilities tucked away in Kernel > Advanced, which are, by definition, for advanced users!


  • Custom backgrounds HMOD


  • fix regression where some actions could not be done on original games (scan, download and delete cover art)
  • update internal hakchi script version revision to 113
  • add upgrade actions to clean up now unused files (will work for portable installs and only partially for non-portable)
  • disable writing debut tar archives on sync and export (fixes progress bar stuck at 100% for a long time)
  • fix linked export original games with custom covers path pointing to the wrong place
  • reenable install driver button on waiting for shell dialog (for when the mini doesn’t come back after a reboot, i suspect this is what is forcing some people to unplug/plug back their mini after a reboot)
  • message tweaks

FAQ / Common Issues

Q: I have an error saying “kexec.static” file is not found and I cannot update my hakchi scripts! What can I do?

A: At the moment, this issue is a real mind-bender, but in order to fix this, simply download the installation package for the current build and variant you are using (debug or release) and update your hakchi2 folder manually with it. There are files in the /tools/arm/ directory that needs to be there that have somehow been deleted.

Q: Where is the dump kernel menu option?

A: It’s gone! If you have a kernel dump in hand, you should still keep it safe, as uninstalling will require using it. However, if you’re ever installing hakchi again on a NES/SNES mini which has its factory kernel installed, the backup is automatically done by the install script and saved somewhere safe, directly in the console’s NAND memory.

Q: Retroarch gives me a black screen on NES games (or others not run by the native emulator).

A: Be sure you are using the latest version of Retroarch (or at the very least, a recent release). A good place to start is here: https://github.com/TheOtherGuys-Hakchi-Projects/Hakchi-Retroarch-Neo-1.7.0

Q: It seems as if many captions, labels and messages are still in English when I switch to using my own language in the language menu! Why can’t I get all the interface in my language like before?

A: Our current team has focused solely on improving and adding features for the meantime. We’re looking into solutions to restore full translations, or at least refresh the languages we can translate ourselves. We are interested to know how many people are actually using foreign languages, so you can inform us if your language isn’t fully translated and this affects you.

Q: How can I give my games a “save icon” in the NES/SNES mini menu?

A: Use the Save Count property on the main hakchi2 CE interface. Setting it to zero means no icon, and any number from 1 to 3 will display an icon.

Q: My games are not sorted the way I want them to be! How can I change this?

A: The Sort name field in hakchi2 CE’s main interface exists solely for this purpose. You can alter the default string generated there and it will affect sort order.

Q: My games are broken. The command line seems to point to an non-existent file. Is there anything I can try besides manually repairing them?

A: Yes. For games that don’t work anymore, you can try the Repair games option that appears in the main games list context menu.

Q: Where is SFROM Tool located in hakchi2 CE? I’ve heard it supports it, but can’t find how to use it!

A: You first need to visit DarkAkuma’s website: http://darkakuma.z-net.us/p/sfromtool.html . And download his tool there. Also download the patches you want to apply. Then decompress the archive in the sfrom_tool/ folder under your hakchi2 CE’s personal directory (there is already a placeholder there for this use). Decompress the patches you want to use inside the patches/ folder. And finally, in hakchi2 CE, enable Settings > SFROM Tool and profit! From then on, when importing SNES games, they will be converted by this tool. You can also find additional options in the games list’s context menu SFROM Tool. Finally, there is helper code to allow dragging & dropping the install package and .cnp files onto hakchi2 CE. You can try this as well!

Q: Can I add a new app or game, but manage it manually and add the files in its directory later on?

A: Use File > Add custom app.

Q: Help! My original games don’t show up in my games list!!!

A: This can happen if you either deleted the files in the games_originals/ folder, or if you’ve selected View > Original games > Hidden (Unselected) in the menu. In the former case, use File > Restore original games menu item. In the latter, simply select a different option within that submenu, it should restore your original games in list!

Q: When I sync my games on my NES/SNES mini, it always takes a long time and the differential sync doesn’t seem to help!

A: This can happen if you either use any of the automatic folders/pages generating options, because whenever you add or remove games, it substantially modifies the folders and file structure, so the differential sync cannot help much. There are two methods to help alleviate this: first we suggest you use the “Linked sync” option, this usually reduces the amount of data needed to transfer by a BIG margin. And second, if you manage your folders manually using the “Custom – Use folders manager” structure option, if you keep your folder structure very similar, it should not happen too often.

Q: When I sync my games on USB, it always takes a long time and the differential sync feature doesn’t seem to help!

A: See above answer, this partly applies to USB export as well, however, in this case, the best scenario is to use the “Linked export” feature, accessible in the export dialog. This only requires that hakchi2 CE be installed on the USB drive. Keeping folder structure similar between exports will also help.

Q: Where is the Folders Manager menu item that was present in the Tools menu before?

A: For consistency, it’s been moved to Structure > Custom - Use folders manager button-menu. Select this option and click on it again to access the folders manager.

Q: Why can’t I sync my NES (USA/Europe) games collection to my Super Famicom (Japan) console? I’ve read that this new version supports HSQS image files and multiboot!

A: In order to use multiboot, you simply have to make sure Settings > Separate games for multiboot is checked. Switching between enabling and disabling this option will delete the previous games collection(s) that were managed using either technique.

Q: I can’t seem to use my games on my USB drive via my OTG device. It worked before!

A: One thing to verify first if it the menu option Settings > Enable USB host is enabled. This setting is stored on the NES/SNES mini and you either need to sync your games, or press the Settings > Save settings to my NES/SNES mini now option to save it.

Q: I’m getting occasional Clovershell timeouts during game syncs or other operations

A: Clovershell ocasionally crashes. Your best bet is to reboot your console and maybe restart H2CE for good measure.

Q: Often when I try to drag a selection in the main games list, my mouse goes crazy and the list ends up scrolled past its limit.

A: This is a Windows API bug in the ListView control. Hard to tell when this bug was introduced, but it’s present on any software using its built-in ListView control. There is someone on GitHub who released a small tool to fix this issue globally, if you’re interested: https://github.com/tablacus/TablacusWindows10FCUBugFix/releases

Q: On app start, I receive an error about System.NotSupportedException: The requested security protocol is not supported.

A: You may still be running hakchi2 CE v1.1.0? If that is the case, you can upgrade to this new release and this error should not occur again. Be advised you need to have an up-to-date install of .NET v4.6.1. A: If you still want to use v1.1.0, you are most likely on an older version of .NET, or a version of Windows older than Windows 10. Microsoft has provided a hotfix for this issue, please download it here: https://support.microsoft.com/en-us/help/3154518/support-for-tls-system-default-versions-included-in-the–net-framework

Q: Which file systems for USB and SD drives are supported?

A: Short outline below:

  • We strongly recommend ext2/ext3/ext4.
  • FAT32 is supported, but is prone to data loss if your system is not properly shut down (don’t pull the power plug).
  • NTFS is also fully supported, but if you’re doing all three of the below together then you may have issues:
    • Running H2CE from the USB drive itself
    • The drive is NTFS
    • You are using the USB drive instead of H2CE to manage HMODs
  • If this is the case, please use H2CE to manage your HMODs, rather than USB transfer. With the new HMOD installation process, managing HMODs is no harder than games, and does not require FEL mode.

hakchi2_CE_1.2.2_Release.zip 16.9MB


Comments are closed here.