To avoid issues with the GTK icon cache inadvertently reusing old notification thumbnails, this commit updates the script to use unique filenames based on the notification title. Previously, all thumbnails were written to a static path, which could lead to stale icons appearing in subsequent notifications. This change ensures that each notification displays the correct associated image.

Updated the notification script to use http.request instead of https.request for fetching remote metadata and artwork. This adjustment improves compatibility with environments where strict HTTPS binding might not be required or available for specific media API endpoints. The change ensures the script remains functional when handling external radio stream data.

This change optimizes metadata handling by moving the mp.observe_property registration out of the global scope. By moving it to notify_current_media with a brief sleep interval instead, we avoid redundant notifications that were previously triggered twice during the initial file load. This results in a cleaner notification experience when playing new media.

This update enhances the mpv notification script by enabling automatic retrieval of album art for configured web radio streams. By defining API paths in config.json, the script now fetches remote metadata to correctly display thumbnails in desktop notifications, creating a much better visual experience for radio listeners.

Removed the escape_pango_markup helper function and stopped escaping title strings in the notify_media function. This change allows users to utilize Pango markup directly in their media titles when displayed via notify-send notifications. Now you can use formatting like bold or italics in your media labels.

This change broadens the hardcoded list of album art filenames the script recognizes, adding common variants like folder.* and AlbumArtwork.* alongside existing cover.* names. It improves media notification behavior for libraries that don't standardize on a single cover filename, reducing cases where artwork is missing even though an image is present. Practical effect: more playback notifications should now show album art out of the box.

This change fills in the meta section of package.nix with the package homepage, description, license, supported platforms, and maintainer information. While it doesn’t alter runtime behavior, it improves how the package appears in Nix tooling and makes it easier for users and maintainers to discover, evaluate, and support. Practical effect: the package is now more complete and better behaved as a first-class Nix package.

The notification code in notify-send.lua now looks up the original_year tag first and only falls back to year when it is missing. This is a small but meaningful metadata tweak for tracks where year may reflect a reissue or remaster rather than the original release date. In practice, desktop notifications should now present more accurate album context with no extra configuration required.

This change introduces a full Nix packaging setup with package.nix, overlay.nix, and a default.nix entrypoint, making the mpv notification script easier to consume from Nix-based systems. The package patches notify-send.lua to use the store path for libnotify's notify-send, which avoids relying on ambient PATH configuration and makes installs more reproducible. The README was also updated with Nix/NixOS usage instructions so users can wire the script into their mpv setup more easily. Practically, Nix users now get a smoother, more reliable installation path.

This change adjusts notify-send.lua to read artist_credit before falling back to artist when building the notification text for the current track. That matters for players and metadata sources that expose a more precise credited artist string, including collaborations or formatted credits that may differ from the plain artist tag. In practice, desktop media notifications should now show better artist attribution with no downside for sources that only provide artist.

This initial commit introduces mpv-notify-send, a small Lua integration for mpv that calls notify-send whenever a file loads. The script pulls track metadata like title, artist, album, and year, escapes notification text safely, and looks for cover.png/cover.jpg/cover.jpeg alongside the media to use as the notification icon. It’s a compact quality-of-life feature for Linux desktop playback that makes mpv sessions feel more integrated with the rest of the system.