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

版本

1.7.0

创建于

2025-10-02

更新于

2025-10-02

大小

12.3 KB

许可证

MIT

适用于

spotidown.app

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

Paste your Spotify playlist/album URL on spotidown.app and let the site render the track list.
Click Resolve Direct Links (up to N, X×) to resolve per-track URLs in parallel.
Optionally click Download Resolved to open the resolved links (tab/iframe/navigate).
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).