Hacking WiiFlow Lite

  • Thread starter Thread starter fledge68
  • Start date Start date
  • Views Views 1,030,769
  • Replies Replies 4,832
  • Likes Likes 66
Hello. Can someone explain to me how the plugings system works and if what I have in mind is possible or not?
I haven't used WiiFlow before and it seems I'm very late to the party. I use USB Loader GX and standalone apps until now with a custom Homebrew Channel theme; all well organized and suited to my likings. Recently I've been updating my Wii setup and many things have changed. I wanted to give Wiiflow a try and use it as a frontend from which select the game and forget about choosing the better app or configuration because that was done beforehand. After all was ready and set, I also wanted to make a custom theme and probably organize things in a different way.

I downloaded the latest Wiiflow Lite (v5.6.1 December 22nd, 2025), Rhapsodii Shima 5.5.4 (16:9 version) theme and the WiiFlow Plugins Pack Complete (Updated May 30, 2025). I'm running Wiiflow from the SD.

Wii and Gamecube games work fine. EmuNAND probably too, but I haven't tested it. It's the plugins where I'm totally lost.

First I thought I could edit the ini files and link the source menu buttons to my existing apps and avoid duplicated *.dol. But I haven't found how to do it. It seems I have to stick to what the Plugins Pack delivers.

So I tried Nintendo 64 and it said "No plugins found" or something like that. Pressing the home menu on the N64 icon and searching for the plugin didn't work. When I chose 'Nintendo 64', Wiiflow freezed and I had to shut down the console manually. I took a look in the ini files and saw that the magic number didn't match. So I set everything to the Wii64 magic number 57493634. Then it worked.
The question is, if everything is related to the same Wii64 magic number. Do I have to create a separated button to use wii64_rice and not64? That kind of defeats the purpouse of using Wiiflow as a frontend instead of standalone applications.

I also downlodad a few covers from the Cover Collections—part 2 thread and stored them in the HDD. I had to change the path for them to show. And they short of do. The problem is that the texture doesn't wrap around the box and the full texture displays in the "front cover face" and leaves all the other faces in black. Furthermore, it isn't the right box format. Instead of the N64 thick horizontal box is the tipical DVD case. How can I fix that? Have I broken something while editing the ini files?

It's getting very frustrating not knowing how the folder structure should be, what do the different files do, what data and files do they expect, what options do I have, trying things blindly and not knowing if that's the expected behaviour or it's broken. I can't find any guide or instructions. I have read several pages of the threads but I couldn't find any tutorial. I tried youtube but everything is from many years ago and doesn't match what the Plugins Pack has.


So what I specifically want to know is:
1. Can I use custom paths for the apps or should I use the plugins pack .dol and have duplicates?
If it's customizable, what files do I have to edit and how?
2. Can I use custom paths for the roms/isos/games? Is it possible to have the dol in the SD card and the games in the HDD or should they be in the same device?
If it's customizable, what files do I have to edit and how?
3. What about the save files?
4. Taking N64 as an example... I navigate through Wiiflow -> source menu -> Consoles -> Nintendo 64 -> boxes of games... Can I set it so some games run with Not64, others with Wii64 and others with Wii64_rice? If not, is there any alternative?
5. Let's say I don't like the box proportions and how the current covers look and want to make my own. What files do I need to change?

Sorry for the long post.
so if you look in the wiiflow plugins folder you should find a N64 folder. inside it should be three plugin ini files - not64.ini, wii64.ini, and wii64_rice.ini. here they are:

[PLUGIN]
arguments=rompath = "{device}:/{path}/{name}"|SkipMenu = 1
bannersound=ZZ--Sounds/N64.ogg
consolecoverid=Nintendo
covercolor=000000
coverfolder=Nintendo/N64
displayname=Nintendo N64 (Not64)
dolfile=N64/not64.dol
filetypes=.n64|.v64|.z64|.zip
magic=4E4F3634
romdir=not64/roms
rompartition=-1
********************************************

[PLUGIN]
arguments={device}:/{path}/|{name}
bannersound=ZZ--Sounds/N64.ogg
consolecoverid=Nintendo
covercolor=000000
coverfolder=Nintendo/N64
displayname=Nintendo N64 (Wii64 glN64)
dolfile=N64/wii64.dol
filetypes=.n64|.v64|.z64|.zip
magic=57493634
romdir=wii64/roms
rompartition=-1
**********************************************

arguments={device}:/{path}/|{name}
bannersound=ZZ--Sounds/N64.ogg
consolecoverid=Nintendo
covercolor=000000
coverfolder=Nintendo/N64
displayname=Nintendo N64 (Wii64 Rice)
dolfile=N64/wii64_rice.dol
filetypes=.n64|.v64|.z64|.zip
magic=57523634
romdir=wii64/roms
rompartition=-1

they all have different dol files and different magic numbers. they should also all have different romdir.
romdir is the folder where the roms go (without the device SD or USB)

