gamdl

Téléchargeur de musique Apple de Glomatico

Une application Python CLI pour télécharger des chansons/clips vidéo/posts Apple Music.

Serveur Discord : https://discord.gg/aBjMEZ9tnq

Caractéristiques

• Téléchargez des chansons au format AAC 256 kbps et autres codecs
• Téléchargez des vidéos musicales jusqu'à 4K
• Téléchargez les paroles synchronisées en LRC, SRT ou TTML
• Choisissez entre FFmpeg et MP4Box pour le remuxing
• Choisissez entre yt-dlp et N_m3u8DL-RE pour le téléchargement
• Hautement personnalisable
• Utilisez les liens d'artistes pour télécharger tous leurs albums ou clips vidéo

Conditions préalables

• Python 3.8 ou supérieur
• Le fichier cookies de votre session du navigateur Apple Music au format Netscape (nécessite un abonnement actif)
  • Pour exporter vos cookies, utilisez l'une des extensions de navigateur suivantes lorsque vous êtes connecté à Apple Music :
    • Firefox : https://addons.mozilla.org/addon/export-cookies-txt
    • Navigateurs basés sur Chromium : https://chrome.google.com/webstore/detail/gdocmgbfkjnnpapoeobnolbbkoibbcif
• FFmpeg sur votre système PATH
  • Les anciennes versions de FFmpeg peuvent ne pas fonctionner.
  • Les binaires à jour peuvent être obtenus à partir des liens ci-dessous :
    • Windows : https://github.com/AnimMouse/ffmpeg-stable-autobuild/releases
    • Linux : https://johnvansickle.com/ffmpeg/

Dépendances facultatives

Les outils suivants sont facultatifs mais requis pour des fonctionnalités spécifiques. Ajoutez-les au PATH de votre système ou spécifiez leurs chemins à l'aide d'arguments de ligne de commande ou du fichier de configuration.

• mp4décrypter
  • Requis lors de la configuration mp4box comme mode remux, pour télécharger des vidéos musicales et pour télécharger des chansons dans des formats non hérités.
• MP4Box
  • Requis lors de la configuration mp4box en mode remux.
• N_m3u8DL-RE
  • Requis lors de la définition de nm3u8dlre comme mode de téléchargement.

Installation

1. Installez le package gamdl en utilisant pip

   pip install gamdl

2. Configurez le fichier cookies.
   • Vous pouvez soit vous déplacer vers le répertoire actuel à partir duquel vous exécuterez Gamdl en tant que cookies.txt , soit spécifier son chemin à l'aide du fichier arguments/config de ligne de commande.

Usage

gamdl [OPTIONS] URLS...

Types d'URL pris en charge

Gamdl prend en charge les types d'URL suivants :

• Chanson
• Album
• Liste de lecture
• Clip vidéo
• Artiste
• Publier une vidéo/vidéo supplémentaire

Exemples

• Télécharger une chanson

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

• Télécharger un album

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

• Choisissez les albums ou les clips vidéo à télécharger d'un artiste

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

Commandes d'invite interactives

• Touches fléchées - Déplacer la sélection
• Espace - Basculer la sélection
• Ctrl + A - Tout sélectionner
• Entrée - Confirmer la sélection

Configuration

Gamdl peut être configuré en utilisant les arguments de ligne de commande ou le fichier de configuration.

Le fichier de configuration est créé automatiquement lorsque vous exécutez Gamdl pour la première fois sur ~/.gamdl/config.json sous Linux et %USERPROFILE%.gamdlconfig.json sous Windows.

Les valeurs du fichier de configuration peuvent être remplacées à l'aide d'arguments de ligne de commande.

