Simple Bunkr Downloader

A Python-based Bunkr downloader that utilizes Playwright for browser automation to fetch and download images and videos from specified URLs. This tool supports downloading from both Bunkr albums and individual file URLs, while also logging any issues encountered during the download process.

Features

• Downloads pictures, videos and albums from specified URLs.
• Supports batch downloading via a list of URLs.
• Progress indication during downloads.
• Automatically creates a directory structure for organized storage.
• Logs URLs that encounter errors for troubleshooting.

Dependencies

• Python 3
• playwright - for browser automation and downloading content.
• BeautifulSoup (bs4) - for HTML parsing
• requests - for HTTP requests
• rich - for progress display in the terminal.

Directory Structure

project-root/
├── helpers/
│   ├── bunkr_utils.py            # Script for checking Bunkr status and URL validation
│   ├── download_utils.py         # Script providing functions to handle the download process
│   ├── progress_utils.py         # Script with functions to create and manage progress indicators
│   └── playwright_downloader.py  # Module that utilizes Playwright to automate media downloads from Bunkr
├── downloader.py                 # Module for initiating downloads from specified Bunkr URLs
├── main.py                       # Entry point script that handles the download process
├── URLs.txt                      # Text file listing album URLs to be downloaded
└── session_log.txt               # Log file for recording session details

Installation

1. Clone the repository:

git clone https://github.com/Lysagxra/SimpleBunkrDownloader.git

2. Navigate to the project directory:

cd SimpleBunkrDownloader

3. Install the required dependencies:

pip install -r requirements.txt

4. Ensure you have Playwright installed and set up installing Firefox:

playwright install firefox

Single Media Download

To download a single media from an URL, you can use downloader.py, running the script with a valid album or media URL.

Usage

python3 downloader.py <bunkr_url>

Example

python3 downloader.py https://bunkr.si/a/PUK068QE

Batch Download

To batch download from multiple URLs, you can use the main.py script. This script reads URLs from a file named URLs.txt and downloads each one using the media downloader.

Usage

1. Create a file named URLs.txt in the root of your project, listing each URL on a new line.

2. Run the batch download script:

python3 main.py

3. The downloaded files will be saved in the Downloads directory.

Logging

The application logs any issues encountered during the download process in a file named session_log.txt. Check this file for any URLs that may have been blocked or had errors.