A game library
for Wii U.

You need a Wii U already running Aroma, its FAT32 SD card, and room for the installer plus your selected components. Setup does not install Aroma itself. Back up the SD before starting.

1. Download uFlow-Setup.wuhb. Copy it to SD:/wiiu/apps/uFlow-Setup.wuhb.
2. Insert the SD and boot into Aroma. Open uFlow Setup from Wii U Menu.
3. All components start checked. Use A or touch to toggle individual items, X for all, or Y for none. The uFlow app is always included.
4. Press + to review the selection, then A to install. Keep the console powered and the SD inserted until Setup reports completion.
5. Fully reboot the console, then launch uFlow. Add your games and use Settings → Library → Add new games.

Existing settings and saves are kept. Replaced files are backed up under SD:/.uflow-setup/. Unchecking a component does not uninstall an existing copy.

Link to this guide ↗

Installed Wii U titles are discovered automatically when General → Show Installed Wii U is enabled. For files, use the folders below or register your own in Settings → Library → Add Directory.

SD:/
├─ wiiu/raw-games/Game Name/{code,content,meta}/
├─ wbfs/Game Name [GAMEID]/GAMEID.wbfs
├─ games/Game Name [GAMEID]/game.iso
├─ wiiu/roms/ds/Game.nds
├─ wiiu/roms/nes/Game.nes
├─ wiiu/roms/snes/Game.sfc
├─ wiiu/roms/gba/Game.gba
├─ wiiu/roms/n64/Game.z64
└─ wiiu/roms/ps1/Game.cue

1. Choose a directory and its content type. In the folder browser, A enters a folder and Y selects it.
2. Set scan depth: 0 checks the chosen folder; 1 includes its immediate children. Increase it if you use more nested folders.
3. Save the path, then choose Add new games to discover new titles while keeping your library. Use Complete scan to rebuild it after removing games; a large library can take a long time. The Media tab has a separate Refresh media action.

Wii U raw folders need the extracted code and content directories. Encrypted packages containing .app, .h3 and title.tmd belong to the Install Content workflow. GameCube RVZ files must be converted to ISO, not renamed.

Removing a library path removes that scan entry, not your game files. The saved catalog lets later launches display the last known library quickly.

Link to this guide ↗

1. Highlight a game and press − to open Launch Options. Only compatible launchers appear.
2. Select a launcher to use it for this launch. Press + in the launcher list to save a per-game default.
3. For a system-wide default, edit the content type under Settings → Library → Manage Content Types.

You can also open Y Details → Game launcher to choose a launcher, reset it to Use Default, or access its settings. If a launcher is missing, rerun Setup with that component selected.

DS offers Virtual Console injection and NooDS. NES, SNES and GBA can use VC injection or the included RetroArch backend. Wii offers WiiFlow and USB Loader GX; GameCube uses Nintendont.

Link to this guide ↗

VC injection uses a compatible Virtual Console base to run your ROM. Compatibility varies by system, base and game; a game appearing in the library does not guarantee it will run.

1. Place the ROM in its system folder and scan the library.
2. Choose the system’s VC launcher using Launch Options or the Game launcher tab in Details.
3. On first launch, follow the injection prompt. You can also use Inject / Re-inject in Details → Game launcher.
4. Wait for preparation to finish, then launch. Use Re-inject when replacing the source ROM or changing the relevant preparation options.

For a game that does not work with its VC base, try an available alternative such as NooDS for DS or RetroArch for NES, SNES and GBA.

Link to this guide ↗

This is separate from installing uFlow itself. Enable the Wii U title installer component in Setup to add the Install Content library.

1. Copy a complete installable package into its own folder under SD:/install/. Keep the package’s title.tmd, content and related files together.
2. Scan, then open Install Content in uFlow.
3. Open the package’s installation options, select the offered destination and review the confirmation.
4. Keep power and storage connected while installation runs. Once complete, the installed title can be discovered in your Wii U library.

Use complete packages for your console and content. An extracted code/content/meta game is a raw-library entry, not an installable package.

Link to this guide ↗

Open Settings → Media → Add Directory. Choose the media type, library scope and folder, then save and scan to match the files to your games.

