PanDeck Dokümantasyonu

Kurulum, yapılandırma ve sorun giderme rehberi.

Kurulum

Windows Host Kurulumu

  1. İndirin: PanDeck-Windows-Setup.exe dosyasını sitemizden indirin.
  2. Çalıştırın: İndirilen .exe dosyasına çift tıklayın. Windows SmartScreen uyarısı alırsanız "Yine de çalıştır" seçeneğine tıklayın.
  3. Kurulumu tamamlayın: Kurulum sihirbazındaki adımları takip edin. Kurulum yönetici (UAC) izni ister; varsayılan dizin C:\Program Files (x86)\PanDeck olacaktır. Ayarlar ve kayıtlar %LOCALAPPDATA%\PanDeck altında tutulur.
  4. Başlatın: Kurulum tamamlandığında "PanDeck" uygulamasını başlatın. Uygulama sistem tepsisinde (system tray) simge olarak görünecektir.

Android Client Kurulumu

  1. Google Play (Önerilen): Google Play Store'da "PanDeck" arayın veya direkt bağlantı ile kurulum yapın.
  2. APK ile kurulum: Sitemizdeki APK dosyasını indirin. Android ayarlarından "Bilinmeyen kaynaklar" veya "Dışarıdan uygulama yükle" seçeneğini aktif edin.
  3. İzinleri verin: Uygulama ilk açılışında yerel ağ erişimi (cihaz keşfi ve bağlantı) izni isteyecektir.
Not: Windows Host ve Android Client cihazlarınızın aynı yerel ağda olması gerekmektedir.

Güvenlik Duvarı

Windows Host ilk çalıştırıldığında Güvenlik Duvarı izni isteyecektir. İzin vermeniz durumunda gerekli tüm portlar otomatik olarak açılır.

Gerekli Portlar

4711 — HTTP API + WebSocket (TCP, veri aktarımı)
5353 — mDNS (cihaz keşfi, UDP)

Manuel Kural Ekleme

  1. Windows Güvenlik Duvarı'nı açın: wf.msc çalıştırın.
  2. Gelen KurallarıYeni Kural
  3. Kural tipi: Port, TCP, 4711
  4. "Bağlantıya izin ver" seçeneğini işaretleyin.
  5. mDNS keşfi (5353/UDP) için aynı adımları UDP ile tekrarlayın.
Uyarı: Güvenlik Duvarı kurallarını yalnızca ihtiyacınız kadar geniş tutun.

Otomatik Başlatma

PanDeck Host'un Windows başlangıcında otomatik olarak çalışması için:

Sistem Tepsisi ile (Önerilen)

  1. Sistem tepsisindeki simgeye sağ tıklayın → "Ayarlar".
  2. "Windows ile başlat" seçeneğini aktif edin.

Elle Yapılandırma

  1. Win + Rshell:startup
  2. PanDeck Host kısayolunu başlangıç klasörüne kopyalayın.
Not: Arka planda çalışan PanDeck Host minimum bellek (≈ 40MB RAM) tüketir.

Host Ayarları

Windows Host penceresi üç sekmeden oluşur: HAKKINDA, AYARLAR ve CİHAZLAR. AYARLAR sekmesi soldaki listeden geçiş yapılan yedi bölüme ayrılmıştır. Yaptığınız değişiklikler alttaki KAYDET düğmesiyle uygulanır.

Bağlantı

  • PANOYU DÜZENLE — panoyu bilgisayardan düzenlemek için tarayıcıda http://localhost:4711/ adresini açar.
  • Durum● ONLINE sunucu ayakta, cihazlar bağlanabilir. ● OFFLINE sunucu durmuş; tepsi menüsünden yeniden başlatın.
  • Bağlantı adresi — cihazın bağlanacağı IP:port. Cihaz host'u mDNS ile kendiliğinden bulamazsa tablette elle bağlanma ekranına bu adresi yazın. Wi-Fi/kablo değişince adres kendiliğinden güncellenir, eşleşmeniz bozulmaz.
  • Güvenlik Duvarı Kuralı Ekle — Windows Güvenlik Duvarı'na 4711/TCP (veri) ve 5353/UDP (keşif) izni ekler. Yönetici onayı ister.
Not: Bu bölümdeki bilgiler ağa göre otomatik gelir; elle ayar yapmanız gerekmez.

