================================================================
   SunoDownPro v3.0 — Panduan Pemakaian
   by By Agus Rendra | Creator Teras Depok
================================================================

DESKRIPSI:
  Chrome Extension untuk download massal lagu dari Suno.com.
  Tampil sebagai Side Panel di sisi kanan browser.
  Mendukung download per workspace dengan penamaan file otomatis.

================================================================
INSTALASI
================================================================

1. Buka Chrome, ketik di address bar:
   chrome://extensions

2. Aktifkan "Developer Mode" (toggle di pojok kanan atas)

3. Klik "Load unpacked"

4. Pilih folder SunoDown2

5. Extension SunoDownPro akan muncul di toolbar Chrome

================================================================
WORKFLOW PEMAKAIAN
================================================================

--- LANGKAH 1: Buka Suno ---

  Buka browser dan masuk ke https://suno.com
  Login ke akun Suno kamu (Free atau Pro)

--- LANGKAH 2: Buka Side Panel ---

  Klik icon SunoDownPro di toolbar Chrome (pojok kanan atas)
  Side panel akan terbuka di sisi kanan browser

--- LANGKAH 3: Refresh Workspace ---

  Klik tombol 🔄 (refresh) di sebelah dropdown "PILIH WORKSPACE"
  Extension akan membaca semua workspace yang ada di akun Suno kamu
  Pilih workspace yang ingin didownload dari dropdown

--- LANGKAH 4: Atur Folder Download ---

  FOLDER HASIL DOWNLOAD:
    - Ketik nama folder tujuan (default: SunoDownload)
    - Atau klik "Browse Folder" untuk buka pengaturan download Chrome

  OPSI:
    ✅ Subfolder workspace  → File disimpan ke subfolder per workspace
                              Contoh: Downloads/SunoDownload/Jazz Relax/lagu.mp3
    ☐ Save As (Browse)     → Muncul dialog "Save As" untuk setiap file
                              (tidak disarankan untuk download massal)

--- LANGKAH 5: Pilih Format ---

  MP3  → Format standar, ukuran lebih kecil
  WAV  → Format lossless, kualitas lebih tinggi, ukuran besar

--- LANGKAH 6: Scroll & Scan Lagu ---

  Klik tombol "🔍 Scroll & Scan Lagu"

  Extension akan OTOMATIS melakukan:
    1. Navigasi ke halaman suno.com/me/workspaces
    2. Mengetik nama workspace di kolom pencarian (Search)
    3. Klik workspace yang cocok dari hasil pencarian
    4. Tunggu halaman workspace terbuka
    5. Auto-scroll halaman dari atas ke bawah
    6. Scrape semua lagu yang ditemukan
    7. Menampilkan daftar lagu di side panel

  Status progress ditampilkan secara real-time:
    🔄 Membuka halaman workspaces...
    🔍 Mencari search box...
    ⌨️ Mengetik "nama workspace" di search...
    🖱️ Mencari dan klik workspace...
    🔍 Scanning: 45 lagu ditemukan... (scroll 0/8)

--- LANGKAH 7: Pilih Lagu ---

  ✅ Pilih Semua  → Centang/uncentang semua lagu sekaligus
  Atau centang/uncentang lagu satu per satu sesuai kebutuhan

--- LANGKAH 8: Download ---

  Klik tombol "⬇ Download Terpilih (N)"
  Progress bar akan menampilkan status download
  File otomatis tersimpan ke folder yang sudah diatur

================================================================
STRUKTUR FOLDER HASIL DOWNLOAD
================================================================

Dengan subfolder workspace AKTIF:
  Downloads/
  └── SunoDownload/
      ├── Jazz Relax/
      │   ├── Smooth Night.mp3
      │   ├── Rainy Cafe.mp3
      │   └── Midnight Blues.mp3
      ├── Reggae Dup/
      │   ├── Island Vibes.mp3
      │   └── Sunset Beach.mp3
      └── My Workspace/
          ├── Song Title 1.mp3
          └── Song Title 2.mp3

Tanpa subfolder workspace:
  Downloads/
  └── SunoDownload/
      ├── Smooth Night.mp3
      ├── Rainy Cafe.mp3
      ├── Island Vibes.mp3
      └── Song Title 1.mp3

================================================================
STATUS VERSI PRO & DUKUNG CREATOR (TRAKTIR KOPI)
================================================================

1. Mode PRO Terbuka Penuh:
   - Seluruh fitur PRO dibuka untuk semua pengguna!
   - Pengguna dapat scan & download SELURUH LAGU tanpa batas (Unlimited).
   - Badge otomatis menampilkan status 🟢 "PRO ACTIVE".