Argument de ligne de commande/clé du fichier de configuration	Description	Valeur par défaut
--disable-music-video-skip / disable_music_video_skip	Ne sautez pas le téléchargement de vidéos musicales dans des albums/listes de lecture.	false
--save-cover , -s / save_cover	Enregistrez la couverture dans un fichier séparé.	false
--overwrite / overwrite	Écrasez les fichiers existants.	false
--read-urls-as-txt , -r / -	Interprétez les URL comme des chemins vers des fichiers texte contenant des URL séparées par des nouvelles lignes.	false
--save-playlist / save_playlist	Enregistrez un fichier de liste de lecture M3U8 lors du téléchargement d'une liste de lecture.	false
--synced-lyrics-only / synced_lyrics_only	Téléchargez uniquement les paroles synchronisées.	false
--no-synced-lyrics / no_synced_lyrics	Ne téléchargez pas les paroles synchronisées.	false
--config-path / -	Chemin d'accès au fichier de configuration.	/.gamdl/config.json
--log-level / log_level	Niveau de journalisation.	INFO
--no-exceptions / no_exceptions	N'imprimez pas les exceptions.	false
--cookies-path , -c / cookies_path	Chemin d'accès au fichier de cookies .txt.	./cookies.txt
--language , -l / language	Langage des métadonnées en tant que code de langue ISO-2A (ne fonctionne pas toujours pour les vidéos).	en-US
--output-path , -o / output_path	Chemin d'accès au répertoire de sortie.	./Apple Music
--temp-path / temp_path	Chemin d'accès au répertoire temporaire.	./temp
--wvd-path / wvd_path	Chemin d'accès au fichier .wvd.	null
--nm3u8dlre-path / nm3u8dlre_path	Chemin d'accès au binaire N_m3u8DL-RE.	N_m3u8DL-RE
--mp4decrypt-path / mp4decrypt_path	Chemin d’accès au binaire mp4decrypt.	mp4decrypt
--ffmpeg-path / ffmpeg_path	Chemin vers le binaire FFmpeg.	ffmpeg
--mp4box-path / mp4box_path	Chemin d'accès au binaire MP4Box.	MP4Box
--download-mode / download_mode	Mode téléchargement.	ytdlp
--remux-mode / remux_mode	Mode remux.	ffmpeg
--cover-format / cover_format	Format de couverture.	jpg
--template-folder-album / template_folder_album	Dossier de modèles pour les pistes faisant partie d'un album.	{album_artist}/{album}
--template-folder-compilation / template_folder_compilation	Dossier de modèles pour les pistes faisant partie d'un album de compilation.	Compilations/{album}
--template-file-single-disc / template_file_single_disc	Fichier modèle pour les pistes faisant partie d'un album à disque unique.	{track:02d} {title}
--template-file-multi-disc / template_file_multi_disc	Fichier modèle pour les pistes faisant partie d'un album multidisque.	{disc}-{track:02d} {title}
--template-folder-no-album / template_folder_no_album	Dossier de modèles pour les pistes qui ne font pas partie d'un album.	{artist}/Unknown Album
--template-file-no-album / template_file_no_album	Fichier modèle pour les pistes qui ne font pas partie d'un album.	{title}
--template-file-playlist / template_file_playlist	Fichier modèle pour la liste de lecture M3U8.	Playlists/{playlist_title}
--template-date / template_date	Modèle de balise de date.	%Y-%m-%dT%H:%M:%SZ
--exclude-tags / exclude_tags	Balises séparées par des virgules à exclure.	null
--cover-size / cover_size	Taille de la couverture.	1200
--truncate / truncate	Longueur maximale des noms de fichiers/dossiers.	null
--codec-song / codec_song	Codec de chanson.	aac-legacy
--synced-lyrics-format / synced_lyrics_format	Format des paroles synchronisées.	lrc
--codec-music-video / codec_music_video	Codec vidéo musical.	h264
--quality-post / quality_post	Qualité de la publication vidéo.	best
--no-config-file , -n / -	N'utilisez pas de fichier de configuration.	false

Variables de balises

Les variables suivantes peuvent être utilisées dans les dossiers/fichiers de modèles et/ou dans la liste exclude_tags :

• 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

Modes de redistribution

Les modes de remux suivants sont disponibles :

• ffmpeg
• mp4box
  • Ne convertit pas les sous-titres codés dans les vidéos musicales qui en contiennent

Modes de téléchargement

Les modes de téléchargement suivants sont disponibles :

• ytdlp
• nm3u8dlre
  • Plus rapide que ytdlp

Codecs de chansons

Les codecs suivants sont disponibles :

• aac-legacy
• aac-he-legacy

Les codecs suivants sont également disponibles, mais leur fonctionnement n'est pas garanti , car actuellement la plupart (ou la totalité) des chansons ne parviennent pas à être téléchargées lors de leur utilisation :

• aac
• aac-he
• aac-binaural
• aac-downmix
• aac-he-binaural
• aac-he-downmix
• atmos
• ac3
• alac
• ask
  • Lorsque vous utilisez cette option, Gamdl vous demandera quel codec de cette liste utiliser et disponible pour la chanson.

Codecs de vidéoclips

Les codecs suivants sont disponibles :

• h264 (jusqu'à 1080p, avec AAC 256 kbps)
• h265 (jusqu'à 2160p, avec AAC 256kpbs)
• ask
  • Lorsque vous utilisez cette option, Gamdl vous demandera quel codec audio et vidéo utiliser qui est disponible pour le clip vidéo.

Qualités de publication de vidéos/vidéos supplémentaires

Les qualités suivantes sont disponibles :

• best (jusqu'à 1080p, avec AAC 256 kbps)
• ask
  • Lorsque vous utilisez cette option, Gamdl vous demandera quelle qualité vidéo utiliser parmi celles disponibles pour la vidéo.

La publication de vidéos ne nécessite pas de remux et est limitée au mode de téléchargement ytdlp .

Formats de paroles synchronisés

Les formats de paroles synchronisés suivants sont disponibles :

• lrc
• srt
• ttml
  • Format natif pour les paroles synchronisées Apple Music.
  • Très peu pris en charge par la plupart des lecteurs multimédias.

Formats de couverture

Les formats de couverture suivants sont disponibles :

• jpg
• png
• raw
  • Ce format obtient la couverture brute sans aucun traitement.
  • Notez que lors de l’utilisation de ce format, l’image de couverture ne sera pas intégrée aux fichiers. Pour résoudre ce problème, vous pouvez activer l'option save_cover pour enregistrer la couverture dans un fichier séparé.