gamdl

Descargador de música Apple de Glomatico

Una aplicación Python CLI para descargar canciones, vídeos musicales y publicaciones de Apple Music.

Servidor de discordia: https://discord.gg/aBjMEZ9tnq

Características

• Descarga canciones en AAC 256 kbps y otros códecs
• Descarga vídeos musicales hasta 4K
• Descarga letras sincronizadas en LRC, SRT o TTML
• Elija entre FFmpeg y MP4Box para remuxing
• Elija entre yt-dlp y N_m3u8DL-RE para descargar
• Altamente personalizable
• Utilice enlaces de artistas para descargar todos sus álbumes o vídeos musicales.

Requisitos previos

• Python 3.8 o superior
• El archivo de cookies de tu sesión del navegador Apple Music en formato Netscape (requiere suscripción activa)
  • Para exportar sus cookies, utilice una de las siguientes extensiones de navegador mientras inicia sesión en Apple Music:
    • Firefox: https://addons.mozilla.org/addon/export-cookies-txt
    • Navegadores basados ​​en Chromium: https://chrome.google.com/webstore/detail/gdocmgbfkjnnpapoeobnolbbkoibbcif
• FFmpeg en la RUTA de su sistema
  • Es posible que las versiones anteriores de FFmpeg no funcionen.
  • Los binarios actualizados se pueden obtener en los siguientes enlaces:
    • Windows: https://github.com/AnimMouse/ffmpeg-stable-autobuild/releases
    • Linux: https://johnvansickle.com/ffmpeg/

Dependencias opcionales

Las siguientes herramientas son opcionales pero necesarias para funciones específicas. Agréguelos a la RUTA de su sistema o especifique sus rutas usando argumentos de línea de comandos o el archivo de configuración.

• mp4descifrar
  • Requerido al configurar mp4box como modo remux, para descargar videos musicales y para descargar canciones en formatos no heredados.
• MP4Box
  • Requerido al configurar mp4box como modo remux.
• N_m3u8DL-RE
  • Requerido al configurar nm3u8dlre como modo de descarga.

Instalación

1. Instale el paquete gamdl usando pip

   pip install gamdl

2. Configure el archivo de cookies.
   • Puede moverse al directorio actual desde el cual ejecutará Gamdl como cookies.txt o especificar su ruta usando el archivo de configuración/argumentos de la línea de comandos.

Uso

gamdl [OPTIONS] URLS...

Tipos de URL admitidos

Gamdl admite los siguientes tipos de URL:

• Canción
• Álbum
• Lista de reproducción
• vídeo musical
• Artista
• Publicar vídeo/vídeo adicional

Ejemplos

• descargar una cancion

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

• Descargar un álbum

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

• Elige qué álbumes o vídeos musicales descargar de un artista

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

Controles de aviso interactivos

• Teclas de flecha - Mover selección
• Espacio - Alternar selección
• Ctrl + A - Seleccionar todo
• Entrar - Confirmar selección

Configuración

Gamdl se puede configurar utilizando los argumentos de la línea de comando o el archivo de configuración.

El archivo de configuración se crea automáticamente cuando ejecuta Gamdl por primera vez en ~/.gamdl/config.json en Linux y %USERPROFILE%.gamdlconfig.json en Windows.

Los valores del archivo de configuración se pueden anular utilizando argumentos de línea de comando.

