https://github.com/cvzi/py_itunesart

Download album cover information from Apple iTunes artwork API and store id3 metadata in mp3 file
https://github.com/cvzi/py_itunesart

albumart cover id3 itunes m4a mp3 mp3-tags

Last synced: 3 months ago
JSON representation

Download album cover information from Apple iTunes artwork API and store id3 metadata in mp3 file

• Host: GitHub
• URL: https://github.com/cvzi/py_itunesart
• Owner: cvzi
• Created: 2017-07-30T16:41:24.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2024-04-08T12:04:27.000Z (9 months ago)
• Last Synced: 2024-10-04T22:54:36.412Z (3 months ago)
• Topics: albumart, cover, id3, itunes, m4a, mp3, mp3-tags
• Language: Python
• Homepage:
• Size: 1.06 MB
• Stars: 7
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# py_itunesart

Download album cover and meta data information from [Apple iTunes API](https://web.archive.org/web/20220206024724/https://affiliate.itunes.apple.com/resources/documentation/itunes-store-web-service-search-api/).

Metadata and album cover can be stored in mp3 metadata/id3 and in m4a metadata

Can be used from the command line or from [Mp3Tag](http://www.mp3tag.de)

Requirements:

 * Python 3 (tested with 3.11)

 * [Mutagen](https://bitbucket.org/lazka/mutagen) python module `pip install mutagen`

 * [Pillow](https://pypi.org/project/Pillow/)/PIL python module `pip install pillow` (only required for the GUI) 

![Animated screenshot of terminal](screenshots/screencapture_itunes_meta.gif)

# Mp3Tag

To add it to the Mp3Tag context menu, do the following steps in Mp3Tag:

![Mp3Tag instructions](screenshots/mp3tag.jpg)

## Metadata from iTunes (Single song)

 * Open Tools -> Options -> Tools

 * Click on the "New" icon

 * Enter the name that shall appear in the context menu

 * For path choose your python.exe

 * For parameter use: `C:\pathtofile\download_itunes_meta_single.py -c -w -s "%_path%"`

 * Accept the "for all selected files" option

## Metadata from iTunes (Album/Folder)

 * Open Tools -> Options -> Tools

 * Click on the "New" icon

 * Enter the name that shall appear in the context menu

 * For path choose your python.exe

 * For parameter use: `C:\pathtofile\download_itunes_meta.py -c -w -s`

 * Uncheck the "for all selected files" option

## Only cover from iTunes (Single song)

 * Open Tools -> Options -> Tools

 * Click on the "New" icon

 * Enter the name that shall appear in the context menu

 * For path choose your python.exe

 * For parameter use: `C:\pathtofile\gui.py "%_path%"`

 * Or use: `C:\pathtofile\gui.py -r "%_path%"` if you want to remove all existing coverart

 * Uncheck the "for all selected files" option

## Only cover from iTunes (Album/Folder)

 * Open Tools -> Options -> Tools

 * Click on the "New" icon

 * Enter the name that shall appear in the context menu

 * For path choose your python.exe

 * For parameter use: `C:\pathtofile\gui.py -a "%_path%"`

 * Or use: `C:\pathtofile\gui.py -a -r "%_path%"` if you want to remove all existing coverart

 * Uncheck the "for all selected files" option

# GUI

tkinter GUI screenshot:

![Artwork GUI](screenshots/gui_2021-09-03.png)