Sorun giderme

Bu sayfa karşılaşılan sorunları ve her birinin çözümünü, neden ortaya çıktığına dair kısa bir notla birlikte toplar. Bunların birçoğu hata değil, platformun sınırıdır; bu yüzden her sorunun hangi platformda geçerli olduğu başlığında yazar.

Gördüğünüz durum burada yoksa SSS sayfasına bakın ya da GitHub üzerinde bir kayıt (issue) açın.

Genel kısayollar çalışmıyor (Linux)

Belirti. Ctrl+Alt+Shift+A ve diğer kısayollar hiçbir şey yapmıyor ya da Snipdeck “Kısayol tuşları kaydedilemedi” diyor.

Neden olur. Wayland’de genel kısayollar masaüstü portalından geçer. Portal, uygulama kimliği (application id) olmayan bir programı geri çevirir; korumalı alan (sandbox) dışında kurulmuş bir program bu kimliği yalnız masaüstü onu kendi .desktop girdisinden başlattığında alır. Uçbirimden başlatılan Snipdeck’in kimliği olmaz ve hiçbir kısayol bağlanamaz.

Ne yapmalı:

• Snipdeck’i install.sh ile (kaynaktan derlediyseniz packaging/linux/install-from-source.sh ile) kurun ve uygulama menünüzden başlatın, uçbirimden değil.
• Kısayollar ilk kez bağlanırken masaüstünüz onaylamanız için bir pencere gösterir. Bir kez onaylayın.
• Bundan sonra kısayollar masaüstünüzündür: onları masaüstünüzün klavye ayarlarında değiştirin. settings.json içindeki hotkey_* anahtarları yalnız Snipdeck’in ilk seferde önerdiği bileşimlerdir.

Super+Alt+sürükle çalışmıyor ya da snip’ler yanlış yerde açılıyor (GNOME)

Belirti. GNOME’da Super+Alt basılıyken sürüklemek bir pencereyi taşıyor ya da hiçbir şey yapmıyor. Ya da snip’ler yakaladığınız yerde değil, GNOME’un koyduğu yerde açılıyor ve üstte kalmıyor.

Neden olur. İkisi de Snipdeck’in GNOME Shell eklentisinin, [email protected]’un işidir. Wayland bir programın kendi pencerelerini yerleştirmesine, üstte tutmasına ya da fareyi genel olarak izlemesine izin vermez; GNOME Shell’in içinde çalışan kod bunları yapabilir. Eklenti yüklenmemişse GNOME, Snipdeck’e sıradan bir program gibi davranır.

Ne yapmalı:

1. Snipdeck’in çalıştığından emin olun. Eklenti Super+Alt+sürükle’yi yalnız Snipdeck çalışırken üstlenir; aksi halde bu bileşim GNOME’un pencere taşıma hareketi olarak kalır.
2. Snipdeck’i kurduktan sonra ve her GNOME yükseltmesinden sonra oturumu kapatıp yeniden açın. GNOME Shell Wayland’de bir eklentiyi yerinde yükleyemez, çünkü oturumunuzu tutan bileşik yöneticinin (compositor) kendisidir.
3. Eklentinin durumuna bakın:

gnome-extensions info [email protected]

Durum ACTIVE olmalı. Komut eklentinin bulunmadığını söylüyorsa kurulmamıştır: install.sh eklentiyi yalnız bir GNOME oturumunun içinde çalıştırıldığında kurar. Eklenti kurulu ama etkin değilse gnome-extensions enable [email protected] komutunu çalıştırıp oturumu kapatıp açın. Durum OUT OF DATE ise kurulu eklenti GNOME sürümünüzü listelemiyor ve GNOME onu yüklemeyi reddetmiş demektir: daha yeni bir Snipdeck kurun.

Eklentiyle bile GNOME Wayland’de eksik kalan bir şey var: bir snip’i sürüklediğinizde onu GNOME taşır ve nereye bıraktığını Snipdeck’e söylemez; bu yüzden konumu yeniden başlatmalar arasında hatırlanmaz.

Snip’ler üstte kalmıyor ve sürükleme hareketi yok (diğer Linux masaüstleri)

Belirti. KDE, sway, Hyprland ya da başka bir Wayland masaüstünde snip’ler bileşik yöneticinin koyduğu yerde açılıyor, diğer pencerelerin üstünde durmuyor ve pencere listesinde görünüyor. Bir değiştirici tuşu basılı tutup sürüklemek hiçbir şey yapmıyor.

