Releases: TeamShinkansen/Hakchi2-CE
hakchi2 CE 3.5
It's been a while, but hakchi2 ce 3.5.0 is finally here!
This release brings a bunch of fixes and new features, one of the most notable being the mod hub, a repository system that allows sources other than the mod store to be easily accessed from CE.
The first repository to make use of this new feature is KMFD's Mod Hub, so no more downloading the hmods manually from the pack just to get one of them that were updated.
Other notable changes is that the PuTTYtel telnet client is included and the Open FTP Client
menu item now opens windows explorer by default.
Also included is preliminary support for running in mono on Linux, to run without crashing, ensure you have libusb installed.
A full list of changes in CE is as follows:
-
Mod Hub
- An all new repository system that allows any source to be added and accessed from within CE!
-
Driver
- Update for windows 7 compatibility
- Launch the driver installer when needed if not installed
- Hide the install driver button in dialogs when the driver is already installed
-
Mod Store
- Made info panel into a proper C# control instead of using HTML
- Change download dialog to one that allows canceling the download.
- Allow aborting downloads
- Add experimental tab
-
Linux Support (Kind Of)
- Make sure libusb is installed, if you get an error about not being able to open the device, run as root or change your udev rules.
- UI bugs galore!
-
Miscellaneous
- Update retroarch core info
- Fix missing folders in the Hakchi2 folder in documents
- Game archiving, you can now export games as .clvg format and import into another copy of Hakchi2 CE
- Shonen jump support
- Open FTP in windows explorer
- Bundle PuTTYtel for telnet access and use as the default client
- Ignore kernel backup if shift is held while selecting
Kernel > Uninstall
- Add menu item to generate modules report file
- Add sort by emulated system in mod select dialog
- Update faustbear icon set to 2.22
- Update credits
- Set working directory to always be the path of
hakchi.exe
-
Code Changes
- Create readme form control
- Re-factor and cleanup hmod related code
- Update installer to include hakchi2 ce version from exe
- Add makefile project for installers to solution
- Add makefile project for zip files to solution
- Update installer to only remove installed files and not the entire install path, this could have been very bad if it was installed to the root directory of a drive!
- Decompression tweaks for hmods
-
Hakchi
- recovery mode now supports wi-fi with latest wpa-supplicant
- time syncs at startup with latest wpa-supplicant
- new usb timeouts
- sntool nand r/w fix
- fix fel boot
- move ttyd
- needKeyFile() function
- export hmod list to usb
- fixed chmenu wait
- clovercon famicom fix
hakchi2 CE v3.4.1 (Hotfix)
hakchi2 CE v3.4.1
Hotfix release to fix SD card issues.
DISCLAIMER
hakchi2 CE by @TeamShinkansen and hakchi scripts from @madmonkey1907 have always been experimental software: while we strive to offer a risk-free experience, unpredictable things can happen, so
USE AT YOUR OWN RISK!
Known issues
Current IP address
of you connected NES/SNES mini is no longer shown inTools
menu options. If using the debug build, you can see this IP address in the console log. If using the release version, this information is available inTools -> Technical information
window.- There is a bug in current hakchi.hmod's
currentFirmware
function that causesShounen Jump
to appear offline, when it is actually online. A workaround hmod is available to fix this issue:
shonen_fix.zip - To get access to
Shounen Jump
original games, you need to useFile -> Restore original games
first while havingShounen Jump
games collection selected.
Bugfixes
- Update hakchi.hmod to .120 to fix SD card not mounting
- Removed mDNS debug ignore message to fix spamming with some users
- Fix minor issue with MOTD not showing on first run
hakchi2 CE v3.4.0
hakchi2 CE v3.4.0
This is v3.4.0 of hakchi2 CE. This release should be ready to handle the new 2018 models of Nintendo NES/SNES minis (NES 2018 rerelease and Shounen Jump special edition Famicom). It also incorporates a more stable and versatile network discovery mode, mDNS, which is, incidentally, the main reason for another important version jump.
DISCLAIMER
hakchi2 CE by @TeamShinkansen and hakchi scripts from @madmonkey1907 have always been experimental software: while we strive to offer a risk-free experience, unpredictable things can happen, so
USE AT YOUR OWN RISK!
Important information regarding Clovershell
If you've been upgrading from older versions of hakchi, it is very possible that your NES/SNES mini is still running the Clovershell
protocol. If that is so, this new version of hakchi2 CE will not allow using emulated FTP
or Synchronization
as long as you are using it.
In order to use the new SSH connection protocol, you only need to first make sure your kernel is up-to-date
and then you can go into Modules -> Uninstall extra modules
, uncheck clovershell
and then click OK
at the bottom. If the uninstall goes well, when your NES/SNES mini reboots, it should be connected using the new network protocols.
Bugfixes / Improvements since v3.3.0
- Fix command lines of Shounen Jump original games
- Remove obsolete now unused console settings
Enable USB host
andUse extended font
- Update
Font Remount
hmod, including a new font with more characters - Add
/info
user directory where one can add libretro .info files for custom cores - Fix a bug that prevented readmes from appearing correctly in
Select modules form
- Update hakchi.hmod core scripts:
- mDNS announce service
- flash uboot should work fine now
- Fix games not checking in some games collections when adding games and
Separate games storage
is disabled - Fix export games on
Shounen Jump
silently failing - Add some safeguards on
Tools -> Switch running firmware
- Add some amazing user submitted (on Discord server) folder images
- Reworked the internals handling NES/SNES mini detection on the network, hopefully for the best
- Removed PING listener; add DNS resolve listener
- Longer timeouts in MemoryStats.cs to allow for very large game collections
- Fix firmware switching causing issues over wifi
- Removed blacklisted hmods from user_mods
FAQ / Common Issues
Q: After rebooting, I get a dialog saying my NES/SNES Mini is taking a long time to reboot and it never comes back online.
A: There are many possible reasons for this, but here are a few common causes:
- Drivers may not be installing correctly. You can either try manually installing the driver located in
hakchi2_CE/driver
namedNintendo_Classic_USB_Driver.exe
, or if this does not work, you can also try an open-source utility calledZadig
. You can download it at this address: https://zadig.akeo.ie/ . - Sometimes, Windows' Firewall may be blocking the connection. Make sure to
Accept
incoming/outgoing connections when running hakchi2 CE. Windows should advise you of which program is requesting access. Only accept for hakchi2 CE. You can also, for debugging purposes, try to disable it and see if it works. Do not leave your system without a firewall afterwards though, this is there for a reason. - A device may be confusing hakchi2 CE or your NES/SNES mini on the network, like a games console on your network, or other devices. If possible, you can try disabling your ethernet or wifi connection to see if it helps, as a temporary measure, of course.
Q: My NES/SNES Mini is in Recovery mode
, I can't do anything, what is that?
A: This mode is when your console does not boot completely, or if you've attempted a kernel operation that might have failed. It will also happen if you select Kernel > Advanced > Boot recovery kernel from RAM
of course. To get out of this mode, if you don't know how to use the shell, is to click Tools > Reboot
or, if this does not work, turn off the NES/SNES Mini power switch, and unplug its USB power cable manually.
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!
A: A new feature is accessible through Settings -> Always copy original games
. This will only allow using original games that have been previously cached by hakchi2 CE upon connecting the desired console. Unchecking it will show all original games, regardless of their availability. hakchi2 CE will continue to rely on those original games to be present on your NES/SNES mini when syncing games to it.
Q: Help! My custom games are not in the list anymore!
A: Make sure the menu option Settings -> Separate games storage
is checked if you are using /games
and /games_snes
folders to store your NES and SNES games separately. When this option is unchecked, only games in /games
are considered.
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" f...
hakchi2 CE v3.3.0 - Catching up!
hakchi2 CE v3.3.0
This is v3.3.0 of hakchi2 CE. This is a mostly a catch-up release, to get back up to speed following the new versions of NES minis. There are a couple noteworthy features added and bugs fixed as well! 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.
DISCLAIMER
hakchi2 CE by @TeamShinkansen and hakchi scripts from @madmonkey1907 have always been experimental software: while we strive to offer a risk-free experience, unpredictable things can happen, so
USE AT YOUR OWN RISK!
Important information regarding Clovershell
If you've been upgrading from older versions of hakchi, it is very possible that your NES/SNES mini is still running the Clovershell
protocol. If that is so, this new version of hakchi2 CE will not allow using emulated FTP
or Synchronization
as long as you are using it.
In order to use the new SSH connection protocol, you only need to first make sure your kernel is up-to-date
and then you can go into Modules -> Uninstall extra modules
, uncheck clovershell
and then click OK
at the bottom. If the uninstall goes well, when your NES/SNES mini reboots, it should be connected using the new network protocols.
Bugfixes / Improvements
- Memboots (kernel and modules operations) will always use up-to-date boot.img now.
- Improvements to flashing/uninstall messages.
- Added MD5 of new 2017 re-released NES mini and Shounen Jump Famicom mini.
- hakchi.hmod: Fixed some cases of MD5 checksum fail.
- hakchi.hmod: p0000_config was being reset on hmod install/uninstall.
- Fixed listener would get "stuck" when all ping attemps would fail.
- Fixed window icon of WaitingForShellCycleForm.
- Fixed SSH listener would not release resources properly on ping fails.
- Fixed out of bounds number on size indicator.
- Savestate manager: should not erase non-standard save folders anymore (used by retroarch for instance).
- Savestate manager: Increased timeout values.
- Core selecter: clicking
Show all
for systems should update core list accordingly. - Linked export/linked sync would rename CLV-* names to uppercase and this caused issues with .desktop links.
- New games added were not checked by default in other games collections.
- Game Genie: clicking on
+
when the text box is empty should not cause an exception anymore. - Internal changes to libraries.
- SharpCompress + tiny7z instead of 7z.dll.
- LibUsbDotNet from official source instead of copied wholesale.
- GitHub forks of ProgressODoom instead of copied wholesale.
- Added Shounen Jump games list.
- Kernel flashing should now work properly on Shounen Jump systems (no ramdisk).
Show in explorer
andDelete
options are added toModules selector
.- Allow
reinstalling
modules. - Games cache doesn't rely on hardcoded lists anymore.
- New option:
Always copy original games
, when enabled, only cached original games are allowed, and when exporting/syncing, they are copied instead of linked. - Autoplay/pixelart folders should now be copied and linked properly on linked sync.
- When
Separate for multiboot
is unchecked, user is locked into connected console type. - Reload games after selecting new cores in Core selector.
- Reload games after updating original games cache.
- Restrict alphanumerical characters in
Add custom app
dialog, also fixes an exception. - Software should function normally (not crash) even with a custom hakchi image with no original games.
- New option:
Separate local games storage
, which when unchecked, stores all games in the same/games
folder, instead of splitted in/games
and/games_snes
. - New option:
Convert SNES ROMS to SFROM
, allows controlling whether or not hakchi2 CE will convert added SNES games to SFROM or not. - New option:
Add games as is
inFiles
menu. This option skips file content detection on compressed games. - New option:
Tools > Switch running firmware
, allows switching currently running firmware on your NES/SNES mini. Clovershell
is now officially outdated. When hakchi2 CE connects to your NES/SNES mini using Clovershell protocol, emulated FTP and synchronization are disabled.- Increased waiting period when rebooting.
- Fix uboot flashing.
- Prevent reloading recovery image when already in recovery mode.
- Internal changes to allow compiling on Mono (still not 100% functioning, but compiles).
- Add
German
translation. - Modstore: fix refresh functionality.
- Modstore: add alphabetical sorting.
- Add
Rock'n'roll Racing
andTetris & Dr.Mario
ips patches. - Update to libretro *.info files, using TheOtherGuys official Retroarch repository.
FAQ / Common Issues
Q: After rebooting, I get a dialog saying my NES/SNES Mini is taking a long time to reboot and it never comes back online.
A: There are many possible reasons for this, but here are a few common causes:
- Drivers may not be installing correctly. You can either try manually installing the driver located in
hakchi2_CE/driver
namedNintendo_Classic_USB_Driver.exe
, or if this does not work, you can also try an open-source utility calledZadig
. You can download it at this address: https://zadig.akeo.ie/ . - Sometimes, Windows' Firewall may be blocking the connection. Make sure to
Accept
incoming/outgoing connections when running hakchi2 CE. Windows should advise you of which program is requesting access. Only accept for hakchi2 CE. You can also, for debugging purposes, try to disable it and see if it works. Do not leave your system without a firewall afterwards though, this is there for a reason. - A device may be confusing hakchi2 CE or your NES/SNES mini on the network, like a games console on your network, or other devices. If possible, you can try disabling your ethernet or wifi connection to see if it helps, as a temporary measure, of course.
Q: My NES/SNES Mini is in Recovery mode
, I can't do anything, what is that?
A: This mode is when your console does not boot completely, or if you've attempted a kernel operation that might have failed. It will also happen if you select Kernel > Advanced > Boot recovery kernel from RAM
of course. To get out of this mode, if you don't know how to use the shell, is to click Tools > Reboot
or, if this does not work, turn off the NES/SNES Mini power switch, and unplug its USB power cable manually.
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:...
hakchi2 CE v1.2.5
hakchi2 CE v1.2.5
This is v1.2.5 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.
DISCLAIMER
hakchi2 CE by @TeamShinkansen and hakchi scripts from @madmonkey1907 have always been experimental software: while we strive to offer a risk-free experience, unpredictable things can happen, so
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. It is functionally equivalent to running uninstall and install back to back, without useless flashing. -
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 itemKernel > Install/Repair
. This should create an internal backup on the NES/SNES mini, and you should not be prompted for a kernel dump 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!
Bugfixes / Improvements
- Fixed
MD5 checksum failed
errors when installing hakchi custom kernel - Fixed console settings being reset when installing hmods
- Always upload up-to-date hakchi boot image when doing kernel operations (fixes upgrading issues)
- Fixed some confusing messages left behind from older kernel flashing methods
- Tentative fix to console being impossible to detect after rebooting
Known issue with v1.2.5
- There is an issue with multi-boot. Use this hmod to fix it for this release :
sntool.zip
hakchi2 CE v1.2.4 (Easy as 1.2...4)
hakchi2 CE v1.2.4 (Easy as 1.2...4)
This is v1.2.4 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.
DISCLAIMER
hakchi2 CE by @TeamShinkansen and hakchi scripts from @madmonkey1907 have always been experimental software: while we strive to offer a risk-free experience, unpredictable things can happen, so
USE AT YOUR OWN RISK!
Additions
Scripts update
andKernel > Install/Repair
should finally work properly for bothclovershell
andssh
shells!- more consistent and more safety dialogs to advise user when the NES/SNES Mini is in
recovery mode
- better chances of network mode working properly
- shell type indicator in the main app status bar
Bugfixes / Improvements
- current hakchi scripts version is now queried directly from installed hmod
- screenshots not always working when emulator is running
- fewer unrelated error messages during disconnects/reconnects
- custom_backgrounds.hmod was not working if directory was not created beforehand
- fixed typo in ftp address in
Tools > Open FTP client
- fixed wrong filenames generated in local
.desktop
files (did not affect syncing/exporting) - better resizing of the Technical Information dialog
- much improved shell environment setup for
clovershell
- fixed a long standing bug that didn't really show up, but would keep spamming threads while running after changing language
- many smaller fixes and tweaks
hakchi2 CE v1.2.3
hakchi2 CE v1.2.3
This is v1.2.3 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.
DISCLAIMER
hakchi2 CE by @TeamShinkansen and hakchi scripts from @madmonkey1907 have always been experimental software: USE AT YOUR OWN RISK!
Additions
- new user-friendly dialog when waiting for the NES/SNES Mini to reboot
- new message of the day dialog that prompts important information that can be updated anytime (only show once per message, no nagging)
- new technical information dialog accessible through
Help > Technical information
- new upload dialog with
speed
,estimated time remaining
andfilename
display - split upload and export tasks in smaller sub-tasks (smoother progress and generally safer approach)
- updated hakchi scripts
- major revision
- improvements for
network mode
compatibility - built-in recovery functions (faster installs)
- add clovershell fallback options for compatibility reasons
- safer dump/flash advanced operations
- smarter exception/errors dialogs (might help debugging). most information that was previously only available in debug build should be available in release build (through the technical information dialog and when encountering errors)
- reinstated
dump original kernel (legacy)
inKernel > Advanced
menu. this is only useful to go back to previous versions, but it has been restored for backwards compatibility - network mode detection should be a bit faster with this release
Bugfixes
- fixed missing icon (and C8 on mini) when using non-standard names for games (i.e.
CLV-Z-DOOM_HAKCHI
) - fixed update failing (
write error
) when clickingyes
on update prompt - increased timeouts on stats reading from the mini when calculating free/used space (MemoryStats)
- fixed double log display on
Memboot custom kernel
- improved
memboot
(kernel operations, updates, etc.) process - fixed improper resizing of folder images (was forcing
204x204
even on snes games collections), now228x204
for snes games collections - reorder main update tasks to avoid race conditions that sometimes made title bar to display
update required
when it was not the case (might fix other issues as well) - fixed small bug in new
custom backgrounds
hmod - fixed
external saves
detection when usingcustom backgrounds
hmod - more error detection and display
- hopefully less issues with autoupdater as it won't cause elevation anymore. if you have issues with it, either reinstall from scratch, or use portable mode, this should work better. also allows dismissing the dialog for a week when not wanting to update right away
hakchi2 CE v1.2.2
hakchi2 CE v1.2.2
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.
DISCLAIMER
hakchi2 CE by @TeamShinkansen and hakchi scripts from @madmonkey1907 have always been experimental software: USE AT YOUR OWN RISK!
Additions
- Custom backgrounds HMOD
Bugfixes
- 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
hakchi2 CE v1.2.1
hakchi2 CE v1.2.1
This is v1.2.0 of hakchi2 CE. This release once again brings a lot of new features, 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.
DISCLAIMER
hakchi2 CE by @TeamShinkansen and hakchi scripts from @madmonkey1907 have always been experimental software: USE AT YOUR OWN RISK!
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
ornetwork 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
andusa
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
Bugfixes
- 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 1280x720 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)
hakchi2 CE v1.1.0
hakchi2 CE v1.1.0
This is v1.1.0 of hakchi2 CE. This release brings a lot of new features, in addition to some bugfixes. 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.
Under the hood improvements
- Significantly reduce the amount of data being copied to the temp folder during game sync
- If you are not using Game Genie codes, your temp folder will now likely be a few hundred KB instead of a whole copy of your collection
- Differential game syncs for NAND/SD users
- If you are changing only a handful of games, only those games that were changed since your last sync get transferred during sync, rather than wiping your whole collection and re-uploading it
- Revamped HMOD install process
- Installing and uninstalling HMODs no longer requires your console to be in FEL mode. Just power it on like normal and connect it to your PC, then select the mod installation option
- The mod management windows are now formatted more nicely and showcase information such as mod author and category
- Support for flashing both SD and stock uboot
- SD users no longer need to use hakchi1 for uboot flashing
- Default to SD uboot.bin when membooting
- Fix for FTP server reporting 500 error when trying to list files in a directory
- Now if there is a file called
nonportable.flag
in the hakchi2 installation directory, it will run in nonportable mode (/nonportable
also still works) - Manual reboots after kernel flashes are no longer required
- The generated kernel.img is smaller, which may fix issues with flashing the custom kernel users had on previous versions
- Added a new web installer in addition to our other distribution methods
UI Improvements
- Integration with SFROM Tool (thanks /u/darkakuma)
- In the menu (only for SNES/SFC Mini users), select
Settings > SFROM Tool > Enable
and follow the on-screen instructions
- In the menu (only for SNES/SFC Mini users), select
- Boot splash screen options
- Choose a custom splash screen, restore the default, or disable it entirely
- Added an option to re-install the hakchi scripts to the console without requiring an
Uninstall
followed byFlash custom kernel
- New
Export games
dialog- The dialog ensures that you're exporting to a valid
/hakchi/games
directory on a drive - If you have multiboot game separation enabled and are on a US or EUR system, the dialog prompts you to select one (JPN systems are auto-detected)
- The dialog ensures that you're exporting to a valid
- Added the ability to edit the sort name and save count for any specific game
- Widened the window to allow for full size cover art display
- Added a setting to enable game thumbnails to be centered, rather than bottom-aligned (disabled by default)
- Custom thumbnails smaller than 40x40 will no longer be upscaled
- Reset Google Image search back to previous keywords
- Clean up built-in folder images
- New icon set
- Folders manager UI was tweaked
Sort by App
added- Games sent to
Recycle Bin
will not sync anymore
- Original games can no longer be deleted
- Fix for default games not checking up in some cases
- Fix the issue with boxarts containing transparency losing the transparency after import
- Better boxart scaling (higher quality)
- Re-arranged UI elements to have a better arrangement
FAQ / Common Issues
Q: On app start, I receive an error about System.NotSupportedException: The requested security protocol is not supported.
A: 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: 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 provided by @KMFDManic. _km_retroarch_170_1_29_18.hmod
in his core set is known to be working, but any version newer than that is likely to work as well.
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. We are hoping to replace Clovershell in the near future with a more robust solution.
Q: Which filesystems 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.