gamdl

Pengunduh Musik Apple Glomatico

Aplikasi Python CLI untuk mengunduh lagu/video musik/postingan Apple Music.

Server Perselisihan: https://discord.gg/aBjMEZ9tnq

Fitur

• Unduh lagu dalam AAC 256kbps dan codec lainnya
• Unduh video musik hingga 4K
• Unduh lirik yang disinkronkan dalam LRC, SRT atau TTML
• Pilih antara FFmpeg dan MP4Box untuk remuxing
• Pilih antara yt-dlp dan N_m3u8DL-RE untuk mengunduh
• Sangat dapat disesuaikan
• Gunakan tautan artis untuk mengunduh semua album atau video musiknya

Prasyarat

• Python 3.8 atau lebih tinggi
• File cookie sesi browser Apple Music Anda dalam format Netscape (memerlukan langganan aktif)
  • Untuk mengekspor cookie Anda, gunakan salah satu ekstensi browser berikut saat masuk ke Apple Music:
    • Firefox: https://addons.mozilla.org/addon/export-cookies-txt
    • Browser berbasis Chromium: https://chrome.google.com/webstore/detail/gdocmgbfkjnnpapoeobnolbbkoibbcif
• FFmpeg di PATH sistem Anda
  • FFmpeg versi lama mungkin tidak berfungsi.
  • Biner terkini dapat diperoleh dari tautan di bawah ini:
    • Windows: https://github.com/AnimMouse/ffmpeg-stable-autobuild/releases
    • Linux: https://johnvansickle.com/ffmpeg/

Ketergantungan opsional

Alat berikut bersifat opsional tetapi diperlukan untuk fitur tertentu. Tambahkan mereka ke PATH sistem Anda atau tentukan jalurnya menggunakan argumen baris perintah atau file konfigurasi.

• mp4decrypt
  • Diperlukan saat mengatur mp4box sebagai mode remux, untuk mendownload video musik dan untuk mendownload lagu dalam format non-legacy.
• Kotak MP4
  • Diperlukan saat mengatur mp4box sebagai mode remux.
• N_m3u8DL-RE
  • Diperlukan saat mengatur nm3u8dlre sebagai mode unduh.

Instalasi

1. Instal paket gamdl menggunakan pip

   pip install gamdl

2. Siapkan file cookie.
   • Anda dapat berpindah ke direktori saat ini tempat Anda akan menjalankan Gamdl sebagai cookies.txt atau menentukan jalurnya menggunakan argumen baris perintah/file konfigurasi.

Penggunaan

gamdl [OPTIONS] URLS...

Jenis URL yang didukung

Gamdl mendukung jenis URL berikut:

• Lagu
• Album
• Daftar putar
• Video musik
• Artis
• Posting video/video tambahan

Contoh

• Unduh sebuah lagu

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

• Unduh album

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

• Pilih album atau video musik mana yang akan diunduh dari artis

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

Kontrol cepat interaktif

• Tombol panah - Memindahkan pilihan
• Spasi - Alihkan pilihan
• Ctrl + A - Pilih semua
• Masuk - Konfirmasikan pilihan

Konfigurasi

Gamdl dapat dikonfigurasi dengan menggunakan argumen baris perintah atau file konfigurasi.

File konfigurasi dibuat secara otomatis saat Anda menjalankan Gamdl untuk pertama kalinya di ~/.gamdl/config.json di Linux dan %USERPROFILE%.gamdlconfig.json di Windows.

Nilai file konfigurasi dapat diganti menggunakan argumen baris perintah.

