Pengunduh otomatis untuk Soulseek yang dibuat dengan Soulseek.NET. Menerima file CSV serta url Spotify dan YouTube. Mendukung pengunduhan daftar putar dan album; memilih file terbaik sesuai dengan kondisi file dan heuristik yang dikonfigurasi pengguna.
A url, search string, or path to a local CSV file.
Run --help "input" to view the accepted inputs.
Can also be passed with -i, --input
--user Soulseek username
--pass Soulseek password
Opsi Umum
Max concurrent downloads (default: 2)
--write-playlist Create an m3u playlist file in the output directory
--playlist-path Override default path for m3u playlist file
--no-skip-existing Do not skip downloaded tracks
--no-write-index Do not create a file indexing all downloaded tracks
--index-path Override default path for sldl index
--skip-check-cond Check file conditions when skipping existing files
--skip-check-pref-cond Check preferred conditions when skipping existing files
--skip-music-dir Also skip downloading tracks found in a music library by
comparing filenames. Not 100% reliable.
--skip-not-found Skip searching for tracks that weren't found on Soulseek
during the last run.
--listen-port Port for incoming connections (default: 49998)
--on-complete Run a command whenever a file is downloaded.
Available placeholders: {path} (local save path), {title},
{artist},{album},{uri},{length},{failure-reason},{state}.
Prepend a state number to only run in specific cases:
1:, 2:, 3:, 4: for the Downloaded, Failed, Exists, and
NotFoundLastTime states respectively.
E.g: '1:' will only run the command if the file is
downloaded successfully. Prepend 's:' to use the system
shell to execute the command.
--print
Opsi Pencarian
Number of fails to downrank a user's shares (default: 1)
--fails-to-ignore Number of fails to ban/ignore a user's shares (default: 2)
--yt-dlp Use yt-dlp to download tracks that weren't found on
Soulseek. yt-dlp must be available from the command line.
--yt-dlp-argument The command line arguments when running yt-dlp. Default:
"{id}" -f bestaudio/best -cix -o "{savepath}.%(ext)s"
Available vars are: {id}, {savedir}, {savepath} (w/o ext).
Note that -x causes yt-dlp to download webms in case ffmpeg
is unavailable.
--search-timeout Max search time in ms (default: 6000)
--max-stale-time Max download time without progress in ms (default: 50000)
--searches-per-time Max searches per time interval. Higher values may cause
30-minute bans, see --help "search". (default: 34)
--searches-renew-time Controls how often available searches are replenished.
See --help "search". (default: 220)">
--fast-search Begin downloading as soon as a file satisfying the preferred
conditions is found. Only for normal download mode.
--remove-ft Remove 'feat.' and everything after before searching
--no-remove-special-chars Do not remove special characters before searching
--remove-brackets Remove square brackets and their contents before searching
--regex Remove a regexp from all track titles and artist names.
Optionally specify a replacement regex after a semicolon.
Add 'T:', 'A:' or 'L:' at the start to only apply this to
the track title, artist, or album respectively.
--artist-maybe-wrong Performs an additional search without the artist name.
Useful for sources like SoundCloud where the "artist"
could just be an uploader. Note that when downloading a
YouTube playlist via url, this option is set automatically
on a per-track basis, so it is best kept off in that case.
-d, --desperate Tries harder to find the desired track by searching for the
artist/album/title only, then filtering. (slower search)
--fails-to-downrank Number of fails to downrank a user's shares (default: 1)
--fails-to-ignore Number of fails to ban/ignore a user's shares (default: 2)
--yt-dlp Use yt-dlp to download tracks that weren't found on
Soulseek. yt-dlp must be available from the command line.
--yt-dlp-argument The command line arguments when running yt-dlp. Default:
"{id}" -f bestaudio/best -cix -o "{savepath}.%(ext)s"
Available vars are: {id}, {savedir}, {savepath} (w/o ext).
Note that -x causes yt-dlp to download webms in case ffmpeg
is unavailable.
--search-timeout Max search time in ms (default: 6000)
--max-stale-time Max download time without progress in ms (default: 50000)
--searches-per-time Max searches per time interval. Higher values may cause
30-minute bans, see --help "search". (default: 34)
--searches-renew-time Controls how often available searches are replenished.
See --help "search". (default: 220)
--youtube-key Youtube data API key
--get-deleted Attempt to retrieve titles of deleted videos from wayback
machine. Requires yt-dlp.
--deleted-only Only retrieve & download deleted music.
Opsi File CSV
--artist-col Artist column name
--title-col Track title column name
--album-col Album column name
--length-col Track length column name
--album-track-count-col Album track count column name (sets --album-track-count)
--yt-desc-col Youtube description column (improves --yt-parse)
--yt-id-col Youtube video id column (improves --yt-parse)
--time-format Time format in Length column of the csv file (e.g h:m:s.ms
for durations like 1:04:35.123). Default: s
--yt-parse Enable if the CSV contains YouTube video titles and channel
names; attempt to parse them into title and artist names.
--remove-from-source Remove downloaded tracks from source CSV file
Opsi Kondisi File
--format Accepted file format(s), comma-separated, without periods
--length-tol Length tolerance in seconds
--min-bitrate Minimum file bitrate
--max-bitrate Maximum file bitrate
--min-samplerate Minimum file sample rate
--max-samplerate Maximum file sample rate
--min-bitdepth Minimum bit depth
--max-bitdepth Maximum bit depth
--strict-title File name must contain title
--strict-artist File path must contain artist name
--strict-album File path must contain album name
--banned-users Comma-separated list of users to ignore
--pref-format Preferred file format(s), comma-separated (default: mp3)
--pref-length-tol Preferred length tolerance in seconds (default: 3)
--pref-min-bitrate Preferred minimum bitrate (default: 200)
--pref-max-bitrate Preferred maximum bitrate (default: 2500)
--pref-min-samplerate Preferred minimum sample rate
--pref-max-samplerate Preferred maximum sample rate (default: 48000)
--pref-min-bitdepth Preferred minimum bit depth
--pref-max-bitdepth Preferred maximum bit depth
--pref-banned-users Comma-separated list of users to downrank
--strict-conditions Skip files with missing properties instead of accepting by
default; if --min-bitrate is set, ignores any files with
unknown bitrate.
Opsi Pengunduhan Album
-a, --album Album download mode: Download a folder
-t, --interactive Interactive mode, allows to select the folder and images
--album-track-count Specify the exact number of tracks in the album. Add a + or
- for inequalities, e.g '5+' for five or more tracks.
--album-art
Retrieve additional images after downloading the album:
'default': No additional images
'largest': Download from the folder with the largest image
'most': Download from the folder containing the most images
--album-art-only Only download album art for the provided album
--no-browse-folder Do not automatically browse user shares to get all files in
in the folder
--failed-album-path Path to move all album files to when one of the items from
the directory fails to download. Set to 'delete' to delete
the files instead. Set to 'disable' keep it where it is.
Default: {configured output dir}/failed
Opsi Pengunduhan Agregat
-g, --aggregate Aggregate download mode: Find and download all distinct
songs associated with the provided artist, album, or title.
--aggregate-length-tol Max length tolerance in seconds to consider two tracks or
albums equal. (Default: 3)
--min-shares-aggregate Minimum number of shares of a track or album for it to be
downloaded in aggregate mode. (Default: 2)
--relax-filtering Slightly relax file filtering in aggregate mode to include
more results
Catatan
Akronim dari bendera dua dan --tiga kata juga diterima, misalnya --twf. Jika opsi berisi kata 'max' maka m harus huruf besar. 'bitrate', 'sameplerate' dan 'bit depth' harus diperlakukan sebagai dua kata yang terpisah, misalnya --Mbr untuk --max-bitrate.
Bendera dapat dinonaktifkan secara eksplisit dengan menyetelnya ke false, misalnya '--interactive false'
Jenis masukan
Jenis masukan biasanya ditentukan secara otomatis. Untuk memaksakan jenis masukan tertentu, setel --input-type [spotify|youtube|csv|string|bandcamp|list]. Jenis masukan berikut tersedia:
berkas CSV
Jalur ke file CSV lokal: Gunakan file csv yang berisi info trek dari lagu yang akan diunduh. Nama kolomnya harus Artis, Judul, Album, Panjang, meskipun nama alternatif biasanya juga terdeteksi. Hanya kolom judul atau album yang diperlukan, namun informasi tambahan dapat meningkatkan peringkat hasil pencarian. Setiap baris yang tidak memiliki teks kolom judul akan diperlakukan sebagai unduhan album.
YouTube
Url daftar putar: Unduh lagu dari daftar putar youtube. Metode default untuk mengambil daftar putar tidak selalu mengembalikan semua video, terutama yang tidak tersedia. Untuk mendapatkan semua judul video, Anda dapat menggunakan API resmi dengan memberikan kunci --youtube-key. Dapatkan di sini https://console.cloud.google.com. Buat proyek baru, klik "Aktifkan Api" dan cari "data youtube", lalu ikuti petunjuknya.
Spotify
Url playlist/album atau 'spotify-likes': Unduh playlist spotify, album, atau lagu kesukaan Anda. Kredensial diperlukan saat mengunduh daftar putar pribadi atau musik yang disukai.
Menggunakan Kredensial
Klik untuk memperluas
Buat aplikasi Spotify di https://developer.spotify.com/dashboard/applications dengan url pengalihan http://localhost:48721/callback. Dapatkan ID aplikasi dan rahasia dari dashboard aplikasi yang dibuat.
Mulai sldl dengan kredensial yang diperoleh dan tindakan resmi untuk memicu alur login aplikasi Spotify:
sldl akan mencoba membuka browser secara otomatis tetapi akan kembali mencatat URL alur login ke output. Setelah alur login selesai, sldl akan menampilkan token dan menyegarkan token dan menyelesaikan menjalankan perintah saat ini.
Untuk melewati alur login yang memerlukan setiap kali sldl digunakan, token dan token penyegaran dapat diberikan ke sldl (petunjuk: simpan info ini di file konfigurasi untuk membuat perintah lebih sedikit bertele-tele):
akses spotify-token hanya berlaku selama 1 jam. spotify-refresh akan memungkinkan sldl memperbarui akses setiap kali dijalankan (dan dapat digunakan tanpa menyertakan spotify-token)
Perkemahan band
Url bandcamp: Unduh satu lagu, album, atau seluruh diskografi artis. Mengekstrak nama artis, nama album, dan set --album-track-count="n+", dengan n adalah jumlah lagu yang terlihat di halaman bandcamp.
Garis pencarian
Nama lagu, album, atau artis yang akan dicari: Bisa berupa string pencarian biasa (seperti apa yang akan Anda masukkan ke dalam bilah pencarian soulseek), atau daftar properti yang dipisahkan koma seperti 'title=Nama Lagu, artis= Nama Artis, panjang=215'.
Properti berikut diterima:
title
artist
album
length (in seconds)
artist-maybe-wrong
album-track-count
Contoh masukan dan interpretasinya:
Input String | Artist | Title | Album | Length
---------------------------------------------------------------------------------
'Foo Bar' (without any hyphens) | | Foo Bar | |
'Foo - Bar' | Foo | Bar | |
'Foo - Bar' (with --album enabled) | Foo | | Bar |
'Artist - Title, length=42' | Artist | Title | | 42
'artist=AR, title=T, album=AL' | AR | T | AL |
Daftar
Jalur ke file teks yang setiap barisnya memiliki bentuk berikut:
Dimana "beberapa masukan" adalah salah satu jenis masukan di atas. Tanda kutip dapat dihilangkan jika kolom tidak berisi spasi. Bidang ketentuan ditambahkan di atas ketentuan yang dikonfigurasi dan juga dapat dihilangkan. Input daftar harus diaktifkan secara manual dengan --input-type=list. Ia juga menerima singkatan untuk pengunduhan album: a:"Artist - Album" . Perhatikan bahwa a: harus muncul di luar tanda kutip.
Mode pengunduhan
Normal
Standarnya. Mengunduh satu file untuk setiap entri masukan.
Album
sldl akan mencari album dan mengunduh seluruh folder termasuk file non-audio. Diaktifkan ketika inputnya berupa tautan ke album spotify atau bandcamp, ketika string input atau baris csv tidak memiliki judul lagu, atau ketika -a/--album diaktifkan.
Agregat
Dengan -g/--aggregate, sldl melakukan pencarian biasa untuk masukan kemudian mencoba mengelompokkan hasilnya ke dalam lagu-lagu berbeda dan mengunduh salah satu dari setiap jenis, dimulai dengan yang dibagikan oleh sebagian besar pengguna. Perhatikan bahwa --min-shares-aggregate adalah 2 secara default, yang berarti lagu yang dibagikan hanya oleh satu pengguna akan diabaikan.
Agregat Album
Diaktifkan ketika --album dan --aggregate diaktifkan. sldl akan mengelompokkan pembagian dan mengunduh salah satu dari setiap album berbeda, dimulai dengan album yang dibagikan oleh sebagian besar pengguna. Disarankan untuk memasangkannya dengan --interactive. Perhatikan bahwa --min-shares-aggregate adalah 2 secara default, yang berarti album yang dibagikan hanya oleh satu pengguna akan diabaikan.
Mencari
Kueri Penelusuran
Permintaan pencarian ditentukan sebagai berikut:
Untuk download album: Jika kolom album tidak kosong, cari 'Album Artis'. Jika tidak, cari 'Judul Artis'
Untuk semua jenis download lainnya: Jika kolom judul tidak kosong, cari 'Judul Artis'. Jika tidak, cari 'Album Artis'
Batasan kecepatan Soulseek
Server akan melarang Anda selama 30 menit jika terlalu banyak pencarian yang dilakukan dalam jangka waktu singkat. Program ini memiliki pembatas pencarian yang dapat disesuaikan dengan --searches-per-time dan --searches-renew-time (bila batas tersebut tercapai, status unduhan akan menjadi "Menunggu"). Secara default dikonfigurasi untuk mengizinkan hingga 34 pencarian setiap 220 detik. Nilai default ditentukan melalui eksperimen, jadi mungkin saja salah.
Mempercepat segalanya
Opsi berikut akan mempercepat proses, namun dapat menurunkan kualitas hasil penelusuran atau menyebabkan ketidakstabilan:
--pencarian cepat melompati menunggu hingga pencarian selesai dan mengunduh segera setelah file yang cocok dengan kondisi pilihan ditemukan
--concurrent-downloads - setel ke 4 atau lebih
--max-stale-time diatur ke 50 detik secara default, sehingga akan menunggu lama sebelum menyerah pada suatu file
--pencarian-per-waktu - meningkatkan risiko larangan.
Kondisi berkas
File yang tidak memenuhi persyaratan yang diperlukan tidak akan diunduh. File yang memenuhi kondisi awal akan lebih diutamakan; pengaturan --pref-format "flac,wav" akan membuatnya mengunduh file lossless jika tersedia, dan hanya mengunduh file lossy jika tidak ada yang lain.
Tidak ada kondisi default yang diperlukan. Kondisi pilihan default adalah:
Oleh karena itu, sldl akan lebih memilih file mp3 dengan bitrate antara 200 dan 2500 kbps, dan yang panjangnya berbeda dari panjang yang disediakan tidak lebih dari 3 detik. Ia juga akan memilih file yang jalurnya berisi judul dan album yang disediakan (mengabaikan huruf besar/kecil, dan dibatasi oleh karakter batas) dan yang panjangnya bukan nol. Mengubah tiga kondisi pilihan terakhir tidak disarankan. Perhatikan bahwa file yang memenuhi sebagian kondisi yang diinginkan akan tetap lebih disukai dibandingkan file yang tidak memenuhi kondisi apa pun, namun beberapa kondisi lebih diutamakan dibandingkan kondisi lainnya. Misalnya, file yang hanya memenuhi judul ketat (jika diaktifkan) akan selalu lebih disukai daripada file yang hanya memenuhi kondisi format. Jalankan dengan --print "results-full" untuk menampilkan logika pengurutan.
Kondisi juga dapat diberikan sebagai string yang dipisahkan titik koma dengan --cond dan --pref, misalnya --cond "br >= 320; format = mp3,ogg; sr < 96000".
Memfilter hasil yang tidak relevan
Opsi --strict-title, --strict-artist dan --strict-album akan memfilter file apa pun yang tidak berisi judul/artis/album dalam nama file (mengabaikan huruf besar/kecil, dibatasi oleh karakter batas). Cara lain untuk mencegah download palsu adalah dengan menyetel --length-tol ke 3 atau kurang untuk mengabaikan lagu apa pun yang berbeda dari input lebih dari 3 detik. Namun, keempat opsi tersebut telah diaktifkan sebagai kondisi 'pilihan' secara default, artinya file tersebut hanya akan diunduh sebagai upaya terakhir. Oleh karena itu, disarankan untuk mengaktifkannya hanya jika Anda perlu meminimalkan unduhan palsu sebanyak mungkin, atau untuk kasus khusus seperti trek atau album yang namanya hanya terdiri dari satu atau dua karakter.
Catatan penting
Beberapa info mungkin tidak tersedia tergantung pada klien yang digunakan oleh rekan. Misalnya, klien Soulseek standar tidak membagikan bitrate file. Jika (misalnya) --min-bitrate disetel, maka sldl akan tetap menerima file apa pun dengan bitrate yang tidak diketahui. Anda dapat mengonfigurasinya untuk menolak semua file yang satu atau lebih properti yang diperiksa adalah null (tidak diketahui) dengan mengaktifkan --strict-conditions. Sebagai konsekuensinya, jika --min-bitrate juga disetel maka file apa pun yang dibagikan oleh pengguna dengan klien default akan diabaikan. Perhatikan juga bahwa kondisi pilihan default sudah akan memengaruhi peringkat dengan opsi ini karena pemeriksaan bitrate dan samplerate.
Format nama
Variabel yang diapit {} akan diganti dengan nilai tag file yang sesuai. Format nama mendukung subdirektori serta ekspresi kondisional seperti {tag1|tag2} - Jika tag1 adalah null, gunakan tag2. Literal string yang diapit tanda kurung diabaikan dalam pemeriksaan nol.
Contoh:
"{artis} - {judul}" Selalu beri nama 'Artis - Judul'. Karena beberapa berkas di Soulseek tidak diberi tag, yang berikut ini umumnya lebih disukai:
"{artis( - )judul|namafile}" Jika artis dan judul bukan null, beri nama 'Artis - Judul', jika tidak, gunakan nama file asli.
"{albumartis(/)album(/)track(. )title|(missing-tags/)namafolder(/)namafile}" Urutkan file ke dalam folder artis/album jika semua tag ada, jika tidak, masukkan file ke dalam folder 'tag yang hilang'.
Variabel yang tersedia:
artist First artist (from the file tags)
sartist Source artist (as on CSV/Spotify/YouTube/etc)
artists Artists, joined with '&'
albumartist First album artist
albumartists Album artists, joined with '&'
title Track title
stitle Source track title
album Album name
salbum Source album name
year Track year or date
track Track number
disc Disc number
filename Soulseek filename without extension
foldername Soulseek folder name
extractor Name of the extractor used (CSV/Spotify/YouTube/etc)
default-folder Default sldl folder name (usually the playlist name)
Konfigurasi
Lokasi Konfigurasi:
sldl akan mencari file bernama sldl.conf di lokasi berikut:
Baris yang dimulai dengan hashtag (#) akan diabaikan. Tilde di jalur diperluas sebagai direktori pengguna.
Profil konfigurasi:
Profil didukung:
[lossless]
pref-format = flac,wav
Untuk mengaktifkan profil di atas, jalankan --profile "lossless". Untuk membuat daftar semua profil yang tersedia, jalankan --profile "help". Profil dapat diaktifkan secara otomatis berdasarkan beberapa kondisi sederhana:
[no-stale]
profile-cond = interactive && download-mode == "album"
max-stale-time = 999999
# album downloads will never be automatically cancelled in interactive mode
[youtube]
profile-cond = input-type == "youtube"
path = ~/downloads/sldl-youtube
# download to another location for youtube
Operator berikut didukung untuk digunakan dalam profile-cond: &&, ||, ==, !=, !{bool}. Variabel berikut tersedia:
Unduh semua album artis yang ditemukan di soulseek:
sldl "artist=MC MENTAL" -a -g -t
Contoh lanjutan: Pengunduh daftar keinginan otomatis
Buat file bernama wishlist.txt , dan tambahkan beberapa item seperti yang dirinci dalam Jenis input: Daftar:
" Artist - My Favorite Song "
a: " Artist - Some Album, album-track-count=5 "" format=flac "
Tambahkan profil ke sldl.conf Anda:
[wishlist]
input = ~/sldl/wishlist.txt
input-type = list
index-path = ~/sldl/wishlist-index.sldl
Ini akan membuat file indeks global wishlist-index.sldl yang akan dipindai setiap kali sldl dijalankan untuk melewati item wishlist yang telah diunduh. Jika Anda ingin melanjutkan pencarian hingga versi yang memenuhi kondisi pilihan diunduh, tambahkan juga skip-check-pref-cond = true (perhatikan bahwa ini mengharuskan file tetap berada di tempat yang sama setelah diunduh). Terakhir, siapkan tugas cron (atau tugas terjadwal di windows) untuk menjalankan sldl secara berkala dengan opsi berikut:
sldl --profile wishlist
Catatan
Untuk versi macOS, Anda dapat menggunakan publikasikan.sh untuk membuat aplikasi. Unduh dotnet dari https://dotnet.microsoft.com/en-us/download/dotnet/6.0, lalu jalankan chmod +x publish.sh && sh publish.sh . Untuk intel mac, batalkan komentar pada x64 dan beri komentar pada bagian arm64 di terbitkan.sh.
Hasil cetakan mungkin tampak terduplikasi, tumpang tindih, atau tidak diperbarui pada beberapa konfigurasi (terminal windows baru, git bash). Gunakan terminal lain atau --no-progress jika terjadi masalah.
Buruh pelabuhan
Kontainer buruh pelabuhan untuk menjalankan sldl dapat dibuat dari repositori ini. Gambar mendukung linux x86/ARM.
Untuk membangun dan memulai penampung:
clone https://github.com/fiso64/slsk-batchdl
cd slsk-batchdl
docker compose up -d
exec ke dalam wadah untuk mulai menggunakan sldl :
docker compose exec sldl sh
sldl --help
Tumpukan penulisan memasang dua direktori relatif terhadap lokasi docker-compose.yml yang dapat digunakan untuk manajemen file:
/config (di ./config di host) - letakkan konfigurasi sldl.conf Anda di direktori ini dan kemudian gunakan sldl -c /config ... untuk menggunakan konfigurasi Anda di dalam container
/data (di ./data di host) - gunakan sebagai direktori unduhan IE sldl -p /data ...
Izin Berkas
Jika Anda menjalankan Docker di Host Linux, Anda harus menentukan izin user:group dari pengguna yang memiliki konfigurasi dan direktori data di Host untuk menghindari masalah izin file buruh pelabuhan. Ini dapat ditentukan menggunakan variabel lingkungan PUID dan PGID .
Untuk mendapatkan UID dan GID untuk pengguna saat ini, jalankan perintah berikut dari terminal:
id -u -- mencetak UID
id -g -- mencetak GID
Ganti ini dengan variabel yang sesuai ( PUIDPGID ) di docker-compose.yml .
Kron
Satu atau lebih perintah sldl dapat dijalankan sesuai jadwal menggunakan cron yang ada di dalam container.
Untuk membuat jadwal, buatlah file baru di host ./config/crontabs/abc dan gunakan dengan sintaks crontab standar.
Pastikan untuk memulai ulang penampung setelah perubahan apa pun pada file cron dilakukan.
Contoh => Jalankan sldl setiap hari Minggu jam 1 pagi, cari lagu yang hilang dari playlist Spotify yang ditentukan