BehanceDl - Behance Downloader

Pull the whole contact sheet. A simple and efficient desktop application to extract and download images and videos from any Behance project.

📖 Description

BehanceDl makes it incredibly easy to save assets from your favorite Behance projects. Instead of saving images one by one, just drop in any Behance project URL. The application will read the page and hand you a manifest of every image and video attached to it, ready to save wherever you like.

✨ Features

• One-Click Extraction: Grab all media files from a project with a single click.
• Simple Workflow: Paste a URL (e.g., https://www.behance.net/gallery/...) and let the app do the rest.
• Sleek Interface: Clean, dark-themed, and user-friendly UI.

🚀 Download

You can download the latest compiled version of the application here:

⬇️ Download Latest Release

(Note: If you are downloading the .exe file, Windows might show a SmartScreen warning since the app is newly published. You can safely click "More info" > "Run anyway".)

💻 How to Use

1. Download the latest version from the link above and run the application.
2. Find a project on Behance and copy its URL.
3. Paste the URL into the input field in BehanceDl.
4. Click the "Read Project" button.
5. Choose your save destination and enjoy your downloaded assets!

⚠️ Notes

Only use this on content you have the right to download (e.g., your own portfolio, or with the owner's permission) and respect Behance's Terms of Service.

💡 About

A small desktop app (Vue 3 + TypeScript + Electron) that reads a Behance project page, lists every image/video asset it can find, and downloads the ones you pick to a folder of your choice.

This is a rewrite of a CLI script into a proper app with a modern UI — the actual scraping/downloading logic (electron/scraper.ts) is the same approach as the original script, just split into typed, reusable functions with progress reporting instead of console.log/readline prompts.

🗂️ Project Structure

electron/
  main.ts       # Electron main process: window + IPC handlers
  preload.ts    # contextBridge API exposed to the renderer as window.behance
  scraper.ts    # Fetching, HTML parsing, and file downloading logic
src/
  App.vue       # The entire UI (intake screen + workspace + progress bar)
  main.ts       # Vue app bootstrap
  style.css     # Design tokens / global styles
index.html      # Renderer HTML entry
vite.config.ts  # Vite + vite-plugin-electron wiring

⚙️ How It Works

1. You paste a Behance project URL and hit Read Project.
2. The main process fetches the page's HTML and:
   • Reads the <title> tag to derive a clean project name.
   • Regex-matches every *.behance.net/project_modules/... asset URL, de-duplicated by filename.
3. The UI shows every asset as a row in a "manifest" list — filter by image/video, pick a resolution (original vs. the 1400px web version), choose a destination folder, and select which files you want.
4. Downloading happens sequentially in the main process; each file tries the source → fs → 1400 resolution variants (or just 1400 for "Standard") before falling back to the original URL, mirroring the original script's retry behavior. Progress streams back to the UI live.
5. Files are saved to <chosen folder>/<Project Name>/, with automatic _1, _2, … suffixes if a filename already exists.

🛠️ Development

Setup

Requires Node.js 18+.

npm install

Run in Development

npm run dev

This starts Vite's dev server and launches the Electron window pointed at it, with hot reload for the Vue UI.

Build App

npm run build

This type-checks the renderer, builds the Vite bundle + compiled Electron main/preload files, then packages everything with electron-builder for your current platform (see the release/ folder for the output).

If you just want an unpacked build to test locally without an installer:

npm run pack