Skip to main content

🎵 hypeddit-dl

PyPI License: MIT Python 3.8+ Playwright

A CLI downloader and Python library for Hypeddit music download links.

Works for Soundcloud gates as of September 2026. It seems like Hypeddit no longer can perform actions on behalf of your Soundcloud account, so we just need to automate clicking through.

Was originally made with agent help for quick personal scripting.


🚀 Installation

pip install hypeddit-dl

Note: Chromium is auto-installed by the package on first run, or you can run playwright install chromium manually.


💻 CLI Usage

Download a single track

hypeddit-dl https://hypeddit.com/artist/track-name

Specify download folder

hypeddit-dl https://hypeddit.com/artist/track-name --dest ~/Music/DJ_Edits

Batch download multiple tracks

Create a text file (e.g. tracks.txt):

https://hypeddit.com/artist1/edit1
https://hypeddit.com/artist2/bootleg2

Then run:

hypeddit-dl --batch tracks.txt --dest ~/Downloads

CLI Options

Flag Short Default Description
url Hypeddit track URL to download
--batch -b Text file with URLs (one per line)
--dest -d ~/Downloads Directory where downloaded audio is saved
--no-headless False Show browser window during execution
--timeout -t 60 Timeout in seconds waiting for download
--email -e auto Custom email to provide to email gates
--version -v Show version and exit

🐍 Python API

You can easily integrate hypeddit-dl into your own Python scripts:

import asyncio
from hypeddit_dl import download_track

async def main():
    result = await download_track(
        url="https://hypeddit.com/headhigh/astherushcomes",
        dest_dir="~/Music",
        headless=True
    )
    
    if result["success"]:
        print(f"Downloaded: {result['filename']}")
        print(f"Path: {result['file_path']}")
        print(f"Size: {round(result['size_bytes'] / (1024*1024), 2)} MB")
    else:
        print(f"Failed: {result['error']}")

asyncio.run(main())

🧩 Standalone Userscript (Tampermonkey)

If you prefer downloading directly in your personal browser (Chrome, Firefox, Safari):

  1. Install Tampermonkey or Violentmonkey.
  2. Open userscript/hypeddit-bypasser.user.js.
  3. Create a new script in your userscript manager and paste the code.
  4. When you visit any Hypeddit gate, it will automatically click through the steps and trigger the download button.

⚖️ License

Distributed under the MIT License.

Metadata

Release files for hypeddit-dl 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hypeddit-dl 0.1.0
File Size Uploaded Provenance Actions
hypeddit_dl-0.1.0.tar.gz 10.3 kB With provenance Details for hypeddit_dl-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for hypeddit-dl 0.1.0
File Interpreter ABI Platform Actions
hypeddit_dl-0.1.0-py3-none-any.whl Python 3 none any Details for hypeddit_dl-0.1.0-py3-none-any.whl

Total release size: 20.5 kB

Release files / hypeddit_dl-0.1.0.tar.gz

Download URL hypeddit_dl-0.1.0.tar.gz
Size 10.3 kB
Tags Source
SHA-256 checksum
How to use checksums
45bed3fabc43914fef7ae366012c16b7ad8a2c08620dd4e181cfca2f60564234
BLAKE2b-256 checksum
How to use checksums
8c4162fb62255aa87034e52fd86e95282ea043d05308875534eeb01c99c10bb0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 3, 2026.

Transparency log

Release files / hypeddit_dl-0.1.0-py3-none-any.whl

Download URL hypeddit_dl-0.1.0-py3-none-any.whl
Size 10.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
acf1360c069ce1e87eb3387f750306d9ca402f409f740bbf72f70b6fc1870071
BLAKE2b-256 checksum
How to use checksums
7fad2683f11bd4bacd81a6cd21aeaa7f1ca9435e3e691b65bf2127b4ee82bb08
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 3, 2026.

Transparency log

Security for hypeddit-dl 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for hypeddit_dl-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 3, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page