MPlayer CE

From WiiBrew
Jump to navigation Jump to search
MPlayer CE
Author(s)Scip, Rodries, etc
TypeMedia player
Downloadable via the Homebrew Browser
Wiimote1.svg Nunchuck alternative.svg GameCube Controller Loads files from SDHC cards in the Front SD slot USB mass storage device Local WiFi Internet DVD

Mplayer CE is a fork of the Team Twiizers MPlayer port, combining elements of MPlayerWii and GeeXboX.


By _Contra_


File:MPlayer CE.png

Optional Requirements


To read DVDs, you will require DVDX "normal" / "default" install. To read external drives at USB 2.0 speeds, you will also need the custom cIOS USB2 modified by the Mplayer CE team, which can be found on the Mplayer CE downloads page. If you install this, then you do not require a DVDx install at all.


You need to install the USB 2.0 cIOS from here.

(Please note that this requires a internet connection).

The installer is for Homebrew USB2 only, this will install IOS202 using base IOS60 automatically. You can select the IOS to use to do the installation, so you can select a IOS with the fake sign bug. (IOS60 is downloaded to SD via the Nintendo's Update Server).

We are using IOS60 as a base as there has been improvements in wifi. Those that install this cIOS do not require a DVDx installation.

Users without the fakesign bug cannot install the cIOS to use USB2. There is a work around for this but we cannot advise about it. Unfortunately there is nothing we can do about it.

If you plan on updating make sure to install the cIOS and DVDx before updating.


Copy the "mplayer_ce" folder into the "/apps" directory on your sd card and launch it via the Homebrew Channel. Do not rename the folder.


You can use a wiimote or a gamecube pad to interact:

Wiimote.svg GameCube Controller Action
Wiimote A Button Gamecube A Button Pause
Wiimote B Button Gamecube B Button Toggle menu
Wiimote 1 Button Gamecube X Button Close menu / Show OSD
Wiimote D-Pad Right Gamecube D-Pad Right Seek 10s forward
Wiimote D-Pad Left Gamecube D-Pad Left Seek 10s backward
Wiimote D-Pad Up Gamecube D-Pad Up Seek 60s forward
Wiimote D-Pad Down Gamecube D-Pad Down Seek 60s backward
Wiimote + Button GameCube R Trigger Next chapter / Increase Volume
Wiimote - Button GameCube L Trigger Previous chapter / Decrease Volume
Wiimote HOME Button GameCube Z Button Quit
Wiimote 2 Button Gamecube Y Button Modifier key

Video Manipulation

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

More persistent screen adjustments are also done from within the 'mplayer.conf' configuration file using three variables called gxzoom (zoom, where higher values yield lower zoom levels), vert_pos (vertical offset), and hor_pos (horizontal offset).


HELP! Some files play back choppy!

Are you trying to play an h.264 encoded video and/or high defenition video? The Wii just doesn't have the hardware to handle it. For more information, see

Turning off frame skipping makes some files play back smooth but the audio goes out of sync!

The Wii is just not powerful enough to handle high compression/high definition content smoothly and still keep the audio in sync.

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. Also some drives have a bad detection, try the following, switch on USB Drive, Power Wii on, Boot HBC and load MPlayerCE, and maybe the drive will have mounted. If not then we need to make improvements in ehci module etc. There is a usb test for you to try if you have a problematic drive, please report the result here.

Why isn't NTFS supported?

MPlayer CE 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 MPlayer CE does not run on top of wii linux. It is a direct port.

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.

How to install the cIOS without Wifi Connection?

Visit Here to read the guide, thanx to Djdynamite123.



  • Files now first analyse, followed by cache, as cache was emptied on analysing previously so now you'll see cache filling later.
  • Improved audio/video internet cache, detects if it is a internet stream, if it's a radio stream then initial cache fill is small.
  • Optimizing memory access suggestion from Shagkur, cache thread is now more stable.
  • A8 patch added for DVD playback in cIOS202 to avoid problems with old ModChips.
  • Improved libfat and fix for special characters.
  • Using latest Libfat to prevent possible corruption on sd.
  • Improved USB hotplug and dvd detection, ehci module modified for more compatability with usb devices.
  • Can now mount any fat partition, shouldn't matter if partition is set as primary or activated.
  • Now has real fat32 limit therfore can now play larger files.
  • Video files that hadn't worked previously may work now.
  • New buffering system implemented for when buffering is low, if cache becomes low, it will pause and re-buffer to fill cache-min value, to prevent possible hangs with bad connections. You can see the cache by pressing 1 twice on the wiimote, when cache drops to 3% then it will pause.
  • Shoutcast TV is complete with caching, thanx to Extrems, Review menu.conf.
  • If IOS202 is installed via the Installer then DVDx is not required for DVD Access.

New cIOS Installer

  • MPlayerCE will now detect the presence of IOS202 to decide to use DVDx or not, so people that install the cIOS202 don't need to install DVDx to use the DVD functions. Default DVDx install can be used if you install IOS202 now. The new installer is for Homebrew USB2 only, this will install IOS202 using base IOS60 automatically as IOS60 has improvements in wifi. Now you can select the IOS to use to do the installation, so you can select a IOS with the fake sign bug. (The reason for DVDx not having to be installed if IOS202 is installed on the wii, is that there is a patch in IOS202 that doesn't require DVDx, and can access DVD without it). The cIOS is needed for MPlayerCE to use the USB2 driver. For more details read the README that is part of the package.


  • USB LAN Adaptor support fixed (again). Thanks to CountZ3ro for testing. Please note that you will need to install the USB 2.0 cIOS.
  • cIOS improved to stop conflicts with other homebrew. Please note that now only port0 has usb2 support. All other USB devices (including the USB LAN adaptor) must go in port1. See here for details:
  • Horizontal stretch parameter added (see mplayer.conf)
  • YouTube options added to menu.conf (thanks to Extrems)
  • Many small bug fixes


  • New screen size variables actually work now.
  • Better usb device detection.
  • Using free Liberation font instead of Arial.
  • Subtitle wraparound bug fixed.
  • Spanish version released.


  • No more maximum cache limit
  • Introduced new variables into mplayer.conf to adjust screen size and position, please see mplayer.conf for details (component-fix is now deprecated)
  • idx/sub subtitle support (please note that these can take up to 30 seconds to load so please be patient)
  • Multiple folder locations added, it is now possible to have the files in
    • sd:/apps/mplayer_ce
    • sd:/mplayer
    • usb:/apps/mplayer_ce
    • usb:/mplayer
  • Added resume points - video will resume at last stopped point. To clear, delete resume_points file in your mplayer_ce folder. To seek to the beginning of the video hold 2 and press the minus button.
  • Added support for Hermes' cIOS. This has greater USB compatibility and enables USB LAN connector support. Please see wiki page for details
  • Added Fribidi library support for right-to-left languages
  • Made cache fill visible on screen
  • Many small bug fixes
  • Updated to latest MPlayer svn


  • SMB now much more robust - thanks to DennisLKJ for smb.c fix
  • libfat cache improved for speed and stability
  • USB ethernet now fixed with USB 1.1; USB 2.0 fix requires an updated cIOS
  • Added ability to manipulate picture using the nunchuk
  • Updated to latest MPlayer revision
  • Now using subfont.ttf instead of font folder - use mplayer.conf to change font size
  • Merged widescreen and 4:3 pack - now MPlayer will use the appropriate loop.avi automatically
  • Improved modchip compatibility for DVD


  • USB 2.0 support (see docs for info)
  • TTF font support (see docs for info)
  • Fixed bug in radio streaming.
  • DVD-Video bugs fixed (DVDs should play much more smoothly now)
  • Fixes in Libdi to detect chipped Wii
  • Codec fixes
  • Updated to latest MPlayer revision
  • Many small fixes


  • Fixed a little bug in keepalive issue that hangs the Wii


  • Fixed code to play videos with incompatible size; we now support many video formats and unorthodox resolutions
  • Fixed keepalive issue in samba (thanks to Ludovic Orban)
  • New loop.avi and widescreen version (thanks to Blue_K)


  • Fixed apostrophies in filenames
  • Improved DVD and USB mounting devices
  • Fixed radio
  • Improved samba reconnection
  • Debugging help for SMB Shares at bootup, debug_network=yes (Review mplayer.conf)


  • Updated menu.conf to allow selecting playlist
  • Fix rodries' loop patch


  • Updated menu.conf to allow selecting subtitles


  • Fixed hang when you access to dvdnav
  • New mplayer.conf option: component_fix=yes to fix side bars on some problematic TVs (Now fixed) Review your configs.
  • Stop Looping Video/Audio file.


  • Reduced font size
  • New Readme
  • New mplayer.conf option: component_fix=yes to fix side bars on some problematic TVs
  • Small fix in cache2.c


  • SD/USB Mount bugs fixed
  • DVD Mount/Stop/Motor/Pause problems fixed, now mounts, only when you select DVD
  • Network Initialising on startup changed, now connects "hidden" in background.
  • Added 5 SMB Shares, review smb.conf
  • Boot-up speed increased
  • Added files filter to only show audio/video files
  • Same directory kept open when you open/close the menu
  • Menu closes on file load


  • SMB fixes
  • DVD cache bug fixed
  • Small USB fixes
  • Modified Libogc & Libfat
  • 2.35:1 videos now scale correctly

V0.1 Christmas Edition

  • Initial project

Further Information

For information on compiling, editing the config files and submitting your custom theme, please see the Google Code Wiki.

How to report a bug/issue

Please only report "new" issues, not duplicates. Google Code Wiki.

User submitted customizations

Feel free to submit links to your own customizations on Google Code Wiki.


                         Scip - Original Project Author
                       tipolosko - DVD-DATA Feature Author
                    rodries - Coding, SMB & USB Improvements
                 AgentX - Source Improvements, Configs & Testing
              DJDynamite123 - Autochain Code/Experimenting & Testing
                     Ludovic Orban - Keepalive issue in samba
                        Extrems - Youtube/Shoutcast patches
                           Tantric - SMB Improvements
                             Brakken - Documentation
                                Blue_K - loop.avi
                             Thanks Goes Out To ...
                                 Team Twiizers
                                GeeXboX Authors
                           Shagkur & LibOGC Contributers