DEVELOPER DOCS
Dokumentasi DezDownload
Mesin ekstraksi media universal: tempel tautan, worker bertanya ke Cobalt API, hasilnya dikembalikan sebagai manifest format. Dokumen lengkap (PRD, arsitektur, testing, deploy) ada di folder docs/ repositori.
Pengantar
DezDownload adalah utilitas web oleh dezzorigin untuk mengekstrak media publik dari 54 platform. Tidak ada akun, tidak ada iklan, tidak ada media yang disimpan: worker hanya merelay permintaan ke instance Cobalt dan membentuk jawabannya jadi daftar format yang bisa diunduh. Kalau instance Cobalt menolak (misalnya butuh autentikasi), worker menjawab dengan pesan error yang jujur — bukan halaman kosong.
Fitur utama
Ekstraksi video + audio
Dua panggilan paralel ke Cobalt: video kualitas tertinggi (mode auto) dan audio saja. Hasil diurutkan 8K → 144p untuk video, bitrate tertinggi dulu untuk audio.
Proxy unduhan
GET /api/proxy?url=…&filename=…mengambil media dan mengembalikannya sebagai attachment — berguna saat tautan sumber memblokir unduhan lintas origin.Cache + gabung permintaan
URL yang sama di-cache 10 menit; permintaan bersamaan untuk URL yang sama digabung jadi satu panggilan ke Cobalt.
PWA
Service worker + manifest, bisa di-install ke layar utama. Pendaftaran service worker tidak mengubah perilaku fetch.
Stack teknis
| Lapisan | Teknologi |
|---|---|
| Framework | Next.js 15 (App Router, static export) & React 19 |
| Bahasa | TypeScript (strict) |
| Styling | Tailwind CSS v4 + token desain dermaga (lihat docs/DESIGN.md) |
| Animasi & ikon | motion/react & Lucide |
| API produksi | Cloudflare Pages Worker (worker/_worker.js) + Cobalt v10 API |
| PWA | Service worker, manifest |
Instalasi & setup
Menjalankan DezDownload lokal dalam hitungan detik:
git clone https://github.com/dezzorigin/dez-download.git cd dez-download
npm ci
Salin .env.example ke .env.local bila memakai instance Cobalt sendiri:
COBALT_API_URL=https://api.cobalt.tools # COBALT_API_KEY=isi-bila-instance-butuh-auth
npm run build npm run serve # http://127.0.0.1:8500 — sajikan out/ + worker
npm run dev hanya menyajikan frontend — rute /api/* hidup lewat worker, jadi pakai npm run serve untuk menguji ekstraksi end-to-end secara lokal.
Arsitektur
Browser → halaman statis (Next.js export di Cloudflare Pages) → Pages Worker (worker/_worker.js) → Cobalt API (dua panggilan paralel: video auto + audio) → manifest format kembali ke browser. Worker memegang cache 10 menit dan menggabungkan permintaan duplikat. Diagram lengkap ada di docs/architecture.html dan penjelasan per lapisan di docs/ARCHITECTURE.md.
Endpoint worker
- GET /api/download?url=… — ekstrak media (juga menerima POST JSON
{"url": …}) - GET /api/proxy?url=…&filename=… — unduh media sebagai attachment
Batasan yang jujur
- Instance publik Cobalt (
api.cobalt.tools) kini meminta autentikasi — tanpaCOBALT_API_KEYatau instance sendiri, ekstraksi akan gagal dengan pesan yang menjelaskan hal itu. - Tidak semua tautan dari 54 platform pasti berhasil — platform bisa menolak, membatasi, atau mengubah formatnya sewaktu-waktu.
- Worker tidak menyimpan media, riwayat, atau akun apa pun.