gamdl

Glomaticos Apple Music Downloader

Eine Python-CLI-App zum Herunterladen von Apple Music-Songs/Musikvideos/Beiträgen.

Discord-Server: https://discord.gg/aBjMEZ9tnq

Merkmale

• Laden Sie Songs in AAC 256 kbps und anderen Codecs herunter
• Laden Sie Musikvideos bis zu 4K herunter
• Laden Sie synchronisierte Liedtexte in LRC, SRT oder TTML herunter
• Wählen Sie zum Remuxen zwischen FFmpeg und MP4Box
• Wählen Sie zum Herunterladen zwischen yt-dlp und N_m3u8DL-RE
• Hochgradig anpassbar
• Verwenden Sie Künstlerlinks, um alle ihre Alben oder Musikvideos herunterzuladen

Voraussetzungen

• Python 3.8 oder höher
• Die Cookie-Datei Ihrer Apple Music-Browsersitzung im Netscape-Format (erfordert ein aktives Abonnement)
  • Um Ihre Cookies zu exportieren, verwenden Sie eine der folgenden Browsererweiterungen, während Sie bei Apple Music angemeldet sind:
    • Firefox: https://addons.mozilla.org/addon/export-cookies-txt
    • Chromium-basierte Browser: https://chrome.google.com/webstore/detail/gdocmgbfkjnnpapoeobnolbbkoibbcif
• FFmpeg auf Ihrem Systempfad
  • Ältere Versionen von FFmpeg funktionieren möglicherweise nicht.
  • Aktuelle Binärdateien können über die folgenden Links bezogen werden:
    • Windows: https://github.com/AnimMouse/ffmpeg-stable-autobuild/releases
    • Linux: https://johnvansickle.com/ffmpeg/

Optionale Abhängigkeiten

Die folgenden Tools sind optional, aber für bestimmte Funktionen erforderlich. Fügen Sie sie zum PATH Ihres Systems hinzu oder geben Sie ihre Pfade mithilfe von Befehlszeilenargumenten oder der Konfigurationsdatei an.

• mp4decrypt
  • Erforderlich beim Festlegen von mp4box als Remux-Modus, zum Herunterladen von Musikvideos und zum Herunterladen von Songs in nicht älteren Formaten.
• MP4Box
  • Erforderlich, wenn mp4box als Remux-Modus eingestellt wird.
• N_m3u8DL-RE
  • Erforderlich, wenn nm3u8dlre als Download-Modus festgelegt wird.

Installation

1. Installieren Sie das Paket gamdl mit pip

   pip install gamdl

2. Richten Sie die Cookie-Datei ein.
   • Sie können entweder in das aktuelle Verzeichnis wechseln, von dem aus Sie Gamdl als cookies.txt ausführen, oder seinen Pfad mithilfe der Befehlszeilenargumente/config-Datei angeben.

Verwendung

gamdl [OPTIONS] URLS...

Unterstützte URL-Typen

Gamdl unterstützt die folgenden URL-Typen:

• Lied
• Album
• Wiedergabeliste
• Musikvideo
• Künstler
• Video/zusätzliches Video posten

Beispiele

• Laden Sie ein Lied herunter

  gamdl " https://music.apple.com/us/album/never-gonna-give-you-up-2022-remaster/1624945511?i=1624945512 "

• Laden Sie ein Album herunter

  gamdl " https://music.apple.com/us/album/whenever-you-need-somebody-2022-remaster/1624945511 "

• Wählen Sie aus, welche Alben oder Musikvideos Sie von einem Künstler herunterladen möchten

  gamdl " https://music.apple.com/us/artist/rick-astley/669771 "

Interaktive Eingabeaufforderungssteuerung

• Pfeiltasten – Auswahl verschieben
• Leertaste – Auswahl umschalten
• Strg + A – Alles auswählen
• Enter – Auswahl bestätigen

Konfiguration

