From WiiBrew
Jump to navigation Jump to search
Lines MediaPlayer.png
TypeMedia player
Downloadable via the Homebrew Browser
Wiimote1.svg Nunchuck alternative.svg ClassicController.svg Loads files from the Front SD slot Loads files from SDHC cards in the Front SD slot USB mass storage device Internet DVD

MPlayerWii is a native port of the MPlayer media player which will play nearly any kind of audio and video file with only a few exceptions.



Wiimote.svg Action
Wiimote D-Pad Up / Wiimote D-Pad Down Select File
Wiimote A Button Play Selected File/Open Folder
Wiimote HOME Button Go Back


Wiimote.svg Action
Wiimote D-Pad Left / Wiimote D-Pad Right Skip Backward/Forward
Wiimote D-Pad Up / Wiimote D-Pad Down Volume Up/Down
Wiimote A Button Pause/Unpause
Wiimote HOME Button Return to File Selection

Video Manipulation

With the Nunchuk:

Nunchuck alternative.svg Action
Nunchuck Control Stick Move Video Output Position
Nunchuck Z Button + Nunchuck Control Stick Stretch/Squeeze Video Output
Nunchuck C Button Reset Video Output Position and Dimensions

Or with the Classic Controller:

ClassicController.svg Action
Classic Left Control Stick X axis Stretch Video Left
Classic Left Control Stick Y axis Stretch Video Up
Classic Right Control Stick X axis Stretch Video Right
Classic Right Control Stick Y axis Stretch Video Down
Classic b Button + any other button Reset Dimensions

File formats tested

  • Containers: AVI, WMV, MKV, OGM, MP3, FLV (Flash Video), MP4, M4V, QuickTime, 3GP
  • Video codecs: Xvid, DivX, Windows Media, MPEG 1/2, H.264
  • Audio codecs: MP1/2/3, Windows Media, AAC

It should also work with other formats.

Note: MPlayerWii does not play DVD videos; only MPlayer TT made by Team Twiizers will do this! However below is an unofficial version that will read files off of burned dvds. It would be to everyones benefit if someone could merge the sources together and add all of the features from the latest Unofficial MPlayerWii to MPlayer so that there is no more confusion.

Bugs and Support

Please report bugs at the project page. You may also find the Official Forum Topic at DCEmu useful.


Why won't my USB storage device work?

First, make sure your hard drive is formatted as FAT12, FAT16, OR FAT32.

Most devices are supported by the library being used to provide usbstorage access, but some do not work due to various reasons such as noncompliance to standards. Such devices usually require special drivers to work and it would be an arduous task to track them all and write support for all of them. You can blame the manufacturers. Note: U3 devices do not work, this includes Sandisk's cruzer line.

Why isn't NTFS supported?

MPlayerWii uses libfat to read from FAT filesystems and it would need a similar library to read from NTFS. No such library has been written. Support for NTFS can be enabled through linux, but MPlayerWii does not run on top of wii linux. It is a direct port.

Why isn't there subtitle support?

MPlayerWii uses a wrapper to enable it to work with the wii. Unfortunately, the changes needed to enable subtitles on the wii cannot be done through this wrapper, but instead would require changes to the actual mplayer code. It is not clear if this will be done or even if it is possible at the moment.

Why don't my RM and RMVB files work?

The wii uses PPC architecture. Newer Real Video encoded files (rmvb and some rm) only have support libraries written for x86 architecture availible.

Why is the picture corrupted with some videos?

Not much is known about this issue at the moment except that it can be caused by some video filters applied in a certain way during the encoding process, which will usually result in a green bar at the bottom of the screen accompanied by discoloration and/or other issues when the file(s) is/are played in MPlayerWii. This is not to be confused with a different minor problem which can usually be resolved by stopping playback and starting it again or by waiting a few seconds.

Why is SMB not working with my Mac?

There is a bug in the libOGC that prevents SMB to work with Mac OS X out of the box. There is a workaround, edit the /etc/smb.conf file on your Mac and add these lines:

   max xmit = 32768

