/VidozaCLI

VidozaCLI - Alat CLI Python untuk mengunduh video dari platform Videq & sejenisnya secara aman tanpa iklan. Tool edukasi untuk pembelajaran scraping HTTP, async programming, & pengembangan CLI. Pengguna wajib patuhi hukum & kebijakan platform.

Primary LanguagePythonMIT LicenseMIT

VidozaCLI – Alat CLI Python Pengunduh Video Aman Tanpa Iklan

VidozaCLI - Logo

VidozaCLI adalah alat baris perintah (CLI tool) modern untuk mengunduh video dari Videq dan platform serupa tanpa iklan berbahaya, malware, atau gangguan lainnya. Dirancang untuk pengalaman pengguna yang aman, cepat, dan bebas hambatan.

📚 Latar Belakang

Platform streaming seperti videq.fitm sering kali menyajikan konten bermanfaat, namun iklan agresif dan potensi malware dapat mengganggu kenyamanan serta keamanan pengguna. VidozaCLI hadir sebagai solusi: mengunduh video langsung tanpa membuka peramban, tanpa iklan, dan tanpa risiko.

Dengan rekayasa permintaan HTTP tingkat lanjut, VidozaCLI meniru interaksi peramban yang sah, melewati mekanisme keamanan sederhana, dan memastikan pengunduhan yang bersih serta efisien.

✨ Fitur Utama

  • Pengunduhan Konkuren: Menggunakan asyncio & aiohttp untuk unduhan paralel.
  • Lintas Platform: Kompatibel dengan Linux, Windows, dan macOS.
  • Bebas Iklan & Malware: Tidak perlu membuka browser, langsung unduh video .mp4.
  • Multi-Tautan: Bisa unduh banyak video sekaligus dalam satu perintah.
  • Antarmuka Profesional: Progress bar & logging berwarna untuk setiap unduhan.
  • Penamaan Berkas Otomatis: Nama file otomatis dari judul video, sudah disanitasi.

⚡ Instalasi

Persyaratan: Python 3.8 atau lebih baru.

  1. Kloning Repositori

    git clone https://github.com/RozhakDev/VidozaCLI.git
cd VidozaCLI

  2. Instal Dependensi

    pip install -r requirements.txt

  3. Instalasi Editable (Opsional)

    pip install -e .

🚀 Penggunaan

Setelah instalasi, gunakan perintah vidozaCLI atau jalankan modul secara langsung.

Sintaks Dasar

vidozaCLI <tautan_1> <tautan_2> ... [opsi]

Contoh

  • Unduh satu video:

    vidozaCLI https://videq.fit/e/z40jeu954mk5

  • Unduh beberapa video sekaligus:

    vidozaCLI https://videq.fit/e/z40jeu954mk5,https://videq.my/d/z40jeu954mk5

  • Simpan ke direktori tertentu:

    vidozaCLI https://videq.fit/e/z40jeu954mk5 -o "D:/Koleksi Video/Anime"

  • Mode verbose untuk debugging:

    vidozaCLI https://videq.fit/e/z40jeu954mk5 -v

🗂️ Struktur Proyek

VidozaCLI/
├── vidoza_downloader/
│   ├── main.py           # Titik masuk CLI & parser argumen
│   ├── downloader.py     # Logika inti pengunduhan
│   ├── network.py        # Pengelola sesi & header HTTP
│   ├── parser.py         # Parsing HTML & Regex
│   ├── logger.py         # Logging kustom
│   └── utils.py          # Utilitas (sanitasi nama file, dll)
├── tests/                # Unit tests
├── pyproject.toml        # Definisi proyek & dependensi
└── README.md             # Dokumentasi ini

⚠️ Peringatan & Penafian

Alat ini dibuat murni untuk tujuan edukasi. Tujuannya adalah untuk mempelajari dan mendemonstrasikan konsep rekayasa permintaan HTTP, web scraping, dan pengembangan aplikasi baris perintah (CLI) dengan Python.

Pengguna bertanggung jawab penuh atas penggunaan alat ini. Harap hormati hak cipta dan patuhi syarat & ketentuan dari situs web mana pun yang Anda akses. Pengembang tidak bertanggung jawab atas segala bentuk penyalahgunaan.

🤝 Kontribusi

Kami sangat menyambut kontribusi dari komunitas untuk membuat VidozaCLI menjadi lebih baik. Jika Anda menemukan bug, memiliki ide untuk fitur baru, atau ingin menyempurnakan kode, silakan buka Issue untuk mendiskusikannya terlebih dahulu. Untuk kontribusi kode, Anda dapat melakukan fork pada repositori ini, membuat branch baru untuk perubahan Anda, dan kemudian mengirimkan Pull Request dengan deskripsi yang jelas. Setiap bantuan, sekecil apa pun, sangat kami hargai!

📄 Lisensi

Proyek ini menggunakan MIT License. Lihat LICENSE untuk detail.