🎧 multidl

Universal Audio Downloader

Made by lunar0x4

multidl is a fast, clean, multi‑platform CLI tool for downloading non‑DRM audio tracks from supported platforms.

Note: Files are stored in the same directory of where you are running multidl.

Currently supports:

• SoundCloud (GraphQL + API‑v2 + HLS → MP3)
• Audio.com (JSON‑LD extraction via headless Chrome)
• Audiomack (HTML track‑ID extraction → API → direct audio URL) (Ad Bypass)
• Bandcamp (Embedded data-tralbum JSON → direct MP3/FLAC stream URL)
• Hearthis (Direct /listen/ endpoint → MP3 stream → FFmpeg copy)
• ReverbNation (HTML‑embedded JSON → CloudFront MP3 URL → FFmpeg copy)
• Archive.org (Direct /serve/<identifier>/<file> URLs → single tracks + full playlists)
• Jamendo (HTML Fetch → MP3 URL)

More platforms coming soon.

---

🚀 Features

• 🔗 Auto‑detects platform from URL
• 🧼 Clean CLI output (no debug spam)
• 🎨 Colorized UI + progress steps
• 🔐 Saves SoundCloud OAuth token locally
• 🖥️ Puppeteer browser automation to bypass bot protection
• 🛠 Works on Windows, macOS, Linux

---

📦 Requirements

• Node.js 18+
• FFmpeg installed and available in PATH
• Dependencies installed automatically via npm:
  • axios
  • chalk
  • puppeteer

---

🔑 SoundCloud OAuth Token (Required for SoundCloud Only)

1. Open soundcloud.com and log in
2. Open DevTools → Network
3. Click any request to api-v2.soundcloud.com
4. Copy the Authorization header
5. Paste it into the CLI when prompted (saved automatically)

Token is stored in:

config/config.json

Delete it to reset.

---

🛠 Installation

npm install -g multidl-cli

---

🎮 Usage

Download any supported track

multidl <url>

Examples:

multidl https://soundcloud.com/neffexmusic/destiny
multidl https://audio.com/duckyboi-audio/audio/veki-veki-super-slowed
multidl https://audiomack.com/skyzen-1/song/veki-veki-2-instrumental-slowed
multidl https://jaymiesilk.bandcamp.com/album/until-we-meet-again-2
multidl https://www.reverbnation.com/alanwalkermusic/song/22564907-fade
multidl https://hearthis.at/nicolas-paul/nicolas-paul-episode-054
multidl https://archive.org/details/bad-apple-10th-anniversary-phase1

---

🔍 What Happens Internally

SoundCloud

1. Resolve permalink via GraphQL
2. Fetch metadata via API‑v2
3. Extract HLS playlist
4. Download & convert to MP3

Audio.com

1. Launch headless Chrome
2. Extract JSON‑LD metadata
3. Download MP3 directly

Audiomack

1. Fetch HTML
2. Extract track ID from aria-labelledby="am-labs-player"
3. Call Audiomack playback API
4. Receive direct audio URL

Bandcamp

1. Fetch HTML page
2. Extract embedded data-tralbum JSON (album/track metadata)
3. Parse trackinfo array
4. Read direct audio URL from file["mp3-128"] (or FLAC if available)
5. Download track(s) with proper naming + album folder support

Hearthis

1. Parse track URL and build /listen/ endpoint
2. Request MP3 stream (server returns raw audio)
3. Extract filename from Content-Disposition header (if present)
4. Download MP3 via FFmpeg (faster than Node streams)

ReverbNation

1. Fetch HTML page
2. Extract embedded JSON containing CloudFront MP3 URL
3. Unescape URL (\/ → /, \u0026 → &)
4. Download MP3 via FFmpeg (direct, no redirects needed)

Archive.org

1. Detect if URL is:
   • a single‑file item
   • a playlist track
   • a full multi‑track playlist
2. For playlist items, extract all <link itemprop="associatedMedia"> URLs
3. Build direct /serve/<identifier>/<filename> download URLs
4. Download each file via FFmpeg (direct copy, no transcoding)

Jamendo

1. Fetch HTML source of the licensing page
2. Locate the embedded JSON containing the storage URL
3. Extract the trackid from the "url":"https://prod-1.storage.jamendo.com/?trackid=XXXXX" field
4. Build the direct MP3 endpoint:
   https://prod-1.storage.jamendo.com/?trackid=<id>&format=mp32
5. Download MP3 via FFmpeg (direct, no auth, no cookies)

---

⚠️ Limitations

• DRM‑protected SoundCloud Go+ tracks cannot be downloaded
• Some private SoundCloud tracks require a fresh OAuth token
• FFmpeg is required for MP3 conversion
• Audio.com requires Puppeteer (installed automatically)

---

📝 License

For educational and personal use only.
Respect artists and copyright laws.