Kumpulan kendala yang benar-benar pernah dialami pengguna, lengkap dengan pesan error persis yang muncul di aplikasi, artinya, dan langkah perbaikannya. Tempel pesan error-mu di kolom cari.
Banyak error lama sudah diperbaiki. Cek di Settings → Cek update atau unduh ulang dari halaman download.
Settings → Mesin aplikasi → Perbaiki YouTube memperbarui pengunduh (yt-dlp) dan Deno sekaligus. Obat utama untuk unduhan gagal / 403 / video buram.
Tambahkan folder aplikasi ke exclusion Windows Security. Ini penyebab utama spawn UNKNOWN, Fetch gagal, dan render macet. Panduan 3 menit →
▾ Log di baris status bawah. Log lengkap tiap sesi tersimpan di:<folder output>/socl-<tanggal>/data/pipeline.logSaat minta bantuan, kirim screenshot + file pipeline.log itu.Installer kami belum ditandatangani digital, jadi Windows sering curiga.
Windows-mu terlalu lama. SOCL Visuals dibangun di atas mesin Chromium terbaru yang wajib Windows 10 atau 11 (64-bit). Di Windows 7, 8, dan 8.1 programnya langsung tertutup sebelum jendela sempat muncul. Bukan file-nya yang rusak, dan antivirus tidak terlibat. Di Mac, syaratnya macOS 11 Big Sur atau lebih baru.
winver, lalu Enter.winver.Windows Defender (atau antivirus lain) mengkarantina file kerja aplikasi: ffmpeg.exe (render), yt-dlp.exe (unduh), python.exe (Smart Face Tracking). Filenya ada, tapi Windows melarang dijalankan. Bukan aplikasinya yang rusak.
SmartScreen menahan aplikasi yang belum punya sertifikat tanda tangan digital. Ini peringatan standar, bukan deteksi virus.
chrome://downloads → Keep / Download dangerous file.Saat pertama dibuka, aplikasi mengunduh mesin pengunduh & render. Biasanya gagal karena internet terputus atau antivirus menghapus file unduhannya di tengah jalan.
deno-download.zip dan folder deno-extract di %APPDATA%\SOCL Visuals Studio\binDeno dipakai untuk membuka stream HD YouTube. Tanpa Deno, unduhan tetap jalan tapi hanya dapat kualitas rendah. Biasanya Deno belum selesai terunduh, atau dihapus/dikarantina antivirus.
deno.exe → Restore / Allow on device, lalu pasang exclusion folder (lihat spawn UNKNOWN).deno-download.zip dan folder deno-extract di:%APPDATA%\SOCL Visuals Studio\binERR_CONNECTION_RESET). Versi terbaru otomatis pindah ke server cadangan (dl.deno.land dan assets.socialvisuals.xyz); versi lama tidak punya cadangan.xattr), sehingga macOS menahan mesin yang dijalankan aplikasi.Bad CPU type.%APPDATA%\SOCL Visuals Studio\binHapus yt-dlp.exe, folder _internal, deno.exe, deno-download.zip, dan folder deno-extract kalau ada. Jangan hapus file lain.Bad CPU type = installer salah, pasang ulang yang benar.Read-only file system) kalau aplikasi masih dijalankan dari jendela DMG.sudo xattr -cr "/Applications/SOCL Visuals Studio.app"xattr -cr ~/Library/Application\ Support/SOCL\ Visuals\ Studio/binrm -rf ~/Library/Application\ Support/SOCL\ Visuals\ Studio/bin/{yt-dlp,deno,_internal}xattr -cr? Perintah ini hanya menghapus tanda “diunduh dari internet” (quarantine) yang dipasang macOS pada aplikasi kami — aplikasi belum dinotarisasi Apple, jadi tanda itu membuat macOS terus menahannya. Tidak mengubah atau menghapus data apa pun.Instal, izin Keychain, dan akses cookie.
…mac-arm64.dmg.…mac-x64.dmg.sudo xattr -cr "/Applications/SOCL Visuals Studio.app"API key disimpan terenkripsi di Keychain Mac. Setiap versi baru, macOS bertanya lagi. Kalau dijawab Deny, key tidak bisa dibaca dan AI jatuh ke deteksi lokal.
Ini bukan penyebab aslinya. YouTube minta login (biasanya video dibatasi usia atau cek bot), aplikasi mencoba meminjam cookie browser, dan macOS melarangnya. Menutup browser tidak menolong di Mac.
Tahap “Fetch” di pipeline.
YouTube menahan unduhan dari koneksi yang belum login. Solusi paling andal: beri aplikasi cookies.txt dari akun YouTube-mu. Sekali dipasang, masalah ini biasanya tidak muncul lagi.
Video hanya dilepas ke akun yang sudah login dan cukup umur. Menunggu, ganti jaringan, atau VPN tidak menolong.
YouTube sering mengubah sistemnya; pengunduh yang basi atau cookies yang kedaluwarsa langsung ditolak.
Server membatasi kecepatan (throttling) atau koneksi tidak stabil. Bukan kerusakan aplikasi. Di Mac Intel, pembukaan pertama memang lebih lambat karena macOS memeriksa file baru.
Masalah kepercayaan HTTPS di komputer/jaringanmu — bukan kerusakan aplikasi atau throttling.
Chrome & Edge versi baru mengunci cookie-nya sehingga aplikasi lain tidak bisa membacanya sama sekali. Menutup browser tidak menolong.
Bingkai 9:16 yang mengikuti wajah pembicara.
Smart Face Tracking butuh runtime Python + model AI yang diunduh sekali (±350 MB, ±1 GB setelah diekstrak). Kalau unduhannya putus, ruang disk kurang, atau antivirus menahan python.exe, aplikasi tetap jalan tapi memotong di tengah (centre crop).
Tracking membaca wajah dari gambar. Hasilnya bisa meleset kalau Smart Face Tracking belum menyala saat Run pipeline (klip jadi centre crop), ada beberapa orang dalam satu frame, atau wajah kecil / menyamping / gelap.
⏵ Smart Track: …, bukan peringatan centre crop (lihat kartu di atas).1 lisensi = 1 perangkat.
Koneksi ke server lisensi terputus — key-mu sendiri baik-baik saja. Versi terbaru otomatis mencoba ulang beberapa kali.
Satu lisensi terkunci ke satu perangkat yang pertama kali mengaktifkannya. Lisensi tidak bisa dipindahkan atau dipakai bersama di perangkat lain.
Deteksi momen, judul, hook, dan deskripsi.
gsk_). Key hanya tampil sekali — simpan.AIza).Otak AI: Groq (atau Gemini), bukan Free AI.Kuota gratis per menit/hari dari penyedia AI sedang penuh. Aplikasi otomatis pindah ke penyedia lain kalau tersedia.
Caption yang dibakar ke video.
Transkrip gagal didapat: YouTube tidak menyediakan caption, dan transkripsi online kena batas durasi audio per jam (sering untuk video > 2 jam).
Video punya dubbing AI otomatis YouTube ke banyak bahasa, dan transkrip yang terambil berasal dari dubbing. Versi terbaru sudah mengabaikan track dubbing.
Proses render dan folder hasil.
Proses render tidak memberi kabar dalam waktu lama. Penyebab tersering: antivirus memindai ffmpeg saat bekerja, atau RAM/CPU kewalahan (laptop lama, banyak klip sekaligus).
D:\SOCL, bukan D:\ (Settings → Export path).hasil/ di dalam folder sesi socl-<tanggal>. Tombol folder output di aplikasi langsung membukanya.pipeline.log ke grup Telegram.pipeline.log ke grup Telegram — tim akan bantu.Kirim screenshot error + file pipeline.log (lihat cara membaca log) ke grup Telegram, atau email soclvisuals@gmail.com.