Skip to content

po5/memo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 

Repository files navigation

memo

A recent files menu for mpv.

This script saves your watch history, and displays it in a nice menu.

Preview

Installation

Place memo.lua in your mpv scripts folder.
Default settings are listed in memo.conf, copy it to your mpv script-opts folder to customize.

The default key to open the history menu is h.
Select a history entry to reopen the file.

This script comes with a simple menu, which gets automatically enhanced for users of uosc.
Make sure you are on the latest version of mpv (and uosc if you use it) when reporting issues.

Custom keybinds

Six keybinds are provided for use in input.conf.
Example usage: h script-binding memo-history

memo-history
Brings up the recent files menu, or closes it if already open. Default key is h.

memo-next
Jumps to the next page of history entries, if there is one. Also opens the menu if it's closed.

memo-prev
Jumps to the previous page of history entries, if there is one. Also opens the menu if it's closed.

memo-last
Opens the last non-deleted file that isn't the current file, and isn't in the same directory if hide_same_dir=yes. Also closes the menu if it's open.

memo-search
Brings up a search box, type your keywords. If using the vanilla menu, press Enter to submit.
This finds entries that contain every keyword. Enclose your search in double quotes for exact matches.
Users of uosc can also start typing right from the standard history menu to start a search (requires menu_type_to_search=yes in uosc.conf).

memo-log
Writes an entry for the current file. Intended for manual bookmarking with enabled=no.

Navigation keybinds for vanilla menu can be configured through script-opts/memo.conf.

Script messages

Just like the keybindings above, script messages can also be bound to keys in input.conf.
Example usage: H script-message memo-dirs "My-Movies|pattern:TV Shows/.-/|Anime"

memo-dirs [<path_prefixes>]
Similar to memo-history, but instead of files it shows the directories of recent files.
It optionally takes in custom path prefixes as a parameter with the same syntax as the option of the same name.
If no custom path prefixes are provided, the ones from the config are used.

uosc menus and buttons

Adding a menu: append #! History to your input.conf keybind, or use this for a menu-only config.

# script-binding memo-history #! History

Adding a button above timeline: add command:history:script-binding memo-history?History to your uosc.conf controls option.

Configuration

All further configuration, like the number of entries to show in menu, is done in script-opts/memo.conf.
A file with all default options and their descriptions is included in the repo.

Disabling for specific directories

It is possible to disable logging of specific files with any criteria that can be queried through auto profiles.
Below is an example to exclude files when "MyCunnyFolder" or "AnotherSecretFolder" is part of the directory path.
This goes in mpv.conf.

[dont-log-my-porn]
profile-cond=(function() local ignored, path = {"mycunnyfolder", "anothersecretfolder"}, get("path", "") path = ((path:find("^%a[%w.+-]-://") or path:find("^%a[%w.+-]-:%?")) and path:lower() or require "mp.utils".join_path(get("working-directory", ""), path)):sub(1, -get("filename", ""):len()-1):lower() for _, ig in ipairs(ignored) do if path:find(ig:lower(), 1, true) then return true end end end)()
profile-restore=copy-equal
script-opts-append=memo-enabled=no

This will apply to future writes, but will not retroactively delete files from history if you opened them before.
Files can easily be manually removed from the history (by default at ~~/memo-history.log). One entry per line.

What sets this apart from other history scripts?

Some scripts only write a history file without the ability to navigate it.
Scripts that do, by design, read the entire history before displaying your files.
This means they will get slower with time, while memo reads only what it needs.
Despite reading little data, it lets you browse as far back as you'd like. It even has a search feature!
The file format used allows you to retroactively change display and filtering options.
It supports displaying titles of YouTube and other web videos.
Comes with extensive format and protocol support, including compressed files and DVDs.
History is global and works across multiple instances of mpv by default, can be set to per-instance volatile history as well.
This is the nicest menu out of all history scripts I know about, and has uosc integration.

Acknowledgements

uosc version check and vanilla menu lifted from mpv-quality-menu (improvements: scroll alignment)
UTF-8 title truncation from recent-menu (improvements: preserves extensions)