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

LapisanTeknologi
FrameworkNext.js 15 (App Router, static export) & React 19
BahasaTypeScript (strict)
StylingTailwind CSS v4 + token desain dermaga (lihat docs/DESIGN.md)
Animasi & ikonmotion/react & Lucide
API produksiCloudflare Pages Worker (worker/_worker.js) + Cobalt v10 API
PWAService worker, manifest

Instalasi & setup

Menjalankan DezDownload lokal dalam hitungan detik:

1. Clone repositori
git clone https://github.com/dezzorigin/dez-download.git
cd dez-download
2. Install dependensi
npm ci
3. Konfigurasi environment (opsional)

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
4. Jalankan (build statis + worker lokal)
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 — tanpa COBALT_API_KEY atau 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.