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

Hakchi2ce ‘Community Edition’ v1.2.1

April 17, 2018 | By 'Team Shinkansen' | Filed in: Hakchi Application Tool.


This is v1.2.0 of hakchi2 CE. This release once again brings a lot of new features (Integrated Hakchi Mod Store!), in addition to as many bugfixes as we could identify and fix. 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 previous versions

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!

Under the hood improvements

  • updated hakchi scripts to the bleeding edge
  • added app support for networking modules (ssh, ftp, telnet)
  • seamless support for both clovershell or network modules
  • many improvements to sync/export games:
    • incremental sync algorithm for both exporting and synchronizing games!
    • linked sync option: greatly improve incremental sync efficiency
    • no more temporary files when exporting or synchronizing (only exception: when using game genie codes)
  • complete support for games separation for multi boot option
  • european and usa models of mini are now considered as 2 different console types
  • better size estimate on games
  • proper free space calculation on export
  • much better search algorithm for cover art scanning
  • cover art scanning now supports putting covers in separate directories per system
  • completely new and more flexible tasks system
  • read and save configuration on the mini on-the-fly
  • new more flexible config file handling
  • more flexible HMOD install drag & drop support
  • install SFROM Tool (as well as .cnp patches) by simply dragging & dropping the install package

UI Improvements

  • new streamlined kernel operations:
    • install / repair (install and repair hakchi kernel/scripts)
    • reset (to erase all files and repair hakchi kernel/scripts)
    • uninstall (to go back to stock kernel)
    • flash uboot submenu for sd card mod users
    • all other advanced options now reside in the advanced submenu
  • improved install/uninstall modules dialog and process
  • improved games collection management
    • allows managing your collections with your console offline or online
    • allows syncing any collection when multiboot is enabled
    • folders/pages settings are remembered for each collection (plus a sync button to make them all the same if needed)
    • new folder images set feature (subfolders in /folder_images become sets accessible in structure submenu)
    • added possibility to generate back button at the left or at the right
    • added home button generation for deep folder trees
  • new view menu options
    • hide original games
    • sort by core
    • group games without cover art
  • prepare art folders dialog (for selective cover art scanning)
  • select cover dialog when cover art scanning yields multiple options
    • very flexible select system and core dialog
    • associate a system to a game
    • associate a core to a game
    • batch modify command line for games
    • uses libretro info files database (and uses known binaries for compatibility)
  • new progress bar dialog with pretty icons
    • works in tandem with the new tasks system, much better view of the actual progress
  • new message boxes with pretty icons
  • add File > Add custom app
  • “live” screenshot dialog
    • unattended screenshot with one keystroke (F11)
  • Context menu > repair games feature (when you have broken links)
  • enable/disable usb host option
  • main application icon now resizes much better in windows explorer
  • connected console firmware is shown in title bar
  • more safety nets when synchronizing games


  • folders manager:
    • image previews were not resized properly
    • splitting folders would trigger an exception in some situations
    • sort by app type would sometimes cause an exception
    • missing folder images would trigger an exception and delete .xml file
  • improper config saving on the console
  • game filenames were not always renamed safely
  • scanning cover art on compressed games would sometimes cause IO errors
  • scanning cover art would cause way too many false positives
  • boot splash now resizes images that are not 1280×720 exactly
  • changing boot splash would hang shell
  • export games would not allow selecting network drives
  • font remount would cause issues with certain mods and hsqs mounting
  • save_count was always zero when importing games with sfrom tool
  • free space wasn’t estimated properly when using separate games for multiboot
  • original games interactive demos and pixelart folders were not linked properly
  • empty directories were not all or always deleted after usb export and nand sync
  • importing corrupted snes game would cause fatal exception
  • reset button combination (and other controller hacks) would stop working after sync
  • game changes were not always saved properly
  • some access violations could occur when doing tasks that require de/compressing games
  • hmod selection window ui would freeze when many hmods were installed (v1.2.1)

FAQ / Common Issues

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.

Hakchi2ce ‘Community Edition’ v1.2.1 Download Link


2 comments on “Hakchi2ce ‘Community Edition’ v1.2.1

  1. Ron says:

    I have installed hakche ce v 1.2.1. Installation went fine on my famicom mini. The problem im running across is with multiboot. I added a NES hsqs firmware and it boots fine except that controls become unresponsive as soon as it boots. Ive read through several forums but have not found a solution. Thx

    • Swingflip says:

      If you still have the issue, join our discord chat room and ask support. We will get you up and running.