Neden olur. Bir Wayland programı pencerelerinin nereye gideceğini seçemez, nerede olduklarını soramaz ve onları diğerlerinin üstünde tutamaz; bunlara bileşik yönetici karar verir. KDE ve wlroots tabanlı yöneticilerin bunun için sunduğu wlr-layer-shell protokolünü Snipdeck henüz kullanmıyor. Değiştirici + sürükle hareketi ise genel bir fare kancası ister; Linux bunu yalnız /dev/input okunarak, yani fiilen sistem genelinde bir tuş kaydedici çalıştırılarak verir ve Snipdeck sizden buna izin vermenizi istemez.

Ne yapmalı. Kısayol tuşlarıyla ya da galerideki Yeni düğmesiyle yakalayın. Bölge yakalama, dondurma katmanı, OCR, sürükleme ve sağ tık menüsü çalışır.

Tepsi simgesi yok (GNOME)

Belirti. Snipdeck çalışıyor ama üst çubukta simgesi yok.

Neden olur. GNOME’un kendi tepsisi yoktur. Snipdeck’in tepsi simgesi libayatana-appindicator paketine ve GNOME’da AppIndicator eklentisine ihtiyaç duyar.

Ne yapmalı. İkisini de kurun, sonra oturumu kapatıp açın. Tepsi olmadan da Snipdeck çalışır:

• Galeri penceresini kapatmak Snipdeck’ten çıkar, çünkü onu geri getirecek bir şey kalmazdı.
• Snipdeck çalışırken onu yeniden başlatmak ikinci bir kopya açmaz, çalışan kopyanın penceresini geri getirir.

Snip alırken ekran paylaşımı penceresi çıkıyor (Linux, Wayland)

Belirti. İlk snip ekranınızı paylaşmak için izin istiyor ya da üst çubukta bir ekran paylaşımı göstergesi beliriyor.

Neden olur. Wayland’de Snipdeck ekranı masaüstünün ScreenCast portalı üzerinden okur. Masaüstü bir kez sorar; gösterge yalnız snip alındığı sırada görünür.

Ne yapmalı. Pencereyi onaylayın. GNOME’da Super+Alt+sürükle ile alınan bir snip portalı hiç kullanmaz; eklenti onu GNOME Shell’in içinde yakalar.

E-posta, görüntü düzenleyicisi ya da Bağlantıyı aç çalışmıyor (Linux)

Belirti. Snip ekli yeni e-posta ya da Sistem görüntü düzenleyicisinde aç xdg-utils kurmanızı isteyen bir hata veriyor ya da yüklemeden sonra Bağlantıyı aç hiçbir şey yapmıyor.

Neden olur. Linux’ta bu eylemler işi xdg-utils paketindeki xdg-email ve xdg-open programlarına verir.

Ne yapmalı. xdg-utils paketini kurun. Yüklemenin kendisi buna ihtiyaç duymaz; bağlantı her durumda panoya kopyalanır.

Win+sürükle ilk seferde tetiklenmiyor (Windows)

Belirti. Snipdeck bir süre boşta kaldıktan sonra ilk Win+sürükle, çoğu zaman ikinci bir monitörde, hiçbir şey yapmıyor. Sonraki çalışıyor.

Neden olur. Snipdeck yakalamayı bir Windows alt düzey giriş kancasıyla başlatır. Windows bu kancalara katı bir süre sınırı koyar; normal öncelikte boşta duran bir işlemde, sessiz bir aradan sonraki ilk olay düşebilir.

Çözüm yerleşik. Snipdeck, kancanın zamanında yanıt vermesi için başlarken kendi işleminin önceliğini yükseltir. Yine de ilk sürüklemenin kaçtığını görürseniz:

• Yeniden sürükleyin.
• Yalnız bir Snipdeck’in çalıştığından emin olun. Snipdeck oturum başına tek kopyaya izin verir, ama önceki bir oturumdan kalmış takılı bir işlem karışabilir; tepsiye ve Görev Yöneticisi’ne bakın.

Win+sürükle yönetici olarak çalışan bir pencerenin üzerinde çalışmıyor (Windows)

Belirti. Win+sürükle her yerde çalışıyor, yalnız yönetici olarak çalışan bir pencerenin, örneğin yükseltilmiş bir uçbirimin üzerinde çalışmıyor.

