2025-05-28 18:42:16 +02:00
2025-05-28 18:42:16 +02:00
2025-05-28 18:42:16 +02:00
2025-05-28 18:42:16 +02:00

MPRIS Last.fm Cover Downloader

Real-time Album Cover Management

MPRIS Last.fm Cover Downloader seamlessly integrates with your music playback to ensure your album covers are always up-to-date without manual intervention. By leveraging the MPRIS interface and Last.fm API, this tool automatically downloads missing album covers, eliminating the need for constant polling and reducing CPU usage. Automatic Cover Downloads for Every Track

When a new track starts playing, the application checks for the presence of the album cover in your local music directory. If the cover is missing, it fetches the highest available resolution image from Last.fm and saves it automatically.

The downloader intelligently selects the largest available cover image from Last.fm, ensuring high-quality visuals for your music library. It prioritizes sizes in the following order: mega, extralarge, large, medium, small. Efficient Resource Usage

Designed to minimize CPU usage, the application avoids unnecessary polling by reacting to real-time events from the MPRIS interface. This ensures your system remains responsive and efficient while managing album covers.

Requirements

Operating System: Linux
Python Dependencies:
    requests
    dbus-next
    pathlib
    logging
System Tools:
    mpdris2-rs
    MPD (Music Player Daemon) or another MPRIS-compatible player
Last.fm Account to obtain an API key.

Installation

git clone the repo. just copy the files to the same location as they are in the repository

Configuration

systemctl --user daemon-reload
systemctl --user enable mpdcovergrabber.service
systemctl --user start mpdcovergrabber.service

Put your lastfm apikey here $HOME/apikeys/lastfm

Contributing

Contributions are welcome! To improve this application, please follow these steps:

Fork the Repository.

Create a New Branch for Your Feature or Fix:

git checkout -b feature/new-feature

Make Your Changes and Commit Them:

git commit -m "Add new feature"

Push Your Changes to the Fork:

git push origin feature/new-feature

Open a Merge Request on GitLab.

License

This project is licensed under the BSD License. See the LICENSE file for details. Contact

If you have any questions or suggestions, feel free to open an issue in the repository or contact me directly via me@priet.us.

Thank you for using MPRIS Last.fm Cover Downloader! We hope this tool makes managing your music album covers easier and more efficient.

Description
No description provided
Readme 29 KiB
Languages
Python 100%