KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #developer-tools #claude-code #ai-agent #codex #deepseek-harness #ai-agents #cli #react #mcp

BunkrDownloader-Portable

★ 101 Open GitHub ↗

Portable executable downloader for Bunkr (Windows OS)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Bunkr Downloader Portable GUI

This project is a fork of the original [BunkrDownloader by Lysagxra](https://github.com/Lysagxra/BunkrDownloader). Huge thanks to her for creating and maintaining the powerful core of this application!

This version focuses on providing an user-friendly **Graphical User Interface (GUI)** for Windows users and includes other features to make downloading as simple as possible.

### Screenshots
*Download tab: paste a URL or load a batch file, watch live progress in the log.*

![Download tab](https://raw.githubusercontent.com/ZeroHackz/BunkrDownloader-Portable/release/latest/screenshots/screenshot-download-tab.png)

*Settings tab: save folder, concurrent downloads, retries, filters, and advanced toggles.*

![Settings tab](https://raw.githubusercontent.com/ZeroHackz/BunkrDownloader-Portable/release/latest/screenshots/screenshot-settings-tab.png)

## ✨ Features

This fork includes all the powerful core features from the original, plus:

*   **Dual Download Modes:** Easily switch between downloading a single URL or batch downloading from a `.txt` file using a simple toggle.
*   **Graphical User Interface (GUI):** A simple and intuitive interface for downloading. No command line needed!
*   **Portable Windows Executable:** Download and run the application directly without needing to install Python or any dependencies.
*   **Easy URL Pasting:** A convenient "Paste" button to quickly insert a Bunkr URL from your clipboard.
*   **File Browser:** A "Browse" button to easily select your URL list file when in "Batch from file" mode.
*   **Settings Tab:** Tweak the save folder, max concurrent downloads, retries, and include/exclude filters without touching the command line.
*   **Stop Button:** Cancel a batch mid-run — the current URL finishes, the rest are skipped.
*   **Detailed CLI Window (optional):** Toggle in Settings to spawn each download in its own console for the full Rich progress bars.
*   **Automatic Folder Opening:** Once your download is complete, the folder containing the files will automatically open.
*   **Build & Setup Scripts:** Comes with `.bat` scripts to easily set up the environment and build the executable from source.

### Core Features

- Downloads multiple files from an album concurrently.
- Supports batch downloading via a list of URLs.
- Supports selective file downloading based on filename criteria.
- Provides progress indication during downloads.
- Automatically creates a directory structure for organized storage.
- Logs URLs that encounter errors for troubleshooting.

## 💻 How to Use (Easy Way)

1.  Go to the [**Releases**](https://github.com/ZeroHackz/BunkrDownloader-Portable/releases) page.
2.  Download the latest `BunkrDownloader-portable-GUI.exe` file.
3.  Run the application.
4.  **Choose your download mode:**
    *   **For a single link:** Leave it on "Single URL", paste your Bunkr URL, and click **Download**.
    *   **For multiple links:** Select "Batch from file", click **Browse** to select your `.txt` file, and then click **Download**.
5.  That's it!

## 🛠️ For Developers (Building from Source)

If you want to build the application yourself:

1.  Clone this repository:
    ```bash
    git clone https://github.com/ZeroHackz/BunkrDownloader-Portable.git
    ```
2.  Navigate to the project directory:
    ```bash
    cd BunkrDownloader-Portable
    ```
3.  Run the setup script. This will create a virtual environment and install the required dependencies.
    ```bat
    setup_launcher.bat
    ```
4.  To build the executable, run the build script:
    ```bat
    build.bat
    ```
    The `.exe` will be available in the `dist` folder.

## CLI Usage

The original command-line interface is still available and fully functional.

### Single Download

```bash
python downloader.py <bunkr_url>
```

### Selective & Batch Downloads

All the original flags like `--ignore`, `--include`, and batch downloading via `URLs.txt` are still supported. The recent upstream sync also adds `--custom-path`, `--max-retries`, `--disable-disk-check`, `--no-download-folder`, and `--version`.
 
For more details, please refer to the [Lysagxra README](https://github.com/Lysagxra/BunkrDownloader/blob/main/README.md).

## Logging

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

BunkrDownloader-Portable

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README