Skip to content

Satan2049/idm-queue

Repository files navigation

IDM Queue

IDM Queue

Release License Python CI Windows

Extract download links, inspect file metadata, and send URLs to Internet Download Manager — on your terms.

Download IDMQueue.exe  ·  Landing page  ·  User guide  ·  Verify downloads  ·  VirusTotal


Description

IDM Queue is a Windows desktop app for power users who collect links from forums, paste blocks, and web pages, then hand them off to Internet Download Manager (IDM). By default, links are added to IDM's queue without starting; you can enable immediate downloads when you want.

No installer required — run the portable executable or clone the repo and start from source.

Features

Feature Description
Link extraction URLs from text, clipboard, drag-and-drop, and page scraping
Directory listings Parses Apache/nginx folder listings (309.5M sizes, multi-line rows)
Metadata probing Background HEAD requests for filename, size, and content type
IDM integration Queue-only mode (default) or start downloads immediately
Merge groups Batch related parts and send as one group
File filters Extension-based filtering for extract and scrape
Persistence SQLite history, queue, metadata cache; JSON settings

Screenshots

Extractor History Settings
Extractor History Settings

Demo

IDM Queue demo

Installation

Portable executable (recommended)

  1. Download IDMQueue.exe from Releases.
  2. (Recommended) Verify against SHA256.txt — see docs/TRUST.md. Optional VirusTotal scan (a few engines may flag unsigned PyInstaller builds as false positives).
  3. Run the executable — no installer required.
  4. Ensure IDM is installed (path is auto-detected under Program Files).
  5. Paste links on the Extractor tab → Add to IDM.

Settings are stored in %USERPROFILE%\.idm-queue\config.json.

From source

git clone https://github.com/Satan2049/idm-queue.git
cd idm-queue
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
python main.py

Development

pip install -r requirements-dev.txt
python -m pytest tests/ -v
python main.py
Resource Link
User guide docs/user-guide.md
Architecture docs/architecture/overview.md
Contributing CONTRIBUTING.md
Security SECURITY.md

Build

Package a standalone Windows executable:

pip install -r requirements-build.txt
.\scripts\build.ps1

Output: dist\IDMQueue.exe

Generate release checksums after building:

.\scripts\generate-sha256.ps1

See docs/building.md and docs/releasing.md for the full release workflow.

Tech stack

Layer Technology
Language Python 3.10+
UI CustomTkinter
Drag & drop tkinterdnd2
Persistence SQLite + JSON config
Packaging PyInstaller
Platform Windows 10+
Integration Internet Download Manager CLI (IDMan.exe)

Configuration

Setting Default Description
idm_path auto Path to IDMan.exe
default_download_path empty Optional IDM save folder
idm_start_immediately false When false, links use IDM /a (queue only)
auto_capture_clipboard false Watch clipboard for new URLs
file_filter_enabled true Filter by extension on extract/scrape
theme dark UI appearance

License

MIT — see LICENSE.

IDM Queue is not affiliated with Tonec Inc. or Internet Download Manager.