MMP: Minimalist Media Player

This is set by the volume controls in MMP

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

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

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.

This is set by the [E] (“[E]ars”) mute/unmute control 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.

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.

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

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.

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.

With this setting, launching MMP with an image file will result in the image being viewed in the Image & Thumbnail Browser rather than in the Main Media Window.
If this is set to any value other than browser, launching MMP with an image will open the image in the Main Media Window - in order to then view the image in the Image & Thumbnail Browser you may either

• press Ctrl [I] to view the [I]mage immediately, or
• you can press [T] or [Y] to launch the Image & Thumbnail Browser in [T]humbnail mode.

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 Media Window, responsible for playing and editing audio and video files (particularly if you set the Audio & Video playlist filter)
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 Media 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 always exit back to the Main Media Window, regardless of the value of this setting.

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.

In both the Main Media 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 you haven't, you can use the up and down arrow keys ([↑] [↓]) to manually navigate the Image & Thumbnail Browser to the previous or next folder.

MMP can play through all the media files on an entire drive. In the Main Media Window this can include all images, all audio files, all video files, or all audio & 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.

The Main Media Window's playlist filter can be limited to files of a specific format: images, audio, video, or audio & 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.
With the release of v5.1.0, Playlist Filtering is always in effect right from the launch of MMP. You can change the filter and re[L]oad the playlist from the current folder if you wish.

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, the default, reduces the dialog to 90% of its designed size.

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

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.

From the Main Media 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

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. A limited subset of this functionality is also available in the Main Media Window.
The following settings apply:

baseFolder=
copied=
moved=
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

This setting only applies to the Main Media Window not to the Image & Thumbnail Browser.
Ctrl-[M] or Shift-[M] in the Main Media Window will [M]ove the media file to the moved= folder.
Shift-[S]ave will [S]ave/move the file to the saved= folder.

In both cases, the baseFolder must be a fully-qualified path to a folder, e.g. c:\pictures\
The other folders can either be fully-qualified paths to folders, or specified as sub-folders of the base folder.

If you have a lot of video editing to do, this setting can be used to launch MMP straight into the Audio & Video Timeline Editor when you click on a video file in your file explorer application (Windows Explorer or Directory Opus, etc.).
Moreover, as of v4.2.0, once open, the Audio & Video Timeline Editor will remain open if you switch to a new video file using any of the Playlist controls: e.g.

• [W]atch next, or
• [Q]ueue previous, or
• click on an item in the Playlist Panel, or
• [Del]ete the current video

If the next item is not a video file, or if the file's path or filename break the rules about which characters are permissible when editing, the Audio & Video Timeline Editor will close.
To clarify: the Audio & Video Timeline Editor remaining open is standard functionality irrespective of the startInEditor setting.

Ctrl-Shift-[R] will [R]ename/Cleanup a file name by replacing any occurrences of a “dirty” character with a space.
Such characters fall into three categories:

• those that will definitely break the Audio & Video Timeline Editor's Export and Join command line (specifically, an apostrophe)
• those that you consider utterly superfluous to the file name (e.g. where dots have been used in place of spaces)
• Unicode characters that you subsequently discover also break the Export and Join command line, in addition to an apostrophe

Whichever characters you designate as “dirty” in the Config Dialog, an implicit apostrophe will always be added to them.
If, when you try to open the Audio & Video Timeline Editor with Ctrl-[E], it complains about an apostrophe in the file name, a quick Ctrl-Shift-[R] will resolve it.
If, when you try to Export and Join your edited video, FFmpeg throws up errors about being unable to open a “non-existent” file, this is typically down to one or more Unicode characters being present in the file name which you should add to your list.
If the offending character is actually in one of the folder names (in the path to the file), you will have to rename the folder(s) manually - MMP will only rename the file.

This is set using the Shift-[Home] command key.