mpv-scripts

Introduction

This repository contain scripts I have made for mpv media player. To add scripts from this repository, download the desired script in your mpv/scripts/ directory, for user customizable settings download the related conf file in your mpv/script-opts/ directory.

Scripts available in this repository: SmartSkip, SmartCopyPaste, SmartCopyPaste_II, SimpleHistory, SimpleBookmark, SimpleUndo, UndoRedo

SmartSkip

You think Netflix is good at binge-watching? Yes, it is.. :) But give SmartSkip a try! Automatically or manually skip opening, intro, outro, and preview, like never before. Jump to next file, previous file, and save your chapter changes!

Default Keybinds

Below default keybinds can be changed using the script conf file, or through script-opts by referring to the names that do not contain spaces.

Keybind	Name	Description
>	smart-next	Skips using silence-skip > chapter-next > playlist-next, based on configurable variables
<	smart-prev	Jumps to beginning > previous chapter > previous playlist, based on configurable variables
?	silence-skip	Skips until a silence is detected based on configurable variables
ctrl+right	chapter-next	Jumps to next chapter > to next playlist
ctrl+left	chapter-prev	Jumps to previous chapter > to beginning > to previous playlist
smart-next, enter, y	Proceed Auto-Skip	Proceeds Auto-Skip when countdown is started
smart-prev, pause, esc, n	Cancel Auto-Skip	Cancels Auto-Skip when countdown is started
ctrl+.	toggle-autoskip	Enables or disables Auto-Skip during playback for the current mpv session
alt+.	toggle-category-autoskip	Enables or disables a chapter for Auto-Skip during playback for the current mpv session
n	add-chapter	Add a chapter for the reached position
alt+n	remove-chapter	Removes the current chapter
ctrl+n	write-chapters	jumps to the previous available filter based on configured filters
alt+s / alt+S	edit-chapter	Renames the current chapter (requires user-input-module )
	bake-chapters	Merge the changes of chapters for the file inside mkv file

Main Features

• Smart Next / Prev: Automatically triggers Skip to Silence, Chapter Next/ Prev, or Playlist Next/ Prev based on configurable parameters.

• Skip to Silence: If the file you are watching is not chaptered, skipping to silence will attempt to skip the intro and outro by finding the silence in the file (optionally: chapter automatically created).
• Auto Skip: If the file you are watching has organized chapters, any opening, ending sound can be automatically skipped after your preferred countdown time.
• Chapters Modification: Create, remove, edit chapters, and then save changes into an external file or bake them into the mkv file.
• Chapter Next / Prev: Go to next chapter, if no chapters available go to next playlist, and vise-versa (like the good times with MPC-HC).
• Customization: Tons of user customizable settings that can even change the behavior and priority of smart-next, smart-prev, auto-skip, and more!
• OSD (On Screen Display): Displays a proper OSD for the actions preformed through SmartSkip.
• More: This is not all! Explore the conf file to learn more about the possibilities you are missing out...

Compatibility

• Works on all of mpv supported platforms.

SmartCopyPaste

Gives mpv the capability to copy and paste while being smart and customizable...

Default Keybinds

The following are the default keybinds, they can be changed in the conf file of the script or using script-opts by referring to the name.

Keybind	Name	Description
ctrl+c / ctrl+C / meta+c / meta+C	copy	copies file path / URI with resume time using the configured smart behavior.
ctrl+v / ctrl+V / meta+v / meta+V	paste	pastes and run into mpv from the clipboard using the configured smart behavior.
ctrl+alt+c / ctrl+alt+C / meta+alt+c / meta+alt+C	copy-specific	copies the file path without the reached time or based on the configured specific copy behavior.
ctrl+alt+v / ctrl+alt+V / meta+alt+v / meta+alt+V	paste-specific	pastes and appends the video file into playlist or based on the configured specific paste behavior.

Main Features

