หน้าแรก>การเขียนโปรแกรมที่เกี่ยวข้อง>ซอร์สโค้ดอื่น ๆ
ดาวน์โหลด

เลื่อน

เครื่องมือดาวน์โหลดอัตโนมัติสำหรับ Soulseek ที่สร้างด้วย Soulseek.NET ยอมรับไฟล์ CSV รวมถึง URL ของ Spotify และ YouTube
รองรับการดาวน์โหลดเพลย์ลิสต์และอัลบั้ม เลือกไฟล์ที่ดีที่สุดตามเงื่อนไขไฟล์และการวิเคราะห์พฤติกรรมที่ผู้ใช้กำหนด

ดูตัวอย่างการใช้งาน

ดัชนี

  • ตัวเลือก
  • ประเภทอินพุต
    • ไฟล์ CSV
    • ยูทูบ
    • สปอทิฟาย
    • แบนด์แคมป์
    • สตริงการค้นหา
    • รายการ
  • โหมดการดาวน์โหลด
    • ปกติ
    • อัลบั้ม
    • รวม
    • รวมอัลบั้ม
  • กำลังค้นหา
  • เงื่อนไขไฟล์
  • รูปแบบชื่อ
  • การกำหนดค่า
  • ตัวอย่าง
  • หมายเหตุ
  • นักเทียบท่า

ตัวเลือก 

 Usage: sldl  [OPTIONS]

อาร์กิวเมนต์ที่จำเป็น

--user Soulseek username --pass Soulseek password">
                            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

ตัวเลือกทั่วไป

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

ตัวเลือกการค้นหา

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)

ตัวเลือก Spotify 

    --spotify-id               Spotify client ID
    --spotify-secret       Spotify client secret
    --spotify-token         Spotify access token
    --spotify-refresh       Spotify refresh token
    --remove-from-source           Remove downloaded tracks from source playlist

ตัวเลือก YouTube 

    --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.

ตัวเลือกไฟล์ 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

ตัวเลือกเงื่อนไขไฟล์ 

    --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.

ตัวเลือกการดาวน์โหลดอัลบั้ม 

    -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

ตัวเลือกการดาวน์โหลดรวม 

    -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

หมายเหตุ

นอกจากนี้ยังยอมรับคำย่อของธงสองและ --สามคำ เช่น --twf หากตัวเลือกมีคำว่า 'สูงสุด' m ควรเป็นตัวพิมพ์ใหญ่ 'bitrate', 'sameplerate' และ 'bitdeep' ควรถือเป็นคำสองคำที่แยกจากกัน เช่น --Mbr สำหรับ --max-bitrate

สามารถปิดการใช้งานแฟล็กได้อย่างชัดเจนโดยตั้งค่าเป็นเท็จ เช่น '--interactive false'

ประเภทอินพุต

โดยทั่วไปประเภทอินพุตจะถูกกำหนดโดยอัตโนมัติ หากต้องการบังคับใช้ประเภทอินพุตเฉพาะ ให้ตั้งค่า --input-type [spotify|youtube|csv|string|bandcamp|list] มีประเภทอินพุตต่อไปนี้:

ไฟล์ CSV

เส้นทางไปยังไฟล์ CSV ในเครื่อง: ใช้ไฟล์ CSV ที่มีข้อมูลแทร็กของเพลงที่จะดาวน์โหลด ชื่อของคอลัมน์ควรเป็นศิลปิน ชื่อ อัลบั้ม ความยาว แม้ว่าโดยปกติจะตรวจพบชื่ออื่นเช่นกัน จำเป็นต้องใช้เฉพาะชื่อหรือคอลัมน์อัลบั้ม แต่ข้อมูลเพิ่มเติมอาจช่วยปรับปรุงอันดับผลการค้นหาได้ ทุกแถวที่ไม่มีข้อความคอลัมน์ชื่อจะถือเป็นการดาวน์โหลดอัลบั้ม

ยูทูบ