Neden olur. Snipdeck normal kullanıcı düzeyinde çalışır. Windows, yükseltilmiş bir pencereye yönelen girdiyi normal düzeydeki bir programın kancalarına iletmez; bu sizi tuş kaydedicilerden korur.

Ne yapmalı. Tepsi simgesine sağ tıklayıp Yönetici olarak çalıştır’ı seçin. Snipdeck tek bir UAC onayından sonra yükseltilmiş olarak yeniden başlar. Bu, siz çıkana kadar sürer; bir sonraki başlatma yine normaldir.

Snip siyah ya da boş çıkıyor (Windows)

Belirti. Bir snip tamamen siyah ya da içindeki bir pencere (donanım hızlandırmalı bir tarayıcı, bir video oynatıcı, bir oyun) siyah, geri kalanı düzgün. Bu en çok iki ekran kartlı dizüstü bilgisayarlarda görülür.

Neden olur. Snipdeck monitörü, Windows’un GPU üzerinde oluşturduğu kareyi okuyan DXGI Desktop Duplication ile yakalar. Bu kullanılamadığında ya da kare tamamen siyah geldiğinde GDI’ya geçer.

Ne yapmalı:

• Snip almadan önce açık bir UAC onayını kapatın.
• Korumalı video her yakalama yönteminde siyah kalır. Snipdeck bunu aşmaya çalışmaz.
• İki ekran kartlı bir dizüstünde siyah pencereler için pencereyi ana ekranınıza taşıyın ya da Desktop Duplication o çıkışta çalışsın diye ekran kartı sürücüsünü güncelleyin.

Antivirüs ya da SmartScreen Snipdeck için uyarıyor (Windows)

Belirti. Windows Defender, SmartScreen ya da şirketinizin güvenlik yazılımı snipdeck.exe için uyarıyor, onu karantinaya alıyor ya da oturum açılınca başlamasını engelliyor.

Neden olur. Bir ekran yakalama aracı, sezgisel denetimlere şüpheli görünen şeyler yapar: genel fare ve klavye kancaları kurar, ekranı yakalar ve oturum açılınca başlar. Bağımsız bir geliştiricinin yeni, imzasız bir programı SmartScreen gibi itibar uyarılarına da takılabilir.

Snipdeck’in bunu önlemek için yaptıkları:

• Oturum açılınca başlatma bir Başlangıç kısayoluyla yapılır, güvenlik araçlarının en sık işaretlediği kayıt defteri Run anahtarıyla değil.
• Program paketlenmemiştir. Yürütülebilir dosya paketleyicileri kötü amaçlı yazılımla ilişkilendirilir. Snipdeck paketlenmemiş, sıradan bir Rust programıdır; yalnız bağlama zamanı iyileştirmesi ve sembollerin ayıklanmasıyla küçültülür.
• Normal kullanıcı düzeyinde çalışır. Yönetici olarak çalıştırmak, tepsiden sizin seçtiğiniz tek seferlik bir eylemdir.

Ne yapmalı:

• SmartScreen “Windows bilgisayarınızı korudu” derse, Releases sayfasındaki resmî dosya için Ek bilgi → Yine de çalıştır’ı seçin.
• Bir güvenlik yazılımı dosyayı karantinaya alırsa bir istisna ekleyin ya da programı kaynaktan kendiniz derleyin; böylece tam olarak hangi programın çalıştığını siz belirlersiniz (bkz. Kurulum).
• Kaynak kod açıktır; siz ya da güvenlik sorumlularınız onu okuyup aynı programı derleyebilirsiniz.

OCR metin bulamıyor

Belirti. OCR + Pano hiçbir şey bulmuyor ya da bir snip’in metni aramada çıkmıyor.

Windows’ta Snipdeck yerleşik Windows.Media.Ocr motorunu kullanır:

• Yazının dili kurulu değil. OCR, Windows profilinizdeki dilleri kullanır ve bulamazsa İngilizce’ye (ABD) döner. Dili Ayarlar → Saat ve dil → Dil ve bölge altından ekleyin ve isteğe bağlı OCR özelliğinin kurulu olduğundan emin olun.
• Snip çok küçük. Snipdeck çok küçük snip’leri OCR’dan önce büyütür, ama tek bir sözcük ya da karakter yine boş dönebilir. Biraz daha geniş bir alan yakalayın.