Sunucu (ileri düzey)

Port  — host'un dinlediği TCP portu (varsayılan 4711)
Token — elle bağlanma anahtarı (normal kullanımda gerekmez)
  • Port: yalnızca 4711 başka bir program tarafından kullanılıyorsa değiştirin. Değiştirdiğinizde sunucu yeniden başlar, güvenlik duvarı kuralını yeni port için yeniden eklemeniz ve adresi elle girdiğiniz cihazlarda portu güncellemeniz gerekir.
  • Token: cihazlar normalde PIN ile eşleşir ve kendi anahtarlarını alır; bu yüzden token'ı yenilemek eşleşmiş cihazları düşürmez — yalnızca token'ı elle girmiş cihazların erişimi kesilir. Token ağda yayınlanmaz (mDNS kaydında yer almaz); kimseyle paylaşmayın.
Uyarı: Port ve Token, PanDeck'in bel kemiğidir. Bu yüzden Port kutusu ve yeni token üretme (↺) düğmesi varsayılan olarak kilitlidir; değiştirmek için önce 🔒 DEĞİŞTİRMEK İÇİN KİLİDİ AÇ düğmesine basmanız gerekir. KAYDET'ten sonra kilit kendiliğinden geri kapanır. Yanlış bir değer girdiyseniz Port'a 4711 yazıp KAYDET demeniz eski hâline dönmek için yeterlidir.

Davranış

  • Windows ile otomatik başlat — oturum açıldığında host arka planda çalışır (yalnızca kurulu sürümde).
  • Tepsiye küçültülmüş başlat — pencere yerine sistem tepsisinde açılır.
  • Gelişmiş komutlar — pano butonlarında cmd /c … gibi kabuk komutlarına izin verir. Varsayılan kapalıdır; yalnızca güvendiğiniz cihazlara erişim verin. Bu anahtar kapalıyken de uygulamanın kendi hazır komut kataloğu (DNS temizle, çöp kutusunu boşalt vb.) çalışır.

Görünüm

Yedi hazır tema ve vurgu (aksan) rengi vardır. Host ve tablet seçimleri ayrıdır: buradaki seçim yalnız host penceresini değiştirir, tabletin teması cihazın kendi Ayarlar > Tema ekranından seçilir. Bazı temalar kendi vurgu rengini dayatır; o durumda renk satırı kilitlenir.

SteelSeries Sonar Entegrasyonu

Ön Koşullar

  • SteelSeries GG uygulaması yüklü olmalı
  • Sonar modülü aktif edilmiş olmalı
  • PanDeck 0.30.0 (Beta) veya üzeri

Kanal Eşlemesi

Sonar Game  → Oyun ses kanalı
Sonar Chat  → Sohbet/iletişim kanalı
Sonar Media → Medya/sistem ses kanalı
Sonar Mic   → Mikrofon (giriş) kontrolü
İpucu: Android/tablet uygulamasından her kanalın ses seviyesini ayarlayabilir ve susturabilirsiniz. (Ses dinleme/akış değil; doğrudan kanal kontrolü.)

PIN ile Eşleştirme

  1. Windows Host sistem tepsisindeki simgeye sağ tıklayın → "PIN Göster".
  2. 6 haneli PIN'i not alın.
  3. Android Client'da "PIN ile Eşleştir" butonuna tıklayın.
  4. IP adresini ve PIN'i girin → "Bağlan".
IP:    192.168.1.100 (veya hostname.local)
Port:  4711
PIN:   123456
Önemli: PIN yalnızca eşleştirme sırasında geçerlidir ve sınırlı sayıda yanlış denemeden sonra yenilenir. Eşleşen cihaz sonraki bağlantılarda cihaza özel bir token ile sessizce tanınır; cihazı host'tan "unutarak" erişimi iptal edebilirsiniz. (Bağlantı yerel ağ içindir; uçtan uca TLS şifrelemesi henüz yoktur — güvenilir bir ağ kullanın.)

Farklı Ağlardan Bağlanma

  • VPN kullanımı (Tailscale, ZeroTier) önerilir — en güvenli yöntem
  • Alternatif olarak 4711 portu için port yönlendirme yapılandırılabilir (güvenlik açısından önerilmez)

Cihaz Yönetimi