• Copy and Paste: Adds copy and paste to mpv for any file, like (urls, torrents, images, subtitles, audio files, video paths)
• Multi-Paste: Capability to paste a list of supported items seperated by new line to generate a playlist and conduct different actions depending on the files pasted.
• youtube-dl Extension Support: Immediately paste links without finding exact video address for youtube and any other youtube-dl extension supported sites.
• Peerflix / WebTorrent Extension Support: Immediately paste torrent links or magnet links when proper extensions are installed.
• Customization: Tons of user customizable settings that can even change the behavior and priority of copy and paste actions.
• OSD (On Screen Display): Displays any SmartCopyPaste action within mpv.
• More: This is not all! Explore the conf file to learn more about the possibilities you are missing out...

Compatibility

• Windows OS (default powershell, customizable / can be changed in the settings inside the script).
• MAC OS (default pbcopy and pbpaste, customizable / can be changed in the settings inside the script).
• Linux OS (default xclip, customizable / can be changed in the settings inside the script).

SmartCopyPaste_II

Just like SmartCopyPaste but logs your clipboard and makes use of it...

Default Keybinds

The following are the default keybinds, they can be changed in the conf file of the script or using script-opts by referring to the name.

Keybind	Name	Description
ctrl+c / ctrl+C / meta+c / meta+C	copy	copies file path / URI with resume time using the configured smart behavior.
ctrl+v / ctrl+V / meta+v / meta+V	paste	pastes and run into mpv from the clipboard using the configured smart behavior.
ctrl+alt+c / ctrl+alt+C / meta+alt+c / meta+alt+C	copy-specific	copies the file path without the reached time or based on the configured specific copy behavior.
ctrl+alt+v / ctrl+alt+V / meta+alt+v / meta+alt+V	paste-specific	pastes and appends the video file into playlist or based on the configured specific paste behavior.
c / C	open-list	opens Clipboard list (LogManager)

Main Features

• Copy and Paste: Adds copy and paste to mpv for any file, like (urls, torrents, images, subtitles, audio files, video paths)
• Multi-Paste: Capability to paste a list of supported items seperated by new line to generate a playlist and conduct different actions depending on the files pasted.
• youtube-dl Extension Support: Immediately paste links without finding exact video address for youtube and any other youtube-dl extension supported sites.
• Peerflix / WebTorrent Extension Support: Immediately paste torrent links or magnet links when proper extensions are installed.
• Saves Clipboard to a Log File: The copies from mpv, and the pastes into mpv will be kept in a log file; log file location is mpv config directory, default for Windows OS: %APPDATA%\mpv\mpvClipboard.log, for Linux OS and MAC OS: ~\.config\mpv\mpvClipboard.log.
• LogManager: Reads the log file directly in mpv, giving access to navigate, play files, add to playlist, delete, search, and filter the content.
• Customization: Tons of user customizable settings that can even change the behavior and priority of copy and paste actions, as well as everything about LogManager.
• OSD: Displays any SmartCopyPaste_II action within mpv.
• More: This is not all! Explore the conf file to learn more about the possibilities you are missing out...

Compatibility

• Windows OS (default powershell, customizable / can be changed in the settings inside the script).
• MAC OS (default pbcopy and pbpaste, customizable / can be changed in the settings inside the script).
• Linux OS (default xclip, customizable / can be changed in the settings inside the script).

SimpleHistory

Stores whatever you open in a history file and abuses it with features! Continue watching your last played or resume previously played videos, manage and play from your history, and more...

Default Keybinds

The following are the default keybinds, they can be changed in the conf file of the script or using script-opts by referring to the name.

Keybind	Name	Description
ctrl+r / ctrl+R	history-resume	File Loaded: Resumes in any previously closed video. / Idle: Loads and resumes the last played videos.
alt+r / alt+R	history-load-last	File Loaded: Adds last closed video into playlist. / Idle: Loads last closed video without resuming.
ctrl+H	history-incognito-mode	Triggeres a customizable incognito mode that stops saving history. To resume saving history press ctrl+H again
h / H	open-list	opens History list (LogManager)
r / R	NA	opens History list - filtered with recent items (LogManager)

Main Features

