Skip to content

The GUI Revolution

Jump to bottom
Abdanio Parchezzi edited this page Jan 6, 2026 · 1 revision

Version 1.4 - The GUI Revolution

Released: January 2026
Build: GUI Standalone
Size: ~112 MB

After three successful terminal versions, SNATCH v1.4 takes a different direction: a graphical interface.

Why GUI?

The terminal works great. I use it every day. But not everyone is comfortable with command-line interfaces. When I showed SNATCH v1.3 to friends and family, the response was always the same: "It looks complicated."

It's not complicated. You type a URL, choose quality, hit enter. But if you didn't grow up with terminals, that black window with white text is intimidating.

So v1.4 is about accessibility. Making SNATCH useful to more people.

What Changed

The Interface

v1.4 replaces the terminal with a Windows GUI application. It's a standard window with buttons, dropdowns, and a progress bar.

Design Philosophy:

  • Clean and simple
  • No cluttered icons or decorations
  • Professional appearance
  • Segoe UI font (Windows standard)
  • Clear status messages

The interface is divided into sections:

Top Section: Title and URL input
Middle Section: Type and quality selection
Queue Section: Visual list of pending downloads
Bottom Section: Control buttons and progress

Everything is visible at once. No hidden menus or tabs to navigate.

Drag and Drop

The biggest usability improvement: drag URLs directly into SNATCH.

How It Works:

You're watching YouTube. You find a video you want. Instead of:

  1. Copy URL
  2. Open SNATCH
  3. Click in text field
  4. Paste
  5. Select options

You just:

  1. Drag the URL
  2. Drop it on SNATCH
  3. Done

SNATCH fills the URL field automatically. Then you choose your settings and add to queue.

What You Can Drag:

  • URLs from browser address bar
  • Selected text containing URLs
  • Text files with URLs (reads first line)

This small change makes a huge difference in workflow.

System Tray

SNATCH minimizes to the system tray instead of the taskbar.

Why This Matters:

When you queue up 20 videos, you don't want SNATCH taking up taskbar space. Minimize it, and it disappears—but the icon stays in your system tray.

Tray Features:

Right-click the icon for quick actions:

  • Show Window - Restore from tray
  • Paste URL from Clipboard - Quick-add without opening
  • Exit - Actually close SNATCH

Double-click the icon to restore the window.

The best part: Paste URL from Clipboard. Copy a URL anywhere. Right-click SNATCH's tray icon. Select paste. The window opens with the URL already filled in. Choose quality, download.

This workflow is faster than the terminal version.

Visual Queue

The queue is now a visual list box instead of numbered text.

What You See:

[1] Video - 1080p - https://youtube.com/watch?v=dQw4w9WgXcQ
[2] Audio - Best - https://youtube.com/watch?v=9bZkp7q19f0
[3] Playlist - 720p - https://youtube.com/playlist?list=...

Each line shows:

  • Position number
  • Type (Video/Audio/Playlist)
  • Quality setting
  • URL preview (truncated if long)

You can see your entire queue at a glance. No scrolling through terminal history.

The queue counter updates in real-time: "Download Queue: 3/50 items"

Progress Indication

v1.4 adds a real progress bar.

Visual Progress:

  • Horizontal bar fills left to right
  • Shows current item / total items
  • Resets to zero when complete

Status Text:

  • "Ready - Enter a URL to begin"
  • "Added to queue successfully"
  • "Downloading 5 of 12"
  • "All downloads completed successfully"

The status text animates while downloading: "Processing", "Processing.", "Processing..", "Processing..."

This gives visual feedback that something is happening, even though the actual download runs silently in the background.

Clean Messages

v1.4 removes all the emoji icons from v1.3 GUI beta.

Before (v1.3 GUI beta):

🎬 SNATCH - YouTube Downloader
📎 Enter YouTube URL:
🎥 Video  🎵 Audio  📋 Playlist
⬇️ Start Downloads
💡 Ready to download!

After (v1.4):

SNATCH YouTube Downloader
Fast and Simple Video Downloads
YouTube URL:
Video  Audio (MP3)  Playlist
Start Downloads
Ready - Enter a URL to begin

Emojis looked fun but:

  • Made the interface look unprofessional
  • Didn't render consistently on all Windows versions
  • Added visual clutter
  • Made text harder to read

Clean text is more professional and easier to understand.

How to Use

Basic Workflow

  1. Enter URL - Type or drag YouTube URL
  2. Choose Type - Video, Audio, or Playlist
  3. Select Quality - Best, 4K, 2K, 1080p, 720p, 480p, or 360p
  4. Add to Queue - Click button
  5. Start - Click "Start Downloads" when ready

Drag and Drop Workflow

  1. Find video on YouTube
  2. Drag URL from address bar
  3. Drop on SNATCH window
  4. Choose settings (type/quality)
  5. Add and download

System Tray Workflow

  1. Minimize SNATCH to tray
  2. Copy URL from anywhere
  3. Right-click SNATCH icon
  4. Select "Paste URL from Clipboard"
  5. Window opens with URL ready
  6. Choose settings and download

Technical Details

GUI Framework

v1.4 uses Win32 API—the native Windows GUI framework.

Why Win32:

  • Built into Windows (no dependencies)
  • Fast and lightweight
  • Works on Windows 7+
  • Native look and feel
  • Direct system tray access

Libraries Used:

  • windows.h - Core Win32 functions
  • commctrl.h - Common controls (progress bar)
  • shellapi.h - Shell API (drag-drop, tray)

The entire GUI is ~30KB of code. The rest of the 112MB is still the embedded yt-dlp and FFmpeg binaries.

Drag and Drop

Implemented using Windows drag-drop API:

DragAcceptFiles(hwnd, TRUE);  // Enable drag-drop

When you drop something, SNATCH:

  1. Receives WM_DROPFILES message
  2. Extracts dropped file path
  3. If it's a text file, reads first line
  4. Otherwise uses the path itself as URL
  5. Fills URL input field

System Tray

Uses Shell_NotifyIcon API:

NOTIFYICONDATA nid;
nid.hIcon = LoadIcon(...);
nid.uCallbackMessage = WM_TRAYICON;
Shell_NotifyIcon(NIM_ADD, &nid);

When you right-click the icon:

  1. Creates popup menu
  2. Shows at cursor position
  3. Handles menu selection
  4. Performs action (show/paste/exit)

Threading

Downloads run in a separate thread to keep the GUI responsive:

CreateThread(NULL, 0, StartDownloads, NULL, 0, NULL);

This prevents the window from freezing during downloads. You can still interact with the interface (though most controls are disabled while downloading to prevent conflicts).

Animation

Status text animation uses a simple timer:

SetTimer(hwnd, ID_TIMER_ANIMATE, 500, NULL);

Every 500ms, the timer fires and updates the status text with the next animation frame. It cycles through: "Processing", "Processing.", "Processing..", "Processing..."

Compared to v1.3

What's Better

Accessibility: Anyone can use it, no terminal knowledge needed.

Workflow: Drag-drop and tray integration are faster than typing.

Visual Feedback: See queue, progress, and status at a glance.

Polish: Professional appearance, clean interface.

What's the Same

Functionality: All v1.3 features work identically.

Quality Options: Same 7 quality presets.

Queue System: Still 50-item maximum.

File Size: Still ~112MB (same embedded tools).

What's Different

Learning Curve: GUI is more intuitive for beginners.

Automation: Terminal version is better for scripts.

Resource Use: GUI uses slightly more memory (about 5MB more).

Platform: GUI requires desktop Windows. Terminal works on Server Core.

When to Use Each Version

Use v1.4 GUI When:

  • You prefer visual interfaces
  • You want drag-and-drop
  • You use system tray frequently
  • You're downloading casually
  • You're new to SNATCH

Use v1.3 Terminal When:

  • You prefer command-line tools
  • You're automating with scripts
  • You're running on Windows Server
  • You want minimum resource use
  • You're comfortable with terminals

Both versions are actively maintained. Use whichever fits your workflow.

What Didn't Make It

Some planned features got cut from v1.4:

Settings Panel

Originally planned: panel to save preferences like default quality, download folder, etc.

Why Cut: Adds complexity without much benefit for v1.4. Most users download immediately after opening SNATCH. Settings will come in v1.5.

Download History

Wanted: list of previously downloaded videos.

Why Cut: Requires persistent storage (database or file). Not worth the complexity for v1.4. Planned for v1.5.

Pause/Resume

Planned: buttons to pause and resume individual downloads.

Why Cut: yt-dlp doesn't easily support pause/resume. Implementing this requires intercepting and managing yt-dlp's process, which is complex. Will research for v1.5.

Themes

Wanted: dark mode and color customization.

Why Cut: v1.4 needed to launch. Themes are nice-to-have, not essential. Planned for v2.0.

Known Limitations

Windows Only

v1.4 is Windows-specific. The Win32 API doesn't exist on Linux or macOS.

Solution: v2.0 will use a cross-platform GUI framework like GTK or Qt. But that's a major rewrite, so it's future work.

No Real-time Progress

The progress bar shows item count (3 of 10), not download percentage within each file.

Why: Getting real-time progress from yt-dlp requires parsing its output stream. v1.4 hides all output for cleaner interface. Real-time progress will come in v1.5.

No Parallel Downloads

Queue processes sequentially—one at a time.

Why: Parallel downloads are complex:

  • Resource management (bandwidth, CPU)
  • Error handling (what if one fails?)
  • Progress display (show all at once?)

Sequential is simpler and more reliable. Parallel downloads planned for v2.0.

Queue Limit

Maximum 50 items per queue.

Why: Memory management. Each item is a struct with a 512-byte URL buffer. 50 items = ~25KB. Reasonable limit.

Workaround: For larger batches, split into multiple sessions.

Building from Source

For developers:

# Requirements:
# - MinGW-w64 with GCC
# - windres (resource compiler)
# - yt-dlp.exe
# - ffmpeg.exe

# Build:
.\build_v1.4.bat

# Output:
# snatch_v1.4.exe (~112 MB)

Build time: 10-20 seconds (same as v1.3).

The GUI code is in snatch_v1.4.c. It's pure C with Win32 API. No external GUI libraries.

What's Next

Version 1.5 (Next Release)

Focus: Enhanced GUI

  • Settings panel with persistence
  • Download history viewer
  • Real-time progress percentage
  • Speed indicator (MB/s)
  • Estimated time remaining
  • Pause/resume buttons
  • Video thumbnails in queue
  • Notification sounds

Version 2.0 (Future)

Focus: Cross-platform

  • Linux support (GTK)
  • macOS support
  • Parallel downloads
  • Dark mode / themes
  • Browser extension integration
  • Auto-update system

Feedback

v1.4 is a major change. The GUI is a complete rewrite, not a modification of v1.3.

If you encounter bugs, have feature requests, or just want to share thoughts:

Conclusion

v1.4 brings SNATCH to a wider audience.

The terminal versions (v1.0-v1.3) proved the concept. They work great for technical users. But they're not for everyone.

The GUI makes SNATCH accessible. Your parents can use it. Your non-technical friends can use it. Anyone comfortable with a mouse can use it.

That was the goal: make YouTube downloading simple for everyone.

v1.4 is just the beginning of GUI SNATCH. Expect many improvements in v1.5 and beyond.

But the core is solid: drag, drop, download. It works.

Previous Version: v1.3 Release Notes
Next Version: v1.5 (Coming Soon)
Back to Wiki: Home

Updated: January 2026

SNATCH Wiki

Home

Getting Started

Documentation

Development

About

Downloads

Latest Release (v1.2)

File: snatch_standalone.exe
Size: ~112 MB

Contact

Abdanio Parchezzi

📧 Email: cheeksparchezzi@gmail.com

📷 Instagram: @oktramdani

💻 GitHub: @Abdanio

Quick Links

🐛 Report Bug

💡 Request Feature

💬 Discussions

⭐ Star on GitHub

SNATCH v1.2 • MIT License

Clone this wiki locally