Host penceresindeki CİHAZLAR sekmesi iki liste gösterir.

Bağlı Cihazlar

  • Aynı ağdan bağlanan tablet ve telefonlar anlık olarak burada görünür (ad, IP, cihaz tipi).
  • Doğrulanmamış bir cihaz bağlanmaya çalıştığında host onay ister; onaylarsanız PIN eşleştirmesi başlar, reddederseniz cihaz geçici olarak engellenir ve tekrar tekrar sormaz.

Eşleşmiş Cihazlar

  • PIN ile bir kez eşleşen cihazlar çevrimdışı olsalar bile listede kalır; sonraki bağlantılarda cihaza özel anahtarla sessizce tanınırlar.
  • UNUT ile bir cihazın erişimini iptal edersiniz; o cihaz tekrar bağlanmak isterse yeniden PIN gerekir.

Arıza Kayıtları ve Hata Bildirimi

  • HAKKINDA > Arıza kayıtları — beklenmedik bir kapanma olursa kayıt burada tarih tarih listelenir; soldan bir kayıt seçip içeriğini görebilir, temizleyebilirsiniz.
  • HAKKINDA > Hata bildir — açıklamanızı ve sürüm/işletim sistemi bilgisini doğrudan geliştiriciye iletir. Hesap veya giriş gerekmez.
Gizlilik: PanDeck bulut veritabanı kullanmaz. Eşleşme kayıtları ve arıza günlükleri yalnızca kendi bilgisayarınızda, %LOCALAPPDATA%\PanDeck altında tutulur.

Pano (Deck) Kullanımı

Pano, Stream Deck tarzı özelleştirilebilir bir buton ızgarasıdır. Butonlar host'ta saklanır ve bağlı tüm cihazlarla senkronize edilir.

Buton Ekleme & Düzenleme

  1. Pano sekmesinde sağ üstteki ayar simgesine dokunun → DÜZENLE.
  2. Boş bir hücreye dokunarak yeni buton ekleyin, var olan butona dokunarak düzenleyin.
  3. Buton editöründe önce aksiyonu seçin, ardından etiket, ikon, renk ve (gerekirse) onay seçeneğini ayarlayın.

Aksiyon Kategorileri

Medya      → oynat/duraklat, sonraki, önceki, sesi kıs/aç
Ses        → kanal/çıkış seviyesi, sustur (Sonar veya temel)
Monitör    → karart / özel görsel göster
Güç        → kilitle, uyut, yeniden başlat, kapat, Wake-on-LAN
Sistem     → uygulama/URL/klasör aç, kısayol, metin yaz, komut
Ses dosyası→ paketli veya seçili bir sesi çal (play_sound)
Makro      → kayıtlı bir makroyu çalıştır (run_macro)
Klasör     → alt ızgara aç (en çok 4 seviye iç içe)

Profiller, Sayfalar & İkonlar

  • Birden çok pano profili oluşturup dikey kaydırma ile aralarında geçiş yapabilirsiniz.
  • Izgara dolduğunda butonlar otomatik olarak yatay sayfalara bölünür.
  • Her buton için hazır ikon setinden seçim yapabilir veya özel PNG/JPG ikon yükleyebilirsiniz.
  • Özel ikon yüklerken açılan kırpma editörü ile görseli kaydırıp yakınlaştırabilirsiniz. İki ek anahtar vardır: tam kaplama (görsel tuşun tamamını doldurur) ve etiketi gizle (yalnız görsel görünür). İkisi de varsayılan kapalıdır, eski butonlarınız aynı kalır.
  • Pano başına tuş boyutu (XS–XL) ve ızgara sütun/satır sayısı ayarlanabilir.
İpucu: Panoyu bilgisayardan düzenlemek için Host'taki "Panoyu Düzenle" (Ayarlar veya tepsi menüsü) bağlantısını kullanın; uygulama http://localhost:4711/ adresinde açılır.
Otomatik Pano: Ayarlar > Tablet bölümündeki "Otomatik Pano" açıkken, bir panoyu belirli bir uygulamaya bağladığınızda (örn. obs64.exe) o uygulama öne geçtiğinde cihaz otomatik olarak ilgili panoya geçer.

Makrolar

Makro, sırayla çalışan birden çok adımdan oluşan bir eylem zinciridir. Her adım bir pano aksiyonudur.