• Last Played: Immediately jumps to your last played video so you continue watching
• Video Resume: It saves the position of all videos you are watching so you can easily resume
• Saves History to a Log File: The files and position of files played will be kept in a log file; log file location is mpv config directory, default for Windows OS: %APPDATA%\mpv\mpvHistory.log, for Linux OS and MAC OS: ~\.config\mpv\mpvHistory.log.
• Incognito Mode: A highly customizable incognito mode that can also be set to auto_run with mpv. It stops history logging when triggered until it is disabled by triggering it again.
• Blacklist/Whitelist: A very smart blacklist option that can understand inputted text to blacklist certain websites, urls, files, file paths, and protocols from saving into history. It can also be inverted into a whitelist so only defined files / urls / websites are saved into history.
• LogManager: Reads the log file directly in mpv, giving access to navigate, play files, add to playlist, delete, search, and filter the content. (I personally like the distinct filter). It lists the last episode played of each different show.
• Customization: Tons of user customizable settings, you can change almost everything. Hate the resume notification? Then just disable it. Hate recents list automatically loading? Then just disable it, and so on so forth...
• OSD: Displays any SimpleHistory action within mpv.
• More: This is not all! Explore the conf file to learn more about the possibilities you are missing out...

Compatibility

• Works on all of mpv supported platforms.

SimpleBookmark

Bookmark with a key, then list and access your bookmarks with a key. Assign your favorites to a keybind then access your favorites with that same keybind. Simple as that...

Default Keybinds

The following are the default keybinds, they can be changed in the conf file of the script or using script-opts by referring to the name.

Keybind	Name	Description
ctrl+b / ctrl+B	bookmark-save	bookmarks file along with time reached.
alt+b / alt+B	bookmark-fileonly	bookmarks file only without the reached time.
b / B	open-list	opens Bookmark list (LogManager)
k / K	NA	opens Bookmark list - filtered with entries assigned to keybinds (LogManager)
alt+1-alt+9	NA	List is open: assigns entry to a keybind. / List is closed: loads the assigned entry.
alt+shift+1-alt+shift+9	NA	override a corresponding assigned keybind entry based on the pressed number.
alt+-	keybind-slot-remove	when list is open it removes the assigned keybind from the bookmarked entry based on cursor position.
alt+shift+-	keybind-slot-remove-highlight	when list is open it removes all the highlighted assigned keybinds from the bookmarked entries.

Main Features

• Bookmark: Adds bookmark functionality to mpv, simply press the bookmark keybind and you are done.
• Assign Bookmark to Keybind: Press the keybind slot when displaying bookmarks will assign the bookmark to a keybind, making it easy to jump to the bookmark at anytime when pressing the same keybind.
• LogManager: Reads the log file directly in mpv, giving access to navigate, play files, add to playlist, delete, search, and filter the content.
• Saves Bookmark to a Log File: The bookmarks will be kept in a log file; log file location is mpv config directory, default for Windows OS: %APPDATA%\mpv\mpvBookmark.log, for Linux OS and MAC OS: ~\.config\mpv\mpvBookmark.log.
• Customization: Tons of user customizable settings that can even change the behavior of bookmarking, assigning video to a keybind, and the LogManager itself.
• OSD: Displays any SimpleBookmark action within mpv.
• More: This is not all! Seriously I am too lazy to write down all the features neatly ;) Explore the conf file to learn more about the possibilities you are missing out...

Compatibility

• Works on all of mpv supported platforms.

SimpleUndo

Accidentally seeked? No worries, simply undo..

Default Keybinds

The following are the default keybinds, they can be changed in the script or using script-opts by referring to the name.

Keybind	Name	Description
ctrl+z / ctrl+Z	undo / undoCaps	undo accidental seek by returning to previous time and vise-versa.

Main Features

• Simple Undo: Undo accidental time jumps in videos by pressing undo keybind and press again to return to previous position.
• OSD: Displays any SimpleUndo action within mpv.

Compatibility

• Works on all of mpv supported platforms.

UndoRedo

Undo is not enough to fix your accidental seek? Well now you can redo as well..

Default Keybinds

The following are the default keybinds, they can be changed in the script or using script-opts by referring to the name.

Keybind	Name	Description
ctrl+z / ctrl+Z	undo / undoCaps	undo by returning to previous time.
ctrl+y / ctrl+Y	redo / redoCaps	redo by restoring the undo time.
ctrl+alt+z / ctrl+alt+Z	undoLoop / undoLoopCaps	undo accidental seek by returning to previous time and vise-versa.

Main Features

