TubeBin

Search, preview & pull YouTube media straight into your Premiere Pro bin. A free, open-source CEP panel for Adobe Premiere Pro (macOS).

📸 Daha fazla ekran görüntüsü / More screenshots

Aramayı panelde yap, sonuca tıkla, "İndir ve Projeye Ekle" de — dosya ~/Movies/TubeBin/ klasörüne iner ve projendeki TubeBin bin'ine otomatik import edilir. Tarayıcıya, şüpheli indirme sitelerine gerek yok.

⚠️ Disclaimer / Sorumluluk notu: Downloading content from YouTube may violate YouTube's Terms of Service, and most content is protected by copyright. This tool is intended for personal workflow use with content you have the rights to use (your own uploads, properly licensed material, etc.). Kullanım sorumluluğu kullanıcıya aittir.

---

✨ Özellikler / Features

• 🔍 Panel içi arama — kelime yaz, Enter'a bas; ilk 20 sonuç listelenir (yt-dlp ytsearch, API key gerektirmez)
• ➕ "Daha fazla sonuç" — her tıklamada sonraki 20 sonuç yüklenir
• 🔗 Link modu — YouTube linki yapıştırınca otomatik algılar, thumbnail + başlık + süre gösterir
• 🎬 Video + Ses (H.264 MP4 — Premiere'de sorunsuz) veya 🎵 Sadece Ses (m4a)
• 📥 Otomatik import — indirilen dosya projedeki "TubeBin" bin'ine düşer
• 📊 Canlı progress bar + tek tıkla iptal
• ⚙️ Ayarlanabilir indirme klasörü ve yt-dlp yolu (~/.tubebin.json)
• 🟢 yt-dlp/ffmpeg durum göstergesi

🧰 Gereksinimler / Requirements

• macOS + Adobe Premiere Pro 2021 veya üzeri (CEP 11/12)
• Homebrew ile:

brew install yt-dlp ffmpeg

🚀 Kurulum / Install

1. İmzasız eklenti modunu aç (unsigned extensions, dev mode):

defaults write com.adobe.CSXS.11 PlayerDebugMode 1
defaults write com.adobe.CSXS.12 PlayerDebugMode 1
killall cfprefsd

2. Eklentiyi yerleştir:

mkdir -p ~/Library/Application\ Support/Adobe/CEP/extensions
cp -R tubebin ~/Library/Application\ Support/Adobe/CEP/extensions/com.kocancreative.tubebin

3. Premiere Pro'yu başlat → Window → Extensions → TubeBin

🖱️ Kullanım / Usage

Yapmak istediğin	Nasıl
Arama	Kutuya kelime yaz → Enter → sonuca tıkla
Daha fazla sonuç	Listenin altındaki "Daha fazla sonuç" butonuna bas
Link ile indirme	YouTube linkini yapıştır (⌘V butonu panodan alır)
Format	Video + Ses ya da Sadece Ses seç
İndir + import	İndir ve Projeye Ekle → dosya "TubeBin" bin'ine düşer
İptal	İndirme sırasında aynı butona tekrar bas

🗂 Mimari / Architecture

com.kocancreative.tubebin/
├── CSXS/manifest.xml    → CEP kimliği, --enable-nodejs, panel boyutu
├── .debug               → geliştirme portu (8092 → localhost:8092 DevTools)
├── index.html           → panel arayüzü
├── css/style.css        → Premiere koyu temasına uyumlu stil
├── js/CSInterface.js    → Adobe'nin resmi CEP köprüsü
├── js/downloader.js     → Node katmanı: yt-dlp spawn, arama, progress parse
├── js/main.js           → UI mantığı + evalScript köprüsü
└── jsx/import.jsx       → ExtendScript: bin oluştur + importFiles

Akış: Panel (HTML/JS) → Node child_process ile yt-dlp → indirme bitince ExtendScript app.project.importFiles() → Premiere bin.

🛠 Sorun giderme / Troubleshooting

• Panel menüde görünmüyor → PlayerDebugMode adımını yaptın mı? Premiere'i tamamen yeniden başlat.
• Sağ üst nokta kırmızı → yt-dlp bulunamadı: brew install yt-dlp, sonra Ayarlar'dan yolu kontrol et (which yt-dlp).
• "ffmpeg bulunamadı" hatası → brew install ffmpeg.
• Debug → panel açıkken Chrome'da http://localhost:8092.

🗺 Yol haritası / Roadmap

• Kalite seçici (1080p / 4K)
• İndirme kuyruğu + geçmiş
• Embed önizleme (panel içinde oynatma)
• Timeline'a otomatik ekleme opsiyonu
• Windows desteği

📄 Lisans / License

MIT — js/CSInterface.js is © Adobe and distributed under Adobe's own license terms (see file header).

---

Built by Doğukan Koçan · Koçan Creative