Modern video downloader với giao diện đẹp, hỗ trợ nhiều nền tảng
- 🌐 Hỗ trợ đa nền tảng: YouTube, Facebook, TikTok, Instagram, Twitter/X
- 🎨 Giao diện hiện đại: UI đẹp mắt với theme sáng/tối, mượt mà
- 📋 Quản lý hàng đợi: Thêm nhiều URL, theo dõi tiến độ từng video
- ⚡ Download đồng thời: Tải nhiều video cùng lúc (1-5)
- 📊 Theo dõi chi tiết: Progress bar thời gian thực, tốc độ download (MB/s), ETA
- 🛠️ Xử lý lỗi thông minh: Log chi tiết, hướng dẫn khắc phục tự động
- ⚙️ Tùy chỉnh chất lượng: Từ best đến worst
- 🎯 One-click setup: Chỉ cần chạy run.bat, mọi thứ tự động!
- 🔄 Auto-retry thông minh: Tự động thử lại 3 lần với exponential backoff (3s → 6s → 12s)
- 🎵 Trích xuất audio: Tải về dạng MP3/M4A chất lượng cao (192kbps)
- 📁 Custom filename: Tùy chỉnh tên file với placeholders (title, uploader, date, id)
- 💾 Export/Import queue: Lưu và khôi phục hàng đợi dưới dạng JSON
- 🚫 Hủy download: Dừng download đang chạy
- 📈 Hiển thị tốc độ: Real-time speed indicator (MB/s) + ETA
- 🆕 Auto-update system: Tự động kiểm tra và cập nhật phiên bản mới từ GitHub
git clone https://github.com/TRIBUI106/czDownloader.git
cd czDownloader# Chỉ cần double-click hoặc:
.\run.batThế thôi! 🎉 File run.bat sẽ tự động:
- ✅ Kiểm tra Python
- ✅ Kiểm tra updates từ GitHub
- ✅ Cài đặt tất cả dependencies cần thiết
- ✅ Setup FFmpeg
- ✅ Test giao diện
- ✅ Khởi chạy ứng dụng
Không cần cài đặt thủ công gì cả!
- URL đơn: Dán link vào ô input → Click "Add to Queue"
- Nhiều URL: Dán vào text area (mỗi URL một dòng) → "Add All URLs"
- Hỗ trợ: YouTube, Facebook, TikTok, Instagram, Twitter/X
- Chất lượng: best, 1080p, 720p, 480p, 360p, worst
- Đồng thời: 1-5 video cùng lúc
- Thư mục: Mặc định
~/Downloads/czDownloader/
- Vào tab Settings
- Tích vào "🎵 Extract audio only (MP3/M4A)"
- Thêm URL và tải về
- File sẽ được lưu dạng
.mp3(192kbps)
- Vào tab Settings
- Sửa "Filename template"
- Dùng các placeholder:
%(title)s- Tên video%(uploader)s- Tên kênh%(upload_date)s- Ngày upload (YYYYMMDD)%(id)s- Video ID
Ví dụ:
%(title)s.%(ext)s → My Video.mp4
[%(uploader)s] %(title)s.%(ext)s → [Channel] My Video.mp4
%(upload_date)s - %(title)s.%(ext)s → 20240101 - My Video.mp4
Lưu hàng đợi:
- Thêm video vào queue
- Vào Settings → Queue Management
- Click "💾 Export Queue" → Lưu file
.json
Khôi phục:
- Vào Settings → Queue Management
- Click "📂 Import Queue" → Chọn file
.json - Videos sẽ được thêm vào queue
- Điều khiển cá nhân: Hủy, thử lại từng video
- Thao tác hàng loạt: Download tất cả, xóa hết, retry failed
- Theo dõi: Progress bar + tốc độ (MB/s) + ETA thời gian thực
- Hỗ trợ lỗi: Hệ thống troubleshooting tích hợp
- Auto-retry: Tự động thử lại 3 lần khi lỗi (3s → 6s → 12s delay)
- 📥 Download: Thêm URL và cấu hình
- 📋 Queue: Theo dõi và quản lý downloads
- ⚙️ Settings: Tùy chỉnh thư mục và themes
- 🌙/☀️: Chuyển đổi theme Dark/Light
- 🔄: Kiểm tra update từ GitHub
- ℹ️: Thông tin về ứng dụng
- ☀️ Light Mode: Giao diện sáng, sạch sẽ
- 🌙 Dark Mode: Dễ nhìn trong môi trường tối
- Chuyển đổi bất cứ lúc nào với nút theme ở header
"Python not found"
- Cài Python từ python.org
- Nhớ tick "Add Python to PATH"
"Dependencies missing"
- Chạy
run.bat- tự động cài đặt - Hoặc thủ công:
pip install yt-dlp requests pillow
"FFmpeg not found"
- App tự cài
ffmpeg-python - FFmpeg đầy đủ: ffmpeg.org
Download thất bại
- Dùng hệ thống help tích hợp (nút ❓)
- Thử chất lượng khác
- Video có thể private/bị khóa vùng
czDownloader/
├── run.bat # 🎯 File duy nhất cần chạy!
├── main.py # Ứng dụng chính với UI
├── version.py # Quản lý version và thông tin app
├── quick_update_check.py # Script kiểm tra update nhanh
├── README.md # Hướng dẫn này
├── requirements.txt # Dependencies (auto-install)
└── config.py # Cấu hình (tùy chọn)
Trước đây (phức tạp):
- setup.bat → demo.bat → setup_check.py → launcher.py → main.py
- Nhiều file, dễ nhầm lẫn
Bây giờ (đơn giản):
run.batlàm tất cả!- 1 file, 1 cú double-click → Xong!
- yt-dlp: Engine download chính
- requests: HTTP requests
- Pillow: Xử lý ảnh
- tkinter: GUI (có sẵn trong Python)
- ffmpeg-python: Hỗ trợ video processing
| Platform | URL Format | Status |
|---|---|---|
| YouTube | youtube.com, youtu.be |
✅ Full Support |
facebook.com, fb.watch |
✅ Full Support | |
| TikTok | tiktok.com |
✅ Full Support |
instagram.com |
✅ Full Support | |
| Twitter/X | twitter.com, x.com |
✅ Full Support |
- Concurrent: 1-5 downloads đồng thời
- Memory: Tối ưu cho batch lớn
- Network: Auto-retry, timeout handling
- Storage: Tên file thông minh, tổ chức tốt
# Clone project
git clone https://github.com/TRIBUI106/czDownloader.git
cd czDownloader
# Chạy ngay (tất cả đều tự động!)
.\run.batVideo demo: Từ 0 đến chạy app chỉ trong 30 giây!
- Fork repo này
- Tạo branch:
git checkout -b feature-moi - Commit:
git commit -am 'Thêm tính năng mới' - Push:
git push origin feature-moi - Tạo Pull Request
- Báo lỗi: Tạo Issue trên GitHub
- Góp ý: Request features qua Issues
- Help: Dùng hệ thống troubleshooting tích hợp
- ✅ All-in-one: 1 file run.bat làm tất cả
- ✅ Zero-config: Không cần setup thủ công
- ✅ Auto-install: Dependencies tự cài
- ✅ Auto-update: Tự động kiểm tra và cập nhật từ GitHub
- ✅ Smart-retry: Thông minh xử lý lỗi
- ✅ Beautiful UI: Giao diện hiện đại mượt mà với nút update
- ✅ Version management: Hệ thống quản lý version chuyên nghiệp
- ✅ Vietnamese-friendly: Tài liệu và UI tiếng Việt
Tự động kiểm tra:
- Mỗi lần khởi động qua
run.bat - Khi click nút 🔄 trong app
- Sau 3 giây khi mở app
Tự động cập nhật:
- Download từ GitHub Releases
- Backup phiên bản cũ
- Cài đặt phiên bản mới
- Khởi động lại app tự động
An toàn:
- Backup trước khi update
- Rollback nếu có lỗi
- Không làm mất dữ liệu
MIT License - Sử dụng tự do cho mục đích cá nhân và thương mại.
Made with ❤️ by CZ Team
Happy downloading! 🎬✨