URL เพลย์ลิสต์: ดาวน์โหลดเพลงจากเพลย์ลิสต์ YouTube วิธีการเริ่มต้นในการดึงเพลย์ลิสต์ไม่ได้ส่งคืนวิดีโอทั้งหมดเสมอไป โดยเฉพาะวิดีโอที่ไม่สามารถใช้งานได้ หากต้องการรับชื่อวิดีโอทั้งหมด คุณสามารถใช้ API อย่างเป็นทางการโดยระบุคีย์ที่มี --youtube-key ดาวน์โหลดได้ที่นี่ https://console.cloud.google.com สร้างโปรเจ็กต์ใหม่ คลิก "เปิดใช้งาน Api" และค้นหา "ข้อมูล youtube" จากนั้นปฏิบัติตามคำแนะนำ

สปอทิฟาย

URL เพลย์ลิสต์/อัลบั้มหรือ 'spotify-likes': ดาวน์โหลดเพลย์ลิสต์ Spotify อัลบั้ม หรือเพลงที่คุณชอบ จำเป็นต้องมีข้อมูลรับรองเมื่อดาวน์โหลดเพลย์ลิสต์ส่วนตัวหรือเพลงที่ชอบ

การใช้ข้อมูลรับรอง

คลิกเพื่อขยาย

สร้างแอปพลิเคชัน Spotify ที่ https://developer.spotify.com/dashboard/applications ด้วย URL การเปลี่ยนเส้นทาง http://localhost:48721/callback รับรหัสแอปพลิเคชันและข้อมูลลับจากแดชบอร์ดแอปพลิเคชันที่สร้างขึ้น

เริ่มต้น sldl ด้วยข้อมูลประจำตัวที่ได้รับและการดำเนินการที่ได้รับอนุญาตเพื่อทริกเกอร์ขั้นตอนการเข้าสู่ระบบแอป Spotify: 

 sldl spotify-likes --spotify-id 123456 --spotify-secret 123456 -n 1 --print-tracks

sldl จะพยายามเปิดเบราว์เซอร์โดยอัตโนมัติ แต่จะถอยกลับไปบันทึก URL ขั้นตอนการเข้าสู่ระบบเพื่อส่งออก หลังจากขั้นตอนการเข้าสู่ระบบเสร็จสมบูรณ์ sldl จะส่งเอาต์พุตโทเค็นและโทเค็นการรีเฟรช และเรียกใช้คำสั่งปัจจุบันให้เสร็จสิ้น

หากต้องการข้ามการกำหนดขั้นตอนการเข้าสู่ระบบทุกครั้งที่ใช้ sldl โทเค็นและโทเค็นการรีเฟรชสามารถระบุให้กับ sldl ได้ (คำแนะนำ: เก็บข้อมูลนี้ไว้ในไฟล์กำหนดค่าเพื่อทำให้คำสั่งละเอียดน้อยลง): 

 sldl spotify-likes --spotify-id 123456 --spotify-secret 123456 --spotify-refresh 123456 --spotify-token 123456 -n 1 --pt

การเข้าถึง Spotify-Token ใช้ได้เพียง 1 ชั่วโมงเท่านั้น Spotify-refresh จะช่วยให้ sldl ต่ออายุการเข้าถึงทุกครั้งที่มีการเรียกใช้ (และสามารถใช้งานได้โดยไม่ต้องรวม Spotify-token)

แบนด์แคมป์

URL ของ bandcamp: ดาวน์โหลดเพลงเดียว อัลบั้ม หรือผลงานทั้งหมดของศิลปิน แยกชื่อศิลปิน ชื่ออัลบั้ม และชุด --album-track-count="n+" โดยที่ n คือจำนวนแทร็กที่มองเห็นได้บนหน้า bandcamp

สตริงการค้นหา

ชื่อของเพลง อัลบั้ม หรือศิลปินที่จะค้นหา: อาจเป็นสตริงการค้นหาทั่วไปใดก็ได้ (เช่น สิ่งที่คุณป้อนลงในแถบค้นหา Soulseek) หรือรายการคุณสมบัติที่คั่นด้วยเครื่องหมายจุลภาค เช่น 'title=Song Name, artist= ชื่อศิลปิน ยาว=215'.

คุณสมบัติต่อไปนี้ได้รับการยอมรับ: 

 title
artist
album
length (in seconds)
artist-maybe-wrong
album-track-count

ข้อมูลตัวอย่างและการตีความ: 

 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       |

รายการ

เส้นทางไปยังไฟล์ข้อความโดยแต่ละบรรทัดมีรูปแบบดังต่อไปนี้: 

 "some input"                    "conditions"                  "preferred conditions"

