HalalDL Portable Asdmir786

desktop-app ffmpeg open-source react rust tauri video-downloader windows yt-dlp yt-dlp-gui

Use this command to install HalalDL Portable with WinGet:

winget install --id=Asdmir786.HalalDL.Portable -e

yt-dlp GUI for Windows built with Tauri (Portable ZIP with bundled tools)

HalalDL

Local-first media downloading for Windows, powered by yt-dlp.

Official website • Download the latest release • Report a bug • Get support • Read the docs

Start Here

HalalDL is a local-first Windows media downloader powered by yt-dlp, with presets, visible logs, and optional tool management.

Best for most users: download the latest release and choose HalalDL-Full-...-setup.exe
Best for power users: choose HalalDL-Lite-...-setup.exe if you want to manage yt-dlp, ffmpeg, and optional tools yourself
Best for no-install use: choose HalalDL-Portable-...zip if you want the app, settings, archive, thumbnails, and managed tools kept together in one folder
WinGet: install Full with winget install --id Asdmir786.HalalDL, Lite with winget install --id Asdmir786.HalalDL.Lite, or Portable with winget install --id Asdmir786.HalalDL.Portable. Catalog propagation can lag behind GitHub Releases, especially for Portable.
Chocolatey: install Full with choco install halaldl. Community moderation can lag behind GitHub Releases.
AlternativeTo: view the HalalDL listing for discovery and comparisons
Scoop: no verified package-manager install path is published yet
Platform today: Windows 10 and Windows 11, x64
Use it responsibly: only download content you are allowed to access and save; respect platform rules, copyright, and local law

Package managers can lag behind GitHub Releases, so the latest GitHub release is still the fastest path to a new version.

Why People Try HalalDL

Local-first: no account, no tracking, no cloud dependency
Beginner-friendly: paste a URL, pick a preset, and go
Fast clipboard flow: quick tray downloads and auto-paste keep repeat downloads moving
Transparent: raw logs stay visible instead of being hidden behind vague progress messages
Flexible: Full, Lite, and Portable builds let you choose between convenience, control, and no-install use

Why This Exists

HalalDL exists because a lot of Windows users want the power of yt-dlp without living in a terminal or hunting through scattered setup steps.

The project tries to keep the strong parts of the CLI ecosystem while making the daily workflow clearer:

sane presets
visible logs
obvious installer choices
no account system or telemetry layer

Screenshots

Paste a URL. Pick a preset. Watch progress and logs. Reopen finished files from History.

HalalDL — Downloads

HalalDL — Presets

HalalDL — Tools

HalalDL — History

HalalDL — Logs

HalalDL — Settings

Dark mode, Install Trust, Performance, and more shots live in docs/assets/screenshots/.

Download Flow

Paste a video or playlist URL.
Pick a preset or keep the default.
Choose whether to queue it or start immediately.
Watch live progress and raw logs.
Find completed files and past activity in History.

Which Build Should I Download?

For most people, start with Full setup EXE.

Build	Best for	Includes tools	Notes
Full setup EXE	Most users	Yes, app-managed	Recommended first install path
Full MSI	Package/manual deployment	Yes, app-managed	Useful when you specifically prefer MSI
Lite setup EXE	Power users	No	Use your own `yt-dlp`, `ffmpeg`, `aria2`, and optional Deno runtime
Lite MSI	Power-user deployment	No	Same Lite behavior, MSI package
Portable ZIP	Locked-down or no-install Windows setups	Yes, inside `portable-data/bin`	Keep the app and its data together in one folder

Install Trust And SmartScreen

HalalDL releases are currently not code-signed, so Windows SmartScreen may warn on first run.

Download from the official GitHub Releases page only
Verify the installer against the SHA256SUMS.txt file attached to each release
If SmartScreen appears, use More info and confirm the publisher/source only if the checksum matches the release page

Verify SHA256 on Windows

Open PowerShell in the folder where you downloaded the installer and run:

Get-FileHash .\HalalDL-Full-v0.6.0-win10+11-x64-setup.exe -Algorithm SHA256

Compare the Hash value with the matching line in SHA256SUMS.txt from the same GitHub Release. If the filename differs, replace the filename in the command with the file you downloaded.

The repo is public so you can inspect the source, workflows, and release process before installing. See the Code signing policy for the current signing plan and verification guidance.

Features

High-quality video and audio downloads from supported platforms
Built-in presets for common formats, devices, and subtitle workflows
Quick tray downloads with clipboard-aware preset launching
In-app release checks with verified update downloads
Better Instagram support including carousel and image-only handling
Full transparency through raw yt-dlp output
Tools management for yt-dlp, ffmpeg, aria2, and optional runtime support
Download history with media-focused organization
Lite and Full packaging for different comfort levels

FAQ

Is HalalDL a cloud service?

No. HalalDL is a local desktop app.

Which build should I choose?

Choose Full setup EXE if you want the easiest setup. Choose Lite if you prefer managing your own tools. Choose Portable ZIP if you want a no-install folder that carries its app data and managed tools with it.

Does HalalDL support macOS or Linux?

Not in the current release path. The project is Windows-first right now.

Is this code-signed?

Not yet. That is why the README and release process include SmartScreen and checksum guidance.

Current Scope

Windows-first desktop app
Tauri v2 + React + TypeScript frontend
Local JSON storage, no login system, no telemetry

Development

Stack

Commands

pnpm install
pnpm dev
pnpm lint
pnpm typecheck
pnpm check
pnpm build:lite
pnpm build:full

Contributing

Small fixes, UX polish, packaging improvements, and bug reports are all welcome.

Read CONTRIBUTING.md
Use GitHub Issues for bugs and feature requests
Use SECURITY.md for vulnerability reporting guidance

Support

Usage help: SUPPORT.md
Release packaging notes: docs/08-packaging.md
Product overview: docs/01-overview.md

License

MIT

About

Local-first Windows media downloader powered by yt-dlp, with presets, visible logs, and optional tool management.