User Tools

Site Tools


project:homebrew:wsbootfriend:witch

BootFriend Installation (WonderWitch program)

  1. Create a BootFriend splash screen on https://wonderful.asie.pl/ws/bootfriend/. When done configuring, select Download bootfriend-inst.fx (WonderWitch program)
    • It is not necessary to change any configuration details; the default blank splash screen is sufficient.
  2. Transfer bootfriend-inst.fx to your WonderWitch.
    • If your computer has issues running TransMagic, you can alternatively use XMODEM serial transfer.
  3. Start the BootFriend installer program. Make sure the status bar at the top says EEP unlocked.
  4. Optional: If you have a custom splash screen installed, you may use the Backup IEEPROM options to copy the existing splash screen to cartridge SRAM or through XMODEM serial transfer to a file on your PC.
  5. Select Install BootFriend and follow the on-screen instructions.
  6. If successful, the right-hand side of the status bar at the top should now display BF v.??, with ?? being the version number.
  7. Turn off the console. BootFriend should now be installed - you can verify this by turning the console on with a different cartridge while holding Y3.

Troubleshooting

  • To uninstall BootFriend, use the Disable BootFriend option.
  • The console will not turn on at all if no cartridge is present in the cartridge slot.
  • The Test BootFriend option may be used to test loading .bfb programs without installing BootFriend - naturally, these programs won't have access to console functionality only available during boot ROM execution.
project/homebrew/wsbootfriend/witch.txt · Last modified: 2024/03/29 18:16 by asie