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.