เช่น:

128" "br >= 320"">
 "artist=Artist, album=Album"    "format=mp3; br > 128"        "br >= 320"

โดยที่ "อินพุตบางส่วน" คือประเภทอินพุตใดๆ ข้างต้น สามารถละเว้นเครื่องหมายคำพูดได้หากฟิลด์ไม่มีการเว้นวรรค ฟิลด์เงื่อนไขจะถูกเพิ่มที่ด้านบนของเงื่อนไขที่กำหนดค่าไว้ และยังสามารถละเว้นได้ อินพุตรายการจะต้องเปิดใช้งานด้วยตนเองด้วย --input-type=list
นอกจากนี้ยังยอมรับชวเลขสำหรับการดาวน์โหลดอัลบั้ม: a:"Artist - Album" โปรดทราบว่า a: ต้องปรากฏนอกเครื่องหมายคำพูด

โหมดการดาวน์โหลด

ปกติ

ค่าเริ่มต้น ดาวน์โหลดไฟล์เดียวสำหรับทุกรายการอินพุต

อัลบั้ม

sldl จะค้นหาอัลบั้มและดาวน์โหลดทั้งโฟลเดอร์รวมถึงไฟล์ที่ไม่ใช่เสียง เปิดใช้งานเมื่ออินพุตเป็นลิงก์ไปยังอัลบั้ม Spotify หรือ bandcamp เมื่อสตริงอินพุตหรือแถว CSV ไม่มีชื่อแทร็ก หรือเมื่อเปิดใช้งาน -a/--album

รวม

ด้วย -g/--aggregate sldl จะทำการค้นหาอินพุตทั่วไป จากนั้นพยายามจัดกลุ่มผลลัพธ์ออกเป็นเพลงที่แตกต่างกันและดาวน์โหลดหนึ่งเพลงในแต่ละประเภท โดยเริ่มจากเพลงที่แชร์โดยผู้ใช้ส่วนใหญ่
โปรดทราบว่า --min-shares-aggregate คือ 2 โดยค่าเริ่มต้น ซึ่งหมายความว่าเพลงที่แชร์โดยผู้ใช้เพียงรายเดียวจะถูกละเว้น

รวมอัลบั้ม

เปิดใช้งานเมื่อเปิดใช้งานทั้ง --album และ --aggregate sldl จะจัดกลุ่มการแชร์และดาวน์โหลดหนึ่งในอัลบั้มที่แตกต่างกัน โดยเริ่มจากอัลบั้มที่แชร์โดยผู้ใช้มากที่สุด ขอแนะนำให้จับคู่สิ่งนี้กับ --interactive
โปรดทราบว่า --min-shares-aggregate คือ 2 โดยค่าเริ่มต้น ซึ่งหมายความว่าอัลบั้มที่แชร์โดยผู้ใช้เพียงคนเดียวจะถูกละเว้น

กำลังค้นหา

คำค้นหา

คำค้นหาถูกกำหนดดังนี้:

  • สำหรับการดาวน์โหลดอัลบั้ม: หากช่องอัลบั้มไม่ว่างเปล่า ให้ค้นหา "อัลบั้มศิลปิน" หรือค้นหา 'ชื่อศิลปิน'
  • สำหรับการดาวน์โหลดประเภทอื่นๆ ทั้งหมด: หากช่องชื่อไม่ว่างเปล่า ให้ค้นหา "ชื่อศิลปิน" หรือค้นหา 'อัลบั้มศิลปิน'

ขีดจำกัดอัตราของ Soulseek

เซิร์ฟเวอร์จะแบนคุณเป็นเวลา 30 นาที หากมีการค้นหามากเกินไปในช่วงเวลาสั้นๆ โปรแกรมมีตัวจำกัดการค้นหาซึ่งสามารถปรับได้ด้วย --searches-per-time และ --searches-renew-time (เมื่อถึงขีดจำกัด สถานะของการดาวน์โหลดจะเป็น "กำลังรอ") ตามค่าเริ่มต้น มีการกำหนดค่าให้อนุญาตการค้นหาสูงสุด 34 ครั้งทุกๆ 220 วินาที ค่าเริ่มต้นถูกกำหนดโดยการทดลอง ดังนั้นค่าเหล่านี้จึงอาจไม่ถูกต้อง

