2025-06-01 22:17:12 +02:00
2025-06-01 22:17:12 +02:00
2025-05-29 18:57:13 +02:00
2025-05-29 18:57:13 +02:00

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

or

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.

Description
No description provided
Readme MIT 34 KiB
Languages
Lua 100%