User Tools

Site Tools


mmp:config

config file settings

volume=87

This is set by the volume controls in MMP

Caption and ProgressBar Colors

caption=$00A8A8A8
timeCaption=$00A8A8A8
progressBar=$00585858

These are set by the Ctrl [B], Shift [B] and Ctrl-Shift [B] controls in MMP

autoUpdate=yes/no

When set to yes and you then open the About Box with Ctrl [A], MMP will check online to determine the latest release version and compare that with the version you're running.
If you're not running the latest version, the latest version will be downloaded and unzipped and the version you're running will be renamed so that the next time you run MMP you will be running the latest version.
see Auto Update for a full explanation. Having autoUpdate= set to yes and opening the About Box with Ctrl [A] is the only time that MMP will ever attempt to go online.

muted=yes/no

This is set by the [E] (“[E]ars”) mute/unmute control in MMP

Controlling the Delete Functions in MMP

You have full control over what MMP can and cannot delete.
A confirmation dialog is always presented to the user prior to the deletion operation being actioned.

audioDelete=yes/no
imageDelete=yes/no
videoDelete=yes/no

If these are set to anything other than yes, MMP will be blocked from deleting any individual file that it classifies in these formats (based on the file extension).
These settings control the [DEL] function for deleting the current file.

folderDelete=yes/no

This setting controls the Ctrl [DEL] function in MMP and whether MMP can delete the entire [remaining] contents of any folder.
Hidden files in a folder are left as is. Ctrl [DEL] never affects the contents of subfolders within the current folder.

The Keep/Delete Function

Individual files can be marked as Kept using the [K] function. This will rename the current file so that it includes a leading underscore _ .
This has the effect, in Windows File Explorer,1) of bringing the file to the top of the folder.
You then easily select and delete the other files in the folder.

keepDelete=yes/no

Alternatively, with this setting set to yes, pressing Ctrl [K] will execute a Keep/Delete operation: files that have been [K]ept will be preserved; all other files in the current folder will be deleted.
Hidden files in a folder are left as is. The contents of any subfolders within the current folder will be unaffected.
If this setting is set to anything other than yes, MMP will block the Ctrl [K] Keep/Delete operation from being actioned.

deleteMethod=recycle/delete/shred

This setting governs all the above described deletion operations. Each deletion operation, if allowed to proceed by the above settings, uses the deletion method specified here.
In the absence of this setting, or a setting other than the three indicated, MMP will default to recycle.
recycle: each deleted file will be restorable to its original location from the Windows Recycle Bin.
delete: a standard Windows delete will occur. This has the effect of marking a file as deleted in the Master File Table.
Such files will no longer show up in File Explorer.
Such files are recoverable using recovery software tools for as long as their contents are not overwritten by the contents of other files.
shred: “Once they're gone, they are gone!”. Neither the contents of a file, nor its original filename are recoverable by recovery software tools.

openImage=browser

With this setting, launching MMP with an image file will result in the image being viewed in the Image & Thumbnail Browser rather than in MMP's main window.
If this is set to any value other than browser, launching MMP with an image will open the image in the main MMP window - In order to then view the image in the Image & Thumbnail Browser you may either press Ctrl [I] to view the image immediately, or you can press [T] or [Y] to launch the Image & Thumbnail Browser in thumbnail mode.

exitBrowser=exitApp

In tandem with the previous setting, exiting the Image & Thumbnail Browser will immediately exit MMP.
With these two settings, the user can, in effect, operate MMP as two applications in one:

  1. the main window responsible for playing and editing audio and video files;
  2. the Image & Thumbnail Browser for managing images.

With any value other than exitApp, exiting the Image & Thumbnail Browser will fall back to the main MMP window.
Other than Ctrl [0], which closes every running instance of MMP immediately, exiting the Image & Thumbnail Browser can be achieved using the [X] or [ESC]ape keys.
Ctrl [X] will exit back to the main MMP window, regardless of the value of this setting.

nextFolderOnEmpty=yes/no

If you delete the remaining files in a folder with Ctrl [DEL] or you delete the one remaining file in a folder with [DEL], you will be left with an empty playlist for that folder.
In that case, this setting will determine whether MMP proceeds to the next folder and plays or displays the first item it finds, or whether MMP will exit.

nextFolderOnEnd=yes/no

In both the main MMP window and the Image & Thumbnail Browser, MMP will remain on the final item in a folder if this setting is anything other than yes.
If this setting is yes, MMP will immediately navigate to the next folder.
In the Image & Thumbnail Browser this will only happen if you have activated the slideshow with the [Spacebar].
If not, you can use the up and down arrow keys ([↑] [↓]) to manually navigate to the previous or next folder.