after this one:

; Site-specific parameters can be added below this comment.

then restart your Mac.



  • fixed screen color depth/banding issues (uses code from dhewg's mplayer port)
  • added progress bar osd display during seek/volume on videos


  • huge speedup on USB devices (thanks to rodries and Hermes)
  • added classic controller support to position and scale the video display


  • added file folders support
  • added fix for PAL widescreen users (set the correct setting in mplayerwii.conf)
  • much faster USB reading speed (huge thanks to rodries)


  • mount/unmount the SD card and/or USB drive so you can swap them out without reloading MPlayerWii
  • added USB read-ahead cache
  • added preliminary samba network share support
  • fixed startup crash when a usblan or usb keyboard is attached
  • added network streaming cache
  • added video scaling with the nunchuk (use joystick to move, Z button to stretch and C to reset)
  • added configuration file (put in the SD root folder)
  • new ascii logo by sensah


  • added USB storage support (USB reading is dead slow unfortunately, only good for MP3 files)
  • added volume controls (Up/Down buttons on the wiimote)
  • added wiimote buttons repeat during playback
  • added preliminary test network streaming (shoutcast and mms)
  • longer filename display in the file selection screen
  • fix for widescreen aspect ratio (uses the Wii display settings)
  • more audio playback fixes


  • added svenp's libfat patches (better read speed on SD cards)
  • added pause button (A button on the wiimote)
  • disabled MPlayer's error/status text during video playback
  • file list now displays 20 files instead of 10
  • improved audio playback code


  • Initial release. Full of bugs, audio sync code is awful and will probably crash often. Also, there's room for lots of speed improvements.


MPlayerWii was ported by rOn (aka fcorbier).

Unofficial Versions

MPlayer is licensed under the GPL, please post only builds which come with source or diff's, thanks

Mplayer dvd+sdhc+SMB.PNG MPlayerWii r20 modified by AgentX (r3)


  • If your file has a 2.35:1 ratio and you want to make it fit the screen, press 1. If your file has a 4:3 ratio and you want to stretch it to fit the screen, press 2. To return to default press 1 and 2 together.
  • Tries to distinguish between audio files, video files and other files. If you select an audio file it will play continuously through the folder. Press B to play next file. Selecting a video will just play the individual file. Any other file will not be recognized and not play (avoiding crashes).

A patch file is included. Source is very hacky. With thanks to DCelso & Qualith for code for continuous play.

Known bugs:

  • Using B to select next file is very touch and go. I think this is a problem with mplayer not freeing memory properly so I can't fix it until I work out how to compile.

Thanks to rodries for constantly updating mplayerwii, samba improvements are much appreciated!

Download (code patch included): MediaFire

Note: Also includes the added support for DVD, SDGecko, and SDHC access.

Mplayer dvd+sdhc+SMB.PNG MPlayerWii v0.07 (r20) DVD/SD/SDHC/SMB support

Released by rodries (version, release 20). This version doesn't crash when browsing on DVD files (left, right buttons). Also, network cache and SMB streaming have improvements (Fixes: no more CodeDumps when browsing on Samba, now DivX videos are highly compatible, better smb streaming support (less glitches). Added: NTLM security protocol).

Download: MediaFire
Source code: Google Code

MPlayerWii v0.05 with YouTube support

by alienmind

video, playlist and search result supported Forum post

MPlayerWii v0.03 widescreen fix

Vader347's version of mplayerwii v0.03 fixes the widescreen bug. Vader347 claims that the only real change is one chunk of code (as recommended by Pepsiman):


rmode = VIDEO_GetPreferredMode(NULL);

if( CONF_GetAspectRatio() )
	rmode->viWidth = 678;
	rmode->viXOrigin = (VI_MAX_WIDTH_PAL - 678)/2;


Note: Starting with v0.5, you could use that fix by setting the "palwsfix" var to 1 in the mplayerwii.conf configuration file.