readme

MMP: Minimalist Media Player

THE OPINION POLLS ARE OPEN! HAVE YOUR SAY: Discussion Polls

VERSION 3 introduced the Image & Thumbnail Browser with image manipulation and saving. Check it out! Download Page mmpimagebrowser.jpg

VERSION 2 RELEASED: Fast, lossless audio and video editing - see Editing Overview mmpvideoeditor.jpg

Now also displays all IMAGES in the current playlist folder (.jpg, .jpeg, .bmp, .png, .webp, animated .gif, .avif). If you set an image display duration, a slideshow of consecutive image files will be shown.

Get the latest release here: Releases

NEW: Now supports .AVIF image files which will be included automatically in the playlist and the slideshow.

TIP: You can crop an image by using zoom ([I]n/[O]ut) and pan (Ctrl-left, ctrl-right, ctrl-up, ctrl-down) until the window shows only the part of the image you want, then [F5] screenshot it to a new file. The screenshot will include any changes you've made to the Brightness, Contrast, Gamma, Saturation or Rotation of the original image.

TIP: You can edit (Ctrl-[E]) an entire audio or video file using just [I] and [O] to set [I]n and [O]ut points. E.g. Use the TAB key to fast forward through a video: when you get to the next section you want to include, press [I]; when you get to the next section that you want to exclude, press [O]. When you're done, click Export. It really doesn't get much easier than that!!

MMP: Minimalist Media Player

A powerful and very effective media player built on MPV's API, libMPV, which is, in turn, built on the famous FFMPEG.

MMP: Minimalist Media Player provides a minimalist keyboard- and mouse-operated user interface. Minimal on-screen clutter allows videos to be viewed without distractions. There are no window borders and no window title bar/caption, and keyboard options allow you to also have no progress bar and no audio/video timestamp, if that's what you want.

Also, the window resizes to fit the video perfectly, eliminating ugly black borders/bands around the video, particularly above and below. All of this provides an immersive viewing experience even when played in window mode rather than full-screen. Despite all this, MMP: Minimalist Media Player provides a wealth of functions via the keyboard and mouse for manipulating the user-interface and the media files themselves.

This is a complete rewrite of (and supercedes) an earlier application that was built on Windows Media Player. As such, MMP: Minimalist Media Player, built on MPV/FFMPEG, provides far superior media file handling and playback functionality such as zoom, pan, step frame (forwards and backwards!), rotation, brightness control, etc. and will play the overwhelming majority of the World's media files (audio/video/image). mmp.jpg

Key Features

  • Automatically matches the aspect ratio of the window to the aspect ratio of the video so it fits the window perfectly, but still allows you to zoom and pan. This is something the MPV player itself doesn't do - you can only have one or the other. So no ugly borders. Ever. Unless they're hard-baked into the video, of course.
  • Opening a media file from Windows Explorer (etc.) will automatically fill the playlist with all media files in the same folder. The playlist is sorted in “natural order” to match the order your files are [usually] listed in your file manager, taking numeric digits in filenames into account.
  • You can “fast forward” through an entire media file by holding down the TAB key. Or backwards by holding down CTRL-TAB. Thanks to MPV, the audio is maintained at the correct pitch.
  • If a corresponding subtitle file exists for the media file (.srt file, for example), or if the media file contains subtitles, the subtitles will be shown automatically. [F7] will cycle through all the subtitle tracks in the media file.
  • Full-resolution screenshots can be saved for individual frames and for a displayed image.
  • All the keyboard and mouse functions (nearly 200) are listed in a handy help panel which can be shown or hidden by pressing Ctrl-[H]. The full functionality of MMP: Minimalist Media Player can be used while this panel is showing so you can try things out.
  • MMP: Minimalist Media Player provides handy keyboard access to brightness, contrast, gamma and saturation. Handy tip: quite often, if you want to brighten the picture, increasing the gamma setting (and sometimes the contrast) gives better results than going straight to the brightness control.
  • You can quickly bookmark the current position of a media file and restart from that point at a later time.
  • You can quickly resize the video by holding down the [G] key to enlarge it. Or quickly reduce it by holding down Ctrl-[G].
  • MMP: Minimalist Media Player provides full zoom and pan functions as well as video rotation.
  • MPV playback can be configured via the normal mpv.conf file. As always with this file, some experimentation will be required to get the effect you require.
  • N.B. Many keys can be held down for rapid repetition.

