mpvcovergrabber

mpvcovergrabber is a script for MPV that shows rich notifications with album covers or movie posters when playing audio or video files. It uses local inference via language models such as gemma2:2b through Ollama and APIs like Last.fm and TMDB.

Features

Metadata inference using LLMs (via Ollama)
Cover retrieval from:
- Local files
- Last.fm (for music)
- TMDB (for movies)
Metadata cleanup using customizable regex patterns
Support for audio streams

Installation

You can install it form the AUR:

yay -S mpvcovergrabber-git

git clone https://aur.archlinux.org/mpvcovergrabber-git.git
cd mpvcovergrabber-git
makepkg -si

This will install the following files:

/etc/mpv/scripts/notify.lua
/etc/mpv/filters/patterns_artist.txt
/etc/mpv/filters/patterns_common.txt

Dependencies

mpv
curl
coreutils

Optional dependencies

Ollama: for LLM-based metadata inference (e.g., gemma2)
ollama-cuda: for GPU-accelerated inference

Configuration

Edit the pattern files to customize metadata cleanup:

/etc/mpv/filters/patterns_artist.txt
/etc/mpv/filters/patterns_common.txt

Store your API keys in:

~/.config/mpv/apikeys/lastfm
~/.config/mpv/apikeys/tmdb

Author

Developed by Teraflops

License

This project is licensed under the MIT License. See the LICENSE file for more details.