Makro Oluşturma

  1. Makrolar sekmesinde yeni bir makro ekleyin; ad, ikon ve renk verin.
  2. Adım ekleyin: her adıma bir aksiyon, parametre ve gecikme (ms) atayın. İsteğe bağlı olarak adıma ikon ve etiket verebilirsiniz.
  3. Adımları sıralayın; ÇALIŞTIR ile makroyu test edin.
Uyarı: Güç veya komut içeren adımlara sahip makrolar çalıştırılmadan önce uygulama içi onay ister. Bu adımlar tek başına da kullanılırken onay gerektirir.

Makroyu Butona Bağlama

Bir pano butonuna run_macro aksiyonunu atayarak kayıtlı bir makroyu tek dokunuşla çalıştırabilirsiniz.

Ses Kitaplığı

Ses kitaplığı, pano butonlarına atayabileceğiniz kısa ses dosyalarını tutar. Sesler host'ta çalar, yani bilgisayarınızın hoparlöründen duyulur.

Dosya Ekleme

  1. Host > AYARLAR > SES KİTAPLIĞI bölümünü açın.
  2. Dosyaları alandaki kutuya sürükleyip bırakın ya da DOSYA SEÇ ile seçin. KLASÖR düğmesi kitaplık klasörünü Gezgin'de açar.
  3. Tabletten de ekleyebilirsiniz: buton sihirbazında PC'DEN EKLE deyince host'ta dosya seçici açılır.

Kabul Kuralları

Biçimler : mp3 · wav · wma · m4a · ogg · flac
Boyut    : dosya başına en fazla 12 MB
Konum    : %LOCALAPPDATA%\PanDeck\sounds

Butona Bağlama

Buton editöründe Ses dosyası aksiyonunu (play_sound) seçin ve kitaplıktan bir dosya belirleyin. Aynı ses birden çok butonda kullanılabilir.

Not: Kurallar (uzantı, 12 MB tavanı, dosya adı temizleme) host ve tablette birebir aynıdır; tabletten eklenen bir dosya da aynı denetimlerden geçer.

Entegrasyonlar

Entegrasyonlar varsayılan olarak kapalıdır ve yalnızca host penceresinden (AYARLAR > ENTEGRASYONLAR) açılabilir. Tabletten uzaktan açılamazlar: bir entegrasyonu açmak yerel disk okumak ya da ağ bağlantısı kurmak demektir ve bu karar bilgisayarın başındaki kişiye aittir.

Steam

  • Açıldığında kurulu Steam oyunlarınız okunur ve pano butonundan tek dokunuşla başlatılabilir.
  • Yalnızca yerel diskteki kütüphane dosyaları okunur; Steam hesabı, şifre veya çevrimiçi API kullanılmaz.

OBS Studio

  1. OBS'te Araçlar > WebSocket Sunucu Ayarları'nı açın, sunucuyu etkinleştirin ve varsa şifreyi not alın.
  2. Host'ta OBS anahtarını açın, adresi (ws://127.0.0.1:4455) ve şifreyi girin.
  3. BAĞLANTIYI SINA ile doğrulayın; sonuç düğmenin altında yazar.

Desteklenen aksiyonlar: sahne değiştirme, kayıt ve yayın başlat/durdur, kaynak gösterme/gizleme, ses kaynağı susturma.

Uyarı: OBS şifresi host'ta yerel olarak saklanır ve ağda yayınlanmaz; yine de PanDeck'i yalnızca güvendiğiniz bir yerel ağda kullanın.

Sistem İzleme

Tabletteki Sistem ekranı CPU/RAM kullanımını ve donanım adlarını gösterir. CPU sıcaklığı ise isteğe bağlıdır ve host'tan açılması gerekir.

CPU Sıcaklığını Etkinleştirme

  1. Host > AYARLAR > SİSTEM bölümünü açın.
  2. ETKİNLEŞTİR düğmesine basın ve bir kereliğine yönetici (UAC) onayı verin.
  3. PanDeck, sıcaklığı okuyan küçük bir yardımcıyı Windows görevi olarak kaydeder; uygulamanın kendisi yönetici olarak çalışmaz.
  4. Kart ● AÇIK olduğunda değer tablette görünür. Kapatmak için aynı düğmeyi kullanın; görev silinir.
