SpotiDown Helper

Resolve per-track links in parallel, show counters, bulk-open resolved links; clean filenames; retry support; persistent UI across content reloads.

作者
sharmanhall
日安装量
0
总安装量
0
评分
0 0 0
版本
1.7.0
创建于
2025-10-02
更新于
2025-10-02
大小
12.3 KB
许可证
MIT
适用于

SpotiDown Helper — Additional Info

What this script does

  • Resolves direct per-track download links by submitting each track’s existing form (/action/track) — no ZIP endpoints, no paywall bypass.
  • Parallel resolution with a small worker pool for speed (default RESOLVE_POOL = 3).
  • Inline replacements: swaps each track’s “Download MP3” button with a direct link (target="_blank", rel="noopener").
  • Bulk open:Download Resolved” button opens all resolved links sequentially with a short delay.
  • Per-row status badges (Pending / Working / Resolved / Opened / Failed) with Retry on failures.
  • Toolbar counters: Total · Resolved · Opened · Failed.
  • Cleaner filenames: sets download="Song - Artist.mp3" when the browser honors it.

✅ This script only automates actions you can already do manually on the site, and does not attempt to remove limits or defeat paywalls.


How to use

  1. Paste your Spotify playlist/album URL on spotidown.app and let the site render the track list.
  2. Click Resolve Direct Links (up to N, X×) to resolve per-track URLs in parallel.
  3. Optionally click Download Resolved to open the resolved links (tab/iframe/navigate).
  4. Use Retry next to any Failed row to attempt again.

Settings (top of the script)

  • MAX_TRACKS — maximum number of tracks to process on the page (default 100).
  • RESOLVE_POOL — number of concurrent “resolve” workers (default 3). Use 2–3 to be gentle.
  • PACE_MS — min/max random delay between resolve requests per worker.
  • OPEN_DELAY_MS — delay between opening resolved links during bulk open.
  • OPEN_MODE'tab' | 'iframe' | 'navigate'
    • tab: opens each in a new tab (most reliable if pop-ups are allowed).
    • iframe: attempts a quiet download in a hidden iframe; good if server sets Content-Disposition: attachment.
    • navigate: leaves the page on first open (stops the queue).

Tip: If your browser blocks pop-ups, prefer OPEN_MODE = 'iframe' or increase OPEN_DELAY_MS.


Filenames

  • The script suggests clean names via the anchor’s download="Song - Artist.mp3".
  • Cross-origin caveat: if the server sets Content-Disposition: attachment; filename=..., that filename will override the hint.

Compatibility

  • Designed for the current structure of spotidown.app playlist/album results:
    • Track rows contain a form named submitspurl with hidden data (Base64 JSON).
    • Direct links are returned by /action/track and typically embedded as <a id="popup" ...>.
  • If the site changes its DOM or endpoints, adjustments may be required.

Troubleshooting

  • Nothing happens on resolve: Ensure the page has rendered multiple track forms (name="submitspurl"). Try refreshing and re-pasting the URL.
  • Pop-ups blocked: Switch OPEN_MODE to 'iframe' or allow pop-ups for the site.
  • Repeated failures: Use Retry per row. If failures persist, the server may be rate-limiting or rejecting requests.
  • Counters off? They should self-correct on successful retries (failed– – / resolved++ or opened++).

Privacy & Permissions

  • No external @require libraries; no analytics, no remote calls beyond the site’s own endpoints.
  • The script only posts to the site’s existing /action/track endpoint with the form’s own FormData.

Notes

  • This script purposely does not interact with /action/bulktrack or /action/create_zip.
  • Please respect the site’s terms, limits, and your local laws.
  • If you maintain large playlists, consider smaller RESOLVE_POOL and a slightly larger PACE_MS.

Changelog

v1.6.2

  • Retry counters fixed for open failures: Retrying an “Open failed” now decrements Failed and increments Opened on success.
  • Keeps previous fixes for resolve retries.

v1.6.1

  • Retry counters fixed for resolve failures: When a Retry of a failed resolve succeeds, Failed −1, Resolved +1.

v1.6.0

  • Retry buttons added for both failure modes:
    • Failed resolve → Retry re-submits /action/track and swaps in the direct link on success.
    • Failed open → Retry attempts to open the direct link again.
  • Per-row badges reflect states (Pending / Working / Resolved / Opened / Failed).

v1.5.0

  • Parallel resolving with a small worker pool (RESOLVE_POOL, default 3).
  • Toolbar counters: Total, Resolved, Opened, Failed.
  • Cleaner filenames via download="Song - Artist.mp3" on the anchor (browser may override if server sets Content-Disposition).

v1.4.0

  • Per-row progress badges.
  • Open modes: tab, iframe, navigate. Default iframe for quiet downloads.
  • Bulk Download Resolved button.

v1.3.0

  • Added Download Resolved button to open already-resolved direct links sequentially with delays.

v1.2.0

  • Replace each per-track Download MP3 button with a direct link by posting to /action/track and parsing the response HTML.

v1.1.0

  • Single-result page support: force _blank on direct link and click it without navigation blocking the queue.

v1.0.0

  • Initial helper: sequential per-track submission and link clicking (safe, respects free cap).