เร่งดำเนินการต่างๆ

ตัวเลือกต่อไปนี้จะทำให้ทำงานเร็วขึ้น แต่อาจลดคุณภาพผลการค้นหาหรือทำให้เกิดความไม่เสถียร:

  • --การค้นหาอย่างรวดเร็วจะข้ามไปรอจนกว่าการค้นหาจะเสร็จสิ้นและดาวน์โหลดทันทีที่พบไฟล์ที่ตรงกับเงื่อนไขที่ต้องการ
  • --concurrent-downloads - ตั้งค่าเป็น 4 หรือมากกว่า
  • --max-stale-time ถูกตั้งค่าเป็น 50 วินาทีตามค่าเริ่มต้น ดังนั้นจึงจะรอเป็นเวลานานก่อนที่จะยอมแพ้กับไฟล์
  • --การค้นหาต่อครั้ง - เพิ่มขึ้นเมื่อเสี่ยงต่อการถูกแบน

เงื่อนไขไฟล์

ไฟล์ที่ไม่ตรงตามเงื่อนไขที่กำหนดจะไม่ถูกดาวน์โหลด ไฟล์ที่ตรงตามเงื่อนไขที่กำหนดไว้จะเป็นที่ต้องการ การตั้งค่า --pref-format "flac,wav" จะทำให้ดาวน์โหลดไฟล์แบบไม่สูญเสียข้อมูลหากมี และดาวน์โหลดไฟล์ที่สูญหายเท่านั้นหากไม่มีสิ่งอื่นใด

ไม่มีเงื่อนไขบังคับเริ่มต้น เงื่อนไขที่ต้องการเริ่มต้นคือ: 

 pref-format = mp3
pref-length-tol = 3
pref-min-bitrate = 200
pref-max-bitrate = 2500
pref-max-samplerate = 48000
pref-strict-title = true
pref-strict-album = true
pref-accept-no-length = false

sldl จะเลือกใช้ไฟล์ MP3 ที่มีบิตเรตระหว่าง 200 ถึง 2500 kbps และมีความยาวแตกต่างจากความยาวที่ให้มาไม่เกิน 3 วินาที นอกจากนี้ยังจะเลือกไฟล์ที่มีพาธประกอบด้วยชื่อและอัลบั้มที่ให้มา (ไม่สนใจตัวพิมพ์และล้อมรอบด้วยอักขระขอบเขต) และมีความยาวไม่เป็นค่าว่าง ไม่แนะนำให้เปลี่ยนเงื่อนไขที่ต้องการสามรายการสุดท้าย
โปรดทราบว่าไฟล์ที่ตรงตามเงื่อนไขเซ็ตย่อยของเงื่อนไขที่ต้องการจะยังคงเป็นที่ต้องการมากกว่าไฟล์ที่ไม่ตรงตามเงื่อนไขใดๆ แต่บางเงื่อนไขจะมีความสำคัญมากกว่าเงื่อนไขอื่นๆ ตัวอย่างเช่น ไฟล์ที่ตรงตามเงื่อนไขชื่อที่เข้มงวดเท่านั้น (หากเปิดใช้งาน) จะถูกเลือกใช้มากกว่าไฟล์ที่ตรงตามเงื่อนไขการจัดรูปแบบเท่านั้น รันด้วย --print "results-full" เพื่อแสดงตรรกะการเรียงลำดับ

เงื่อนไขยังสามารถระบุเป็นสตริงคั่นด้วยอัฒภาคด้วย --cond และ --pref เช่น --cond "br >= 320; format = mp3,ogg; sr < 96000"

การกรองผลลัพธ์ที่ไม่เกี่ยวข้อง