Neden ayrı bir görev? Sıcaklık sensörleri yalnızca yükseltilmiş yetkiyle okunabilir. Yardımcıyı ayrı bir görev olarak çalıştırmak, PanDeck'in her açılışta yönetici izni istemesini önler.
Değer görünmüyorsa: Bazı sistemlerde çekirdek bütünlüğü (HVCI / Bellek Bütünlüğü) sürücü tabanlı okumayı engeller. Kartın altındaki durum satırı sebebi yazar; sıcaklık dışındaki tüm sistem bilgileri bu durumda da çalışmaya devam eder.

Yedekleme & Aktarma

Pano Yedeği

  1. Ayarlar > PANO YEDEK > DIŞA AKTAR: JSON'u kopyalayın veya dosyaya indirin.
  2. İÇE AKTAR: JSON'u yapıştırın veya dosya seçin, onaylayın. İçe aktarma mevcut panoların yerini alır (değiştirir).

Makro Yedeği

  1. Makrolar > MAKRO YEDEK > DIŞA / İÇE AKTAR.
  2. Makro içe aktarma, mevcut makrolara ekler (çakışan kimlikler yeniden üretilir).
Otomatik yedek: Host her pano kaydından önce panonun bir önceki sürümünü %LOCALAPPDATA%\PanDeck\decks_backups\ altına kopyalar ve en yeni 5 sürümü saklar.

Güç & Wake-on-LAN

Güç Aksiyonları

  • Kilitle / Uyut / Yeniden Başlat / Kapat aksiyonları bir pano butonuna atanabilir.
  • Bu aksiyonlar her zaman onay ister; güvenlik için onay kapatılamaz.

Wake-on-LAN

  1. Hedef bilgisayarın BIOS/UEFI ve ağ kartı ayarlarından Wake-on-LAN'ı etkinleştirin.
  2. Host'ta WoL hedeflerini (MAC adresi) tanımlayın.
  3. Uyku/kapalı durumdaki cihazı bir WoL butonuyla uyandırın.

Boşta Modları

Ayarlar bölümünden cihaz belirli bir süre dokunulmadığında devreye giren boşta modunu seçebilirsiniz: Kapalı, Kararma veya Saat (ekran koruyucu). Süre 1–15 dakika arasında ayarlanır; ilk dokunuş cihazı uyandırır.

Otomatik Güncelleme

PanDeck Host yeni sürümleri kendisi denetler.

  1. Açılışta Host, sürüm bilgisini çevrimiçi denetler; daha yeni bir sürüm varsa sürüm notları ve İNDİR butonuyla uygulama içi bir güncelleme penceresi gösterir.
  2. Elle denetlemek için Hakkında > Güncellemeleri Denetle seçeneğini kullanın.
  3. Kurulum sihirbazı uygulamayı mevcut dizine kurar; ayarlarınız, panolarınız ve makrolarınız korunur.
Not: Güncelleme sırasında çalışan Host otomatik olarak kapatılır ve yeni sürümle birlikte yeniden başlatılabilir.

Sorun Giderme

Bağlantı Kurulamıyor

  • Cihazların aynı ağda olduğundan emin olun
  • Güvenlik Duvarı'nın PanDeck'e izin verdiğini kontrol edin
  • Yönlendiricinizi yeniden başlatın

mDNS Keşfi Çalışmıyor

  • IGMP Snooping ayarlarını kontrol edin
  • PIN ile elle eşleştirme yöntemini kullanın

Ses Kontrolü Çalışmıyor

  • Sonar kanalları görünmüyorsa SteelSeries GG / Sonar'ın açık ve etkin olduğundan emin olun
  • Sonar yoksa uygulama temel mod (varsayılan çıkış + mikrofon) ile çalışır
  • Ayar değişiklikleri için Host'taki Ses modülünün açık olduğunu kontrol edin

Pano (Deck) Senkronize Olmuyor

  • Cihazın host'la eşleşmiş ve bağlı olduğundan emin olun
  • Host'u yeniden başlatıp cihazı tekrar bağlayın
  • Buton değişiklikleri host'ta kaydedilir; birden çok cihaz aynı panoyu paylaşır
Yardım mı gerekiyor? info@pancstar.com.tr adresine e-posta gönderin.