Suflo › Rehber

Suflo Paneli Görünmüyor, Boş ya da Açılmıyor: Windows ve Mac Çözüm Rehberi

Window > Extensions menüsünde Suflo yok, panel boş ya da açılmıyor mu? Windows ve Mac için PlayerDebugMode, klasör yolları ve temiz kurulum adımları.

Önce bir dakikalık hızlı kontrol

Suflo'yu kurdun ama Premiere'de bulamıyorsan sorun neredeyse her zaman aşağıdaki beş maddeden biridir. Sırayla dene; çoğu kişi ilk üçünde çözer.

1. Premiere'i tamamen kapatıp yeniden aç. Kurulum Premiere açıkken yapıldıysa panel menüye ancak yeniden başlatmadan sonra gelir.
2. Doğru menüye bak. Premiere 25.6 ve sonrasında (2026 sürümleri dahil) Suflo Window > Extensions (Legacy) altında olabilir; daha eski sürümlerde Window > Extensions altındadır.
3. Premiere sürümünü kontrol et. Suflo, Premiere Pro 2020 (14.4) ve üstünde çalışır. Daha eski sürümlerde menüde hiç görünmez.
4. Kurulum dosyasını çıkarılmış klasörden çalıştır. Windows'ta Suflo-Kur.bat, Mac'te Suflo-Kur.command; pencerenin sonunda KURULUM TAMAM yazısını görmelisin.
5. İmzasız eklenti iznini (PlayerDebugMode) aç. Kurulum dosyası bunu kendisi yapar; elle yapman gerekirse komutlar aşağıda.

1. Doğru menüye bakıyor musun? Extensions ve Extensions (Legacy)

Suflo, Adobe'un CEP adlı eklenti altyapısıyla çalışan bir paneldir. Adobe, Premiere 25.6 ile yeni nesil UXP eklentilerini getirdi ve CEP panellerini "eski altyapı" (Legacy) olarak ayırmaya başladı. Panel aynıdır; yalnızca menüdeki yeri değişebilir:

• Premiere 25.6 ve sonrası (Adobe Premiere 2026, 26.x): Window > Extensions (Legacy) > Suflo
• Premiere Pro 2020 – 25.5: Window > Extensions > Suflo

Menünde hangisi varsa oradan aç. Suflo Window > UXP Plugins menüsünde görünmez; orası yalnızca yeni altyapıyla yazılmış eklentiler içindir.

Premiere'i Türkçe kullanıyorsan menü adları çevrilmiş olabilir; aynı yol Pencere menüsünün altındaki uzantılar bölümündedir. Panel bir kez açıldıktan sonra Premiere onu çalışma alanında hatırlar.

2. Premiere sürümün yeterli mi?

Suflo'nun manifest dosyası Premiere 14.4 ve üstünü hedefler, çünkü panelin ihtiyaç duyduğu Chromium ve Node.js altyapısı (CEP 10) ilk kez bu sürümle geldi. Premiere Pro 2019 (13.x) ve öncesinde Suflo menüde hiç listelenmez. Bu bir kurulum hatası değil, uyumluluk sınırıdır.

Sürümünü görmek için Windows'ta Help menüsünden, Mac'te uygulama menüsünden About Premiere penceresini aç. 14.4'ün altındaysan Creative Cloud uygulamasından güncel sürümü kur.

3. Kurulum dosyası gerçekten çalıştı mı?

Suflo'yu GitHub'daki Suflo-x.y.z-Kurulum.zip paketinden kuruyorsun. Paketin içinde iki kurulum dosyası, bir OKUBENI.txt ve bir panel klasörü vardır. En sık yaşanan sorunlar:

• ZIP çıkarılmadan çalıştırılmış: Windows ZIP'in içini önizleme olarak açar; oradan çift tıklanan Suflo-Kur.bat panel klasörünü bulamaz ve "Panel dosyaları bulunamadı" der. ZIP'e sağ tıkla, Tümünü ayıkla de, sonra çıkan klasördeki dosyaya çift tıkla.
• Windows "Bilinmeyen yayımcı" uyarısı: SmartScreen penceresinde Ek bilgi > Yine de çalıştır de. Suflo açık kaynaktır; kodun tamamı GitHub'dadır.
• Mac "geliştirici doğrulanamadı" uyarısı: Suflo-Kur.command dosyasına sağ tıkla, Aç'ı seç ve çıkan pencerede yine Aç'a bas.
• Mac "erişim ayrıcalıklarına sahip değilsiniz" hatası: Terminal'i aç, chmod +x yazıp sonuna bir boşluk bırak, Suflo-Kur.command dosyasını Terminal penceresine sürükle ve Enter'a bas. Sonra dosyaya yeniden çift tıkla.
• Antivirüs kopyalamayı durdurmuş: Kurulum "Dosyalar kopyalanamadı" derse antivirüs programı araya girmiştir. Kurulum dosyasına geçici izin verip yeniden çalıştır.

Kurulum başarıyla bittiğinde pencerede KURULUM TAMAM yazar. Bu yazıyı görmediysen panel kopyalanmamıştır; önce bu adımı düzelt.

