WiiFlow Lite: Difference between revisions

From GameBrew
No edit summary
 
(37 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{#seo:
|title=Wii Homebrew Apps (File browsers) - GameBrew
|title_mode=append
|image=wiiflowlitewii.jpg
|image_alt=WiiFlow Lite
}}
{{Infobox Wii Homebrews
{{Infobox Wii Homebrews
|title=WiiFlow Lite
|title=WiiFlow Lite
|image=wiiflowlitewii.jpg
|image=wiiflowlite2.png
|description=WiiFlow is a app for loading backup games from a USB Device or SD card.
|description=Load backup games from a USB device or SD card.
|author=Fix94/Fledge68
|author=Fledge68
|lastupdated=2022/03/23
|lastupdated=2024/04/09
|type=File browsers
|type=Title Launchers
|version=5.5.3
|version=5.5.4-1
|license=Mixed
|license=Mixed
|download=https://dlhb.gamebrew.org/wiihomebrews/wiiflowlitewii.7z
|download=https://dlhb.gamebrew.org/wiihomebrews/wiiflowlite.7z
|website=https://sites.google.com/site/wiiflowiki4/
|website=https://gbatemp.net/threads/wiiflow-lite.422685/
|source=https://github.com/Fledge68/WiiFlow_Lite
|source=https://github.com/Fledge68/WiiFlow_Lite
}}
}}
WiiFlow Lite is a modification of the popular homebrew app [[WiiFlow]] for the Nintendo Wii and Wii U. WiiFlow allows users to boot games from a USB device or SD card, making it a convenient way to play a large collection of games without the need for physical media. It works on both the Wii and Wii U in Wii mode.


WiiFlow is a homebrew USB loader for the Nintendo Wii video game console and the Wii-U video game console in Wii Menu mode.  It displays your games and apps in full 3D box coverflow display and is capable of launching Wii and WiiWare/VC games, homebrew titles, and GameCube games through the use of Nintendont or Devolution. Plus with WiiFlows intuitive plugin system you can launch and play several classic retro games via their respective homebrew emulator. Watching videos and listening to music is even possible via this plugin system. WiiFlow also supports using Emu NANDs for your WiiWare/VC titles and is capable of launching them via Neek2o if needed.
This modification aims to improve upon the original WiiFlow and add new features and enhancements, while still maintaining its user-friendly interface and ease of use.


'''What is WiiFlow Lite?'''
==Installation==
As of v5.2.0 WiiFlow Lite will simply be a replacement for WiiFlow. For previous WiiFlow Lite users, you must uninstall your WiiFlow Lite forwarder and replace it with a WiiFlow forwarder.