Argumen baris perintah / Kunci file konfigurasi	Keterangan	Nilai bawaan
--disable-music-video-skip / disable_music_video_skip	Jangan lewatkan pengunduhan video musik di album/daftar putar.	false
--save-cover , -s / save_cover	Simpan sampul sebagai file terpisah.	false
--overwrite / overwrite	Timpa file yang ada.	false
--read-urls-as-txt , -r / -	Menafsirkan URL sebagai jalur ke file teks yang berisi URL yang dipisahkan oleh baris baru.	false
--save-playlist / save_playlist	Simpan file playlist M3U8 saat mendownload playlist.	false
--synced-lyrics-only / synced_lyrics_only	Unduh hanya lirik yang disinkronkan.	false
--no-synced-lyrics / no_synced_lyrics	Jangan mengunduh lirik yang disinkronkan.	false
--config-path / -	Jalur ke file konfigurasi.	<home>/.gamdl/config.json
--log-level / log_level	tingkat log.	INFO
--no-exceptions / no_exceptions	Jangan cetak pengecualian.	false
--cookies-path , -c / cookies_path	Jalur ke file cookie .txt.	./cookies.txt
--language , -l / language	Bahasa metadata sebagai kode bahasa ISO-2A (tidak selalu berfungsi untuk video).	en-US
--output-path , -o / output_path	Jalur ke direktori keluaran.	./Apple Music
--temp-path / temp_path	Jalur ke direktori sementara.	./temp
--wvd-path / wvd_path	Jalur ke file .wvd.	null
--nm3u8dlre-path / nm3u8dlre_path	Jalur ke biner N_m3u8DL-RE.	N_m3u8DL-RE
--mp4decrypt-path / mp4decrypt_path	Jalur ke biner mp4decrypt.	mp4decrypt
--ffmpeg-path / ffmpeg_path	Jalur ke biner FFmpeg.	ffmpeg
--mp4box-path / mp4box_path	Jalur ke biner MP4Box.	MP4Box
--download-mode download_mode	Modus unduh.	ytdlp
--remux-mode / remux_mode	Modus remux.	ffmpeg
--cover-format / cover_format	Format sampul.	jpg
--template-folder-album / template_folder_album	Folder templat untuk trek yang merupakan bagian dari album.	{album_artist}/{album}
--template-folder-compilation / template_folder_compilation	Folder templat untuk trek yang merupakan bagian dari album kompilasi.	Compilations/{album}
--template-file-single-disc / template_file_single_disc	File templat untuk trek yang merupakan bagian dari album disk tunggal.	{track:02d} {title}
--template-file-multi-disc / template_file_multi_disc	File templat untuk trek yang merupakan bagian dari album multi-disk.	{disc}-{track:02d} {title}
--template-folder-no-album / template_folder_no_album	Folder templat untuk trek yang bukan merupakan bagian dari album.	{artist}/Unknown Album
--template-file-no-album / template_file_no_album	File templat untuk trek yang bukan bagian dari album.	{title}
--template-file-playlist / template_file_playlist	File templat untuk daftar putar M3U8.	Playlists/{playlist_title}
--template-date templat / template_date	Templat tag tanggal.	%Y-%m-%dT%H:%M:%SZ
--exclude-tags / exclude_tags	Tag yang dipisahkan koma untuk dikecualikan.	null
--cover-size / cover_size	Ukuran sampul.	1200
--truncate / truncate	Panjang maksimum nama file/folder.	null
--codec-song / codec_song	Kodek lagu.	aac-legacy
--synced-lyrics-format / synced_lyrics_format	Format lirik yang disinkronkan.	lrc
--codec-music-video / codec_music_video	Kodek video musik.	h264
--quality-post / quality_post	Kualitas video postingan.	best
--no-config-file , -n / -	Jangan gunakan file konfigurasi.	false

Variabel tag

Variabel berikut dapat digunakan dalam folder/file templat dan/atau dalam daftar 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

Mode remux

Mode remux berikut tersedia:

• ffmpeg
• mp4box
  • Tidak mengonversi teks tertulis di video musik yang memilikinya

Mode pengunduhan

Mode pengunduhan berikut tersedia:

• ytdlp
• nm3u8dlre
  • Lebih cepat dari ytdlp

Codec lagu

Codec berikut tersedia:

• aac-legacy
• aac-he-legacy

Codec berikut juga tersedia, namun tidak dijamin berfungsi , karena saat ini sebagian besar (atau semua) lagu gagal diunduh saat menggunakannya:

• aac
• aac-he
• aac-binaural
• aac-downmix
• aac-he-binaural
• aac-he-downmix
• atmos
• ac3
• alac
• ask
  • Saat menggunakan opsi ini, Gamdl akan menanyakan codec mana dari daftar ini yang akan digunakan dan tersedia untuk lagu tersebut.

Codec video musik

Codec berikut tersedia:

• h264 (hingga 1080p, dengan AAC 256kbps)
• h265 (hingga 2160p, dengan AAC 256kpbs)
• ask
  • Saat menggunakan opsi ini, Gamdl akan menanyakan codec audio dan video mana yang akan digunakan dan tersedia untuk video musik tersebut.

Posting video/kualitas video tambahan

Kualitas berikut tersedia:

• best (hingga 1080p, dengan AAC 256kbps)
• ask
  • Saat menggunakan opsi ini, Gamdl akan menanyakan kualitas video mana yang akan digunakan dan tersedia untuk video tersebut.

Posting video tidak memerlukan remuxing dan terbatas pada mode unduh ytdlp .

Format lirik yang disinkronkan

Tersedia format lirik tersinkronisasi berikut:

• lrc
• srt
• ttml
  • Format asli untuk lirik yang disinkronkan Apple Music.
  • Sangat tidak didukung oleh sebagian besar pemutar media.

Format sampul

Tersedia format sampul berikut:

• jpg
• png
• raw
  • Format ini mendapatkan sampul mentah tanpa pemrosesan apa pun.
  • Perhatikan bahwa saat menggunakan format ini, gambar sampul tidak akan disematkan di dalam file. Untuk mengatasinya, Anda dapat mengaktifkan opsi save_cover untuk menyimpan sampul sebagai file terpisah.