中文版本 ∙ English

                   

Report Bug · Request Feature · Ask Question · Report security bug

spankbang-dl is a GUI Python app that allows you to download albums from Spankbang. The GUI is built using tkinter, a standard Python library for creating graphical user interfaces. The app is designed to be:

• User-friendly and easy to use, making it accessible for everyone
• Lightweight and fast, allowing you to download albums quickly and efficiently

Table of Contents

• Requirements
• Installation
  • From PyPI
  • Manual installation
  • Uninstall
• Usage
  • Example of execution
• Contributors
  • How do I contribute to spankbang-dl?
• License
• Credits

Requirements

Here's a breakdown of the packages needed and their versions:

• poetry >= 1.7.1 (only for manual installation)
• beautifulsoup4 >= 4.13.4
• cloudscraper >= 1.2.71
• core-helpers >= 1.2.0
• inquirer >= 3.1.3
• requests >= 2.31.0
• rich >= 13.5.3

Note

The software has been developed and tested using Python 3.13.5. The minimum required version to run the software is Python 3.9. Although the software may work with previous versions, it is not guaranteed.

Installation

From PyPI

spankbang-dl can be installed easily as a PyPI package. Just run the following command:

pip3 install spankbang-dl

Important

For best practices and to avoid potential conflicts with your global Python environment, it is strongly recommended to install this program within a virtual environment. Avoid using the --user option for global installations. We highly recommend using pipx for a safe and isolated installation experience. Therefore, the appropriate command to install spankbang-dl would be:

pipx install spankbang-dl

The program can now be ran from a terminal with the spankbang-dl command.

Manual installation

If you prefer to install the program manually, follow these steps:

Warning

This will install the version from the latest commit, not the latest release.

1. Download the latest version of spankbang-dl from this repository:

   git clone https://github.com/YisusChrist/spankbang-dl
   cd spankbang-dl

2. Install the package:

   poetry install --only main

3. Run the program:

   poetry run spankbang-dl

If you prefer, you can directly install the package from the repository using pip/pipx:

pipx install git+https://github.com/YisusChrist/spankbang-dl.git

Uninstall

If you installed it using pip/pipx, you can use the following command:

pipx uninstall spankbang-dl

Usage

Tip

For more information about the usage of the program, run spankbang-dl --help or spankbang-dl -h.

The program can be run from the terminal with the spankbang-dl command. It will open a window where you can introduce the URL of the video you want to download.

Example of execution

468299776-99a43e6b-1b9e-4ba2-98c9-0f034725f021.mp4

Contributors

How do I contribute to spankbang-dl?

Before you participate in our delightful community, please read the code of conduct.

I'm far from being an expert and suspect there are many ways to improve – if you have ideas on how to make the configuration easier to maintain (and faster), don't hesitate to fork and send pull requests!

We also need people to test out pull requests. So take a look through the open issues and help where you can.

See Contributing Guidelines for more details.

License

spankbang-dl is released under the GPL-3.0 License.

Credits

This program is a fork of an original project created by hoppop-web. I made a few modifications to the original script to fit my needs, which basically are:

• Convert the script into a package, easier to install and use
• Add cloudflare bypass support (#71)
• Resolve video information properly (#73)
• Add support for multiple languages
• Add logging capabilities
• Set the program to always use GUI
• Add some graphic improvements during the download process and fix the progress bar (#75)