This commit is contained in:
Frank Skare
2020-04-15 20:28:30 +02:00
parent 7f55ad908a
commit c54f240346
3 changed files with 179 additions and 23 deletions

View File

@@ -1,10 +1,4 @@
To Do
=====
add vpy support to docs
5.4.4.3 Beta (not yet released) 5.4.4.3 Beta (not yet released)
============ ============

191
Manual.md
View File

@@ -1,6 +1,9 @@
# mpv.net manual
## Table of contents mpv.net manual
==============
Table of contents
-----------------
* [About mpv.net](#about-mpvnet) * [About mpv.net](#about-mpvnet)
+ [Target Audience](#target-audience) + [Target Audience](#target-audience)
@@ -14,6 +17,7 @@
+ [MediaInfo.NET](#mediainfonet) + [MediaInfo.NET](#mediainfonet)
* [Command Line Interface](#command-line-interface) * [Command Line Interface](#command-line-interface)
* [Terminal](#terminal) * [Terminal](#terminal)
* [Extensions](#extensions)
* [Color Theme](#color-theme) * [Color Theme](#color-theme)
* [Hidden and secret features](#hidden-and-secret-features) * [Hidden and secret features](#hidden-and-secret-features)
* [Context Menu](#context-menu) * [Context Menu](#context-menu)
@@ -96,7 +100,8 @@
+ [Exit](#exit) + [Exit](#exit)
+ [Exit Watch Later](#exit-watch-later) + [Exit Watch Later](#exit-watch-later)
## About mpv.net About mpv.net
-------------
mpv.net is a modern desktop media player for Windows. mpv is similar to VLC not based on DirectShow like MPC, mpv.net is based on libmpv which in return is based on ffmpeg. mpv.net is a modern desktop media player for Windows. mpv is similar to VLC not based on DirectShow like MPC, mpv.net is based on libmpv which in return is based on ffmpeg.
@@ -104,15 +109,15 @@ libmpv provides the majority of the features of the mpv media player, a fork of
mpv.net is designed to be mpv compatible, almost all mpv features are available because they are all contained in libmpv, this means the official [mpv manual](https://mpv.io/manual/master/) applies to mpv.net. mpv.net is designed to be mpv compatible, almost all mpv features are available because they are all contained in libmpv, this means the official [mpv manual](https://mpv.io/manual/master/) applies to mpv.net.
### Target Audience
The target audience of mpv and mpv.net are programmers, nerds and software enthusiasts that need a desktop player that is more advanced than a normal desktop player. mpv.net is very similar to mpv so it's well suited to learn mpv. Requirements
------------
## Requirements
mpv.net requires minimum .NET Framework 4.8 and Windows 7. For optimal results a modern graphics card is recommended. mpv.net requires minimum .NET Framework 4.8 and Windows 7. For optimal results a modern graphics card is recommended.
## Installation
Installation
------------
mpv.net is available as setup and as portable download in the 7zip and Zip archive format, to unpack the portable download 7zip can be used, it is available at www.7-zip.org. mpv.net is available as setup and as portable download in the 7zip and Zip archive format, to unpack the portable download 7zip can be used, it is available at www.7-zip.org.
@@ -137,7 +142,9 @@ Alternatively, Chocolatey can also be used:
`choco install mpvnet.install` `choco install mpvnet.install`
### File Associations
File Associations
-----------------
File Associations can be created using the setup or with the context menu under 'Tools > Setup'. File Associations can be created using the setup or with the context menu under 'Tools > Setup'.
@@ -147,7 +154,9 @@ It's also possible to change the default application using the 'Open with' featu
[Open with++](#open-with) can be used to extend the File Explorer context menu to get menu items for 'Play with mpv.net' and 'Add to mpv.net playlist'. [Open with++](#open-with) can be used to extend the File Explorer context menu to get menu items for 'Play with mpv.net' and 'Add to mpv.net playlist'.
## External Tools
External Tools
--------------
### Play with mpv ### Play with mpv
@@ -159,10 +168,12 @@ Due to Chrome Extensions not being able to start a app, another app that communi
This will start the app on system start and have it running in the background. When the file association registration of mpv.net was executed then the app should find the location of mpv.net, alternativly the mpv.net folder can be added to the Path environment variable. This will start the app on system start and have it running in the background. When the file association registration of mpv.net was executed then the app should find the location of mpv.net, alternativly the mpv.net folder can be added to the Path environment variable.
### External Application Button ### External Application Button
Alternatively Chrome/Firefox extension [External Application Button](https://github.com/stax76/mpv.net/issues/106) can be used. Alternatively Chrome/Firefox extension [External Application Button](https://github.com/stax76/mpv.net/issues/106) can be used.
### Open with++ ### Open with++
Open with++ allows to customize the File Explorer context menu to add menu items 'Play with mpv.net' and 'Add to mpv.net playlist'. Open with++ allows to customize the File Explorer context menu to add menu items 'Play with mpv.net' and 'Add to mpv.net playlist'.
@@ -173,6 +184,7 @@ https://github.com/stax76/OpenWithPlusPlus#mpvnet
https://github.com/stax76/OpenWithPlusPlus#add-to-mpvnet-playlist https://github.com/stax76/OpenWithPlusPlus#add-to-mpvnet-playlist
### MediaInfo.NET ### MediaInfo.NET
MediaInfo.NET is a media info GUI. MediaInfo.NET is a media info GUI.
@@ -189,7 +201,9 @@ If the path has spaces then it must be enclosed in quotes and then double backsl
`_ run "D:/Soft ware/MediaInfoNET.exe" "${path}" #menu: Tools > Open file with MediaInfo.NET` `_ run "D:/Soft ware/MediaInfoNET.exe" "${path}" #menu: Tools > Open file with MediaInfo.NET`
## Command Line Interface
Command Line Interface
----------------------
mpvnet implements a command line interface to set mpv commands. mpvnet implements a command line interface to set mpv commands.
@@ -201,7 +215,9 @@ Example:
`mpvnet --mute=yes <file|URL>` `mpvnet --mute=yes <file|URL>`
## Terminal
Terminal
--------
When mpv.net is started from a terminal it will attach to the terminal and print status debug and error messages to the terminal. When mpv.net is started from a terminal it will attach to the terminal and print status debug and error messages to the terminal.
@@ -209,7 +225,44 @@ In the context menu under 'Tools > Setup' a button can be found to add mpv.net t
JavaScript and Lua scripts must be debugged with the terminal as there is no debugger support available. JavaScript and Lua scripts must be debugged with the terminal as there is no debugger support available.
## Color Theme
Extensions
==========
Walkthrough creating an extension
---------------------------------
- Download and install [Visual Studio Community](https://visualstudio.microsoft.com).
- Create a new project of type **Class Library .NET Framework** and ensure the project name ends with **Extension**.
- Add a reference to **System.ComponentModel.Composition**.
- Add a reference to mpvnet.exe, select the mpvnet reference in the Solution Explorer, open the Properties window and set **Copy Local** to false to prevent mpvnet.exe being copied to the output directory when the project is built.
- Now open the project properties and set the output path in the Build tab, extensions are like scripts located in your config folder, example: `C:\Users\\%username%\AppData\Roaming\mpv.net\Extensions\ExampleExtension\ExampleExtension.dll`
- Also in the project properties choose the option **Start external program** in the Debug tab and define the path to mpvnet.exe. In the Debug tab you may also define command line arguments like a video file to be played when you start debugging.
Sample Code
-----------
### ScriptingExtension
The ScriptingExtension implements the C# scripting host using [CS-Script](https://www.cs-script.net/).
I use this extension as well to develop and debug all my C# scripts. Once the code was developed and debugged, I move the code from the extension to a standalone script.
<https://github.com/stax76/mpv.net/blob/master/extensions/ScriptingExtension/ScriptingExtension.cs>
### RatingExtension
This extension writes a rating to the filename of rated videos when mpv.net shuts down.
The input.conf defaults contain key bindings for this extension to set ratings.
<https://github.com/stax76/mpv.net/blob/master/extensions/RatingExtension/RatingExtension.cs>
Color Theme
-----------
mpv.net supports custom color themes, the definition of the built-in themes can be found at: mpv.net supports custom color themes, the definition of the built-in themes can be found at:
@@ -223,7 +276,24 @@ The theme.conf file may contain an unlimited amount of themes.
In the config editor under UI there are the settings dark-theme and light-theme to define the themes used in dark and in light mode. In the config editor under UI there are the settings dark-theme and light-theme to define the themes used in dark and in light mode.
## Hidden and secret features
Advanced Features
-----------------
### Playback of VapourSynth scripts
vpy files are supported with following mpv.conf configuration:
```
[extension.vpy]
demuxer-lavf-format = vapoursynth
```
Python and VapourSynth must be in the path environment variable.
Hidden Features
---------------
Selecting multiple files in File Explorer and pressing enter will open the files in mpv.net. Explorer restricts this to maximum 15 files and the order will be random. Selecting multiple files in File Explorer and pressing enter will open the files in mpv.net. Explorer restricts this to maximum 15 files and the order will be random.
@@ -231,7 +301,9 @@ Whenever the control key is pressed when files or URLs are opened, the playlist
Pressing the shift key while opening a single file will suppress loading all files in the folder. Pressing the shift key while opening a single file will suppress loading all files in the folder.
## Context Menu
Context Menu
------------
The most important part of the user interface in mpv.net is the context menu, the menu can be customized as it's defined in the same file where the key and mouse bindings are defined (input.conf). The most important part of the user interface in mpv.net is the context menu, the menu can be customized as it's defined in the same file where the key and mouse bindings are defined (input.conf).
@@ -249,6 +321,7 @@ Whenever the control key is pressed when files or URLs are opened, the playlist
Pressing the shift key while opening a single file will suppress loading all files in the folder. Pressing the shift key while opening a single file will suppress loading all files in the folder.
### Open > Open URL ### Open > Open URL
The Open URL menu entry can be used to open URLs for example from YouTube. The Open URL menu entry can be used to open URLs for example from YouTube.
@@ -259,18 +332,22 @@ When mpv.net is started from a terminal such as PowerShell, mpv.net attaches to
Whenever the control key is pressed when files or URLs are opened, the playlist is not cleared but the files or URLs are appended to the playlist. This works in all mpv.net features that open files or URLs. Whenever the control key is pressed when files or URLs are opened, the playlist is not cleared but the files or URLs are appended to the playlist. This works in all mpv.net features that open files or URLs.
### Open > Show media search ### Open > Show media search
mpv.net supports system wide media searches using the Everything indexing service installed by the popular file search tool Everything (www.voidtools.com). mpv.net supports system wide media searches using the Everything indexing service installed by the popular file search tool Everything (www.voidtools.com).
### Open > Load external audio files ### Open > Load external audio files
Allows to load an external audio file. It's also possible to auto detect external audio files based on the file name, the option for this can be found in the settings under 'Settings > Show Config Editor > Audio > audio-file-auto'. Allows to load an external audio file. It's also possible to auto detect external audio files based on the file name, the option for this can be found in the settings under 'Settings > Show Config Editor > Audio > audio-file-auto'.
### Open > Load external subtitle files ### Open > Load external subtitle files
Allows to load an external subtitle file. It's also possible to auto detect external subtitle files based on the file name, the option for this can be found in the settings under 'Settings > Show Config Editor > Subtitles > sub-auto'. Allows to load an external subtitle file. It's also possible to auto detect external subtitle files based on the file name, the option for this can be found in the settings under 'Settings > Show Config Editor > Subtitles > sub-auto'.
### Play/Pause ### Play/Pause
Play/Pause using the command: Play/Pause using the command:
@@ -281,6 +358,7 @@ Play/Pause using the command:
[pause property](https://mpv.io/manual/master/#options-pause) [pause property](https://mpv.io/manual/master/#options-pause)
### Stop ### Stop
Stops the player and unloads the playlist using the command: Stops the player and unloads the playlist using the command:
@@ -289,6 +367,7 @@ Stops the player and unloads the playlist using the command:
[stop command](https://mpv.io/manual/master/#command-interface-stop) [stop command](https://mpv.io/manual/master/#command-interface-stop)
### Toggle Fullscreen ### Toggle Fullscreen
Toggles fullscreen using the command: Toggles fullscreen using the command:
@@ -299,6 +378,7 @@ Toggles fullscreen using the command:
[fullscreen property](https://mpv.io/manual/master/#options-fs) [fullscreen property](https://mpv.io/manual/master/#options-fs)
### Navigate > Previous File ### Navigate > Previous File
Navigates to the previous file in the playlist using the command: Navigates to the previous file in the playlist using the command:
@@ -307,6 +387,7 @@ Navigates to the previous file in the playlist using the command:
[playlist-prev command](https://mpv.io/manual/master/#command-interface-playlist-prev) [playlist-prev command](https://mpv.io/manual/master/#command-interface-playlist-prev)
### Navigate > Next File ### Navigate > Next File
Navigates to the next file in the playlist using the command: Navigates to the next file in the playlist using the command:
@@ -315,6 +396,7 @@ Navigates to the next file in the playlist using the command:
[playlist-next command](https://mpv.io/manual/master/#command-interface-playlist-next) [playlist-next command](https://mpv.io/manual/master/#command-interface-playlist-next)
### Navigate > Next Chapter ### Navigate > Next Chapter
Navigates to the next chapter using the command: Navigates to the next chapter using the command:
@@ -325,6 +407,7 @@ Navigates to the next chapter using the command:
[chapter property](https://mpv.io/manual/master/#command-interface-chapter) [chapter property](https://mpv.io/manual/master/#command-interface-chapter)
### Navigate > Previous Chapter ### Navigate > Previous Chapter
Navigates to the previous chapter using the command: Navigates to the previous chapter using the command:
@@ -335,6 +418,7 @@ Navigates to the previous chapter using the command:
[chapter property](https://mpv.io/manual/master/#command-interface-chapter) [chapter property](https://mpv.io/manual/master/#command-interface-chapter)
### Navigate > Jump Next Frame ### Navigate > Jump Next Frame
Jumps to the next frame using the command: Jumps to the next frame using the command:
@@ -343,6 +427,7 @@ Jumps to the next frame using the command:
[frame-step command](https://mpv.io/manual/master/#command-interface-frame-step) [frame-step command](https://mpv.io/manual/master/#command-interface-frame-step)
### Navigate > Jump Previous Frame ### Navigate > Jump Previous Frame
Jumps to the previous frame using the command: Jumps to the previous frame using the command:
@@ -351,6 +436,7 @@ Jumps to the previous frame using the command:
[frame-back-step command](https://mpv.io/manual/master/#command-interface-frame-back-step) [frame-back-step command](https://mpv.io/manual/master/#command-interface-frame-back-step)
### Navigate > Jump ### Navigate > Jump
Seeking using the command: Seeking using the command:
@@ -366,6 +452,7 @@ time format.
[seek command](https://mpv.io/manual/master/#command-interface-[relative|absolute|absolute-percent|relative-percent|exact|keyframes]) [seek command](https://mpv.io/manual/master/#command-interface-[relative|absolute|absolute-percent|relative-percent|exact|keyframes])
### Pan & Scan > Increase Size ### Pan & Scan > Increase Size
Adds video zoom using the command: Adds video zoom using the command:
@@ -376,6 +463,7 @@ Adds video zoom using the command:
[video-zoom property](https://mpv.io/manual/master/#options-video-zoom) [video-zoom property](https://mpv.io/manual/master/#options-video-zoom)
### Pan & Scan > Decrease Size ### Pan & Scan > Decrease Size
Adds negative video zoom using the command: Adds negative video zoom using the command:
@@ -386,6 +474,7 @@ Adds negative video zoom using the command:
[video-zoom property](https://mpv.io/manual/master/#options-video-zoom) [video-zoom property](https://mpv.io/manual/master/#options-video-zoom)
### Pan & Scan > Move Left ### Pan & Scan > Move Left
`add video-pan-x -0.01` `add video-pan-x -0.01`
@@ -394,6 +483,7 @@ Adds negative video zoom using the command:
[video-pan-x, video-pan-y property](https://mpv.io/manual/master/#options-video-pan-y) [video-pan-x, video-pan-y property](https://mpv.io/manual/master/#options-video-pan-y)
### Pan & Scan > Move Right ### Pan & Scan > Move Right
`add video-pan-x 0.01` `add video-pan-x 0.01`
@@ -402,6 +492,7 @@ Adds negative video zoom using the command:
[video-pan-x, video-pan-y property](https://mpv.io/manual/master/#options-video-pan-y) [video-pan-x, video-pan-y property](https://mpv.io/manual/master/#options-video-pan-y)
### Pan & Scan > Move Up ### Pan & Scan > Move Up
`add video-pan-y -0.01` `add video-pan-y -0.01`
@@ -410,6 +501,7 @@ Adds negative video zoom using the command:
[video-pan-x, video-pan-y property](https://mpv.io/manual/master/#options-video-pan-y) [video-pan-x, video-pan-y property](https://mpv.io/manual/master/#options-video-pan-y)
### Pan & Scan > Move Down ### Pan & Scan > Move Down
`add video-pan-y 0.01` `add video-pan-y 0.01`
@@ -418,6 +510,7 @@ Adds negative video zoom using the command:
[video-pan-x, video-pan-y property](https://mpv.io/manual/master/#options-video-pan-y) [video-pan-x, video-pan-y property](https://mpv.io/manual/master/#options-video-pan-y)
### Pan & Scan > Decrease Height ### Pan & Scan > Decrease Height
`add panscan -0.1` `add panscan -0.1`
@@ -426,6 +519,7 @@ Adds negative video zoom using the command:
[panscan property](https://mpv.io/manual/master/#options-panscan) [panscan property](https://mpv.io/manual/master/#options-panscan)
### Pan & Scan > Increase Height ### Pan & Scan > Increase Height
`add panscan 0.1` `add panscan 0.1`
@@ -434,6 +528,7 @@ Adds negative video zoom using the command:
[panscan property](https://mpv.io/manual/master/#options-panscan) [panscan property](https://mpv.io/manual/master/#options-panscan)
### Pan & Scan > Reset ### Pan & Scan > Reset
Resets Pan & Scan, multiple commands in the same line are separated with semicolon. Resets Pan & Scan, multiple commands in the same line are separated with semicolon.
@@ -444,6 +539,7 @@ Resets Pan & Scan, multiple commands in the same line are separated with semicol
[video-pan-x, video-pan-y property](https://mpv.io/manual/master/#options-video-pan-y) [video-pan-x, video-pan-y property](https://mpv.io/manual/master/#options-video-pan-y)
### Video > Decrease Contrast ### Video > Decrease Contrast
Decreases contrast with the following command: Decreases contrast with the following command:
@@ -454,6 +550,7 @@ Decreases contrast with the following command:
[contrast property](https://mpv.io/manual/master/#options-contrast) [contrast property](https://mpv.io/manual/master/#options-contrast)
### Video > Increase Contrast ### Video > Increase Contrast
Increases contrast with the following command: Increases contrast with the following command:
@@ -464,6 +561,7 @@ Increases contrast with the following command:
[contrast property](https://mpv.io/manual/master/#options-contrast) [contrast property](https://mpv.io/manual/master/#options-contrast)
### Video > Decrease Brightness ### Video > Decrease Brightness
Decreases brightness using the following command: Decreases brightness using the following command:
@@ -474,6 +572,7 @@ Decreases brightness using the following command:
[brightness property](https://mpv.io/manual/master/#options-brightness) [brightness property](https://mpv.io/manual/master/#options-brightness)
### Video > Increase Brightness ### Video > Increase Brightness
Increases brightness using the following command: Increases brightness using the following command:
@@ -484,6 +583,7 @@ Increases brightness using the following command:
[brightness property](https://mpv.io/manual/master/#options-brightness) [brightness property](https://mpv.io/manual/master/#options-brightness)
### Video > Decrease Gamma ### Video > Decrease Gamma
Decreases gamma using the following command: Decreases gamma using the following command:
@@ -494,6 +594,7 @@ Decreases gamma using the following command:
[gamma property](https://mpv.io/manual/master/#options-gamma) [gamma property](https://mpv.io/manual/master/#options-gamma)
### Video > Increase Gamma ### Video > Increase Gamma
Increases gamma using the following command: Increases gamma using the following command:
@@ -504,6 +605,7 @@ Increases gamma using the following command:
[gamma property](https://mpv.io/manual/master/#options-gamma) [gamma property](https://mpv.io/manual/master/#options-gamma)
### Video > Decrease Saturation ### Video > Decrease Saturation
Decreases saturation using the following command: Decreases saturation using the following command:
@@ -514,6 +616,7 @@ Decreases saturation using the following command:
[saturation property](https://mpv.io/manual/master/#options-saturation) [saturation property](https://mpv.io/manual/master/#options-saturation)
### Video > Increase Saturation ### Video > Increase Saturation
Increases saturation using the following command: Increases saturation using the following command:
@@ -524,6 +627,7 @@ Increases saturation using the following command:
[saturation property](https://mpv.io/manual/master/#options-saturation) [saturation property](https://mpv.io/manual/master/#options-saturation)
### Video > Take Screenshot ### Video > Take Screenshot
`async screenshot` `async screenshot`
@@ -532,6 +636,7 @@ Increases saturation using the following command:
[screenshot command](https://mpv.io/manual/master/#command-interface-[subtitles|video|window|single|each-frame]) [screenshot command](https://mpv.io/manual/master/#command-interface-[subtitles|video|window|single|each-frame])
### Video > Toggle Deinterlace ### Video > Toggle Deinterlace
Cycles the deinterlace property using the following command: Cycles the deinterlace property using the following command:
@@ -542,6 +647,7 @@ Cycles the deinterlace property using the following command:
[deinterlace property](https://mpv.io/manual/master/#options-deinterlace) [deinterlace property](https://mpv.io/manual/master/#options-deinterlace)
### Video > Cycle Aspect Ratio ### Video > Cycle Aspect Ratio
Cycles the aspect ratio using the following command: Cycles the aspect ratio using the following command:
@@ -552,11 +658,13 @@ Cycles the aspect ratio using the following command:
[video-aspect property](https://mpv.io/manual/master/#options-video-aspect) [video-aspect property](https://mpv.io/manual/master/#options-video-aspect)
### Audio > Cycle/Next ### Audio > Cycle/Next
This uses a mpv.net command that shows better info then the mpv preset This uses a mpv.net command that shows better info then the mpv preset
and also has the advantage of not showing no audio. and also has the advantage of not showing no audio.
### Audio > Delay +0.1 ### Audio > Delay +0.1
Adds a audio delay using the following command: Adds a audio delay using the following command:
@@ -567,6 +675,7 @@ Adds a audio delay using the following command:
[audio-delay property](https://mpv.io/manual/master/#options-audio-delay) [audio-delay property](https://mpv.io/manual/master/#options-audio-delay)
### Audio > Delay -0.1 ### Audio > Delay -0.1
Adds a negative audio delay using the following command: Adds a negative audio delay using the following command:
@@ -577,6 +686,7 @@ Adds a negative audio delay using the following command:
[audio-delay property](https://mpv.io/manual/master/#options-audio-delay) [audio-delay property](https://mpv.io/manual/master/#options-audio-delay)
### Subtitle > Cycle/Next ### Subtitle > Cycle/Next
Shows the next subtitle track using the following command: Shows the next subtitle track using the following command:
@@ -587,6 +697,7 @@ Shows the next subtitle track using the following command:
[sub/sid property](https://mpv.io/manual/master/#options-sid) [sub/sid property](https://mpv.io/manual/master/#options-sid)
### Subtitle > Toggle Visibility ### Subtitle > Toggle Visibility
Cycles the subtitle visibility using the following command: Cycles the subtitle visibility using the following command:
@@ -597,6 +708,7 @@ Cycles the subtitle visibility using the following command:
[sub-visibility property](https://mpv.io/manual/master/#options-no-sub-visibility) [sub-visibility property](https://mpv.io/manual/master/#options-no-sub-visibility)
### Subtitle > Delay -0.1 ### Subtitle > Delay -0.1
Adds a negative subtitle delay using the following command: Adds a negative subtitle delay using the following command:
@@ -607,6 +719,7 @@ Adds a negative subtitle delay using the following command:
[sub-delay property](https://mpv.io/manual/master/#options-sub-delay) [sub-delay property](https://mpv.io/manual/master/#options-sub-delay)
### Subtitle > Delay 0.1 ### Subtitle > Delay 0.1
Adds a positive subtitle delay using the following command: Adds a positive subtitle delay using the following command:
@@ -617,6 +730,7 @@ Adds a positive subtitle delay using the following command:
[sub-delay property](https://mpv.io/manual/master/#options-sub-delay) [sub-delay property](https://mpv.io/manual/master/#options-sub-delay)
### Subtitle > Move Up ### Subtitle > Move Up
Moves the subtitle up using the following command: Moves the subtitle up using the following command:
@@ -627,6 +741,7 @@ Moves the subtitle up using the following command:
[sub-pos property](https://mpv.io/manual/master/#options-sub-pos) [sub-pos property](https://mpv.io/manual/master/#options-sub-pos)
### Subtitle > Move Down ### Subtitle > Move Down
Moves the subtitle down using the following command: Moves the subtitle down using the following command:
@@ -637,6 +752,7 @@ Moves the subtitle down using the following command:
[sub-pos property](https://mpv.io/manual/master/#options-sub-pos) [sub-pos property](https://mpv.io/manual/master/#options-sub-pos)
### Subtitle > Decrease Subtitle Font Size ### Subtitle > Decrease Subtitle Font Size
Decreases the subtitle font size using the following command: Decreases the subtitle font size using the following command:
@@ -647,6 +763,7 @@ Decreases the subtitle font size using the following command:
[sub-scale property](https://mpv.io/manual/master/#options-sub-scale) [sub-scale property](https://mpv.io/manual/master/#options-sub-scale)
### Subtitle > Increase Subtitle Font Size ### Subtitle > Increase Subtitle Font Size
Increases the subtitle font size using the following command: Increases the subtitle font size using the following command:
@@ -657,6 +774,7 @@ Increases the subtitle font size using the following command:
[sub-scale property](https://mpv.io/manual/master/#options-sub-scale) [sub-scale property](https://mpv.io/manual/master/#options-sub-scale)
### Volume > Up ### Volume > Up
Increases the volume using the following command: Increases the volume using the following command:
@@ -667,6 +785,7 @@ Increases the volume using the following command:
[volume property](https://mpv.io/manual/master/#options-volume) [volume property](https://mpv.io/manual/master/#options-volume)
### Volume > Down ### Volume > Down
Decreases the volume using the following command: Decreases the volume using the following command:
@@ -677,6 +796,7 @@ Decreases the volume using the following command:
[volume property](https://mpv.io/manual/master/#options-volume) [volume property](https://mpv.io/manual/master/#options-volume)
### Volume > Mute ### Volume > Mute
Cycles the mute property using the following command: Cycles the mute property using the following command:
@@ -687,6 +807,7 @@ Cycles the mute property using the following command:
[mute property](https://mpv.io/manual/master/#options-mute) [mute property](https://mpv.io/manual/master/#options-mute)
### Speed > -10% ### Speed > -10%
Decreases the speed by 10% using the following command: Decreases the speed by 10% using the following command:
@@ -697,6 +818,7 @@ Decreases the speed by 10% using the following command:
[speed property](https://mpv.io/manual/master/#options-speed) [speed property](https://mpv.io/manual/master/#options-speed)
### Speed > 10% ### Speed > 10%
Increases the speed by 10% using the following command: Increases the speed by 10% using the following command:
@@ -707,6 +829,7 @@ Increases the speed by 10% using the following command:
[speed property](https://mpv.io/manual/master/#options-speed) [speed property](https://mpv.io/manual/master/#options-speed)
### Speed > Half ### Speed > Half
Halfs the speed using the following command: Halfs the speed using the following command:
@@ -717,6 +840,7 @@ Halfs the speed using the following command:
[speed property](https://mpv.io/manual/master/#options-speed) [speed property](https://mpv.io/manual/master/#options-speed)
### Speed > Double ### Speed > Double
Doubles the speed using the following command: Doubles the speed using the following command:
@@ -727,6 +851,7 @@ Doubles the speed using the following command:
[speed property](https://mpv.io/manual/master/#options-speed) [speed property](https://mpv.io/manual/master/#options-speed)
### Speed > Reset ### Speed > Reset
Resets the speed using the following command: Resets the speed using the following command:
@@ -737,10 +862,12 @@ Resets the speed using the following command:
[speed property](https://mpv.io/manual/master/#options-speed) [speed property](https://mpv.io/manual/master/#options-speed)
### Extensions > Rating > 0stars ### Extensions > Rating > 0stars
A plugin the writes the rating to the filename. A plugin the writes the rating to the filename.
### View > On Top > Enable ### View > On Top > Enable
Forces the player to stay on top of other windows using the following command: Forces the player to stay on top of other windows using the following command:
@@ -751,6 +878,7 @@ Forces the player to stay on top of other windows using the following command:
[ontop property](https://mpv.io/manual/master/#options-ontop) [ontop property](https://mpv.io/manual/master/#options-ontop)
### View > On Top > Disable ### View > On Top > Disable
Disables the player to stay on top of other windows using the following command: Disables the player to stay on top of other windows using the following command:
@@ -761,10 +889,12 @@ Disables the player to stay on top of other windows using the following command:
[ontop property](https://mpv.io/manual/master/#options-ontop) [ontop property](https://mpv.io/manual/master/#options-ontop)
### View > File Info ### View > File Info
Shows info using a mpv.net command about the current file, shows length, position, formats, size and filename. Shows info using a mpv.net command about the current file, shows length, position, formats, size and filename.
### View > Show Statistics ### View > Show Statistics
Show statistics using the following command: Show statistics using the following command:
@@ -773,6 +903,7 @@ Show statistics using the following command:
[script-binding command](https://mpv.io/manual/master/#command-interface-script-binding) [script-binding command](https://mpv.io/manual/master/#command-interface-script-binding)
### View > Toggle Statistics ### View > Toggle Statistics
Toggles statistics using the following command: Toggles statistics using the following command:
@@ -781,6 +912,7 @@ Toggles statistics using the following command:
[script-binding command](https://mpv.io/manual/master/#command-interface-script-binding) [script-binding command](https://mpv.io/manual/master/#command-interface-script-binding)
### View > Toggle OSC Visibility ### View > Toggle OSC Visibility
Toggles OSC Visibility using the following command: Toggles OSC Visibility using the following command:
@@ -789,6 +921,7 @@ Toggles OSC Visibility using the following command:
[script-binding command](https://mpv.io/manual/master/#command-interface-script-binding) [script-binding command](https://mpv.io/manual/master/#command-interface-script-binding)
### View > Show Playlist ### View > Show Playlist
Shows the playlist for 5 seconds using the following command: Shows the playlist for 5 seconds using the following command:
@@ -797,6 +930,7 @@ Shows the playlist for 5 seconds using the following command:
[show-text command](https://mpv.io/manual/master/#command-interface-show-text) [show-text command](https://mpv.io/manual/master/#command-interface-show-text)
### View > Show Audio/Video/Subtitle List ### View > Show Audio/Video/Subtitle List
Shows the Audio/Video/Subtitle list for 5 seconds using the following command: Shows the Audio/Video/Subtitle list for 5 seconds using the following command:
@@ -805,14 +939,17 @@ Shows the Audio/Video/Subtitle list for 5 seconds using the following command:
[show-text command](https://mpv.io/manual/master/#command-interface-show-text) [show-text command](https://mpv.io/manual/master/#command-interface-show-text)
### Settings > Show Config Editor ### Settings > Show Config Editor
Shows mpv.net's config editor. Shows mpv.net's config editor.
### Settings > Show Input Editor ### Settings > Show Input Editor
Shows mpv.net's key binding editor. Shows mpv.net's key binding editor.
### Settings > Open Config Folder ### Settings > Open Config Folder
Opens the config folder which contains: Opens the config folder which contains:
@@ -825,14 +962,17 @@ input.conf containing mpv key and mouse bindings
User scripts and user extensions User scripts and user extensions
### Tools > Command Palette ### Tools > Command Palette
Shows the command palette window which allows to quickly find and execute commands and key shortcuts. Shows the command palette window which allows to quickly find and execute commands and key shortcuts.
### Tools > Show History ### Tools > Show History
Shows a text file that contains the file history. If the file don't exist it asks if the file should be created in the settings folder. Once the file exist then the history is logged. It logges the playback history containing the time and filename. Shows a text file that contains the file history. If the file don't exist it asks if the file should be created in the settings folder. Once the file exist then the history is logged. It logges the playback history containing the time and filename.
### Tools > Set/clear A-B loop points ### Tools > Set/clear A-B loop points
Enables to set loop start and end points using the following command: Enables to set loop start and end points using the following command:
@@ -841,6 +981,7 @@ Enables to set loop start and end points using the following command:
[ab-loop command](https://mpv.io/manual/master/#command-interface-ab-loop) [ab-loop command](https://mpv.io/manual/master/#command-interface-ab-loop)
### Tools > Toggle infinite file looping ### Tools > Toggle infinite file looping
Loops the current file infinitely using the following command: Loops the current file infinitely using the following command:
@@ -851,6 +992,7 @@ cycle-values loop-file "inf" "no"
[loop-file command](https://mpv.io/manual/master/#options-loop) [loop-file command](https://mpv.io/manual/master/#options-loop)
### Tools > Toggle Hardware Decoding ### Tools > Toggle Hardware Decoding
Cycles the hwdec property to enable/disable hardware decoding using the following command: Cycles the hwdec property to enable/disable hardware decoding using the following command:
@@ -861,32 +1003,39 @@ Cycles the hwdec property to enable/disable hardware decoding using the followin
[hwdec property](https://mpv.io/manual/master/#options-hwdec) [hwdec property](https://mpv.io/manual/master/#options-hwdec)
### Tools > Setup ### Tools > Setup
Allows to manage file associations. Allows to manage file associations.
### Help > Show mpv manual ### Help > Show mpv manual
Shows the [mpv manual](https://mpv.io/manual/stable/). Shows the [mpv manual](https://mpv.io/manual/stable/).
### Help > Show mpv.net web site ### Help > Show mpv.net web site
Shows the [mpv.net web site](https://mpv-net.github.io/mpv.net-web-site/). Shows the [mpv.net web site](https://mpv-net.github.io/mpv.net-web-site/).
### Help > Show mpv.net manual ### Help > Show mpv.net manual
Shows the [mpv.net manual](https://github.com/stax76/mpv.net/blob/master/Manual.md). Shows the [mpv.net manual](https://github.com/stax76/mpv.net/blob/master/Manual.md).
### Help > Check for Updates ### Help > Check for Updates
Checks for updates and allows to execute the update routine. Checks for updates and allows to execute the update routine.
The update routine requires PowerShell 5 and curl, an up to date Windows 10 system has both included. The update routine requires PowerShell 5 and curl, an up to date Windows 10 system has both included.
### Help > About mpv.net ### Help > About mpv.net
Shows the mpv.net about dialog which shows a copyright notice, the versions of mpv.net and libmpv and a license notice (MIT). Shows the mpv.net about dialog which shows a copyright notice, the versions of mpv.net and libmpv and a license notice (MIT).
### Exit ### Exit
Exits mpv.net using the following command: Exits mpv.net using the following command:
@@ -895,6 +1044,7 @@ Exits mpv.net using the following command:
[quit command](https://mpv.io/manual/master/#command-interface-quit-[%3Ccode%3E]) [quit command](https://mpv.io/manual/master/#command-interface-quit-[%3Ccode%3E])
### Exit Watch Later ### Exit Watch Later
Exits mpv.net and remembers the position in the file using the following command: Exits mpv.net and remembers the position in the file using the following command:
@@ -902,3 +1052,14 @@ Exits mpv.net and remembers the position in the file using the following command
`quit-watch-later` `quit-watch-later`
[quit-watch-later command](https://mpv.io/manual/master/#command-interface-quit-watch-later) [quit-watch-later command](https://mpv.io/manual/master/#command-interface-quit-watch-later)
Extensions are located in the config folder and the filename must end with 'Extension.dll':
```Text
<config folder>\Extensions\ExampleExtension\ExampleExtension.dll
```
The config folder can be opened with the context menu at:
`Settings > Open Config Folder`

View File

@@ -1,3 +1,4 @@
![](https://raw.githubusercontent.com/stax76/mpv.net/master/img/mpvnet.png) ![](https://raw.githubusercontent.com/stax76/mpv.net/master/img/mpvnet.png)
![GitHub closed pull requests](https://img.shields.io/github/issues-pr-closed/stax76/mpv.net) ![GitHub closed issues](https://img.shields.io/github/issues-closed/stax76/mpv.net) ![GitHub All Releases](https://img.shields.io/github/downloads/stax76/mpv.net/total) ![GitHub tag (latest by date)](https://img.shields.io/github/tag-date/stax76/mpv.net) ![GitHub stars](https://img.shields.io/github/stars/stax76/mpv.net) [![PayPal donate button](https://img.shields.io/badge/paypal-donate-yellow.svg)](https://www.paypal.me/stax76) ![GitHub closed pull requests](https://img.shields.io/github/issues-pr-closed/stax76/mpv.net) ![GitHub closed issues](https://img.shields.io/github/issues-closed/stax76/mpv.net) ![GitHub All Releases](https://img.shields.io/github/downloads/stax76/mpv.net/total) ![GitHub tag (latest by date)](https://img.shields.io/github/tag-date/stax76/mpv.net) ![GitHub stars](https://img.shields.io/github/stars/stax76/mpv.net) [![PayPal donate button](https://img.shields.io/badge/paypal-donate-yellow.svg)](https://www.paypal.me/stax76)
@@ -62,7 +63,7 @@ Table of contents
- Configuration files that are easy to read and edit ([Manual](https://mpv.io/manual/master/#configuration-files)) - Configuration files that are easy to read and edit ([Manual](https://mpv.io/manual/master/#configuration-files))
- Searchable command palette to quickly find commands and keys ([Screenshot](#command-palette-screenshot)) - Searchable command palette to quickly find commands and keys ([Screenshot](#command-palette-screenshot))
- Modern graphical user interface with customizable color themes ([Screenshot](#config-editor-screenshot)) - Modern graphical user interface with customizable color themes ([Screenshot](#config-editor-screenshot))
- [Extension API for .NET languages (C#, VB.NET and F#)](https://github.com/stax76/mpv.net/wiki/Extensions) - Extension API for .NET languages (C#, VB.NET and F#)
- Scripting API for Python, C#, Lua, JavaScript and PowerShell ([Wiki](https://github.com/stax76/mpv.net/wiki/Scripting)) - Scripting API for Python, C#, Lua, JavaScript and PowerShell ([Wiki](https://github.com/stax76/mpv.net/wiki/Scripting))
- Language agnostic JSON IPC to control the player with a external programs - Language agnostic JSON IPC to control the player with a external programs
- On Screen Controler (OSC, play control buttons) ([Screenshot](#main-window-screenshot)) - On Screen Controler (OSC, play control buttons) ([Screenshot](#main-window-screenshot))
@@ -211,7 +212,7 @@ The config folder can be opened from the context menu.
## Extensions ## Extensions
[Extensions wiki page](https://github.com/stax76/mpv.net/wiki/Extensions) [Extensions](Manual.md#extensions)
## Architecture ## Architecture