ר    
                             ,.                                              
                            :@@#                                             
   .,.      ...  ..         .@@&    .......    ,....  ,.    ......    ,,.....
   H@@@    S@@@r @@@@@@@@@A  @@3  :@@@@@@@@@2 #@@@@@ r@@9 A@@@@@@@@@  @@@@@@@
   9@@@@   @@@@: @@@M32X@@@  @@X  i@@A::;5@@@ ,@@@@M :@@5 @@@:::;@@@; @@@rsSi
   S@@@@i A@@@@, @@@    A@@  @@X    ,..iM@@@B :@@2   ,@@s A@@;;;   .  @@&    
   s@@@@@;@@@@@. @@@    &@@  @@X   #@@@@&2@@H S@@    .@@r ;@@@@@A     @@B    
   s@@:@@@@@,@@. @@@    H@@  @@3  ;@@2.;. @@H S@@:   .@@r @@@    :@@. @@@    
   5@@ ;@@@  @@. @@@,@@@@@@  @@@@ .@@@@@@ @@@ ;@@@@@@@@@r #@@@@@@@@@: @@@@   
   ,99  25i ,@@, @@@ @#A2r   :XB#  :S335. XGs   r9Ah2B@@s  rXAHHH&Xr  .2H@   
          @@@@@. @@@                              @@#@@@.                    
          @@#A;  A@H     -|    MPlayer CE     |-  #@#B&:                rK

                    http://code.google.com/p/mplayer-ce

ח  --
|0Oo                           INTRODUCTION                        oO0|
`    '

MPlayer CE is an unofficial  port of the  very popular multimedia  player for
various  platforms  including  Windows  and  Linux.  This  Nintendo Wii  port 
features the same compatibility that the other versions offer, but is limited
in some aspects  as it can't playback  some high resolution videos due to the
processing power of the Wii.

MPlayer CE will  allow you to  watch various  movies in different  formats on 
your  Nintendo Wii  including AVI,  DIVX,  XVID,  MPEG2  and  DVD  Videos. It 
actually supports a huge  range of formats  and can playback media from DVDs,
SD Cards, USB drives  and over your local  area  network  using  Samba  (SMB)
shares. MPlayer CE also  allows  you  to  listen  to  radio  streams over the 
Internet.

This port is  based on the original work of  Team Twiizer's  MPlayer Wii port 
and uses code from [rOn]'s  MPlayer Wii port along with code from GeeXbox. It 
is currently  maintained by Scip, tipolosko, rodries, AgentX & DJDynamite123.

While there are  numerous ports and versions  of MPlayer for the Nintendo Wii 
its hard to  tell which  one to use, but  this one is being heavily developed 
and surpases  the other versions  due to its  performance, optimizations  and 
features.

ח  --
|0Oo                         SUPPORTED FORMATS                     oO0|
`    '

Supported Input Formats

    * (S)VCD (Super Video CD)
    * CDRwin's .bin image file
    * DVD, including encrypted DVD
    * MPEG-1/2 (ES/PS/PES/VOB)
    * RIFF AVI file format
    * ASF/WMV/WMA format
    * QT/MOV/MP4 format
    * RealAudio/RealVideo format
    * Ogg/OGM files
    * Matroska
    * NUT
    * NSV (Nullsoft Streaming Video)
    * VIVO format
    * FLI format
    * NuppelVideo format
    * yuv4mpeg format
    * FILM (.cpk) format
    * RoQ format
    * PVA format
    * streaming via HTTP/FTP, RTP/RTSP, MMS/MMST, MPST, SDP
    * TV grabbing

Supported Video and Audio Codecs

    * MPEG-1 (VCD) and MPEG-2 (SVCD/DVD/DVB) video
    * MPEG-4 ASP in all variants including DivX ;-), OpenDivX (DivX4), DivX 5 (Pro), Xvid
    * MPEG-4 AVC aka H.264
    * Windows Media Video 7/8 (WMV1/2)
    * Windows Media Video 9 (WMV3) (using x86 DLL)
    * RealVideo 1.0, 2.0 (G2)
    * RealVideo 3.0 (RP8), 4.0 (RP9) (using Real libraries)
    * Sorenson v1/v3 (SVQ1/SVQ3), Cinepak, RPZA and other QuickTime codecs
    * DV video
    * 3ivx
    * Intel Indeo3 (3.1, 3.2)
    * Intel Indeo 4.1 and 5.0 (using x86 DLL or XAnim codecs)
    * VIVO 1.0, 2.0, I263 and other H.263(+) variants (using x86 DLL)
    * MJPEG, AVID, VCR2, ASV2 and other hardware formats
    * FLI/FLC
    * HuffYUV
    * various old simple RLE-like formats

Most important audio codecs:

    * MPEG layer 1, 2, and 3 (MP3) audio
    * AC3/A52 (Dolby Digital) audio (software or SP/DIF)
    * AAC (MPEG-4 audio)
    * WMA (DivX Audio) v1, v2
    * WMA 9 (WMAv3), Voxware audio, ACELP.net etc (using x86 DLLs)
    * RealAudio: COOK, SIPRO, ATRAC3 (using Real libraries)
    * RealAudio: DNET and older codecs
    * QuickTime: Qclp, Q-Design QDMC/QDM2, MACE 3/6 (using QT libraries), ALAC
    * Ogg Vorbis audio
    * VIVO audio (g723, Vivo Siren) (using x86 DLL)
    * alaw/ulaw, (ms)gsm, pcm, *adpcm and other simple old audio formats

ח  --
|0Oo                            INSTALLATION                       oO0|
`    '

To run MPlayer CE you'll need a Nintendo Wii that has been "soft modded" with
either  the  Homebrew  Channel,  Homebrew  Launcher  or LoadMii.  The archive  
contains a folder  named "MPlayer_ce"  which  you will  need  to copy to your
"apps" folder  on your SD Card. 
Once  copied  over you  can launch it  using the  loader of your choice.

ח  --
|0Oo                              USB 2.0                          oO0|
`    '

For  USB 2.0  support  you  will  need  to install the USB 2.0 cIOS from here
(please note that this requires an internet connection): 

   http://mplayer-ce.googlecode.com/files/cIOS_Installer.rar

Make sure to watch it download and install in case it fails and returns to HBC.
Those that install this cIOS do not require DVDx.

Offline installation is available.  For a guide please see here:

   http://www.tehskeen.com/forums/showthread.php?p=62838

If you receive the error codes -1017 or -2011 your Wii probably does not have
an  IOS  with the  fakesigning bug.  Users without  the  fakesign  bug cannot
install this cIOS. Trucha Bug Restorer is an  application to workaround this.
It is  compatible  with  all  Wiis and  up to  system menu 4.1. Only use this
program if you have an idea what the trucha bug

   http://wiibrew.org/wiki/Signing_bug

is and why you need it. For more information and to download visit:

   http://www.tehskeen.com/viewarticle.php?articleid=4295

Once complete, download the cIOS Installer and choose IOS36 as the IOS in the
selection screen.
Make sure to watch it download and install in case it fails and returns to HBC.

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

ח  --
|0Oo                            CONFIGURATION                      oO0|
`    '

In the "MPlayer_ce" folder you copied over to your SD card you will find some
.conf files  which can  alter the way  MPlayer operates  and is also  used to 
setup your SMB shares. MPlayer CE has  the ability to use  five different SMB
shares, but they  must be configured manually by editing the "smb.conf" file.
Inside of  it you'll find  five different  entries.  You can  fill in as many 
shares as you like. The format is as follows:

#Samba share1  (smb1:/)
ip1=192.168.0.1
share1=Movies
user1=Test
pass1=fr0g

The "ip1" is your  computer's  IP address,  the "share1"  is the name of your 
shared folder, "user1" is the  username you use to login to your computer and
lastly "pass1" is your password  you use to login to your computer. If you do
not use a username and password,  leave  user1  and  pass1  blank,  "user1=",
"pass1=" so MPlayer CE knows not to use a password to login to your SMB share.

If your share folder has a space in it, you must surround  it  with quotation
marks: share1="My Movies".

You can also force the aspect ratio of  the screen. This means that all video
files will be displayed at the specified ratio.  To force 16/9 you will  need
to edit the "mplayer.conf" file and add the following line:

"ratio=1.7778" (add it without the quotes)

Lastly, if you wish to change the  background image you can create  your own.
After creating a custom background  (it can be a still image or an animation)
convert it to a video, name it "loop.avi" and place it  in  the  "MPlayer_ce"
folder.  The specifications for "loop.avi" are listed below.

XVID MPEG4 Compressed AVI
640x456 or 720x480 Resolution

How to change colour of subtitles?

to change colour of subs you need to add some params to your'e mplayer.conf
e.g. with this param now subs are yellow
ass=yes
ass-font-scale=2.2
ass-color=FFFF0000
ass-font-scale to change subs size

More information can be found here: 
http://www.mplayerhq.hu/DOCS/man/en/mplayer.1.html#OSD/SUBTITLE%20OPTIONS

Further Customization Instructions can be found on the MPlayer CE Wiki

http://code.google.com/p/mplayer-ce/w/list

ח  --
|0Oo                               USAGE                           oO0|
`    '

After launching MPlayer CE a brief text based loading screen will appear then
the  Main Menu  will come up.  To  navigate  through  the  menus you use the
directional  pad  and the "A" button  for selecting  and the "B" button to go 
back. The Main Menu presents you with the following options:

 Stop              - Stops the Current Movie/Song
 Open              - Open File/Playlist/Radio/DVD 
 Current playlist  - View Current Playlist
 Options           - Options Menu
 About             - Credits
 Quit              - Return to Loader

-[ OPEN ]-

This option  will display  the following options  for you to choose  what you
want to play. Simply select your  source and pick a file to play with the "A"
button.

 File
 Playlist
 Subtitle
 DVD Video
 Radio

 -[ FILE / PLAYLIST / SUBTITILE ]-

These options will display the following sources for you to browse and select
which  files you wish to open. Simply select your  source and pick a  file to
play with the "A" button.

 Wii SD
 Wii USB
 Wii DVD
 SMB

-[ SMB ]-

This option will bring up the SMB  sharing menu where you can choose the  SMB
share you with to access:

 SMB share1
 SMB share2
 SMB share3
 SMB share4
 SMB share5

-[ DVD ]-

This option will bring up the DVD-Video  menu allowing you to play normal DVD
movies in your Nintendo Wii. It presents you with the following options:

  Play DVD              - Plays the DVD
  Chapter               - N/A (Does Nothing)
  Play Title #1         - Play 1st VOB
  Play Title #2         - Play 2nd VOB
  Play Title #3         - Play 3rd VOB
  Play Title #4         - Play 4th VOB
  Play Title #5         - Play 5th VOB
  Play DVD (libdvdnav)  - N/A (Reboots to Loader)

-[ RADIO ]-

This  option will display  a list of  the Radio  Streams you've  added to the
"menu.conf" file (see "Radio Streams" below).  You  can  pick which stream to
play from here.

-[ OPTIONS ]-

Using  the Options menu you can  configure various aspects  on how MPlayer CE
handles  playback of  your multimedia files. The options and descriptions are
listed below.

General
  OSD Level: 0-3
  Loop: 1-999

Audio
 Audio Stream
 Volume
 Balance
 Mute
 Delay

Video
  Frame Dropping: Enabled / Disabled
  
Subtitles
  Visibility: Enabled / Disabled
  Position: 100 through 0
  Delay: -3600 through 4700

Properties
  Displays the Properties of the current file you're playing

Aspect
  16:9
  4:3
  2.35:1

ח  --
|0Oo                             CONTROLS                          oO0|
`    '

 Wiimote      GameCube Controller     Function                 Input.conf key
 ----------------------------------------------------------------------------
    A                 A               Pause                           a
    B                 B               Toggle Menu                     b
    1                 X               Close Menu / Show OSD           x
    RIGHT             RIGHT           Seek 10s forward                RIGHT
    LEFT              LEFT            Seek 10s backward               LEFT
    UP                UP              Seek 60s forward                UP
    DOWN              DOWN            Seek 60s backward               DOWN
    +                 R               Next Chapter                    r
    -                 L               Previous Chapter                l
    HOME              Z               Quit                            z
    2                 Y               Modifier Key

ח  --
|0Oo                  DVD READING & DVD-VIDEO PLAYBACK             oO0|
`    '

The Nintendo Wii is capable of reading DVD DATA and DVD-VIDEO discs, but this
functionality  while  left  into  the  Nintendo  Wii  needs  to be enabled by 
installing  DVDx from  Team Twiizers.  If you use USB2 and have installed the 
cIOS202 then you don't need a DVDx install at all, as the cIOS has a patch to 
access DVD without it.
You  can  locate  DVDx  from  the URLs below.  
Make sure to install  the  correct version as there is one for System Menu 
3.2/3.3  3.4  and 4.0
DVDx 3.2/3.3 -> http://hackmii.com/2008/08/libdi-and-the-dvdx-installer
DVDx 3.4 -> http://hackmii.com/2009/02/dvdx34/
DVDx 4.0 -> http://bootmii.org/download/

ח  --
|0Oo                           RADIO STREAMS                       oO0|
`    '

You can add your own radio  streams to MPlayer CE via editing the "menu.conf"
file.  Locate the included streams and copy  one and enter in the  new stream
information. As you can see below you need to specify a name and the location
of the PLS file. You can find thousands of PLS files here:

http://www.winamp.com/media/radio

Example:

<e name="Woxy radio" ok="loadlist 'http://woxy.lala.com/stream/aac32.pls'"/>

ח  --
|0Oo                         Youtube/SHOUTcast                     oO0|
`    '
You can add changes to the Youtube/SHOUTcast, check your menu.conf. 
By default it is running via Extrems' Server.

ח  --
|0Oo                             CHANGELOG                         oO0|
`    '

v0.76
   * Fixes for 4.2 update
   * Stability fixes (hopefully freezing is gone forever now)
   * Network (LAN and WAN) speeds increased
   * Added directory play feature
   * YouTube section entirely revamped
   * Added Nintendo Channel content (quality may not yet be optimal) (thanks to yellowstar6 for his work on ninchdl-listext)
   * [blip.tv was planned but couldn't make it on time]
   * Many, many more bugs fixed

v0.75
   * FTP support added
   * NTFS support added for USB and SD
   * SMB speed improved
   * Hopefully finally eradicated the freezing bug
   * Fixed noise bug when loading another stream

v0.72
   * Fix playlist bug
   * More SMB servers detected (thanks to hax)
   * SMB now supports user-level share security (thanks to hax)
   * SMB now supports plain text passwords (thanks to hax)

v0.71
   * Autoload implemented. If the next file has a very similar name (using a
     Levenshtein distance of 2) it will be autoloaded. 
     Examples: film.part1.avi > film.part2.avi (1 change)
               episode.s01e09.avi > episode.s01e10.avi works (2 changes)
   * Improved memory management: fixes MPlayer hanging if out of memory.
   * OSD level 3 now shows mem1 and mem2 info.
   * Driver improved with autodetection error: on error the device is reinitied
     and read is retried.
   * Restore Points fixed. Now quit or power off saves restore point and can
     resume properly. Please delete your previous restore_point file in case
     it is corrupted, and check that your SD card isn't locked.
   * Improved SMB connections: now SMB will always reconnect.
   * Improved stream initialisation.
   * Fixed green lines at the top of loading screen.
   * Further improved video compatibility
   * Added ability to load an external driver from SD for USB 2.0 testing.
     More details (and drivers) will be added to the Google Code page at a
     later date.  Thanks to Hermes for the patch.
   * Finally fixed the problem with network and USB 2.0 conflicts
     (due to the driver using a bad device).
   * Font loading improved.
   * Improved MPlayer support when a file unexpectedly disappears and reappears.
   * Many other small fixes and code cleanup.
   * New USB test:
      - If http://mplayer-ce.googlecode.com/files/USB%20Test.rar says USB device
        is compatible but a device is not working then there is no FAT partition
        on the device.  Check if you are using NTFS or exFAT instead.

v0.7
   * Use small cache if opening an internet stream (audio and video).
   * Optimized memory access (thanks to a 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:
      - fix for special characters
      - prevent possible corruption on sd
      - can now mount any FAT partition, whether primary or active
      - real FAT32 limit so larger files can be played
   * Improved USB hotplug and DVD detection
   * ECHI module modified for greater compatibility with USB devices.
   * Improved video compatibility.
   * New buffering system implemented.  If the cache drops below 3% MPlayer will
     pause and re-buffer to prevent possible hangs with bad connections. Cache is
     shown on OSD level 3.
   * Shoutcast TV is complete with caching, thanks to Extrems.  Please see
     menu.conf.
   * If new cIOS is used then DVDx is not required for DVD access.
   * New cIOS Installer:
      - Installs IOS202 using base IOS60 automatically for greater WiFi support.
      - Ability to select the IOS to use so you can select an IOS with the
        fakesign bug.

v0.62
    * 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:
      http://mplayer-ce.googlecode.com/files/usb.jpg
    * Horizontal stretch parameter added (see mplayer.conf)
    * YouTube options added to menu.conf (thanks to Extrems)
    * Many small bug fixes

v0.61
    * New screen size variables actually work now.
    * Better usb device detection
    * Using free Liberation font instead of Arial
    * Subtitle wraparound bug fixed

v0.6
    * 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

v0.5
    * 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 nunchuck
    * 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

 v0.4

    * USB 2.0 support
    * TTF font support
    * 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

 v0.3
 
    * 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)
 
 v0.21e
     
    * Fixed apostrophies in filenames
    * Improved DVD and USB mounting devices
    * Fixed radio
    * Improved samba reconnection
    * Debugging help for SMB Shares at bootup. It will pause for 10 seconds.
      #debug_network=yes Review mplayer.conf

 v0.21d

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

 v0.21c

    * Updated menu.conf to allow selecting subtitles

 V0.21b

    * 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. 
    * Fixed hang when you access dvdnav 

 V0.21

    * Reduced font size
    * New Readme
    * New mplayer.conf option: component_fix=yes to fix side bars on some
      problematic TVs

 V0.2

    * 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 

V0.1

    * 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 

ח  --
|0Oo                              CREDITS                          oO0|
`    '

                          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 - SHOUTcast/Youtube Patches
                            Tantric - SMB Improvements		
                                hax - FTP devoptab
                                 Shareese - NTFS						
                              Brakken - Documentation
                                 Blue_K - loop.avi
						  yellowstar6 - ninchdl-listext
                              
                              Thanks Goes Out To ...
                              
                                      [rOn]
                                  Team Twiizers
                                 GeeXboX Authors
	                            dargllun									 
                                      Daca
                           Shagkur & LibOGC Contributers
                              
ר    rK