4. İmzasız eklenti izni: PlayerDebugMode

Premiere, yalnızca Adobe'un onayladığı sertifikayla imzalanmış eklentileri kendiliğinden yükler. Suflo imzalıdır ama kendi sertifikasıyla; bu yüzden Premiere'in imzasız eklentilere izin veren PlayerDebugMode ayarının açık olması gerekir. Kurulum dosyası bu ayarı senin kullanıcı hesabında CSXS.9'dan CSXS.14'e kadar bütün anahtarlara yazar. Ayar silindiyse ya da paneli elle kopyaladıysan aşağıdaki komutlarla açabilirsin.

Premiere sürümleri farklı anahtarları okur:

Hangisini kullandığından emin değilsen hepsini aç; fazladan anahtar hiçbir şeye zarar vermez. Aşağıdaki komutlar zaten 9'dan 14'e kadar hepsini yazar.

Windows

Başlat menüsüne cmd yaz, Komut İstemi'ni aç, şu satırı yapıştırıp Enter'a bas. Yönetici yetkisi gerekmez:

for %V in (9 10 11 12 13 14) do reg add "HKCU\Software\Adobe\CSXS.%V" /v PlayerDebugMode /t REG_SZ /d 1 /f

Elle yapmak istersen Kayıt Defteri Düzenleyicisi'nde (regedit) HKEY_CURRENT_USER\Software\Adobe\CSXS.12 anahtarına PlayerDebugMode adlı bir Dize Değeri (String) ekle ve değerini 1 yap. Değer türü DWORD değil, Dize olmalı. Anahtar yoksa önce oluştur.

macOS

Terminal'i aç (⌘ + boşluk, "Terminal" yaz) ve şu iki satırı çalıştır:

for v in 9 10 11 12 13 14; do defaults write com.adobe.CSXS.$v PlayerDebugMode 1; done
killall cfprefsd

İkinci satır macOS'un ayar önbelleğini yeniler, böylece yeni ayar oturumu kapatıp açmadan geçerli olur. Ardından Premiere'i yeniden başlat.

Ayar yerinde mi? Windows'ta reg query "HKCU\Software\Adobe\CSXS.12" /v PlayerDebugMode, Mac'te defaults read com.adobe.CSXS.12 PlayerDebugMode komutu 1 göstermeli.

5. Eklenti klasörü doğru yerde mi?

Suflo kendini kullanıcı hesabının CEP eklenti klasörüne kurar. Klasörün adı com.sametcreates.kesit'tir: Suflo'nun ilk adı Kesit'ti ve kayıtlı ayarlar bozulmasın diye kimlik değişmedi.

• Windows: %APPDATA%\Adobe\CEP\extensions\com.sametcreates.kesit — bu yolu Dosya Gezgini'nin adres çubuğuna yapıştırabilirsin.
• macOS: ~/Library/Application Support/Adobe/CEP/extensions/com.sametcreates.kesit — Finder'da Git > Klasöre Git (⇧⌘G) ile aç.

Klasörün içinde doğrudan CSXS, js, jsx klasörlerini ve index.html dosyasını görmelisin. Premiere paneli CSXS/manifest.xml dosyasından tanır. Paneli elle kopyaladıysan en sık hata araya fazladan bir klasör girmesidir: com.sametcreates.kesit\panel\index.html gibi. Bu durumda Premiere manifest dosyasını bulamaz ve Suflo menüde görünmez. İçeriği bir üst seviyeye taşı ya da kurulum dosyasını yeniden çalıştır.

Eski bir kopya kalmış olabilir. Suflo'yu daha önce bir ZXP kurucusuyla kurduysan aynı kimlikte ikinci bir kopya sistem genelindeki klasörde durabilir: Windows'ta C:\Program Files (x86)\Common Files\Adobe\CEP\extensions, Mac'te /Library/Application Support/Adobe/CEP/extensions. Aynı kimlikli iki kopya çakışıp eski sürümün açılmasına yol açabilir. Oradaki com.sametcreates.kesit klasörünü sil, yalnız kullanıcı klasöründeki kopya kalsın.

6. Panel açılıyor ama boş, siyah ya da beyaz

Menüde Suflo var, tıklayınca pencere açılıyor ama içi boş kalıyorsa panel dosyaları yüklenemiyor demektir. Sırayla dene:

1. Paneli kapat, Premiere'i yeniden başlat. İlk açılışta geçici bir yükleme hatası olabilir.
2. CEP önbelleğini temizle. Premiere kapalıyken şu klasörü sil; Premiere bir sonraki açılışta yeniden oluşturur. Windows'ta %TEMP%\cep_cache, Mac'te ~/Library/Caches/CSXS/cep_cache.
3. Mac'te karantina damgasını kaldır. macOS internetten inen dosyalara bir güvenlik damgası koyar. Kurulum dosyası bunu temizler; paneli elle kopyaladıysan Terminal'de şunu çalıştır:

   xattr -dr com.apple.quarantine ~/Library/Application\ Support/Adobe/CEP/extensions/com.sametcreates.kesit

