CanlıHalay — TikTok LIVE etkileşimli sahne
Dosya Açıklaması
TikTok canlı yayınındaki izleyicileri halay, horon, zeybek ve daha fazlasını oynayan karakterlere dönüştüren, OBS uyumlu etkileşimli bir sahne.
Yorum yazan izleyici halkaya katılır ve mesajı karakterinin üstünde balon olarak çıkar. Hediyeler sahnede gerçek etkiler yaratır: havai fişek, para yağmuru, gelin-damat, şans çarkı… Beğeniler müziğin temposunu yükseltir.
Sahneler (7): Halay, Horon, Ankara Havası, Düğün, Kına Gecesi, Zeybek, Kulüp/DJ. Her birinin kendi arka planı, yöresel kıyafetleri, dans figürleri ve müziği var.
İzleyici etkileşimi
- Yorum = karakter: yorum yazan halkaya katılır, mesajı konuşma balonu olur
kız/erkekyazınca kıyafet değişir- Ücretsiz sohbet hareketleri:
hopzıplatır,selamel sallatır, ❤️ kalp çıkarır - Hoş geldin animasyonu, en çok hediye atanlar tablosu
- 120 kişiye kadar iç içe iki halkada dans
Hediye → eylem sistemi (yayına özel, arayüzden düzenlenir)
- 15 eylem: Tempoyu artır, Para yağdır, Gelin, Damat, Havai fişek, Konfeti, Sıkıştır, Mendil salla, Başa geç, Kıyafet yükselt (3 seviye), Davulcu/Zurnacı/Kemençeci ol, Hoppa, Şans çarkı
- Sahnenin üstünde hangi hediyenin ne yaptığını gösteren kayan şerit
- Her eylem için "Dene" düğmesi
Görsel şölen
- Hediye büyüklüğüne göre kademeli şov: ışık patlaması, uçan yazılar, roketli havai fişek, ekran sarsıntısı; 1000+ elmasta MEGA şov
- TikTok tarzı canlı sayan hediye bantları, kombo patlamaları (x10, x25, x50…)
- Beğeni hedefi: her X beğenide bütün halka coşar
Oyunlar
- 🎡 Şans çarkı: ödüller sahneye etki eder, yayıncı görevleri yazılabilir
- 🔴🔵 Takım yarışı: izleyiciler
1/2yazarak takım seçer, hediyeler ve beğeniler puan, süreli turlar
Ses ve müzik
- Kodla üretilen telifsiz müzik (davul, zurna, kemençe, darbuka, bağlama, elektronik); tempo sahne enerjisine uyar
- Hediye ses efektleri
- İsteğe bağlı: sahne başına kendi müzik dosyanı yükle
Yayıncı araçları
- 📱 Telefondan kumanda (QR kodla): sahne değiştir, efekt tetikle, çarkı çevir, ekrana yazı yaz, ses ve oran ayarla
- OBS yayın modu (
Htuşu veya?clean), 16:9 ve 9:16 (dik yayın) desteği - Ayarlar şifreyle korunur
- 🧪 Demo modu: canlı yayın açmadan sahte izleyicilerle test
Gereksinim: Node.js 20+
npm install
cp .env.example .env
npm run devTarayıcıda http://localhost:3000 adresini aç. Denemek için Demoyu izle'ye bas.
Yayında kullanırken üretim modunda çalıştır:
npm run build
npm start| Değişken | Açıklama |
|---|---|
TIKTOK_SIGN_API_KEY | Euler Stream ücretsiz API anahtarı. TikTok bağlantısı için gereken imza servisinin limitlerini yükseltir. Önerilir. |
SETTINGS_PASSWORD | Ayarları kaydetmek ve kumandayı kullanmak için şifre. İnternete açık kurulumda mutlaka ayarla. |
- OBS'te Kaynak ekle → Tarayıcı seç.
- Adres:
http://localhost:3000/live/KULLANICI_ADI/halay?clean- Dik yayın için sonuna
&oran=9:16ekle.
- Dik yayın için sonuna
- Genişlik/yükseklik: 1920×1080 (dik yayında 1080×1920).
- Sesin yayına gitmesi için "Sesi OBS üzerinden kontrol et" kutusunu işaretle.
Yayın ekranındaki 📱 düğmesine bas, çıkan QR kodu telefonla okut. Telefon bilgisayarla aynı Wi-Fi ağında olmalı. Açılmazsa Windows güvenlik duvarında Node.js'e "Özel ağ" izni ver.
- Next.js 16, React 19, TypeScript, Tailwind CSS 4
- TikTok bağlantısı TikTok-Live-Connector ile yapılır. Aynı kullanıcı adı için bütün sekmeler ve OBS tek bir TikTok bağlantısını paylaşır; böylece imza servisi limiti boşa harcanmaz.
- Uzun süreli bağlantı (SSE) kullandığı için kendi bilgisayarında, bir VPS'te ya da Railway/Render gibi bir sunucuda çalıştırılması önerilir. Sunucusuz platformlar bağlantı süresini sınırlar.
- Ayarlar ve yüklenen müzikler
data/klasöründe saklanır.
Bu proje TikTok ile bağlantılı değildir; resmi olmayan bir API kullanır.
Tıkladığınızda 10 saniyelik güvenli bağlantı geri sayımı başlayacaktır.
Güvenli Bağlantı Oluşturuluyor...
Dosyanız taranıyor ve tek kullanımlık şifreli indirme bağlantınız hazırlanıyor. Lütfen bekleyiniz.
Dosyanız Hazır! İndirme Başlatıldı.
İndirme otomatik olarak başlamadıysa veya tekrar indirmek isterseniz aşağıdaki butona tıklayabilirsiniz. Her indirmede tek kullanımlık yeni bir güvenlik bağlantısı oluşturulur.