Gamdl kann mithilfe der Befehlszeilenargumente oder der Konfigurationsdatei konfiguriert werden.

Die Konfigurationsdatei wird automatisch erstellt, wenn Sie Gamdl zum ersten Mal unter ~/.gamdl/config.json unter Linux und %USERPROFILE%.gamdlconfig.json unter Windows ausführen.

Konfigurationsdateiwerte können mithilfe von Befehlszeilenargumenten überschrieben werden.

Befehlszeilenargument/Konfigurationsdateischlüssel	Beschreibung	Standardwert
--disable-music-video-skip / disable_music_video_skip	Überspringen Sie nicht das Herunterladen von Musikvideos in Alben/Playlists.	false
--save-cover , -s / save_cover	Cover als separate Datei speichern.	false
--overwrite / overwrite	Vorhandene Dateien überschreiben.	false
--read-urls-as-txt , -r / -	Interpretieren Sie URLs als Pfade zu Textdateien, die durch Zeilenumbrüche getrennte URLs enthalten.	false
--save-playlist / save_playlist	Speichern Sie beim Herunterladen einer Wiedergabeliste eine M3U8-Wiedergabelistendatei.	false
--synced-lyrics-only / synced_lyrics_only	Laden Sie nur die synchronisierten Liedtexte herunter.	false
--no-synced-lyrics / no_synced_lyrics	Laden Sie die synchronisierten Liedtexte nicht herunter.	false
--config-path / -	Pfad zur Konfigurationsdatei.	/.gamdl/config.json
--log-level / log_level	Protokollebene.	INFO
--no-exceptions / no_exceptions	Ausnahmen nicht drucken.	false
--cookies-path , -c / cookies_path	Pfad zur TXT-Cookie-Datei.	./cookies.txt
--language , -l / language	Metadatensprache als ISO-2A-Sprachcode (funktioniert nicht immer für Videos).	en-US
--output-path , -o / output_path	Pfad zum Ausgabeverzeichnis.	./Apple Music
--temp-path / temp_path	Pfad zum temporären Verzeichnis.	./temp
--wvd-path / wvd_path	Pfad zur .wvd-Datei.	null
--nm3u8dlre-path / nm3u8dlre_path	Pfad zur N_m3u8DL-RE-Binärdatei.	N_m3u8DL-RE
--mp4decrypt-path / mp4decrypt_path	Pfad zur mp4decrypt-Binärdatei.	mp4decrypt
--ffmpeg-path / ffmpeg_path	Pfad zur FFmpeg-Binärdatei.	ffmpeg
--mp4box-path / mp4box_path	Pfad zur MP4Box-Binärdatei.	MP4Box
--download-mode / download_mode	Download-Modus.	ytdlp
--remux-mode / remux_mode	Remux-Modus.	ffmpeg
--cover-format / cover_format	Coverformat.	jpg
--template-folder-album / template_folder_album	Vorlagenordner für Titel, die Teil eines Albums sind.	{album_artist}/{album}
--template-folder-compilation / template_folder_compilation	Vorlagenordner für Titel, die Teil eines Compilation-Albums sind.	Compilations/{album}
--template-file-single-disc / template_file_single_disc	Vorlagendatei für die Titel, die Teil eines Single-Disc-Albums sind.	{track:02d} {title}
--template-file-multi-disc / template_file_multi_disc	Vorlagendatei für die Titel, die Teil eines Multi-Disc-Albums sind.	{disc}-{track:02d} {title}
--template-folder-no-album / template_folder_no_album	Vorlagenordner für die Titel, die nicht Teil eines Albums sind.	{artist}/Unknown Album
--template-file-no-album / template_file_no_album	Vorlagendatei für die Titel, die nicht Teil eines Albums sind.	{title}
--template-file-playlist / template_file_playlist	Vorlagendatei für die M3U8-Playlist.	Playlists/{playlist_title}
--template-date / template_date	Datums-Tag-Vorlage.	%Y-%m-%dT%H:%M:%SZ
--exclude-tags / exclude_tags	Durch Kommas getrennte Tags zum Ausschließen.	null
--cover-size / cover_size	Covergröße.	1200
--truncate / truncate	Maximale Länge der Datei-/Ordnernamen.	null
--codec-song / codec_song	Song-Codec.	aac-legacy
--synced-lyrics-format / synced_lyrics_format	Synchronisiertes Textformat.	lrc
--codec-music-video / codec_music_video	Musikvideo-Codec.	h264
--quality-post / quality_post	Qualität des Postvideos.	best
--no-config-file , -n / -	Verwenden Sie keine Konfigurationsdatei.	false

Markiert Variablen

Die folgenden Variablen können in den Vorlagenordnern/-dateien und/oder in der exclude_tags -Liste verwendet werden:

• album
• album_artist
• album_id
• album_sort
• artist
• artist_id
• artist_sort
• comment
• compilation
• composer
• composer_id
• composer_sort
• copyright
• cover
• date
• disc
• disc_total
• gapless
• genre
• genre_id
• lyrics
• media_type
• playlist_artist
• playlist_id
• playlist_title
• playlist_track
• rating
• storefront
• title
• title_id
• title_sort
• track
• track_total
• xid

Remux-Modi

Die folgenden Remux-Modi sind verfügbar:

• ffmpeg
• mp4box
  • Untertitel in Musikvideos, die diese enthalten, werden nicht konvertiert

Download-Modi

Folgende Download-Modi stehen zur Verfügung:

• ytdlp
• nm3u8dlre
  • Schneller als ytdlp

Song-Codecs

Folgende Codecs stehen zur Verfügung:

• aac-legacy
• aac-he-legacy

Die folgenden Codecs sind ebenfalls verfügbar, es kann jedoch nicht garantiert werden, dass sie funktionieren , da derzeit die meisten (oder alle) Songs nicht heruntergeladen werden können, wenn sie verwendet werden:

• aac
• aac-he
• aac-binaural
• aac-downmix
• aac-he-binaural
• aac-he-downmix
• atmos
• ac3
• alac
• ask
  • Wenn Sie diese Option verwenden, werden Sie von Gamdl gefragt, welcher Codec aus dieser Liste verwendet werden soll, der für den Song verfügbar ist.

Codecs für Musikvideos

Folgende Codecs stehen zur Verfügung:

• h264 (bis zu 1080p, mit AAC 256 kbps)
• h265 (bis zu 2160p, mit AAC 256 kpbs)
• ask
  • Wenn Sie diese Option nutzen, werden Sie von Gamdl gefragt, welcher Audio- und Videocodec verwendet werden soll, der für das Musikvideo verfügbar ist.

Veröffentlichen Sie Videos/zusätzliche Videoqualitäten

Folgende Qualitäten stehen zur Auswahl:

• best (bis zu 1080p, mit AAC 256kbps)
• ask
  • Wenn Sie diese Option verwenden, werden Sie von Gamdl gefragt, welche Videoqualität verwendet werden soll, die für das Video verfügbar ist.

Das Posten von Videos erfordert kein Remuxen und ist auf ytdlp Downloadmodus beschränkt.

Synchronisierte Textformate

Die folgenden synchronisierten Liedtextformate sind verfügbar:

• lrc
• srt
• ttml
  • Natives Format für mit Apple Music synchronisierte Liedtexte.
  • Wird von den meisten Mediaplayern kaum unterstützt.

Coverformate

Folgende Coverformate stehen zur Auswahl:

• jpg
• png
• raw
  • Dieses Format erhält das Rohcover ohne jegliche Bearbeitung.
  • Beachten Sie, dass bei Verwendung dieses Formats das Titelbild nicht in die Dateien eingebettet wird. Um dieses Problem zu beheben, können Sie die Option save_cover aktivieren, um das Cover als separate Datei zu speichern.