Keyboard Controls


Although there are a lot of keyboard controls, the alphabetic letters have been applied intuitively. The action description will therefore help to associate the action with the letter.

Many of these controls also apply to the Image & Thumbnail Browser. However, in some cases, the Image & Thumbnail Browser uses a different key for the action described below than what the Main Media Window uses (e.g [5] vs [F5] for screenshots). Also, the Image & Thumbnail Browser has additional key controls specific to managing your image library which are not available in the Main Media Window. Refer to the Ctrl-[H] Help Panel in both the Main Media Window and in the Image & Thumbnail Browser if you're unsure. In both cases, the Help Panel can be left open while you use the full functionality of MMP, in order to help you learn the many controls available to you.

Control Action
Ctrl-H toggle the [H]elp panel listing all the keyboard and mouse functions
Shift-\ display the MMP config dialog
ESCape exit Fullscreen mode, or exit the app if not in fullscreen mode
SPACEBAR pause/resume playback of audio/video. pause/resume slideshow of images
BACKSPACE reset zoom, pan, rotation, speed, brightness, contrast, gamma, saturation and captions/progress bar brightness to normal
Numlock and mouse with NumLock on, run your mouse along the progress bar to quickly “scrub” backwards and forwards through the video
Ctrl and mouse alternatively, hold a Ctrl key down to temporarily “scrub” along the progress bar with the mouse
Right Arrow pauses the video and steps forwards one frame. Can be held down for rapid continuous stepping
Left Arrow pauses the video and steps backwards one frame. Can be held down for rapid continuous stepping
Up Arrow increase the volume. Can be held down for rapid increase
Down Arrow decrease the volume. Can be held down for rapid decrease
Ctrl-Up Arrow pan up. Can be held down for continuous panning (Ctrl-Shift for double speed)
Ctrl-Down Arrow pan down. Can be held down for continuous panning (Ctrl-Shift for double speed)
Ctrl-Left Arrow pan left. Can be held down for continuous panning (Ctrl-Shift for double speed)
Ctrl-Right Arrow pan right. Can be held down for continuous panning (Ctrl-Shift for double speed)
Left button down drag the media window around the screen, but not when Playlist panel is open
Ctrl+Left button down drag the media window around the screen, even when the Playlist panel is open
Pg Up rotate video left/anti-clockwise (you must have first rotated right at least once)
Pg Dn rotate video right/clockwise (you must do this at least once before you can rotate left)
INSERT copy media file name (without the extension) to the clipboard. e.g. for saving the file after F12
Vol+ media key increase the volume. Can be held down for rapid increase
Vol- media key decrease the volume. Can be held down for rapid decrease
Vol-mute media key mute/unmute sound
Numpad + increase playback speed. Can be held down for rapid increase
/ increase playback speed. Can be held down for rapid increase
Numpad - decrease playback speed. Can be held down for rapid decrease
\ decrease playback speed. Can be held down for rapid decrease
# briefly reshow the media caption (the filename and its position/number in the playlist)
8 decrease brightness. Can be held down for rapid decrease
9 increase brightness. Can be held down for rapid increase
2 reset brightness to normal
0 reset contrast to normal
- (Hyphen) decrease contrast. Can be held down for rapid decrease
= increase contrast. Can be held down for rapid increase
{ decrease saturation setting. Can be held down for rapid decrease
} increase saturation setting. Can be held down for rapid increase
[ decrease gamma setting. Can be held down for rapid decrease
] increase gamma setting. Can be held down for rapid increase
; reset saturation to normal
' (single quote) reset gamma to normal

Alphabetic and Numeric Controls


