Argus Studio is a powerhouse desktop media downloader engineered specifically to solve modern YouTube downloading restrictions, bot detection barriers, and file-locking bottlenecks on Windows.
Key Features • Why Argus Studio? • Installation & Usage • Building from Source • License
Modern YouTube updates have made video downloading notoriously unreliable for standard tools:
⚠️ JavaScript Challenges & Bot Detection: YouTube frequently blocks requests with errors like"Sign in to confirm you're not a bot"or"This video is not available".⚠️ Complex Streams (DASH/SABR): High-resolution streams (1080p, 1440p, 4K, 8K) separate audio and video tracks, requiring precise on-the-fly muxing.⚠️ Windows File Rename Locks ([WinError 32]): Antivirus and Windows Search Indexers lock.partfiles right as downloads finish, crashing downloaders during rename operations.⚠️ Browser Cookie Conflicts: Active browser sessions lock SQLite cookie databases, preventing tools from reading session tokens.
- Automated JavaScript Challenge Solving: Integrates Node.js execution and dynamic challenge solving (
remote_components: {'ejs:github'}) to bypass bot challenges natively. - Direct-to-File Stream Architecture: Employs
nopart: Truewith progressive retry guards (file_access_retries: 10) to eliminate Windows Defender file-locking errors completely. - Fail-Safe Cookie Extraction: Automatically strips locked database handles and falls back seamlessly to public stream endpoints without interrupting your queue.
- Download single videos, YouTube Shorts, or full channels.
- Select from Best Available, 4K (2160p), 1440p (2K), 1080p (Full HD), 720p (HD), 480p, or 360p.
- Clean container packaging into MP4 or MKV.
- Extract studio-quality audio: MP3 (320 kbps), MP3 (192 kbps), M4A (AAC), FLAC (Lossless), or WAV.
- Automatically fetches video thumbnails and embeds them directly as front album cover art into the audio file.
- Automatically writes full ID3 tags (Artist, Title, Album, Year) using Mutagen.
- Paste any YouTube playlist or channel link and click 📂 Playlist.
- View complete video lists with thumbnails, durations, and titles.
- Select/deselect individual tracks, select all, and enable Sequential Track Numbering (
01 - Video Title.mp4).
- Download only the specific segment of a video you need without downloading gigabytes of unwanted footage.
- Enter Start Time and End Time (e.g.
00:01:30to00:04:15) to extract the exact clip directly from the YouTube stream.
- Fetch official subtitles or YouTube auto-generated captions.
- Select languages: English, Spanish, French, German, or All Languages.
- Option to embed subtitles directly into the MP4 video container or export as standalone
.srtfiles.
- Detects when you copy a YouTube link anywhere in Windows (
youtube.com/watch,youtu.be/,shorts/,playlist). - Displays a quick, non-intrusive "Load YouTube Link" banner directly inside the app.
- Concurrent download queue with configurable worker pool (1 to 5 concurrent jobs).
- Live progress indicators showing percentage, transfer speed (MB/s), downloaded bytes, and ETA.
- Global Bandwidth Limiter (Unlimited, 1 MB/s, 2 MB/s, 5 MB/s, 10 MB/s).
- Automatically tracks all finished downloads.
- Quick action buttons to ▶ Play directly in your default media player, 📂 Show in Explorer, or remove entries.
Download and run the setup wizard (ArgusStudio-Setup.exe) from the repository releases:
- Automatically installs to
AppData\Local\Programs\ArgusStudio. - Creates desktop shortcuts and Start Menu entries.
- Includes a clean uninstaller.
- Download
ArgusStudio.exe. - Place it in any folder and run it directly. No installation or Python setup required!
- Python 3.10+
- Node.js (required for solving YouTube JavaScript challenges)
- FFmpeg (recommended for video/audio merging and ID3 conversion)
# 1. Clone the repository
git clone https://github.com/ChimbuezeDavid/argus-studio.git
cd argus-studio
# 2. Install dependencies
pip install -r requirements.txt
# 3. Launch the application
python app.py# Run the automated build script
build_exe.batThis produces dist\ArgusStudio.exe bundled with all CustomTkinter theme assets, Mutagen ID3 hooks, and windowed launcher flags.
If you have Inno Setup 6 installed:
iscc installer.issThis generates dist\ArgusStudio-Setup.exe.
| Component | Technology | Responsibility |
|---|---|---|
| GUI Framework | customtkinter |
Modern dark-mode responsive desktop interface |
| Download Engine | yt-dlp |
Video/Audio extraction, stream muxing, challenge resolution |
| JS Runtime | Node.js |
Headless execution of YouTube player challenge scripts |
| Audio Tagging | mutagen |
ID3v2.3 tag writing & high-res APIC cover art embedding |
| Queue Manager | Python threading & Queue |
Asynchronous multi-worker download queue |
| Packaging | PyInstaller & Inno Setup |
Single-binary executable & Windows setup wizard |
Distributed under the MIT License. See LICENSE for more details.
Developed by Chimbueze David Okoroji • Star ⭐ this repository if Argus Studio helped you!