Thumbnail Downloader

Aplikasi desktop untuk mengunduh thumbnail video YouTube dengan mudah, cepat, dan gratis. Cukup tempel URL video, playlist, atau beberapa URL sekaligus — aplikasi akan mengambil thumbnail dalam kualitas terbaik ke folder tujuanmu.

Dibangun dengan Python dan Tkinter dengan desain antar muka modern (Bento-style), lalu dikemas menjadi file .exe tunggal dengan PyInstaller sehingga bisa langsung dijalankan di Windows tanpa perlu menginstal Python.

Fitur

• Preview thumbnail sebelum mengunduh — lihat dulu seperti apa thumbnail-nya.
• Single — unduh thumbnail satu video dari URL YouTube.
• Batch — unduh thumbnail banyak video sekaligus (satu URL per baris).
• Playlist — muat daftar video dari URL playlist, lalu unduh semua thumbnail-nya.
• Pilihan kualitas — tersedia beberapa ukuran/resolusi thumbnail.
• Nama file sesuai judul video — opsional, bisa diaktifkan lewat checkbox.
• Folder tujuan fleksibel — tentukan sendiri folder penyimpanan (default: folder Downloads).
• Proses berjalan di latar belakang — UI tetap responsif dengan indikator progres.
• Tombol Stop — batalkan proses download kapan saja.

Cara Penggunaan

1. Jalankan aplikasi — buka ThumbnailDownloader.exe.
2. Pilih tab sesuai kebutuhan:
   • Single — tempel URL satu video YouTube, klik Preview untuk melihat thumbnail, lalu klik Download.
   • Batch — tempel beberapa URL YouTube (satu per baris), lalu klik Download.
   • Playlist — tempel URL playlist YouTube, klik Muat Daftar Video untuk melihat isinya, lalu klik Download.
3. Atur pengaturan:
   • Pilih kualitas thumbnail.
   • Pilih folder tujuan (opsional; default: Downloads).
   • Centang "Gunakan judul video sebagai nama file" jika ingin file diberi nama sesuai judul video.
4. Tunggu proses selesai — thumbnail tersimpan di folder tujuan.

Tip: klik Stop untuk membatalkan proses yang sedang berjalan.

Unduhan

Unduh versi terbaru (file .exe siap pakai untuk Windows) dari halaman Releases.

Bahasa Pemrograman & Teknologi

• Bahasa: Python
• GUI: Tkinter (ttk) dengan tema kustom Bento-style
• Pengambilan thumbnail: yt-dlp
• Pemrosesan gambar: Pillow
• HTTP client: requests
• Packaging: PyInstaller (one-file executable)

Persyaratan (untuk menjalankan dari source code)

• Python 3.10+
• Install dependensi:

pip install -r requirements.txt

• Jalankan:

python src/main.py

Membangun dari source code

Gunakan file build.bat atau jalankan perintah PyInstaller berikut:

python -m PyInstaller --noconfirm --clean --onefile --windowed --name "ThumbnailDownloader" --collect-all yt_dlp --icon "icon.ico" --add-data "ICON.png;." "src\main.py"

Hasil build tersedia di folder dist\ThumbnailDownloader.exe.

Struktur Proyek

├── src/
│   ├── main.py           # Entry point aplikasi
│   ├── ui.py             # Antarmuka pengguna (Tkinter)
│   ├── theme.py          # Tema kustom Bento-style
│   ├── worker.py         # Thread untuk proses download
│   ├── thumbnails.py     # Logika pengambilan thumbnail
│   └── youtube_utils.py  # Helper URL YouTube / playlist
├── icon.ico              # Ikon aplikasi
├── ICON.png              # Ikon (dikemas ke dalam exe)
├── requirements.txt      # Dependensi Python
└── build.bat             # Script build PyInstaller

Lisensi

Proyek ini dilisensikan di bawah MIT License. Lihat file LICENSE untuk detail lengkap.