SD:/wiiu/apps/uFlow/media/<system>/
  front/        back/       spine/
  fullcovers/   logos/      backgrounds/
  previews/     media/      metadata/

Use the game’s title ID or matching game name as the filename. Artwork accepts PNG, JPEG and TGA. A full sleeve is laid out back | spine | front. Transparent PNGs work well for logos and disc/cartridge artwork. Missing faces fall back to the configured default sleeve.

For videos, choose Gameplay Videos as the media type. Set the directory’s start delay, layer and volume. Background playback keeps the library visible; foreground playback takes over the view. For smooth playback, prefer H.264 MP4 at 720p/30 fps.

Display → Preview Delay, directly below Gameplay Previews, adds 0–30 seconds to the source delay; its default is 0 seconds. B dismisses a playing preview until you change games.

Metadata files use the same matching name with an .ini extension. Supported fields include description, developer, publisher, year, genre, players and rating.

Link to this guide ↗

Display → Cover Type selects Box, Logo, Media or Thumbnails. Each remembers its own compatible layout. Boxes offer 3D arrangements; logos use flat layouts and directional wheels; thumbnails give you square tiles.

• Cover Spacing: 50–200%. Cover Zoom: 40–200%, with 120% as the normal view.
• Inspection Zoom: 1.0×–4.0× in 0.5× steps, used when holding a cover-inspection control.
• Wall / Curved Wall: navigate in four directions; the selection stays centered and the grid wraps around.
• General → Skin: choose GlassFlow, Pixel Deck, Switch Light, Switch Dark or an installed custom skin.
• General → Demo Mode: enable it, then set the inactivity time shown below. It visits games with videos, waits for each clip to finish, then chooses another. Input exits demo mode and returns to your original game.

To add a skin, extract its folder to SD:/wiiu/apps/uFlow/skins/, restart uFlow, and select it in General. A skin contains skin.ini plus optional image assets. You can customize colors, icons and placement without rebuilding the app.

Download the editable skin starter ↗ · Read the skin format

Link to this guide ↗

1. Open Settings → Controls and select an action.
2. Use Replace for a new binding, or Add to keep the existing binding and add another.
3. Release the activation button. Press the desired button or hold a combination together, then release everything to finish capture.
4. Clear removes the action’s bindings; Reset Defaults restores the standard controls.

A + between icons means a combination; a slash means alternatives. When a button belongs to both a single action and a combination, its single action waits for release.

The left stick and D-pad navigate by default. Right-stick up/down inspect the front/back cover. Assign Next Layout to a spare button or combination to change layouts without opening Settings.

On the GamePad, swipe through rows and logo wheels, or in either direction on wall layouts. Tap settings rows, arrows and footer buttons. In Switch skins, L3 / System Buttons focuses the dock; the controller icon opens Wii U controller pairing.

Link to this guide ↗

Press Y to open Details. Move up/down between the icon tabs for synopsis, play, launcher, source, media and information. Right enters interactive controls; Left or B returns to the tabs.

Use the Media tab to browse artwork or play a video. Leaving the video or closing Details stops its player. X marks a favorite from browsing; the synopsis tab also lets you toggle it with A.

Time played and native play counts use the current Wii U account’s activity records when available. uFlow also keeps account-specific launch counts and personal ratings. Unsupported launchers show that play time is not reported rather than estimating a duration.

Link to this guide ↗

Rerun the latest Setup to update the selected app, modules and launchers. Existing configuration and saves are preserved. Reboot afterward so the updated Aroma modules are loaded.

The in-app updater checks for signed app releases at startup and asks before installing. It updates the uFlow app; module and backend changes still require Setup. This page’s installer build and the app’s signed update channel are separate releases.

Choose your startup library with General → Start View. To launch uFlow automatically, install Start-on-boot support and enable General → Start uFlow on Boot. Hold + on the GamePad during boot to bypass to Wii U Menu. Installing support alone leaves autostart off.

If boot stops at a minute or environment-selection menu, configure that boot stage for your own console setup first; uFlow’s autostart setting does not install or configure coldboot.

Link to this guide ↗