4. Antivirüsü kontrol et. Bazı antivirüs programları panelin js klasöründeki dosyaları karantinaya alır. Klasörde eksik dosya görüyorsan eklenti klasörünü dışlamalara ekleyip yeniden kur.
5. Temiz yeniden kurulum yap. Adımlar aşağıda.

7. Panel açılıyor ama Premiere'e bağlanmıyor

Panelin sağ üstündeki PREMIERE yazısının yanındaki nokta Premiere bağlantısını gösterir. Bağlantı kurulamazsa üst şeritte "Premiere'e bağlanılamadı" yazar. Bu durumda:

• Bir proje ve en az bir sekans aç. Sekans yokken üst şeritte "Sequence yok" görmen normaldir.
• Premiere'i yeniden başlat. Uzun süre açık kalan oturumlarda betik bağlantısı takılabilir.
• Suflo Doctor'u çalıştır (bir sonraki bölüm). "Premiere bağlantısı" satırı sorunun nerede olduğunu söyler.

8. Suflo Doctor ile tek taramada kontrol et

Panel açılıyorsa en hızlı teşhis aracı Suflo Doctor'dur. Panelin sağ üstündeki dişli simgesine (Ayarlar) tıkla, Suflo Doctor kartında Taramayı başlat'a bas. Doctor şunları tek raporda denetler:

• Premiere: bağlantı ve Suflo'nun kullandığı Premiere özellikleri (alt sekans, Auto Reframe, marker'lar)
• Altyazı motoru: FFmpeg, yerel motor ve model, ekran kartı hızlandırması
• Pro içerikler ve kütüphaneler: Pro içerik eşitlemesi, presetler, ses efekti ve animasyon klasörleri
• Sistem: güncelleme bağlantısı ve kurulu sürüm

Tarama salt okunurdur; timeline'ına ve medya dosyalarına dokunmaz. Bir sorun bulursa yanında FFmpeg'i onar, Motoru onar ya da Eşitle gibi düğmeler çıkar; Güvenli sorunları düzelt hepsini tek seferde uygular. Destek isteyeceksen Raporu kopyala ile sonucu mesajına yapıştır.

Doctor panelin içinde çalışır. Panel hiç açılmıyorsa senin için 1-6. adımlar geçerli.

Temiz yeniden kurulum (adım adım)

1. Premiere'i tamamen kapat.
2. Eklenti klasörünü sil: Windows'ta %APPDATA%\Adobe\CEP\extensions\com.sametcreates.kesit, Mac'te ~/Library/Application Support/Adobe/CEP/extensions/com.sametcreates.kesit. Sistem klasöründe eski bir kopya varsa onu da sil.
3. GitHub'dan son sürümün Suflo-x.y.z-Kurulum.zip dosyasını indir ve bir klasöre tamamen çıkar.
4. Windows'ta Suflo-Kur.bat, Mac'te Suflo-Kur.command dosyasını çalıştır ve KURULUM TAMAM yazısını bekle.
5. Premiere'i aç; paneli Window > Extensions (Legacy) > Suflo ya da eski sürümlerde Window > Extensions > Suflo yolundan başlat.

Eklenti klasörünü silmek ayarlarını, indirdiğin yapay zekâ modellerini ve Pro lisansını silmez; bunlar ayrı klasörlerde durur. Yeniden kurduktan sonra kaldığın yerden devam edersin.

Hâlâ görünmüyorsa bize yaz

Hepsini denediysen hangi adımda takıldığını bilmemiz yeterli. Mesajına işletim sistemini, Premiere sürümünü ve varsa Doctor raporunu ekle:

• Panel açılıyorsa: Ayarlar'daki Sorun bildir düğmesi günlüğü kopyalar ve bildirim sayfasını açar; yapıştırman yeterli.
• Panel açılmıyorsa: GitHub'da hata bildir ya da Instagram'da @suflo.app hesabına yaz.

Panel açıldı: ilk altyazın 2 dakikada

Suflo ilk açılışta Altyazı sekmesinin üstünde İlk altyazın 2 dakikada rehberini gösterir:

1. Motoru kur: Türkçe için küçük ve hızlı Small modeli (190 MB) iner. Hesap, abonelik ya da kredi gerekmez.
2. İlk altyazı: timeline'da bir klip seç ve Altyazı oluştur'a bas; sonra Normal altyazı izi ekle ile ücretsiz caption izi oluştur.
3. Stilini seç: Altyazı Efektleri'ni (giriş ve vurgu animasyonlu kendi altyazı görünümün) kendi altyazınla önizle. Animasyonlu efekt katmanı Suflo Pro'dadır.
4. Yapay zekâyı aç (ücretsiz, 1 dk): ücretsiz bir Groq anahtarıyla AI metin kontrolü, bölüm başlıkları, paylaşım metni ve kanca önerileri açılır. Çeviri, viral anlar ve B-roll önerileri Suflo Pro'da aynı anahtarla çalışır.

Rehberi kapattıysan Ayarlar > Destek > Kurulum rehberini aç ile geri getirebilirsin. Ayrıntılı kurulum anlatımı için Premiere Pro'ya Türkçe altyazı ekleme rehberine bak.