ตัวเลือก --strict-title, --strict-artist และ --strict-album จะกรองไฟล์ใดๆ ที่ไม่มีชื่อ/ศิลปิน/อัลบั้มในชื่อไฟล์ (ไม่สนใจตัวพิมพ์เล็กและใหญ่ ล้อมรอบด้วยตัวอักษรขอบเขต)
อีกวิธีหนึ่งในการป้องกันการดาวน์โหลดที่ผิดพลาดคือการตั้งค่า --length-tol เป็น 3 หรือน้อยกว่า เพื่อให้ไม่สนใจเพลงใดๆ ที่แตกต่างจากอินพุตมากกว่า 3 วินาที อย่างไรก็ตาม ตัวเลือกทั้ง 4 ตัวเลือกได้รับการเปิดใช้งานเป็นเงื่อนไข 'ที่ต้องการ' ตามค่าเริ่มต้นแล้ว ซึ่งหมายความว่าไฟล์ดังกล่าวจะถูกดาวน์โหลดเป็นทางเลือกสุดท้ายเท่านั้น ดังนั้นจึงขอแนะนำให้เปิดใช้งานหากคุณต้องการลดการดาวน์โหลดที่ผิดพลาดให้เหลือน้อยที่สุด หรือในกรณีพิเศษ เช่น แทร็กหรืออัลบั้มที่มีชื่อเพียงหนึ่งหรือสองตัวอักขระ

หมายเหตุสำคัญ

ข้อมูลบางอย่างอาจไม่พร้อมใช้งานทั้งนี้ขึ้นอยู่กับไคลเอนต์ที่เพียร์ใช้ ตัวอย่างเช่น ไคลเอนต์ Soulseek มาตรฐานไม่แชร์บิตเรตของไฟล์ หาก (เช่น) --min-bitrate ถูกตั้งค่าไว้ sldl จะยังคงยอมรับไฟล์ใดๆ ที่มีบิตเรตที่ไม่รู้จัก คุณสามารถกำหนดค่าให้ปฏิเสธไฟล์ทั้งหมดที่มีคุณสมบัติที่เลือกอย่างน้อยหนึ่งรายการเป็นโมฆะ (ไม่ทราบ) โดยเปิดใช้งาน --strict-conditions
ด้วยเหตุนี้ หากตั้งค่า --min-bitrate ไว้ด้วย ไฟล์ใดๆ ที่แชร์โดยผู้ใช้ที่มีไคลเอ็นต์เริ่มต้นจะถูกละเว้น โปรดทราบว่าเงื่อนไขที่ต้องการเริ่มต้นจะส่งผลต่อการจัดอันดับด้วยตัวเลือกนี้อยู่แล้ว เนื่องจากการตรวจสอบบิตเรตและแซมเปิลเรต

รูปแบบชื่อ

ตัวแปรที่อยู่ใน {} จะถูกแทนที่ด้วยค่าแท็กไฟล์ที่เกี่ยวข้อง รูปแบบของชื่อรองรับไดเร็กทอรีย่อยและนิพจน์แบบมีเงื่อนไข เช่น {tag1|tag2} - หาก tag1 เป็นค่าว่าง ให้ใช้ tag2 ตัวอักษรสตริงที่อยู่ในวงเล็บจะถูกละเว้นในการตรวจสอบค่าว่าง

ตัวอย่าง:

  • "{ศิลปิน} - {ชื่อ}"
    ตั้งชื่อเป็น 'ศิลปิน - ชื่อ' เสมอ เนื่องจากไฟล์บางไฟล์ใน Soulseek ไม่มีการติดแท็ก โดยทั่วไปจึงแนะนำให้ใช้สิ่งต่อไปนี้:
  • "{ศิลปิน( - )ชื่อ|ชื่อไฟล์}"
    หากศิลปินและชื่อไม่เป็นค่าว่าง ให้ตั้งชื่อว่า 'ศิลปิน - ชื่อ' มิฉะนั้นให้ใช้ชื่อไฟล์ต้นฉบับ
  • "{albumartist(/)album(/)track(. )title|(missing-tags/)foldername(/)filename}"
    จัดเรียงไฟล์ลงในโฟลเดอร์ศิลปิน/อัลบั้ม หากมีแท็กทั้งหมด มิฉะนั้น ให้วางไว้ในโฟลเดอร์ 'แท็กที่ขาดหายไป'

ตัวแปรที่มีอยู่: 

 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)

การกำหนดค่า

ตำแหน่งกำหนดค่า:

sldl จะค้นหาไฟล์ชื่อ sldl.conf ในตำแหน่งต่อไปนี้: 

 ~/AppData/Roaming/sldl/sldl.conf
~/.config/sldl/sldl.conf

รวมถึงในไดเร็กทอรีของไฟล์ปฏิบัติการด้วย

ไวยากรณ์:

ตัวอย่างไฟล์กำหนดค่า: 

 username = your-username