allowIntoWindows=yes/no

MMP can play through all the media files on an entire drive. In the main MMP window this can include all images, all audio files and all video files.
In the Image & Thumbnail Browser's slideshow, this will include all images that MMP finds.
This setting determines whether MMP is allowed to navigate into the Windows folder on your machine.
Generally speaking, there shouldn't be an issue; however, it's vaguely possible that the permissions on some files or folders might cause issues for MMP.
The recommended setting is no for everyday use. If you wish to poke around in the Windows folder on the odd occasion, you can temporarily set this to yes.
In all cases, MMP will ignore the “WinSxS” folder which contains tens of thousands of folders of no interest to MMP. This setting governs not only automatic nagivation by MMP (for example when actioning the two previous settings) but it also prevents the user from manually navigating into the Windows folder.

playlistFormat=audio/video/image

The main MMP window's playlist can be limited to files of a specific format: images, audio or video.
Any other setting will result in playlists containing all the media files in a folder.
With one of the formats set, you activate (and deactivate) Playlist Filtering by pressing Ctrl [P].
With Playlist Filtering activated, navigating to another file or folder will be limited to files of that format.
In effect, Ctrl [P] activates a “slideshow” for your selected format. In the case of images, this will be an actual slideshow.
For that reason, when viewing an image, [Spacebar] and Ctrl [P] are synonymous - they both activate/deactivate the slideshow/Playlist Filtering.
Also, if you have Playlist Filtering activated and you edit this setting (while MMP is running) to change it from, say audio to image, you will see that the slideshow is, indeed, already activated.

scaleFactor=50-100

This scales down the size of the “Confirm Delete” dialog window. The dialog can look very big on some smaller monitors. This setting can be changed in the .conf file while MMP is running so you can easily experiment to find a size that suits. scaleFactor=90 reduces the dialog to 90% of its designed size.

showMetaData=yes/no

This is set by Ctrl [C] when turning on/off the media file metadata captions.

repeatDelayMs=100

This limits the keyboard repetition when holding down the left and right arrow keys ([→] [←]) to rapidly navigate through all the images in the current playlist folder.
The default is 100ms, specified as repeatDelayMs=100.
When holding down either of these keys it's possible, depending on the [large] size of an image, for the keyboard to instruct MMP to display the next/previous image before the current image has finished being rendered to the screen.
Although MPV signals to client applications like MMP that a file has been loaded [physically from disk] MPV doesn't indicate when that file [in the case of an image] has finished being rendered to the screen.
As a result, the 100ms default is a compromise which seems to work for most images, but may need to be taken into consideration when rapidly flicking through multiple images.
100ms may be too short for some large images. Conversely, increasing the delay to, say, 500ms (half a second) may be noticeably too slow for smaller images and holding down an arrow key may seem unduly ponderous.
If it is vitally important that you don't miss a single image in a folder and get to see every single one, you should be aware of the limitations of holding down the arrow keys.
Remember, you always have the option of single-tapping the arrow keys and waiting for an image to display before repeating the keyboard stroke.

Launching External Apps

From the main MMP window (not from the Image & Thumbnail Browser), the current image, audio file or video file can be opened in one of three external apps by pressing the [F10], [F11] or [F12] key.
Currently MMP defaults to opening PotPlayer, LosslessCut, and ShotCut, assuming they are installed in the following locations:
PotPlayer: C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe
LosslessCut: C:\Program Files\LosslessCut-win-x64\LosslessCut.exe
ShotCut: C:\Program Files\Shotcut\shotcut.exe

All three external applications can be overridden by the following three settings:
F10=
F11=
F12=

For example, F11=B:\Tools\Classic Paint\Program\mspaint.exe
See the main topic at User-Defined Applications

User Folders

In the Image & Thumbnail Browser images can be moved ([S]ave, or [F1] to [F12]) or copied ([C]opy) to various user-specified folders to separate them into different categories. The following settings apply:

baseFolder=
copied=
saved=
folder1=
folder2=
folder3=
folder4=
folder5=
folder7=
folder6=
folder8=
folder9=
folder10=
folder11=
folder12=

User folders and these settings are explained in detail in User Folders

moveFolder=<folder path>

This setting only applies to the main media window not the Image & Thumbnail Browser.
Ctrl-[M] in the main media window will move the media file to the specified folder. The setting should contain the full path to a folder.

1)
or whichever alternative file explorer software you're using, such as Directory Opus
mmp/config.txt · Last modified: 2025/04/14 13:15