ammg

A tool for appending metadata from Apple Music to music files.


Keywords
apple, music, metadata, mutagen
License
Other
Install
pip install ammg==0.2.1

Documentation

Apple Music Metadata Grabber (ammg)

ammg is a tool for appending metadata to music files from Apple Music. Mainly files downloaded from Youtube Music (not youtube), because Youtube Music (albums/singles/ep) and Apple Music (albums) holds the same song info...

With ammg you choose your youtube music songs, and you choose which metadata.

Note: Supported file types are m4a and opus. Using opus is better than m4a because the best quality available on youtube is opus.

However m4a is used if you want to open the files in iTunes and sync them to your iPhone/iPad.

Installation

You can download ammg using pip:

pip install --upgrade ammg

Usage

  • First: Choose your song, album, or single.
  • Second: Download the album playlist from Youtube Music.
  • Third: Copy the album ID from the search bar from Apple Music.

Example: We will be downloading Scary Pockets, Elise Trouw - Careless Whisper (feat. Dave Koz).

Notice: the Youtube Music link is a playlist. By downloading using the playlist (album link), you will be able to add metadata without manual intervetion.

Command Process: Download the music using yt-dlp (make sure you download yt-dlp first).

  • Downloading .opus file using yt-dlp:
yt-dlp -cw -o "music/%(title)s.%(ext)s" -x --audio-quality "0" "https://music.youtube.com/playlist?list=OLAK5uy_kVIMiCrxX4gmnZI-IufqRvJte6Hk3NTbY"
  • Downloading .m4a file using yt-dlp:
yt-dlp -cw -o "music/%(title)s.%(ext)s" -x --audio-format m4a --audio-quality "0" "https://music.youtube.com/playlist?list=OLAK5uy_kVIMiCrxX4gmnZI-IufqRvJte6Hk3NTbY"

This will download Careless Whisper in the music folder. So the path of the downloaded song will be music/Careless Whisper (feat. Dave Koz).opus.

Adding the metadata using ammg:

Required arguments:

  • -i: Apple album id.
  • -o: Output directory.
    • The directory where the file will be once it is saved.
  • positional argument: here music where the downloaded song is.
ammg get -i 1681177202 -o Ordered_Music music

If you are querying a lot of songs in one session, it is adviced to use --do-not-check-token.

ammg get --do-not-check-token -i 1681177202 -o Ordered_Music music

After embedding metadata, the file will be moved to Ordered_Music/S/Scary Pockets & Elise Trouw/Careless Whisper (feat. Dave Koz) - Single/. That way we will have an ordered music library.

Simplifying our work

We can using bash scripting on Linux, to created alias or functions that simplify our work, and make the process faster.

Alias domus to download music:

alias domus='yt-dlp -cw -o "music/%(title)s.%(ext)s" -x --audio-quality "0"'

A shell function that accepts a link and album id:

domuspp() {
    domus "$1";
    ammg get --do-not-check-token -i "$2" -o Ordered_Music music;
}