2. Dukung Creator (Traktir Kopi):
   - Jika tools ini bermanfaat untuk Anda, silakan traktir kopi creator:
     Link: https://lynk.id/agusrendra/xejxkgy6vgyx
   - Tombol ☕ Traktir Kopi tersedia langsung di Side Panel.

3. Cara Membaca Panduan:
   - Pengguna bisa membaca dokumen ini kapan saja dengan mengklik tombol
     "📖 Panduan" di bagian kanan atas Side Panel SunoDownPro.

================================================================
TIPS & CATATAN
================================================================

• Pastikan sudah LOGIN di Suno sebelum menggunakan extension
• Jika workspace tidak terbaca, klik tombol 🔄 refresh
• Untuk workspace dengan banyak lagu (50+), scanning butuh waktu
  lebih lama karena harus scroll sampai semua lagu termuat
• Nama file otomatis menggunakan judul lagu yang bersih
  (karakter spesial dihapus otomatis)
• Jika download gagal, coba kurangi jumlah lagu per batch
• Extension menggunakan CDN Suno (cdn1.suno.ai) untuk download
• Format URL download: cdn1.suno.ai/{song-uuid}.mp3

================================================================
TROUBLESHOOTING
================================================================

Masalah: Workspace tidak muncul di dropdown
Solusi:  Pastikan sudah di suno.com, klik 🔄 refresh

Masalah: Scan hanya menemukan sedikit lagu
Solusi:  Coba scan ulang, extension akan scroll lebih dalam

Masalah: Navigasi ke workspace gagal
Solusi:  Pastikan nama workspace sama persis di dropdown

Masalah: File download nama aneh / file mentah
Solusi:  Reload extension di chrome://extensions, lalu coba lagi

Masalah: "Gagal berkomunikasi dengan halaman Suno"
Solusi:  Refresh halaman Suno (F5), lalu coba scan lagi

================================================================
6. SYARAT, KETENTUAN & PELEPASAN TANGGUNG JAWAB (DISCLAIMER)
================================================================

Dengan memasang (menginstal), memuat, dan/atau menggunakan ekstensi
SunoDownPro, Anda menyatakan bahwa Anda telah membaca, memahami, dan
menyetujui seluruh ketentuan pelepasan tanggung jawab hukum berikut ini:

1. BATASAN FUNGSI & SIFAT ALAT (BROWSER UTILITY):
   - SunoDownPro adalah utilitas peramban pribadi yang semata-mata
     berfungsi menjembatani pengunduhan data audio stream yang secara
     sah telah dimuat dan diputar pada browser pengguna.
   - Alat ini TIDAK meng-host file audio, tidak memiliki server lagu
     independen, dan tidak membobol enkripsi atau sistem pembayaran pihak lain.

2. PELEPASAN TANGGUNG JAWAB HAK CIPTA (COPYRIGHT DISCLAIMER):
   - Pengembang (Developer / Agus Rendra / Creator Teras Depok)
     DILEPASKAN SEPENUHNYA dari segala bentuk tanggung jawab hukum,
     gugatan, tuntutan pidana/perdata, denda, klaim hak cipta (copyright
     infringement), hak royalti, atau sengketa kepemilikan intelektual.
   - Urusan hak cipta dan lisensi komersial audio sepenuhnya adalah
     hubungan langsung antara pengguna dengan pemilik hak cipta / platform asal.

3. TANGGUNG JAWAB PENUH PENGGUNA (USER'S SOLE RESPONSIBILITY):
   - Setiap berkas audio yang diunduh, didistribusikan, diunggah ulang,
     atau dimonetisasi menjadi tanggung jawab mutlak pemakai (user) 100%.
   - Pengguna wajib mematuhi aturan hak cipta dan memastikan memiliki
     hak/lisensi yang sah atas konten yang diunduhnya sesuai paket akun mereka.

4. AKUN PENGGUNA & LAYANAN PIHAK KETIGA (THIRD-PARTY TOS):
   - SunoDownPro adalah alat independen dan TIDAK TERAFILIASI secara
     resmi dengan Suno Inc., Suno.ai, atau entitas terkait lainnya.
   - Segala risiko terhadap akun pengguna (seperti pembatasan akun,
     suspensi, pemblokiran akun, atau pelanggaran Terms of Service pihak
     ketiga) sepenuhnya merupakan risiko dan tanggung jawab pemakai.

5. PENYEDIAAN "SEBAGAIMANA ADANYA" (PROVIDED "AS IS"):
   - Perangkat lunak ini disediakan atas dasar "sebagaimana adanya"
     (AS IS) tanpa jaminan apapun. Pengembang dibebaskan dari segala
     bentuk kerugian materiil maupun non-materiil akibat penggunaan alat.

================================================================
  SunoDownPro v3.3 | By Agus Rendra | Creator Teras Depok | 2026
================================================================