if you want to use all 3 because some games work with wii64, some with wi64 rice, and some with not64. if this is the case then you should have a different romdir for each one and put the proper games in the proper rom folders.

now you can have source menu button for N64 with magic=4E4F3634, 57493634, 57523634
when you click on the n64 source button all your n64 games will show without duplicates. and when you click a game to start it the game will start with proper emu (not64, wii64, or wii64 rice)

hope this helps
 
Ok it's been a while not posting here due to lost account by faulty email.

I get back my 29" Trinitron from a friend for a retro game room :wub:, start collecting, with original consoles (super famicom, pal ps1, sega saturn jap, and jap gamecube switched) and games.
And the mighty hacked wii (I was on vwii before), to not be frustrated to not have all the expensive stuff...

Since the Wii is the cornerstone of my setup, I try to have a nice setup, with for now 16GB SD + 500GB usb HDD

One of my question Is why the boxcovers can't be recognized on the HDD, on plugins ? With NGC and Wii it's ok.

Does I need to edit manualy sd:/wiiflow/plugins/SNES for exemple like :
coverfolder=Nintendo/SNES to
coverfolder=usb:/wiiflow/boxcovers/SNES where they are ?

Automatic within wiiflow do nothing

Wiiflow lite version =
Theme lite =
 
Last edited by jul16ares,
  • Like
Reactions: impeeza
Ok it's been a while not posting here due to lost account by faulty email.

I get back my 29" Trinitron from a friend for a retro game room :wub:, start collecting, with original consoles (super famicom, pal ps1, sega saturn jap, and jap gamecube switched) and games.
And the mighty hacked wii (I was on vwii before), to not be frustrated to not have all the expensive stuff...

Since the Wii is the cornerstone of my setup, I try to have a nice setup, with for now 16GB SD + 500GB usb HDD

One of my question Is why the boxcovers can't be recognized on the HDD, on plugins ? With NGC and Wii it's ok.

Does I need to edit manualy sd:/wiiflow/plugins/SNES for exemple like :
coverfolder=Nintendo/SNES to
coverfolder=usb:/wiiflow/boxcovers/SNES where they are ?

Automatic within wiiflow do nothing

Wiiflow lite version =
Theme lite =
all covers (wii, gc, plugins) have to be on the same device (sd or usb1). you can't have wii covers on SD and plugin covers on USB.

in a plugin ini file coverfolder is just subfolders of the main box covers or flat covers paths.
so if the main path is:
sd:/wiiflow/boxcovers/

and the plugin ini coverfolder = nintendo/snes

your full box covers for snes need to be in:

sd:/wiiflow/boxcovers/nintendo/snes

you can change the path of boxcovers and flat covers by going into main settings>set paths. but if you do it changes the path for all game types and covers.
 
Hi @fledge68

I hope you could me help with navigation in the settings:

Pressing the "Zurück" (Back) button does nothing. Only 'B' on WiiMote returns to the upper level.
Is this a problem with WFL or the Rhapsodii Shima theme?

2026-04-10-20-17-37-335.cleaned.jpg
 
  • Like
Reactions: impeeza
  • Like
Reactions: fatherjack
@fledge68 ~ just noticed it’s 10 years (and 2 days) since you started this thread and still providing support.
I’d just like to say a MASSIVE THANX for your contribution mate - it’s people like you that make ‘temp what it is
(probably broke rools posting off-topic but it needed to be said)
:)
 
https://github.com/Fledge68/WiiFlow_Lite/issues/432

i've only committed the fix locally. when i'm ready to i will push them all at once and release a new version. basically the same thing blackb0x does.

i added this at line #414 of menu_config_gc_game.cpp

if(m_btnMgr.selected(m_gameSettingsBtnBack))
break;
 
Hi guys,
I'm trying to set up a plugin in WiiFlow to launch M3U playlists using MPlayer-CE, but I'm stuck. When I click on the .m3u file, WiiFlow successfully opens the player, but instead of playing the content, it just crashes and returns me to the WiiFlow menu.
I suspect my plugin's .ini configuration or the M3U structure might be wrong. Could someone share the correct plugin arguments for MPlayer-CE to recognize the playlist path? Also, does the M3U need to use absolute paths (sd:/video/...) or relative ones?
Any help with the correct plugin structure would be greatly appreciated. Thanks!
 
Last edited by Maralrero0511,
  • Like
Reactions: impeeza
if homebrew coverflow is set to smallbox it will use the icon.png in the apps folder. if you turn off smallbox it will use cover images from dev:/wiiflow/boxcovers/homebrew. these covers are just like the wii and gamecube covers. in fact some of them can be downloaded via gametdb.com.

go into main settings>homebrew settings to change smallbox
 

Attachments

  • home.png
    home.png
    93.1 KB · Views: 9
  • COLECOVISION.png
    COLECOVISION.png
    373 KB · Views: 11
  • tier1.png
    tier1.png
    201.8 KB · Views: 8
  • Nintendo.png
    Nintendo.png
    113.5 KB · Views: 6
  • MS-DOS.png
    MS-DOS.png
    148.3 KB · Views: 8
  • tier-comp.png
    tier-comp.png
    329.1 KB · Views: 7
Hey guys, I'm can't get my Wiistation 3.2 to run properly from WiiflowLite. 🥲

When i'm booting a ps1 game from the wiiflow menu, the game will booting, but the wiimotes won't get recognised,
even after a clean reinstall and multiple config attempts.

My problem in bullet points:
  • Emulator boots and games start normally
  • No controller input works in-game when i boot from wiiflow lite
  • Only Power button works
  • I'm using the vWii (Wii U)
  • Wii Remotes work perfectly in Homebrew Channel and Wii menu -> so it’s NOT a sync or hardware issue
What I tried:
  • Forced WPAD to Port 1 (PadAssign1 = 1)
  • Disabled AutoAssign
  • Set PadType1 = 0 (standard controller)

Has anyone a confirmed working WiiStation version on vWii with proper Wii Remote via Wiiflow input?
Any known working config or build would help. 🙏
 
  • Like
Reactions: impeeza
I had a similar issue where the controls stopped responding. Unplugging the wii controller from the Wiimote fixed it for me—have you given that a try yet?
 
  • Like
Reactions: impeeza
I had a similar issue where the controls stopped responding. Unplugging the wii controller from the Wiimote fixed it for me—have you given that a try yet?
Thanks for the quick respond!

I've really tried everything—except plugging in a GameCube controller.

And probably every possible combination of Wiistation settings, which I've always changed in Wiistation via the HBC.
 
  • Like
Reactions: impeeza
Thanks for the quick respond!

I've really tried everything—except plugging in a GameCube controller.

And probably every possible combination of Wiistation settings, which I've always changed in Wiistation via the HBC.
WiiStation input through WFL has been hit/miss throughout. RX input worked well but after updates did not and same goes for the WiiStation releases.

I tinkered with this many hours in the past to find the culprit, wether using as standalone and through WFL was causing the issue. I never got concrete evidence in my testings.

I do know removing cfg files from previous installations is supposed to help with input issues but again, my testings never proved this. I still had the same issues with WiiStation/RX input you are experiencing.

I myself have never used Wii for PS1 emulation for long periods to truly know if input is working correct. What you are using currently (3.2) has not been included in the plugins pack for quite a long time.

In my testings, the included WiiStation plugins (4.5 beta) have no issues with input. Please remove your settings/cfg files and install either of the 2 provided in the plugins pack. Hopefully this will fix issues you have.
 
I've updated WiiSX to support WiiFlow, please let me know if I need any further changes to support it. I've not used WiiFlow before so apologies if my example plugin .ini is incorrect. Link here to a comment/build: https://github.com/emukidid/pcsxgc/pull/32#issuecomment-4363369745

If all is well I'll publish a new release shortly!
 
I've updated WiiSX to support WiiFlow, please let me know if I need any further changes to support it. I've not used WiiFlow before so apologies if my example plugin .ini is incorrect. Link here to a comment/build: https://github.com/emukidid/pcsxgc/pull/32#issuecomment-4363369745

If all is well I'll publish a new release shortly!

I've admired your work for years -- nearly a decade. I've always been impressed and loved your "hi-res texture packer" and used it on wiiflow especially with textures packs for starfox, banjo, OOT, and sm64 which all have some really cool community made textures out there. The one big problem though is it can only load one graphic pack at a time -- i.e. only a file called "texture.pak" can be loaded from the singular location where it exists. For example, if I want to use it on banjo I have to take my texture packed banjo file, name it "texture.pak" and put it onto my sd card in the correct location. Then later, if I want to use the texture packs for mario, I have to pull out my sd card, and rename the mario texture pack to "texture.pak" and then load the game (since only one file named "texture.pak" can exist in that hardcoded SD location at a time.)

I wondered if there was a way for your Wii64 Rice (Hi-Res pack enabled test build) to be compatible with a couple different texture.pak files in the same location (banjo.pak, mario.pak or even texturepak1.pak, texturepak2.pak etc)?
 
  • Like
Reactions: impeeza
I've updated WiiSX to support WiiFlow, please let me know if I need any further changes to support it. I've not used WiiFlow before so apologies if my example plugin .ini is incorrect. Link here to a comment/build: https://github.com/emukidid/pcsxgc/pull/32#issuecomment-4363369745

If all is well I'll publish a new release shortly!
I tested this release with your cfg and yes It is auto booting through WiiFlow Lite but I have not been able to get input working this way.

Launching through hbc works and allows input cfg to be set correct and playable but the input cfg does not work through WFL. :(

I am happy to test more if any changes are made in the future.
 

Site & Scene News

Popular threads in this forum