password = your-password
pref-format = flac
fast-search = true

บรรทัดที่ขึ้นต้นด้วยแฮชแท็ก (#) จะถูกละเว้น ตัวหนอนในพาธจะถูกขยายเป็นไดเร็กทอรีผู้ใช้

โปรไฟล์การกำหนดค่า:

รองรับโปรไฟล์: 

 [lossless]
pref-format = flac,wav

หากต้องการเปิดใช้งานโปรไฟล์ด้านบน ให้รัน --profile "lossless" หากต้องการแสดงรายการโปรไฟล์ที่มีอยู่ทั้งหมด ให้รัน --profile "help"
โปรไฟล์สามารถเปิดใช้งานได้โดยอัตโนมัติตามเงื่อนไขง่ายๆ บางประการ: 

 [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

โอเปอเรเตอร์ต่อไปนี้ได้รับการสนับสนุนสำหรับการใช้งานใน profile-cond: &&, ||, ==, !=, !{bool}
มีตัวแปรต่อไปนี้: 

 input-type        ("youtube"|"csv"|"string"|"bandcamp"|"spotify")
download-mode     ("normal"|"aggregate"|"album"|"album-aggregate")
interactive       (bool)

ตัวอย่าง

ดาวน์โหลดแทร็กจากไฟล์ CSV: 

 sldl test.csv

ดาวน์โหลด Spotify ไลค์: 

 sldl spotify-likes

ดาวน์โหลดอัลบั้มแบบโต้ตอบ: 

 sldl "Some Album" -a -t

ดาวน์โหลดเพลงเฉพาะตามชื่อ โดยเลือกแบบไม่สูญเสียข้อมูล: 

 sldl "MC MENTAL @ HIS BEST, length=242" --pref-format "flac,wav"

ดาวน์โหลดอัลบั้มของทุกเพลงในเพลย์ลิสต์ Spotify: 

 sldl https://spotify/playlist/id -a

ดึงชื่อวิดีโอที่ถูกลบ จากนั้นดาวน์โหลดจากเพลย์ลิสต์ YouTube พร้อมทางเลือก yt-dlp: 

 sldl https://www.youtube.com/playlist/id --get-deleted --yt-dlp

พิมพ์เพลงทั้งหมดโดยศิลปินที่ไม่ได้อยู่ในห้องสมุดของคุณ: 

 sldl "artist=MC MENTAL" --aggregate --skip-music-dir "path/to/music" --print results-full

ดาวน์โหลดอัลบั้มทั้งหมดโดยศิลปินที่พบใน Soulseek: 

 sldl "artist=MC MENTAL" -a -g -t

ตัวอย่างขั้นสูง: เครื่องมือดาวน์โหลดสิ่งที่อยากได้อัตโนมัติ

สร้างไฟล์ชื่อ wishlist.txt และเพิ่มบางรายการตามรายละเอียดใน Input types: List: 

 " Artist - My Favorite Song "
a: " Artist - Some Album, album-track-count=5 " " format=flac "

เพิ่มโปรไฟล์ใน sldl.conf ของคุณ : 

 [wishlist]
input = ~/sldl/wishlist.txt 
input-type = list
index-path = ~/sldl/wishlist-index.sldl

สิ่งนี้จะสร้างไฟล์ดัชนีส่วนกลาง wishlist-index.sldl ซึ่งจะถูกสแกนทุกครั้งที่เรียกใช้ sldl เพื่อข้ามรายการสิ่งที่อยากได้ที่ดาวน์โหลดไปแล้ว หากคุณต้องการค้นหาต่อไปจนกว่าจะดาวน์โหลดเวอร์ชันที่ตรงตามเงื่อนไขที่ต้องการ ให้เพิ่ม skip-check-pref-cond = true (โปรดทราบว่าการดำเนินการนี้ต้องการให้ไฟล์ยังคงอยู่ในจุดเดิมหลังจากดาวน์โหลดแล้ว)
สุดท้าย ให้ตั้งค่างาน cron (หรืองานที่กำหนดเวลาไว้บน windows) เพื่อรัน sldl เป็นระยะด้วยตัวเลือกต่อไปนี้: 

 sldl --profile wishlist

หมายเหตุ

  • สำหรับรุ่น macOS คุณสามารถใช้ publish.sh เพื่อสร้างแอพได้ ดาวน์โหลด dotnet จากhttps://dotnet.microsoft.com/en-us/download/dotnet/6.0 จากนั้นเรียกใช้ chmod +x publish.sh && sh publish.sh สำหรับ Intel Mac ให้ยกเลิกหมายเหตุ x64 และแสดงความคิดเห็นส่วน arm64 ใน publish.sh
  • ผลลัพธ์ที่พิมพ์ออกมาอาจดูเหมือนซ้ำกัน ทับซ้อนกัน หรือไม่อัปเดตในการกำหนดค่าบางอย่าง (เทอร์มินัล windows ใหม่, git bash) ใช้เทอร์มินัลอื่นหรือ --no-progress ในกรณีที่เกิดปัญหา

นักเทียบท่า

คุณสามารถสร้างคอนเทนเนอร์นักเทียบท่าสำหรับการรัน sldl ได้จากที่เก็บนี้ รูปภาพรองรับ linux x86/ARM

วิธีสร้างและเริ่มต้นคอนเทนเนอร์: 

clone https://github.com/fiso64/slsk-batchdl
cd slsk-batchdl
docker compose up -d

exec ลงในคอนเทนเนอร์เพื่อเริ่มใช้ sldl : 

docker compose exec sldl sh
sldl --help

สแต็กการเขียนจะเมานต์สองไดเร็กทอรีสัมพันธ์กับตำแหน่งที่ docker-compose.yml อยู่ ซึ่งสามารถใช้สำหรับการจัดการไฟล์:

  • /config (ที่ . ./config บนโฮสต์) - ใส่การกำหนดค่า sldl.conf ของคุณในไดเร็กทอรีนี้ จากนั้นใช้ sldl -c /config ... เพื่อใช้การกำหนดค่าของคุณในคอนเทนเนอร์
  • /data (ที่ ./data บนโฮสต์) - ใช้เป็นไดเร็กทอรีดาวน์โหลด IE sldl -p /data ...

สิทธิ์ของไฟล์

หากคุณใช้งาน Docker บน โฮสต์ Linux คุณควรระบุสิทธิ์ user:group ของผู้ใช้ที่เป็นเจ้าของ การกำหนดค่าและไดเร็กทอรีข้อมูล บนโฮสต์ เพื่อหลีกเลี่ยงปัญหาสิทธิ์อนุญาตไฟล์นักเทียบท่า สิ่งเหล่านี้สามารถระบุได้โดยใช้ตัวแปรสภาพแวดล้อม PUID และ PGID

หากต้องการรับ UID และ GID สำหรับผู้ใช้ปัจจุบันให้รันคำสั่งเหล่านี้จากเทอร์มินัล:

  • id -u - พิมพ์ UID
  • id -g -- พิมพ์ GID

แทนที่สิ่งเหล่านี้ด้วยตัวแปรที่เกี่ยวข้อง ( PUID PGID ) ใน docker-compose.yml

ครอน

คำสั่ง sldl หนึ่งคำสั่งขึ้นไปสามารถรันตามกำหนดเวลาได้โดยใช้ cron ที่สร้างไว้ในคอนเทนเนอร์

หากต้องการสร้างกำหนดเวลาให้สร้างไฟล์ใหม่บนโฮสต์ ./config/crontabs/abc และใช้กับไวยากรณ์ crontab มาตรฐาน

อย่าลืมรีสตาร์ทคอนเทนเนอร์หลังจากทำการเปลี่ยนแปลงไฟล์ cron

ตัวอย่าง => เรียกใช้ sldl ทุกวันอาทิตย์เวลา 01.00 น. ค้นหาเพลงที่หายไปจากเพลย์ลิสต์ Spotify ที่ระบุ 

 # min   hour    day     month   weekday command
0 1 * * 0 sldl https://open.spotify.com/playlist/6sf1WR5grXGJ6dET -c /config -p /data --skip-existing --m3u-path /data/index.sldl"

crontab.guru สามารถใช้เพื่อช่วยในการกำหนดนิพจน์ได้

ขยาย
ข้อมูลเพิ่มเติม
แอปที่เกี่ยวข้อง
แนะนำสำหรับคุณ
ข้อมูลที่เกี่ยวข้อง ทั้งหมด
ความคิดเห็นจากผู้ใช้