This is my mod or continuation of WiiFlow. WiiFlow is a Nintendo Wii homebrew app for booting games from a USB Device or SD card. It will also work on a Wii U in Wii mode.
The following setup guide is based on [https://wii.guide/wiiflow.html this tutorial.]


As of v5.2.0 I changed the name back to WiiFlow to make things less complicated, But kept the WiiFlow Lite name on Github.
Requirements:
* A Wii with [https://wii.hacks.guide/cios cIOS] installed.
* A USB drive and/or SD card.
* WiiFlow Lite.


==Features==
Preparations:
'''Old Features from WiiFlow'''
*Copy your games over with [[Wii Backup Manager]] (Windows), [[Witgui Wii|Witgui]] (macOS), or [[Wii Backup Fusion]] (Windows/macOS/Linux).
* A full 3d box, front to back coverflow interface
*If you want to play games that are in NKit format, use [[NKit Wii|this program]] to convert them to ISO first. You can also use a development build of Dolphin, right click on a game, and use "Convert File" to convert it.
* Can Run via IOS58 with AHBProt disabled via the forwarder channel or HBC 1.08+ but cIOS is still needed to launch Wii and NAND games
*If you are not copying games using Wii Backup Manager, Witgui, or Wii Backup Fusion, make a folder on the root of the USB drive or SD card named "wbfs" and put the games in there.
* Compatible with hermes, waninkoko, and d2x cios, but d2x is highly recommended
* Launch Wii games from SD or USB HDD formatted to FAT32, NTFS, EXT2, and WBFS. FAT32 is recommended. Don't use WBFS.
* Launch GameCube games on SD or USB HDD via Nintendont or Devolution. Nintendont recommended.
* Launch Wii and Gamecube games via retail disc
* Launch Channels from real NAND or emu NAND
* Launch Homebrew titles
* Launch classic emu games and movie files via WiiFlow's plugin system
* Option to use Neek2o v90+ to launch emu NAND channels
* Extract Real NAND to emu NAND
* Wii savegame emulation via emu NAND
* Copy savegames from real NAND to emu NAND
* Flash savegames back to real NAND
* Plays included banner animations for Wii, Gamecube, and NAND titles
* Can play custom made banners for GameCube and Plugin titles
* Banner animations can be full screen or mini banner preview
* Download covers via GameTDB
* Options to select cover types and countries for downloading
* Background music with sub folder support
* Optional  THP game trailer's video player on selected game menu
* Custom titles and cover spine color support
* Theme support
* Multiple languages
* Help Guide built in
* Sort and Categorize games
* Mark games as Favorites even for plugins
* Parental lock to block config menu access and access to games set as blocked
* Download and use Cheat Codes for Wii, GameCube, and NAND titles
* Wiinner Tag and DU Tag support
* Optional Source Menu for choosing which covers to view


==Installing==
About USB drive/SD card:
As of v5.2.0 WiiFlow Lite will simply be a replacement for WiiFlow. Put it in apps/wiiflow and use wiiflow forwarder's to launch it via the wii system menu. forwarders can be found on wiiflowiki4. for previous wiiflow lite users, sorry but you must uninstall your wiiflow lite forwarder and replace it with a wiiflow forwarder.
*To play games, it is recommended using an external hard drive for your Wii. Flash drives should be usable too, but external hard drives are recommended as they are more reliable, and can store more games.
*Unlike [[USB Loader GX Wii|USB Loader GX]], WiiFlow can load games of an SD card.
*Make sure your USB drive and/or SD card is formatted as FAT32 or NTFS. Do not format it as other types such as exFAT, extFS, or WBFS, the latter is an old format of storing Wii games.


Simply download the latest release and extract it to your apps/wiiflow folder on SD or USB HDD. SD is recommended. Your device should be formatted to FAT32.
How to setup:
*Extract WiiFlow and put the apps and WiiFlow folders on your USB drive or SD card.
*Insert your USB drive, and SD card if you’re using one, into your Wii and launch WiiFlow from the Homebrew Channel.
*WiiFlow by default is set to only find games on the SD card. This can be changed by going in to settings, startup settings then turn off "Mount SD Only".
*You can toggle between viewing Wii games, GameCube games, Wii Channels, Plugins, Homebrew apps by clicking the button second to last button on the right.
*You can download game covers by going to "Settings" then "Download Covers and Banners".


==Booting==
If you have a previous older version:
To start WiiFlow Lite you will need the Homebrew Channel or a WiiFlow forwarder channel installed on your Wii or vWii system menu.
* Make a back up before extracting the new release, simply copy wiiflow_lite.ini to the same folder and rename it to wiiflow_lite_old.ini.
* If something doesn't work right with the new release simply download the old release and extract it over the new release. Then delete wiiflow_lite.ini and rename wiiflow_lite_old.ini back to wiiflow_lite.ini.


==Themes==
Channel Installer:
Currently only Rhapsodii and Rhapsodii Shima themes are compatible with WiiFlow Lite. Other older wiiflow themes need to be updated to work properly with WFL.
* You will also need to use [https://www.mediafire.com/file/odv5cp3d6hda1pu/WiiFlow_Channel_Installer_v1.1.zip/file WiiFlow_Channel_Installer_v1.1.zip] to install the WFL forwarder channel and a hidden channel. It will work for both Wii and Wii U.
* The forwarder channel is used to start WFL from the Wii or vWii menu and in WFL main settings you can set it as the 'Return To' channel for when you exit a Wii game.
* The hidden channel is used by GameCube launchers (Nintendont/Devolution), Homebrew apps, and plugin emu's to exit them and return to WFL.


Rhapsodii made by Hakaisha is a new theme designed for wiiflow lite. find it here - (https://gbatemp.net/threads/wiiflow-lite-theme-rhapsodii.511833/)
==User guide==
===Starting WiiFlow Lite===
You can start WFL via the HBC or install a forwarder channel to launch it directly from the Wii or vWii system menu.


Other wiiflow lite themes can be found on the wiki linked below. but they need to be updated to properly work with wiiflow lite.
If you are not happy with the forwarder channel installed by [https://www.mediafire.com/file/odv5cp3d6hda1pu/WiiFlow_Channel_Installer_v1.1.zip/file WiiFlow_Channel_Installer_v1.1.zip] you can find alternative ones on the old wiiflowiki 4 [https://sites.google.com/site/wiiflowiki4/forwarder-channels here]. Install them with a wad manager, they will overwrite the current one.


==Screenshots==
If you are using a Wii (not Wii U) with Priiloader you can set Priiloader to run [https://www.mediafire.com/file/tj13pbiab8whsgq/Priiloader-Forwader-Loader-DWFA.dol/file Priiloader-Forwader-Loader-DWFA.dol] which will auto start the WFL forwarder channel you have installed.
 
===Start Configurator===
When WFL runs you can go into main settings>startup settings to change some startup options like to use IOS58 or a CIOS and which CIOS to default to, the USB port for wiiflow to use, and if you want to use SD only. But sometimes WFL won't even start properly so you can't access this menu.
 
In this case use [[WiiFlow Start Configurator|Wiiflow_Start_Configurator.zip]]. Extract it to your device and run it via the HBC it will allow you to make changes to start WFL. Hopefully a change that will fix WFL startup.
 
===User Interface===
When WiiFlow detects games, they are displayed in flow view. When you click on a game you are given these options:
*Star - Adds game to favorites.
*Bookshelf - Adds the game to 1 of 6 categories of your choosing.
*Gears - Opens the settings menu for the specific game. Changing settings here will only effect the game you changed the settings for.
*X - Deletes the game from the USB drive or SD card
 
When you bring the cursor to the bottom of the screen while in flow view, there are 6 icons:
*Bookshelf - View the games that are sorted in the categories you chose.
*Star - View games you favorited.
*Gears - Opens WiiFlow Settings.
*Game Type - Toggles between different types of apps/games. The logo changes depending on what game type you have selected.
*Disc - Loads game that is in disc drive.
*House - Will open this menu. This menu can also be launched by pressing the home button.


==Media==
WF_menu:
<youtube>S5ZiSjBwKJQ</youtube>
*Help Guide - Shows all the controls you can use in WiiFlow.
*Reload Cache - Press this when WiiFlow is not detecting a new game on the USB drive or SD card.
*File Explorer - Allows you to boot games/apps from anywhere on your USB drive or SD card.
*Select Plugins - Allows you to select plugins.
*Credits - Shows the people who worked on WiiFlow.
*Shutdown - Allows you to either go into full shutdown, or Standby mode.
*Exit To - Lets you exit to Wii Menu, HBC, neek2o, Priiloader and Bootmii.
*Settings - Will open the WiiFlow Settings menu


==Known Issues==
===Diflicker Filter Options===
===Issue Downloading Covers===
As of v5.5.0 Blackb0x (Wiidev) added the option to turn off the deflicker filter of Wii and wiiware/vc games. GC games are handled by Nintendont's deflicker option.
WiiFlow has a issue when downloading covers. Mainly when downloading a large quantity. The problem is the cover 'png' images are downloaded and saved but some or all of them don't get converted to 'wfc' cache files that WiiFlow actually uses to display them on screen. The cause isn't totally known but it appears to be an issue with 'out of memory'. If it happens most likely you will need to exit wiiflow and reboot it.


This may also happen if you manually add a lot of covers for your emulator plugins when you boot WiiFlow and do 'reload cache'.
Only use this option if you have your Wii connected via component cables or HDMI and you are using Progressive Scan. The available choices are:
*Normal - Use this if you are not using Progressive Scan or just want to leave it alone.
*Off (safe) - Completely turns it off.
*Off (extended) - Completely turns it off.
*On (low) - Mostly off.
*On (medium) - Half off.
*On (high) - Barely off.


The easiest way to fix it is remove your SD card or USB device and connect it to your home PC. Download and use a program called WFC_conv by Wiimpathy. It's a Linux and Windows tool that will convert all the png images in a folder to wfc files for wiiflow.
Some games might not use the filter, so you won't always notice a difference with either the safe or extended settings.


Download it here - https://github.com/Wiimpathy/WFC_conv/releases/download/v0.1/WFC_conv_0-1.zip
The "global default" setting is in Main Settings page 14. In Game Settings if you set it to "default" then it will use this "global default" setting in Main Settings.


Extract it and follow these directions to use it.
[https://gbatemp.net/threads/possible-to-disable-the-wiis-de-flicker-filter.477163/ More info about deflicker filter.]
====What is WFC_converter====
WFC_converter is a command line tool to convert images to WiiFlow cache files. It scans all covers found in 'boxcovers' and saves the .wfc files in the cache folder. Only png are supported with the same constraints as in WiiFlow(max height < 1090 for example).


You may consult the log file 'log_cachecreate.txt' for any errors during the cache creation. Refer to the Return codes in pngu.h to see what the error number means.
===Themes===
====Usage:====
If you're not happy with the WFL GUI then you might want to try these themes. Note WiiFlow 4 themes need to be updated to properly work with WFL.
Note: in Windows you will need to open a command prompt. In Windows 10 go to the Windows folder with wfc_conv.exe and hold shift while right clicking in open area (not on a file). select Open Powershell window here. Now you can type the following commands.
* [https://gbatemp.net/threads/wiiflow-lite-theme-rhapsodii.511833/ Hakaisha's Rhapsodii theme].
‎<syntaxhighlight line>
* [https://gbatemp.net/threads/rhapsodii-shima-5-4.555062/ Tetsuo Shima's Rhapsodii Shima 5.4 theme and more].
wfc_conv.exe Path [-OPTION]
* [https://www.mediafire.com/file/5zit9z3oxl7fle7/Rhapsodii+Shima.ini/file New rhapsodii shima theme ini].


#Path#
===Game Covers===
WiiFlow can download covers for Wii, GC, and WiiWare/VC games via GameTDB.com. Note there is [https://github.com/Fledge68/WiiFlow_Lite/wiki/Known-Issues#issue-downloading-coversan issue sometimes].


The path to the WiiFlow folder containing your boxcovers.
Box covers for Emu Retro Games can be found and downloaded via these 2 threads.
*https://gbatemp.net/threads/cover-collections-for-emulators-with-cover-support.324714/
*https://gbatemp.net/threads/cover-collections-part-2.559649/


#OPTION#
===Plugin Downloads===
If you plan on using WFL for emu plugins these downloads will make WFL better. It's a work in progress for now.
*[https://gbatemp.net/threads/the-great-quest-for-wiiflow-plugins-tm-a-call-for-adventurers.563575/ WiiFlow Plugins Pack Thread].
*[https://www.mediafire.com/file/4blrpsqqn5g0bdu/Wiiflow_Database.7z/file Wiimpathy's plugin database files] for Titles, CRC's, and general game info of plugin rom games.
*[http://www.mediafire.com/file/6a563zva8c7weew/Wiiflow_Snapshots.7z/file Wiimpathy's packages of rom snapshots] for game info screen.
*[https://www.mediafire.com/file/xegmyb7uxid4nki/Wiiflow_CartDisk.7z/file Wiimpathy's packages of cart/disk images].
*[https://gbatemp.net/threads/wiiflow-lite-with-emulators-database.527613/ More snapshot and and cart/disk image by @RunningSnakes].


-uncompress : Don't compress textures. Not recommended, files are large. It's disabled by default in WiiFlow.
Locations:
* Plugins - Extract to dev:/wiiflow/plugins_data.
* Snapshots - Extract to dev:/wiiflow/snapshots.
* Cart/Disk images - Extract to dev:/wiiflow/cart_disk.


-wiicovers : Create cache files for Wii and GameCube covers.
===Useful links===
*[https://gbatemp.net/threads/wiiflow-lite.422685/ Support thread on GBAtemp].
*[https://github.com/Fledge68/WiiFlow_Lite/wiki WiiFlow Lite Official Wiki].
*[https://gbatemp.net/threads/wiiflow-lite.422685/post-9869026 Kirby's adventure Wii/Return to Dreamland Metafortress help].
*[https://sites.google.com/site/wiiflowiki4/home Old WiiFlow 4 wiki] (outdated but can still be helpful).
*[https://gbatemp.net/threads/wiiflow-lite.422685/page-76#post-8580238 Dosbox .conf and .map files collection for Wiiflow].


Examples :
==Screenshots==
https://dlhb.gamebrew.org/wiihomebrews/wiiflowlite3.png
https://dlhb.gamebrew.org/wiihomebrews/wiiflowlite9.png


wfc_conv.exe e:\WiiFlow
https://dlhb.gamebrew.org/wiihomebrews/wiiflowlite10.png
https://dlhb.gamebrew.org/wiihomebrews/wiiflowlite6.png


wfc_conv.exe e:\WiiFlow -wiicovers
https://dlhb.gamebrew.org/wiihomebrews/wiiflowlite7.png
‎</syntaxhighlight>
https://dlhb.gamebrew.org/wiihomebrews/wiiflowlite8.png


===Issue WiiFlow Won't Boot Up===
==Media==
For some users WiiFlow may show the splash screen and then exit or it may get stuck in endless wait animation.
'''Wiiflow Lite Full Tutorial (v5.4) ([https://www.youtube.com/watch?v=QGpWkkR0-_0 Daniel Matsyuk])'''<br>
<youtube>QGpWkkR0-_0</youtube>


This is most likely caused by your SD or USB device not working with the current cIOS or IOS 58. The next problem is WiiFlow uses a savegame on your wii just like all wii games do. This savegame contains settings for WiiFlow's boot up such as to use IOS 58 or a cIOS, which cIOS to use, and what port the USB device is attached to. WiiFlow makes this savegame on bootup if it's not found. It defaults to cIOS 249. It could be your device works better with IOS 58 or a different cIOS. Simply deleting this savegame does not solve this problem because it will just be recreated with the default of cIOS 249.
'''2TB Fully Loaded Wii Console setup with Wiiflow Lite ([https://www.youtube.com/watch?v=AvSjkoffrfk Planet Scanlines])'''<br>
<youtube>AvSjkoffrfk</youtube>


You need to use WiiFlow Start Configurator. A Wii app to edit this savegame by choosing to use IOS 58 or a different cIOS.
==Known issues==
https://github.com/Fledge68/WiiFlow_Lite/wiki/Known-Issues


Download here - https://www.mediafire.com/file/vdchnzz8nh587g1/Wiiflow_Start_Configurator.zip/file
==Changelog==
'''v5.5.4-1 2024/04/09'''
*Fix for 'auto' game IOS option. in v5.5.4 'auto' causes the game to use a d2x cios base 38 if you have it installed, which prevents game from booting. This fix prevents this from happening.
'''v5.5.4 2023/09/21'''
*GENERAL AND WII CHANGES:
**Added Kirby RTD/Adventure metafortress patch thanks to wiidev/blackb0x.
**Added "auto" cios selection based on the games' IOS and d2x cios installed. only works for d2x cios. if you wish to use a hermes cios you can still manually choose 222 - 225. note if more than one cios have the same base the higher slot will be chosen. (idea from usblgx but not copy and paste of code)
**Added framebuffer video width game option taken from usblgx. thanks to wiidev/blackb0x.
**Added fix for wii u users using WFL with IOS58 to ignore usb devices without an MBR or WBFS signature (a wii u formatted drive). thanks kcpants and wiidev/blackb0x.
**Added option to 'Reset game settings to defaults' for wii, emunand, and gamecube games.
**Moved emunand partition setting from partitions menu to emunand setup menu.
**Possible fix for GPT drives with partition types other than FAT (NTFS, EXT2).
**Fixed a few texts that wouldn't translate.
**Fix for Sam & Max and Back to the Future.
**Fixed sorting covers.
**B+PLUS to set sorting type (alphabet, playcount, lastplayed, players, and year. wifiplayers for wii games and game ID (1st letter) for VC games).
**B+up/down to next/prev sorted item.
**B on next/prev icons to next/prev sorted item.
**Added sorting by year released for all games including plugins if the database is used. requires 'Reload Cache'. issue #265
**Added option to init network on start (issue #335) but you have to manually edit wiiflow_lite.ini. there's no option in startup settings (yet). just add [GENERAL] async_network=yes and save it.
**Added the partition option to select SD and USB together for wii and gamecube. issue #325. BUT if you have the same game on both it will be shown twice. Adding a check to see if the game is already listed for every time a game is added i think will slow down the process.
**Made path to wiitdb.xml configurable. issue #327. Use Path Manager menu page 2.
**Fixed reload cache when both channel types is chosen.
**Moved SD only setting to wiiflow save file to possibly speed up wiiflow start up. note very first time will be slow and try to mount USB HDD because the SD only setting will need to be moved to the savefile. but afterwards will be fast again.
**Now compiled with devkitppc r42-1 and libogc 2.4.0.
*PLUGIN CHANGES:
**Fix for issue #318. favorites and adult_only in gameconfig1 and categories in categories_lite will now use the platform name and game ID if using the plugin database files. if either the platform name or game ID are not available we will still use old method of plugin magic and game title. With new method if old plugin magic and game title is found it will be converted to platform name and game ID. because of this it is recommended to backup gameconfig1 and categories_lite just in case you have issues with new WFL and need to go back to old WFL. Titlesdump.ini has also been updated to new method and will now include output of the filtered game list for plugins. Set [GENERAL] dump_list=yes before starting WFL. set it to 'no' when done dumping your lists.
**Added playcount and lastplayed for plugin games.
**Added a fix for in case the plugin filetypes line ends in a '|'
**Added plugin game setting to reload its cached cover in case you change the png for it. a work around for issue #322
**Added a date patch to make the wiituka plugin work.
**Added the use of GamesTDB for ScummVM titles to get localisation of the title. (eku)
**Updated internal default text for regex to hopefully work better. (chrondelta)
*GUI AND THEME CHANGES:
**Fixed error messages to wrap the text if too long.
**Added total games text to display every time you change favorites or categories. (eku)
**Fixed an issue with gui sound volume not sticking on next start.
**Fixed source menu buttons hiding/showing.
**Removed splash image on start up.
**Added parental lock for source menu editor.
**All settings menu's now use the same labels and buttons. the text is just changed. keeps theme ini smaller and easier to maintain. need updated rhapsodii shima theme ini.
**All checkbox menu's now use the same labels and checkboxes. again, keeps theme ini smaller and easier to maintain.
**All checkboxes use a single button and we just set the texture image based on it's state. before we had a button for each state - on, off, or other. and would just show only the state needed while hiding the others.


Run it via The Homebrew Channel, make your changes, exit it, and try to run WiiFlow again.
'''v5.5.3 2022/03/23'''
* Disable splash image and wait animation if direct launching a wii game (via wiiGSC).
* Added option to use nands not vwiinands when on wii u. set manually by changing [CHANNELS] use_vwiinands=no in wiiflow_lite.ini
* Fixed using hermes cios in the rare case you ever need to use it.
* Other minor code changes.


Note: vWii users may find more success with a cIOS of base 58 or 57.
'''v5.5.2 2022/02/07'''


==Changelogs==
external_booter.bin fixes that i missed when i changed the booter in v5.5.0 beta 12:
* Added missing *BI2 = 0x817E5480; to Disc_SetLowMem() for wii games.
* Added missing memcpy((void*)0x80001800, (void*)Disc_ID, 8); needed for debugger and ocarina cheats engine.
* Fixed Disc_SelectVMode() for channels in v5.5.1. (video mode based on Disc_ID[3])


main changes:
* Fixed default setting for savegame emulation back to OFF (0). v5.5.0 and v5.5.1 new clean install's would set it to FULL (2) which caused wii games to crash on boot up. if you have this issue you can simply go to main settings>nand emulation settings and set it to OFF.
* Reinstated Fix94's keep USB alive thread for IOS58 mode.
* Fixed reloading wiiflow after any changes on Startup Settings menu.
* Changed the order of functions for ShutdownBeforeExit() to possible fix any shutdown and gameboot issues.
* Changes to STexture::fromPNG() to hopefully clear up the out of mem issue when downloading and converting the cover png to a wfc cache file.


[https://github.com/Fledge68/WiiFlow_Lite/releases Click here for the complete changelogs.]


https://gbatemp.net/threads/wiiflow-lite.422685/
==External links==
* GitHub - https://github.com/Fledge68/WiiFlow_Lite/
* GBAtemp - https://gbatemp.net/threads/wiiflow-lite.422685/
* Backup Loaders comparison - https://wiki.gbatemp.net/wiki/USB_Loader_Releases ([https://gbatemp.net/threads/backup-loaders-comparison-chart.333364/ forum post])

Latest revision as of 04:54, 2 May 2024

WiiFlow Lite
Wiiflowlite2.png
General
AuthorFledge68
TypeTitle Launchers
Version5.5.4-1
LicenseMixed
Last Updated2024/04/09
Links
Download
Website
Source

WiiFlow Lite is a modification of the popular homebrew app WiiFlow for the Nintendo Wii and Wii U. WiiFlow allows users to boot games from a USB device or SD card, making it a convenient way to play a large collection of games without the need for physical media. It works on both the Wii and Wii U in Wii mode.

This modification aims to improve upon the original WiiFlow and add new features and enhancements, while still maintaining its user-friendly interface and ease of use.

Installation

As of v5.2.0 WiiFlow Lite will simply be a replacement for WiiFlow. For previous WiiFlow Lite users, you must uninstall your WiiFlow Lite forwarder and replace it with a WiiFlow forwarder.

The following setup guide is based on this tutorial.

Requirements:

  • A Wii with cIOS installed.
  • A USB drive and/or SD card.
  • WiiFlow Lite.

Preparations:

  • Copy your games over with Wii Backup Manager (Windows), Witgui (macOS), or Wii Backup Fusion (Windows/macOS/Linux).
  • If you want to play games that are in NKit format, use this program to convert them to ISO first. You can also use a development build of Dolphin, right click on a game, and use "Convert File" to convert it.
  • If you are not copying games using Wii Backup Manager, Witgui, or Wii Backup Fusion, make a folder on the root of the USB drive or SD card named "wbfs" and put the games in there.

About USB drive/SD card:

  • To play games, it is recommended using an external hard drive for your Wii. Flash drives should be usable too, but external hard drives are recommended as they are more reliable, and can store more games.
  • Unlike USB Loader GX, WiiFlow can load games of an SD card.
  • Make sure your USB drive and/or SD card is formatted as FAT32 or NTFS. Do not format it as other types such as exFAT, extFS, or WBFS, the latter is an old format of storing Wii games.

How to setup:

  • Extract WiiFlow and put the apps and WiiFlow folders on your USB drive or SD card.
  • Insert your USB drive, and SD card if you’re using one, into your Wii and launch WiiFlow from the Homebrew Channel.
  • WiiFlow by default is set to only find games on the SD card. This can be changed by going in to settings, startup settings then turn off "Mount SD Only".
  • You can toggle between viewing Wii games, GameCube games, Wii Channels, Plugins, Homebrew apps by clicking the button second to last button on the right.
  • You can download game covers by going to "Settings" then "Download Covers and Banners".

If you have a previous older version:

  • Make a back up before extracting the new release, simply copy wiiflow_lite.ini to the same folder and rename it to wiiflow_lite_old.ini.
  • If something doesn't work right with the new release simply download the old release and extract it over the new release. Then delete wiiflow_lite.ini and rename wiiflow_lite_old.ini back to wiiflow_lite.ini.

Channel Installer:

  • You will also need to use WiiFlow_Channel_Installer_v1.1.zip to install the WFL forwarder channel and a hidden channel. It will work for both Wii and Wii U.
  • The forwarder channel is used to start WFL from the Wii or vWii menu and in WFL main settings you can set it as the 'Return To' channel for when you exit a Wii game.
  • The hidden channel is used by GameCube launchers (Nintendont/Devolution), Homebrew apps, and plugin emu's to exit them and return to WFL.

User guide

Starting WiiFlow Lite

You can start WFL via the HBC or install a forwarder channel to launch it directly from the Wii or vWii system menu.

If you are not happy with the forwarder channel installed by WiiFlow_Channel_Installer_v1.1.zip you can find alternative ones on the old wiiflowiki 4 here. Install them with a wad manager, they will overwrite the current one.

If you are using a Wii (not Wii U) with Priiloader you can set Priiloader to run Priiloader-Forwader-Loader-DWFA.dol which will auto start the WFL forwarder channel you have installed.

Start Configurator

When WFL runs you can go into main settings>startup settings to change some startup options like to use IOS58 or a CIOS and which CIOS to default to, the USB port for wiiflow to use, and if you want to use SD only. But sometimes WFL won't even start properly so you can't access this menu.

In this case use Wiiflow_Start_Configurator.zip. Extract it to your device and run it via the HBC it will allow you to make changes to start WFL. Hopefully a change that will fix WFL startup.

User Interface

When WiiFlow detects games, they are displayed in flow view. When you click on a game you are given these options:

  • Star - Adds game to favorites.
  • Bookshelf - Adds the game to 1 of 6 categories of your choosing.
  • Gears - Opens the settings menu for the specific game. Changing settings here will only effect the game you changed the settings for.
  • X - Deletes the game from the USB drive or SD card

When you bring the cursor to the bottom of the screen while in flow view, there are 6 icons:

  • Bookshelf - View the games that are sorted in the categories you chose.
  • Star - View games you favorited.
  • Gears - Opens WiiFlow Settings.
  • Game Type - Toggles between different types of apps/games. The logo changes depending on what game type you have selected.
  • Disc - Loads game that is in disc drive.
  • House - Will open this menu. This menu can also be launched by pressing the home button.

WF_menu:

  • Help Guide - Shows all the controls you can use in WiiFlow.
  • Reload Cache - Press this when WiiFlow is not detecting a new game on the USB drive or SD card.
  • File Explorer - Allows you to boot games/apps from anywhere on your USB drive or SD card.
  • Select Plugins - Allows you to select plugins.
  • Credits - Shows the people who worked on WiiFlow.
  • Shutdown - Allows you to either go into full shutdown, or Standby mode.
  • Exit To - Lets you exit to Wii Menu, HBC, neek2o, Priiloader and Bootmii.
  • Settings - Will open the WiiFlow Settings menu

Diflicker Filter Options

As of v5.5.0 Blackb0x (Wiidev) added the option to turn off the deflicker filter of Wii and wiiware/vc games. GC games are handled by Nintendont's deflicker option.

Only use this option if you have your Wii connected via component cables or HDMI and you are using Progressive Scan. The available choices are:

  • Normal - Use this if you are not using Progressive Scan or just want to leave it alone.
  • Off (safe) - Completely turns it off.
  • Off (extended) - Completely turns it off.
  • On (low) - Mostly off.
  • On (medium) - Half off.
  • On (high) - Barely off.

Some games might not use the filter, so you won't always notice a difference with either the safe or extended settings.

The "global default" setting is in Main Settings page 14. In Game Settings if you set it to "default" then it will use this "global default" setting in Main Settings.

More info about deflicker filter.

Themes

If you're not happy with the WFL GUI then you might want to try these themes. Note WiiFlow 4 themes need to be updated to properly work with WFL.

Game Covers

WiiFlow can download covers for Wii, GC, and WiiWare/VC games via GameTDB.com. Note there is issue sometimes.

Box covers for Emu Retro Games can be found and downloaded via these 2 threads.

Plugin Downloads

If you plan on using WFL for emu plugins these downloads will make WFL better. It's a work in progress for now.

Locations:

  • Plugins - Extract to dev:/wiiflow/plugins_data.
  • Snapshots - Extract to dev:/wiiflow/snapshots.
  • Cart/Disk images - Extract to dev:/wiiflow/cart_disk.

Useful links

Screenshots

wiiflowlite3.pngwiiflowlite9.png

wiiflowlite10.pngwiiflowlite6.png

wiiflowlite7.pngwiiflowlite8.png

Media

Wiiflow Lite Full Tutorial (v5.4) (Daniel Matsyuk)

2TB Fully Loaded Wii Console setup with Wiiflow Lite (Planet Scanlines)

Known issues

https://github.com/Fledge68/WiiFlow_Lite/wiki/Known-Issues

Changelog

v5.5.4-1 2024/04/09

  • Fix for 'auto' game IOS option. in v5.5.4 'auto' causes the game to use a d2x cios base 38 if you have it installed, which prevents game from booting. This fix prevents this from happening.

v5.5.4 2023/09/21

  • GENERAL AND WII CHANGES:
    • Added Kirby RTD/Adventure metafortress patch thanks to wiidev/blackb0x.
    • Added "auto" cios selection based on the games' IOS and d2x cios installed. only works for d2x cios. if you wish to use a hermes cios you can still manually choose 222 - 225. note if more than one cios have the same base the higher slot will be chosen. (idea from usblgx but not copy and paste of code)
    • Added framebuffer video width game option taken from usblgx. thanks to wiidev/blackb0x.
    • Added fix for wii u users using WFL with IOS58 to ignore usb devices without an MBR or WBFS signature (a wii u formatted drive). thanks kcpants and wiidev/blackb0x.
    • Added option to 'Reset game settings to defaults' for wii, emunand, and gamecube games.
    • Moved emunand partition setting from partitions menu to emunand setup menu.
    • Possible fix for GPT drives with partition types other than FAT (NTFS, EXT2).
    • Fixed a few texts that wouldn't translate.
    • Fix for Sam & Max and Back to the Future.
    • Fixed sorting covers.
    • B+PLUS to set sorting type (alphabet, playcount, lastplayed, players, and year. wifiplayers for wii games and game ID (1st letter) for VC games).
    • B+up/down to next/prev sorted item.
    • B on next/prev icons to next/prev sorted item.
    • Added sorting by year released for all games including plugins if the database is used. requires 'Reload Cache'. issue #265
    • Added option to init network on start (issue #335) but you have to manually edit wiiflow_lite.ini. there's no option in startup settings (yet). just add [GENERAL] async_network=yes and save it.
    • Added the partition option to select SD and USB together for wii and gamecube. issue #325. BUT if you have the same game on both it will be shown twice. Adding a check to see if the game is already listed for every time a game is added i think will slow down the process.
    • Made path to wiitdb.xml configurable. issue #327. Use Path Manager menu page 2.
    • Fixed reload cache when both channel types is chosen.
    • Moved SD only setting to wiiflow save file to possibly speed up wiiflow start up. note very first time will be slow and try to mount USB HDD because the SD only setting will need to be moved to the savefile. but afterwards will be fast again.
    • Now compiled with devkitppc r42-1 and libogc 2.4.0.
  • PLUGIN CHANGES:
    • Fix for issue #318. favorites and adult_only in gameconfig1 and categories in categories_lite will now use the platform name and game ID if using the plugin database files. if either the platform name or game ID are not available we will still use old method of plugin magic and game title. With new method if old plugin magic and game title is found it will be converted to platform name and game ID. because of this it is recommended to backup gameconfig1 and categories_lite just in case you have issues with new WFL and need to go back to old WFL. Titlesdump.ini has also been updated to new method and will now include output of the filtered game list for plugins. Set [GENERAL] dump_list=yes before starting WFL. set it to 'no' when done dumping your lists.
    • Added playcount and lastplayed for plugin games.
    • Added a fix for in case the plugin filetypes line ends in a '|'
    • Added plugin game setting to reload its cached cover in case you change the png for it. a work around for issue #322
    • Added a date patch to make the wiituka plugin work.
    • Added the use of GamesTDB for ScummVM titles to get localisation of the title. (eku)
    • Updated internal default text for regex to hopefully work better. (chrondelta)
  • GUI AND THEME CHANGES:
    • Fixed error messages to wrap the text if too long.
    • Added total games text to display every time you change favorites or categories. (eku)
    • Fixed an issue with gui sound volume not sticking on next start.
    • Fixed source menu buttons hiding/showing.
    • Removed splash image on start up.
    • Added parental lock for source menu editor.
    • All settings menu's now use the same labels and buttons. the text is just changed. keeps theme ini smaller and easier to maintain. need updated rhapsodii shima theme ini.
    • All checkbox menu's now use the same labels and checkboxes. again, keeps theme ini smaller and easier to maintain.
    • All checkboxes use a single button and we just set the texture image based on it's state. before we had a button for each state - on, off, or other. and would just show only the state needed while hiding the others.

v5.5.3 2022/03/23

  • Disable splash image and wait animation if direct launching a wii game (via wiiGSC).
  • Added option to use nands not vwiinands when on wii u. set manually by changing [CHANNELS] use_vwiinands=no in wiiflow_lite.ini
  • Fixed using hermes cios in the rare case you ever need to use it.
  • Other minor code changes.

v5.5.2 2022/02/07

external_booter.bin fixes that i missed when i changed the booter in v5.5.0 beta 12:

  • Added missing *BI2 = 0x817E5480; to Disc_SetLowMem() for wii games.
  • Added missing memcpy((void*)0x80001800, (void*)Disc_ID, 8); needed for debugger and ocarina cheats engine.
  • Fixed Disc_SelectVMode() for channels in v5.5.1. (video mode based on Disc_ID[3])

main changes:

  • Fixed default setting for savegame emulation back to OFF (0). v5.5.0 and v5.5.1 new clean install's would set it to FULL (2) which caused wii games to crash on boot up. if you have this issue you can simply go to main settings>nand emulation settings and set it to OFF.
  • Reinstated Fix94's keep USB alive thread for IOS58 mode.
  • Fixed reloading wiiflow after any changes on Startup Settings menu.
  • Changed the order of functions for ShutdownBeforeExit() to possible fix any shutdown and gameboot issues.
  • Changes to STexture::fromPNG() to hopefully clear up the out of mem issue when downloading and converting the cover png to a wfc cache file.

Click here for the complete changelogs.

External links

Advertising: