The tiny MPUI user manual

Version: 1.1.5
Last Modified: 2006-03-18

Note: This document is not intended to be a complete manual on how to use a video player. Instead, it focuses on MPUI's special features.

Starting Playback

To play one or many media files, such as .mpg, .avi, .mov or .mp4, they can be dragged from a file manager application (e.g. Explorer) and dropped onto MPUI's main window. This will replace the current playlist (see below) and automatically start playback. Alternatively, files or network URLs can be opened from the menu.

MPUI automatically detects efforts to play back IFO files, DVD/VCD directories or whole drives and handles these requests gracefully.

A file name or URL may be specified at the MPUI command-line to be played on startup. This means that MPUI can be registered with the Windows shell using the »Open With« or »Send To« menus.


MPUI offers two basic types of navigation: »Direct« seeking using the seek bar below the video display panel, or »incremental« seeking using MPlayer's keyboard shortcuts. Please note that neither of these methods will work perfectly on all media types – especially in MPEG streams, one or both methods are likely to be broken. This is a limitation of MPlayer, not MPUI.

Keyboard and mouse bindings

Right/Left arrowseek forward/backward by 10 seconds
Up/Down arrowseek forward/backward by 1 minute
PgUp/PgDnseek forward/backward by 10 minutes
Dtoggle frame dropping (only visible if the CPU is too slow)
Double click
toggle fullscreen mode
Ctoggle »compact« mode (no title bar, menu bar and navigation bar)
Ltoggle playlist window
Ttoggle always-on-top mode
Ocycle through OSD modes: no OSD, basic OSD, time display, total time display
P or Spacetoggle pause mode
Qquit MPUI immediately
Screate a screenshot: a file called shotXXXX.png (where XXXX are numbers from 0001 on) will be created in MPUI's startup directory
Tabshow or hide controls in fullscreen mode
1/2adjust contrast
3/4adjust brightness
5/6adjust hue
7/8adjust saturation
Keypad ÷/×
Mouse wheel
adjust volume
Keypad /+adjust audio sync
Ctrl+Keypad /+adjust playback speed
Ctrl+0reset playback speed to normal
Ctrl+Lopen URL
Ctrl+Oopen media file
Ctrl+Wclose file (i.e. stop playback)
Alt+0disable window size lock
Alt+1lock window size to half the video size
Alt+2lock window size to the video size
Alt+3lock window size to twice the video size
open menus
Right clickshow video popup menu


Sound output driver: Select the sound output method. In most cases, DirectSound should work OK. In case of problems, try Win32 output. The other two options are only useful for buggy files.

DirectSound output device: If DirectSound is used and multiple sound cards are installed in the system, the card used for sound output can be selected here.

Postprocessing can improve the perceived video quality by smoothing blocking and ringing artifacts that result from compression. Automatic postprocessing automatically determines a feasible amout of smoothing based on the image content and remaining CPU time, whereas maximum quality postprocessing always filters with maximum strength.

Aspect ratio: If MPlayer's movie aspect ratio autodetection fails, the most common aspect ratios can be forced using this option.

Deinterlace: Video content produced for television often produces unfavorable comb-like artifacts when played back on progressive-scan displays such as computer monitors. MPUI offers two deinterlacing filters: The Simple one smoothes the artifacts away, retaining only half of the image's original resolution. The adaptive filter tries to detect the image areas where the artifacts are visible, which usually gives a slightly better quality at the cost of increased CPU load. Both methods deteriorate the quality of non-interlaced material (e.g. movies), so deinterlacing should normally be turned off.

The rebuild file index if necessary option is useful for broken AVI streams where the last part of the original file is missing, e.g. due to transmission errors. Normally, MPlayer will not be able to seek in such files. With the index rebuild option enabled, MPlayer scans the whole file when it is opened, allowing for seeking in such files. The downside is that the time needed for opening the file is much longer.

If clips play back too silently, software volume control can be enabled. In this mode, the volume can be raised up to 10 times full scale. Note that the volume slider stops at 100%. To reach higher values, the keyboard shortcuts mentioned above or the mouse wheel have to be used.

The higher priority option is useful if other CPU-consuming processes running on the machine cause framedrops.

Configuration Files

MPUI stores its configuration only when requested using the Save button in the options dialog. The configuration will then be stored in a normal Windows INI file called MPUI.ini in MPUI's program directory.

On startup, MPUI checks for configuration data in the files autorun.inf and MPUI.ini (again, in the MPUI.exe directory), in this order. This unusual behavior, in combination with the option AutoPlay=1 in the [MPUI] section, allows simple creation of self-playing video CDs: Simply put MPUI.exe, MPlayer.exe, the autorun.inf from the MPUI package and one(!) playable video file on a CD or DVD. The disc will now auto-play its content if put into any Windows PC with Autorun enabled. This is quite cool because the target PC doesn't need to install any codecs, it only adds about 3.5 MB to the CD/DVD and the target PC's user gets a nice media player application for free :)