qBitLauncher

A PowerShell post-download handler for qBittorrent with a themed GUI for extracting archives and managing executables.

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
• 🔔 Action feedback - Themed dialogs and sound effects 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.

Context Menu Integration (Optional)

Add "Open with qBitLauncher" to your Shift+Right-click context menu for folders and archive files.

Install:

1. Edit Add-ContextMenu.reg and verify the script path is correct
2. Double-click Add-ContextMenu.reg → Click Yes to confirm

Uninstall:

• Double-click Remove-ContextMenu.reg to remove all context menu entries

Supported locations:

• Folders
• Archive files: .zip, .rar, .7z, .iso, .img

Note: The menu item only appears with Shift+Right-click to keep your regular context menu clean.

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
Runnables	exe, bat, cmd
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