Skip to main content

Update Plex music album covers to the corresponding front covers embedded in your MP3 files

Project description


Is your Plex showing waveforms or label covers instead of the posters (covers) you worked or paid for?

Update Plex music album covers to the corresponding front covers embedded in your MP3 files.


This utility was written as a solution to a problem with Plex Media Server and music album covers. Some MP3 files such as the ones purchased from Beatport come with the usual cover one would expect as well as an additional waveform image. They often include a label cover too. When scanning files for covers Plex Media Server sees all of these and selects one seemingly at random. This utility scans your music library for albums with multiple covers, attempts to extract the embedded front covers from the MP3 files themselves and updates the album covers with the those. The MP3 files are not modified in this process.


Install via PIP on the same machine where you Plex server is running:

pip3 install --user update-plex-music-album-covers


update-plex-music-album-covers USERNAME --password PASSWORD SERVER LIBRARY

If you want to conceal your password you can pass it via environment variable like so:

read -p "Enter your password: " -s PLEX_PASSWORD && export PLEX_PASSWORD
update-plex-music-album-covers USERNAME SERVER LIBRARY

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for update-plex-music-album-covers, version 0.1.2
Filename, size File type Python version Upload date Hashes
Filename, size update_plex_music_album_covers-0.1.2-py3-none-any.whl (16.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size update-plex-music-album-covers-0.1.2.tar.gz (3.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page