Control Action
A or HOME play the first media file in the playlist (Z/END plays last)
Ctrl-A show [A]bout Box. Checks for updates if autoUpdates=yes is in .conf
B [B]lankout/restore progress [B]ar
Ctrl-B Make the progress [B]ar [B]righter/more prominent
Ctrl-Shift-B Make the progress [B]ar darker/less prominent
C show/hide on-screen [C]aptions (toggle media file timestamp, hide media metadata)
Ctrl-C show/hide all on-screen [C]aptions (media file timestamp and media metadata)
DEL [D]elete current media file (after user confirmation) - deletion functions can be disabled by deleting rot.exe
Ctrl-DEL [D]elete all files in the current media file's folder (after user confirmation) - subfolders are not affected - deletion functions can be disabled by deleting rot.exe
E [E]ars - mute/unmute sound
Ctrl-E toggle the media timeline [E]diting tools for lossless editing of audio and video files
Shift-E play the [E]xported/[E]dited media file in a new MMP window
F show/cancel [F]ullScreen mode
G [G]reater window size. Can be held down for rapid increase
Ctrl-G reduce, i.e. un[G]reater, the window size. Can be held down for rapid decrease
H position the window [H]orizontally (and Vertically) in the center of the screen
Ctrl-H toggle the [H]elp panel listing all the keyboard and mouse functions
I zoom [I]n. Can be held down for rapid zooming
J [J]ust waiting to be assigned an action
K mark this media file as [K]eep (renames with a leading ! to bring to top of folder)
L re[L]oad the playlist with all supported media files from the current folder. Useful when you have knowingly changed the folder contents while the app is running. Saves having to restart the app to access the new folder contents
M Maximize the video to the largest allowable by the screen whilst maintaining the correct aspect ratio. Very occasionally, the window might be positioned so that the bottom edge is behind the Windows taskbar. This corrects that
Ctrl-M [M]ove the current media file to the folder specified in the moved= user folder in the .conf file
Shift-M [M]ove the current media file to the folder specified in the moved= user folder in the .conf file
N mi[N]imize window to the Windows taskbar
O zoom [O]ut. Can be held down for rapid zooming
P show/hide the [P]laylist
Q play the previous media file in the [Q]ueue/playlist
R [R]ename the current media file
Ctrl-R toggle infinite [R]epeat of the current media file
S re[S]tart the current media file from the beginning, aka [S]tartover
Ctrl-S toggle subtitles on/off
Shift-S [S]ave (move) the current media to the folder specified in the saved= user folder in the .conf file
T Tab through the media file. See below in Category section
U [U]nzoom, i.e. re-fit the video to the window
V synchronize all [V]ideo windows
W or Numpad ENTER [W]atch the next video in the list (or play the next audio)
X e[X]it the application
Y [Y]et to be assigned an action
Z or END play the last media file in the playlist (A/HOME plays the first)
1 reset the playback speed to normal, i.e. [1]00%
2 reset Brightness to normal
3 reset Panning to normal
4 reset Rotation to normal/not rotated
5 bookmark the current media file timestamp to the configuration file
6 retrieve a bookmarked media file timestamp from the configuration file and continue playback from that point
7 delete any previously saved/bookmarked media file timestamp for the current media file
8 decrease brightness. Can be held down for rapid decrease
9 increase brightness. Can be held down for rapid increase
0 reset contrast to normal
- (Hyphen) decrease contrast. Can be held down for rapid decrease
= increase contrast. Can be held down for rapid increase
Ctrl-9 Auto-arrange up to 4 (or more) simultaneous videos
Ctrl-0 close all running instances of MMP

Full List of Controls By Category