Argumento de línea de comando/clave del archivo de configuración	Descripción	Valor predeterminado
--disable-music-video-skip / disable_music_video_skip	No omita la descarga de videos musicales en álbumes/listas de reproducción.	false
--save-cover , -s / save_cover	Guarde la portada como un archivo separado.	false
--overwrite / overwrite	Sobrescribir archivos existentes.	false
--read-urls-as-txt , -r / -	Interprete las URL como rutas a archivos de texto que contienen URL separadas por nuevas líneas.	false
--save-playlist / save_playlist de reproducción	Guarde un archivo de lista de reproducción M3U8 al descargar una lista de reproducción.	false
--synced-lyrics-only / synced_lyrics_only	Descarga solo las letras sincronizadas.	false
--no-synced-lyrics / no_synced_lyrics	No descargues las letras sincronizadas.	false
--config-path / -	Ruta al archivo de configuración.	<home>/.gamdl/config.json
--log-level / log_level	Nivel de registro.	INFO
--no-exceptions / no_exceptions	No imprima excepciones.	false
--cookies-path , -c / cookies_path	Ruta al archivo de cookies .txt.	./cookies.txt
--language , -l / language	Idioma de metadatos como código de idioma ISO-2A (no siempre funciona para videos).	en-US
--output-path , -o / output_path	Ruta al directorio de salida.	./Apple Music
--temp-path temp / temp_path	Ruta al directorio temporal.	./temp
--wvd-path / wvd_path	Ruta al archivo .wvd.	null
--nm3u8dlre-path / nm3u8dlre_path	Ruta al binario N_m3u8DL-RE.	N_m3u8DL-RE
--mp4decrypt-path / mp4decrypt_path	Ruta al binario mp4decrypt.	mp4decrypt
--ffmpeg-path / ffmpeg_path	Ruta al binario FFmpeg.	ffmpeg
--mp4box-path / mp4box_path	Ruta al binario MP4Box.	MP4Box
--download-mode / download_mode	Modo de descarga.	ytdlp
--remux-mode / remux_mode	Modo Remux.	ffmpeg
--cover-format / cover_format	Formato de portada.	jpg
--template-folder-album / template_folder_album	Carpeta de plantillas para pistas que forman parte de un álbum.	{album_artist}/{album}
--template-folder-compilation / template_folder_compilation	Carpeta de plantillas para pistas que forman parte de un álbum recopilatorio.	Compilations/{album}
--template-file-single-disc / template_file_single_disc	Archivo de plantilla para las pistas que forman parte de un álbum de un solo disco.	{track:02d} {title}
--template-file-multi-disc / template_file_multi_disc	Archivo de plantilla para las pistas que forman parte de un álbum multidisco.	{disc}-{track:02d} {title}
--template-folder-no-album / template_folder_no_album	Carpeta de plantillas para las pistas que no forman parte de un álbum.	{artist}/Unknown Album
--template-file-no-album / template_file_no_album	Archivo de plantilla para las pistas que no forman parte de un álbum.	{title}
--template-file-playlist / lista de reproducción template_file_playlist	Archivo de plantilla para la lista de reproducción M3U8.	Playlists/{playlist_title}
--template-date / template_date	Plantilla de etiqueta de fecha.	%Y-%m-%dT%H:%M:%SZ
--exclude-tags / exclude_tags	Etiquetas separadas por comas para excluir.	null
--cover-size / cover_size	Tamaño de la cubierta.	1200
--truncate / truncate	Longitud máxima de los nombres de archivos/carpetas.	null
--codec-song / codec_song	Códec de canciones.	aac-legacy
--synced-lyrics-format / synced_lyrics_format	Formato de letras sincronizadas.	lrc
--codec-music-video / codec_music_video	Códec de vídeo musical.	h264
--quality-post / quality_post	Publicar calidad de vídeo.	best
--no-config-file , -n / -	No utilice un archivo de configuración.	false

Etiquetas variables

Las siguientes variables se pueden utilizar en las carpetas/archivos de plantilla y/o en la lista de 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

Modos Remux

Están disponibles los siguientes modos remux:

• ffmpeg
• mp4box
  • No convierte subtítulos en videos musicales que los tienen

Modos de descarga

Están disponibles los siguientes modos de descarga:

• ytdlp
• nm3u8dlre
  • Más rápido que ytdlp

Códecs de canciones

Están disponibles los siguientes códecs:

• aac-legacy
• aac-he-legacy

Los siguientes códecs también están disponibles, pero no se garantiza que funcionen , ya que actualmente la mayoría (o todas) las canciones no se pueden descargar al usarlas:

• aac
• aac-he
• aac-binaural
• aac-downmix
• aac-he-binaural
• aac-he-downmix
• atmos
• ac3
• alac
• ask
  • Al usar esta opción, Gamdl le preguntará qué códec de esta lista usar que está disponible para la canción.

Códecs de vídeos musicales

Están disponibles los siguientes códecs:

• h264 (hasta 1080p, con AAC 256 kbps)
• h265 (hasta 2160p, con AAC 256 kpbs)
• ask
  • Al usar esta opción, Gamdl le preguntará qué códec de audio y video usar que esté disponible para el video musical.

Publicar videos/cualidades de videos adicionales

Están disponibles las siguientes calidades:

• best (hasta 1080p, con AAC 256 kbps)
• ask
  • Al usar esta opción, Gamdl le preguntará qué calidad de video usar que esté disponible para el video.

Publicar videos no requiere remuxing y está limitado al modo de descarga ytdlp .

Formatos de letras sincronizadas

Están disponibles los siguientes formatos de letras sincronizadas:

• lrc
• srt
• ttml
  • Formato nativo para letras sincronizadas con Apple Music.
  • Altamente no soportado por la mayoría de los reproductores multimedia.

Formatos de portada

Están disponibles los siguientes formatos de portada:

• jpg
• png
• raw
  • Este formato obtiene la portada cruda sin ningún procesamiento.
  • Tenga en cuenta que al utilizar este formato, la imagen de portada no se incrustará en los archivos. Para solucionar este problema, puede habilitar la opción save_cover para guardar la portada como un archivo separado.