Linux’ta Snipdeck tesseract kullanır:

• tesseract kurulu değil. Kurulu değilse OCR hata vermek yerine atlanır. Dağıtımınızdan kurun (Debian ve Ubuntu’da örneğin tesseract-ocr).
• Dil verisi eksik. Snipdeck, verileri kuruluysa tesseract’tan Türkçe ve İngilizce ister; değilse tesseract’ın varsayılanını kullanır. Gereken dil paketlerini kurun, örneğin tesseract-ocr-tur.

İki platformda da:

• Basılı metin yok: bir fotoğraf, bir simge, süslü bir logo ya da el yazısı.
• Metin ekranda soluk ya da çok küçük. Yakalamadan önce yakınlaştırın.

OCR + Çevir başarısız oluyor

Belirti. OCR çalışıyor ama OCR + Çevir bir hata gösteriyor.

Neden olur. Çeviri yerel değildir. OCR’dan sonra tanınan metin translate.googleapis.com adresindeki Google Çeviri’ye gider; sorun çıkabilecek yer bu tek ağ isteğidir:

• İnternet bağlantısı yok. OCR çevrimdışı çalışır, çeviri çalışmaz.
• Bir güvenlik duvarı ya da vekil sunucu (proxy) isteği engelliyor. HTTPS üzerinden translate.googleapis.com adresine izin verin.
• Hizmet sizi geçici olarak sınırladı. Bu, anahtarsız ve herkese açık bir uç noktadır. Olağan kullanım hafif olduğundan nadirdir; bekleyip yeniden deneyin.
• İstek zaman aşımına uğradı. Snipdeck, takılan bir istek onu bekletmesin diye kısa bir süre sonra vazgeçer. Yeniden deneyin.

OCR + Çevir’i ilk kullandığınızda Snipdeck metnin gönderilip gönderilemeyeceğini sorar. Siz kabul edene kadar hiçbir şey gönderilmez. Bkz. Gizlilik ve güvenlik.

Yükleme başarısız oluyor

Belirti. Yükleme penceresinde Yükleme başarısız yazıyor.

Neden olur. Pencere, barındırıcının ya da ağın verdiği nedeni gösterir. Sık görülenler:

• Imgur isteği reddetti (HTTP 403): settings.json içindeki Client-ID yanlış olabilir. imgur_client_id değerine bakın.
• Imgur kotası aşıldı (HTTP 429): daha sonra yeniden deneyin.
• Bağlanılamadı: ağ yok ya da bir güvenlik duvarı barındırıcıyı engelliyor.
• Barındırıcının yanıtında {json:…} yok (ya da başka bir alan): kendi sunucunuz yanıt verdi ama .sxcu dosyasının tarif ettiği biçimde değil. Sunucu değişmiş olabilir; ondan yeni bir .sxcu dosyası alın.

Ne yapmalı. Nedeni giderin ve Yeniden dene’ye basın; snip hâlâ oradadır. Yükleme sırasında pencereyi gizlediyseniz sonuçla birlikte kendiliğinden geri gelir.

Bir .sxcu dosyası eklerken reddedilirse, ileti Snipdeck’in desteklemediği hangi şeyi istediğini söyler. Bkz. Paylaşma ve dışa aktarma.

Ayarlarınız sıfırlandı

Belirti. Snipdeck varsayılan ayarlarla başlıyor ve “Ayarlar okunamadı ve sıfırlandı” diyor.

Neden olur. settings.json geçerli JSON değildi; çoğu zaman elle yapılan bir düzenlemeden sonra olur. Snipdeck varsayılanlarla başladı ve dosyanızın üzerine yazılmasın diye onu settings.json.bak adıyla kenara aldı.

Ne yapmalı. Snipdeck’ten çıkın, settings.json.bak dosyasındaki hatayı (çoğu zaman eksik bir virgül ya da tırnak) düzeltin ve adını yeniden settings.json yapın. Bkz. Ayarlar.

Ayrıca bakın

• Kurulum: Windows ve Linux’ta kurulum
• Yakalama kısayolları: platforma göre bütün yakalama hareketleri
• OCR ve OCR + Çeviri: metin tanıma ve çevirinin nasıl çalıştığı
• Gizlilik ve güvenlik: nelerin yerelde kaldığı, nelerin makineden çıktığı
• SSS: sık sorulan soruların kısa yanıtları