• Undo and Redo: Undo any accident time jumps in the video by pressing the undo keybind and redo the jumps by pressing the redo keybind.
• Simple Undo: Undo accidental time jumps in videos by pressing Simple Undo keybind and press again to return to previous position.
• OSD: Displays any UndoRedo action within mpv.

Compatibility

• Works on all of mpv supported platforms.

LogManager

A highly customizable GUI to list and manage the logged items for SimpleHistory, SimpleBookmark, SmartCopyPaste_II; it is already integrated with the scripts.

Bookmarks (Keybinds Filter and Sort)	Clipboard (Highlighted 3 Items)	History (Search for Naruto in April 2022)

Default Keybinds

The following are the default keybinds, they can be changed in the conf file of the scripts or using script-opts by referring to the name.

Keybind	Name	Description
UP / WHEEL_UP	move-up	navigates up on the log list
DOWN / WHEEL_DOWN	move-down	navigates down on the log list
PGUP	page-up	navigates to the first item of current shown page on the log list
PGDWN	page-down	navigates to the last item of current shown page on the log list
HOME	move-first	navigates to the first item on the log list
END	move-last	navigates to the last item on the log list
SHIFT	NA	highlights the items on the list to manage and take action on multiple items. Keep holding SHIFT, then press any navigation keybind, e.g.: SHIFT+UP/SHIFT+PGDWN to highlight the items navigated towards
ctrl+a / ctrl+A	list-highlight-all	highlights all the displayed items on the log list
ctrl+d / ctrl+D	list-unhighlight-all	cancels the highlight of all highlighted items shown on the log list
RIGHT / MBTN_FORWARD	list-filter-next	jumps to the next available filter based on configured filters
LEFT / MBTN_BACK	list-filter-previous	jumps to the previous available filter based on configured filters
alt+s / alt+S	list-cycle-sort	cycles through the different available sorts on the log list
ENTER / MBTN_MID	list-select	loads an entry based on cursor position
ctrl+ENTER	list-add-playlist	add entry to playlist based on cursor position
SHIFT+ENTER	list-add-playlist-highlight	adds all highlighted entries to playlist
0-9	NA	quick-select an entry from 0th to 9th position
DEL	list-delete	deletes an entry from the log file based on cursor position
SHIFT+DEL	list-delete-highlight	deletes all highlighted entries from the log file
ctrl+f / ctrl+F	list-search-activate	triggers search to quickly find an item on the log list
ALT+ENTER	search_string_not_typing	forcefully exit typing mode of search while keeping search open
Depends on the script	ignore	Keybinds that will be ignored when the log list is open (mainly to avoid opening another log list from a different script while current one is active)
ESC / MBTN_RIGHT	NA	close the log list (closes search first if it is open)

Main Features

• Log Manage: List the log entries and manage them using mpv
• Log Search: Search for any specific entries in the list using a simplified search engine
• Log Filter: Apply a filter to the list depending on various built-in filters or build your own keywords filter
• Log Multi-Select: Multi-select the items to load / manage multiple entries easily
• Customization: LogManager is highly customizable in terms of anything that has to do with it, such as, keybinds, GUI with tons of built-in variables, the list of entries, and more.
• OSD: Displays any LogManager action within mpv.

Compatibility

• Intergrated with SmartCopyPaste-II, SimpleHistory, SimpleBookmark

Misc

MPV.net Support

MPV.net users must change the option input-default-bindings = no to input-default-bindings = yes located in MPV.net/mpv.conf

Special Thanks

Below is list of contributors/ honorable mentions. Without the below contributions these scripts would not exist today.

• SmartCopyPaste Script: For the handlers that are used inside the script, which added compatibility for newer mpv versions, the method was originally forked and edited from @jonniek appendURL script. Special thanks for his work.
• LogManager: @jonniek mpv-playlistmanager script and @hacel recents script, both scripts were forked and modified to help me in developing the LogManager which is used inside the script. Specials thanks for their work.
• UndoRedo Script: Credits and special thanks to my friend @Banz99 for forking SimpleUndo script and enhance it by a table to store undo and redo values.
• SmartSkip Script: skiptosilence.lua by @detuur, chapters.lua by @mar04, and chapterskip.lua by @po5. The following scripts were forked and modified in order to develop SmartSkip. Specials thanks for their work.