Control Action
Brightness
8 decrease brightness. Can be held down for rapid decrease
9 increase brightness. Can be held down for rapid increase
2 reset brightness to normal
Contrast
- (Hyphen) decrease contrast. Can be held down for rapid decrease
= increase contrast. Can be held down for rapid increase
0 reset contrast to normal
Editing (Ctrl-E)
Ctrl-E toggle the media timeline [E]diting tools for lossless editing both of audio and video files
Shift-E play the [E]xported/[E]dited media file in a new MMP window
I [I]n point: split segment at cursor and mark left-hand segment as e[X]cluded, i.e. deleted
O [O]ut point: split segment at cursor and mark right-hand segment as e[X]cluded, i.e. deleted
L [L]engthen the selected segment by one second
S [S]horten the selected segment by one second
M [M]erge the selected segment with the segment to its right
N [N]erge the selected segment with the segment to its left
R [R]estore the selected e[X]cluded segment
X e[X]clude the selected segment from the final edit
File Control
INSERT copy media file name (without the extension) to the clipboard. e.g. for saving the project file after F12
DEL [D]elete current media file (after confirmation)
Ctrl-DEL [D]elete all files in the current media file's folder (after user confirmation) - subfolders are not affected - deletion functions can be disabled by deleting rot.exe
K mark this media file as [K]eep (renames with a leading ! to bring to top of folder)
Ctrl-M [M]ove the current media to the folder specified in the moved= user folder in the .conf file
Shift-M [M]ove the current media to the folder specified in the moved= user folder in the .conf file
R [R]ename the current media file
Ctrl-Shift-[R] [R]ename/Cleanup the file name by replacing the “dirty” characters with spaces
Shift-S [S]ave (move) the current media to the folder specified in the saved= user folder in the .conf file
Freeze Frame
Right Arrow pauses the video and steps forwards one frame. Can be held down for rapid continuous stepping.
Left Arrow pauses the video and steps backwards one frame. Can be held down for rapid continuous stepping.
Gamma
[ decrease gamma. Can be held down for rapid decrease
] increase gamma. Can be held down for rapid increase
' (single quote) reset gamma
Mouse
Left click the window and hold the window can be dragged/repositioned
Left double-click the window toggle fullscreen mode
Right single-click the window pause/resume playback of audio/video. pause/resume slideshow of images
with Numlock on move mouse along the progress bar to “scrub” backwards and forwards through the media file
CTRL hold ctrl key down and move mouse along the progress bar. Same as above
Wheel up volume up
Wheel down volume down
On-Screen Display
# briefly reshow the media caption (the filename and its position/number in the playlist)
B [B]lankout/restore progress [B]ar
Ctrl-B Make the progress [B]ar [B]righter/more prominent. Hold for rapid increase. Your preference gets saved to the configuration file
Ctrl-Shift-B Make the progress [Bar] darker. Hold for rapid decrease. Your preference gets saved to the configuration file
C show/Hide on-screen [C]aptions (media info) and media file timestamp
Ctrl-C show/Hide all on-screen captions, media file timestamp and media metadata
Ctrl-S toggle subtitles on/off
Panning
Ctrl-Up Arrow pan up. Can be held down for continuous panning (Ctrl-Shift for double speed)
Ctrl-Down Arrow pan down. Can be held down for continuous panning (Ctrl-Shift for double speed)
Ctrl-Left Arrow pan left. Can be held down for continuous panning (Ctrl-Shift for double speed)
Ctrl-Right Arrow pan right. Can be held down for continuous panning (Ctrl-Shift for double speed)
3 reset panning to normal
Playback
SPACEBAR pause/resume playback of audio/video. pause/resume slideshow of images
Right single-click the window pause/resume playback of audio/video. pause/resume slideshow of images
Ctrl-R toggle infinite [R]epeat of the current media file
S re[S]tart the current media file from the beginning, aka [S]tartover
F8 skip to the previous chapter, if there is one
F9 skip to the next chapter, if there is one
Right Arrow pauses the video and steps forwards one frame. Can be held down for rapid continuous stepping.
Left Arrow pauses the video and steps backwards one frame. Can be held down for rapid continuous stepping.
Playlist
A play the first media file in the playlist (Z/END plays last)
HOME play the first media file in the playlist (Z/END plays last)
Z play the last media file in the playlist (A/HOME plays the first)
END play the last media file in the playlist (A/HOME plays the first)
W [W]atch the next video in the list (or play the next audio)
Numpad ENTER [W]atch the next video in the list (or play the next audio)
Q play the previous media file in the [Q]ueue/playlist
L re[L]oad the playlist with all supported media files from the current folder. Useful when you have knowingly changed the folder contents while the app is running. Saves having to restart the app to access the new folder contents
Shift-[Home] toggle shuffle mode on and off
Rotating
Pg Up rotate video left/anti-clockwise (you must have first rotated right at least once)
Pg Dn rotate video right/clockwise (you must do this at least once before you can rotate left)
4 reset rotation to normal/not rotated
Saturation
{ decrease saturation. Can be held down for rapid decrease
} increase saturation. Can be held down for rapid increase
; reset saturation to normal
Screenshots
F5 save a screenshot of the current frame or the currently displayed image
Speed
Numpad - decrease playback speed. Can be held down for rapid decrease
\ decrease playback speed. Can be held down for rapid decrease
Numpad + increase playback speed. Can be held down for rapid increase
/ increase playback speed. Can be held down for rapid increase
1 reset the playback speed to normal, i.e. [1]00%
Subtitles
Ctrl-S toggle subtitles on/off
F7 cycle through all subtitle tracks in the media file
Tabbing
T [T]ab through the media file a 100th (default) of its duration. Can be held down for rapid tabbing
Ctrl-T [T]ab back through the media file a 100th (default) of its duration. Can be held down for rapid tabbing
TAB tab forwards 1 second. Can be tapped repeatedly or held down to do a “fast forward” through the media file
Ctrl-TAB tab backwards 1 second. Can be tapped repeatedly or held down to do a “fast reverse” through the media file
Caps Lock-T tab forwards 200th of media duration. Can be tapped repeatedly or held down for “fast forward”
Caps Lock Ctrl-T tab backwards 200th of media duration. Can be tapped repeatedly or held down for “fast reverse”
Shift-T tab forwards 50th of media duration
Ctrl-Shift-T tab backwards 50th of media duration
Volume / Sound
Up Arrow increase the volume. Can be held down for rapid increase
Down Arrow decrease the volume. Can be held down for rapid decrease
Vol+ media key increase the volume. Can be held down for rapid increase
Vol- media key decrease the volume. Can be held down for rapid decrease
Vol-mute media key mute/unmute sound
E [E]ars - mute/unmute sound
F6 cycle through all audio tracks in the media file
Window Control
ESCape exit Fullscreen mode, or exit the app if not in fullscreen mode
F show/cancel [F]ullScreen mode
G [G]reater window size. Can be held down for rapid increase
Ctrl-G reduce, i.e. un[G]reater, the window size. Can be held down for rapid decrease
H
M Maximize the video to the largest allowable by the screen whilst maintaining the correct aspect ratio. Very occasionally, the window might be positioned so that the bottom edge is behind the Windows taskbar. This corrects that
N mi[N]imize window to the Windows taskbar
V synchronize all [V]ideo windows
Ctrl-9 Auto-arrange up to 4 (or more) simultaneous videos
Ctrl-0 close all running instances of MMP
Left button down drag the media window around the screen, but not when Playlist panel is open
Ctrl+Left button down drag the media window around the screen, even when the Playlist panel is open
Zoom
I zoom [I]n. Can be held down for rapid zooming in
O zoom [O]ut. Can be held down for rapid zooming out
U [U]nzoom, i.e. re-fit the video to the window
Additional
F5 save a screenshot of the current frame or the currently displayed image
F6 cycle through all audio tracks in the media file
F7 cycle through all subtitle tracks in the media file
F8 skip to the previous chapter, if there is one
F9 skip to the next chapter, if there is one
F10 open media file in PotPlayer (assumes default installation folder) - can be overridden in .conf
F11 open media file in LossLessCut (assumes default installation folder) - can be overridden in .conf
F12 open media file in ShotCut editor (assumes default installation folder) - can be overridden in .conf
Ctrl-A show [A]bout Box. Checks for updates if _autoUpdates=yes_ is in .conf
Ctrl-H show [H]elp panel of all keyboard and mouse controls
Shift-\ display the MMP config dialog
INSERT copy media file name (without the extension) to the clipboard. e.g. for saving the project file after F12
BACKSPACE reset zoom, pan, rotation, speed, brightness, contrast, gamma, saturation and captions/progress bar brightness to normal
SPACEBAR pause/resume playback of audio/video. pause/resume slideshow of images
readme.txt · Last modified: