Skip to content

azrollin/az-downloader

Repository files navigation

AZ Downloader 🎬

From A to Z — download from everywhere.


Fair warning: I've never written a single line of code in my life before this week.
I'm 38, quit my corporate job, currently driving Uber to pay bills, and built this with Claude AI in one evening.
I have no idea what I'm doing — but somehow it works on 14 platforms. Go figure. 😅
Be gentle. First GitHub repo ever. 🙏


What Is This?

AZ Downloader is a private, local, zero-cloud video downloader that runs entirely on your Mac.

No accounts. No ads. No data shared. No subscriptions. No browser extensions.
Just paste a URL, pick a quality, hit download. Done.

Built for researchers, content creators, agencies, and anyone who's tired of sketchy online downloaders that sell your data, show 47 popups, and still fail half the time.


✅ Platform Scorecard — Live Tested Feb 24, 2026

Platform Status Verified Quality Notes
YouTube ✅ Works 1080p
TikTok ✅ Works 1024p
Instagram Reels ✅ Works 960p Platform max
Twitter / X ✅ Works 720p Platform compresses
Facebook Reels ✅ Works 960p
YouTube Shorts ✅ Works 854p
Vimeo ✅ Works 1080p Best quality platform
Reddit ✅ Works 1080p
Pinterest ✅ Works 1024p Short pin.it links work too
Bilibili ✅ Works 852p Chinese filenames save correctly
Twitch VODs ✅ Works 720p MPEG-TS auto-fixed
Dailymotion ✅ Works 848p Short dai.ly links work too
Streamable ✅ Works 540p Platform max
Odysee ✅ Works 1080p Full HD, clean
Rumble ❌ Blocked 403 Forbidden — Cloudflare protection
LinkedIn ❌ Blocked Login required by design

14 out of 16 platforms confirmed working. Every result above was personally tested and verified with ffprobe resolution check — not just assumed.


🖥️ Screenshots

The App

AZ Downloader UI

Successful Download Log

Success Log

Stats & History — Live Proof

Stats


Features

  • 5 quality options — 4K, 1080p, 720p, 480p, MP3/Audio Only
  • 6 research categories — AI & OpenClaw Research, Content Hooks & Formats, Competitor Analysis, Health & KETO, Business Ideas, Client Resources
  • Resolution verification — ffprobe confirms actual quality after every download
  • Download history — tracks everything with stats by day, week, month, all time
  • Category breakdown — visual bars showing your research activity
  • Failed download tracking — red X with full error log
  • Real-time progress log — color coded output so you know exactly what's happening
  • 100% local — zero cloud, zero accounts, zero data shared ever

🚀 Installation (Mac Only — Windows coming soon)

Prerequisites

You need Homebrew installed. If you don't have it:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Install dependencies

brew install python3 yt-dlp ffmpeg

Download AZ Downloader

Click the green Code button above → Download ZIP → Unzip it → Move folder to your Desktop.

Launch

Double-click launch.command in the folder.

If Mac blocks it: Right-click → Open → Open anyway. (Mac Gatekeeper protection — one time only.)

Your browser opens automatically at http://localhost:8899 and you're ready to go.


How To Use

  1. Paste any video URL into the input field
  2. Pick a category and quality
  3. Hit Download — watch the live progress log
  4. Find your files at ~/Downloads/AZ_Research/[Category]/

That's it. Seriously.


🗺️ What's Coming

v2.2 — Quality of Life

  • Custom folder creation — type a name, creates instantly
  • MP3 / Audio Only moved to its own dedicated button (not buried in quality options)
  • Retry button on failed downloads

v3.0 — Agency Batch Mode

  • Paste 10, 20, 50 URLs at once
  • Visual cards per URL showing live status (Queued → Downloading → Done)
  • Per-card category assignment
  • One-click "Download All"
  • Built for teams and agencies managing large content libraries

Tech Stack

Built on the shoulders of giants:

  • yt-dlp — the engine that does the actual downloading
  • ffmpeg — handles video processing and resolution verification
  • Python 3 — runs the local web server
  • Claude AI — helped a non-coder build all of this in one evening

About The Builder

I'm AZ. 38 years old. From Azerbaijan, living in Oceanside, California.

Quit my corporate job in July 2025 to go all-in on AI. Currently driving Uber to pay the bills while building in every spare moment — including parking lots at 3AM.

This is my first tool. First GitHub repo. First everything.

Follow the journey:


License

MIT License — use it freely, just give credit. That's all I ask.


If this saved you time, you can buy me a coffee ☕
I'm literally still driving Uber while building this.

Buy Me A Coffee


Built with Claude AI · 100% local · No data shared ever

About

From A to Z — download from everywhere. Built with Claude AI by a non-coder.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages