qBitLauncher

A PowerShell post-download handler for qBittorrent that automatically extracts archives and launches executables with a clean GUI.

Features

• 🗜️ Auto-extraction - Extracts ZIP, RAR, 7z, ISO, and IMG archives
• 📂 Custom extraction path - Choose where to extract with modern folder picker
• 📊 Progress bar - Visual feedback during extraction with cancel support
• 🔍 Smart executable discovery - Finds .exe files with icons, sorted by folder depth
• ✏️ Inline rename - Rename executables directly (F2, double-click, or right-click)
• 📋 Activity Log - Real-time log panel showing all actions
• 🎨 Themed GUI - Dracula dark theme with Light mode option
• 🛡️ Run as Administrator - One-click UAC elevation for installers
• 🔔 Toast notifications - Windows notifications for all actions
• 📦 Auto-update - Checks for updates on startup

Requirements

• Windows 10/11
• PowerShell 5.1+
• 7-Zip (recommended) or WinRAR

Installation

Clone:

git clone https://github.com/DeonHolo/qBitLauncher.git

Or download qBitLauncher.ps1 from the repo.

qBittorrent Integration

1. qBittorrent → Tools → Options → Downloads
2. Under "Run external program", enable "Run on torrent finished"
3. Set command:

   powershell.exe -WindowStyle Hidden -ExecutionPolicy Bypass -File "C:\path\to\qBitLauncher.ps1" "%F"
   

Note: Replace C:\path\to\qBitLauncher.ps1 with the actual path where you saved the script.

Usage

When a torrent completes:

• Archives: Extract → show executables
• Executables: Show selection GUI
• Media: Open containing folder

GUI Actions

Button	Action	Shortcut
Run	Launch as admin	Alt+R
Shortcut	Create desktop shortcut	Alt+S
Open Folder	Open in Explorer	Alt+O
Rename	Rename executable	Alt+N, F2, double-click
Settings	Configure theme	Alt+T
Close	Close window	Alt+C

Configuration

Edit via Settings button or config.json:

{
  "Theme": "Dracula"
}

Themes: Dracula, Light

Supported Extensions

Type	Extensions
Archives	iso, zip, rar, 7z, img
Media	mp4, mkv, avi, mov, wmv, flv, webm, mp3, flac, wav, aac, ogg, m4a

Logging

• GUI: Real-time Activity Log panel
• File: qBitLauncher_log.txt

License

MIT License - see LICENSE