Kurulum — Snipdeck kılavuzu

Bu sayfa, Snipdeck’i çalışır hale getirmek için gereken her şeyi kapsar: sistem gereksinimleri, Windows ve Linux için indirme, ilk açılışta olanlar, GNOME eklentisi, kaynaktan derleme ve oturum açılınca başlatma.

Sistem gereksinimleri

Gereksinim	Windows	Linux
İşletim sistemi	Windows 10 veya 11	glibc 2.30 ve sonrası (Debian 11, Ubuntu 20.04, RHEL 9 ve daha yenileri); masaüstüne göre farklar aşağıda
Mimari	x64	x64
Kurulum	Tek bir taşınabilir `.exe`, kurulum yok	`.deb` ya da `.rpm` paketi, veya root gerektirmeyen `install.sh`
Çalışma bağımlılıkları	Yok. OCR, yerleşik `Windows.Media.Ocr` motorunu kullanır	`libayatana-appindicator` (tepsi), `xdg-utils` (paylaşım), isteğe bağlı olarak `tesseract` ve istediğiniz dil verileri (OCR)

Hiçbir platformda yakalama ya da dizinleme için ağ bağlantısı gerekmez. macOS sürümü henüz yok.

Windows

İndirin

Releases sayfasını açın.
snipdeck-windows-x64.exe dosyasını indirin.
İstediğiniz yere koyun: İndirilenler klasörüne, bir araçlar dizinine ya da bir USB belleğe. Kurulum yok; Program Files içine hiçbir şey yazılmaz.

Taşınabilir olduğu için dosyayı doğrudan çalıştırırsınız. Kaldırmak için .exe dosyasını silmeniz yeterlidir (verilerinizi de kaldırmak isterseniz Verilerinizin tutulduğu yer altındaki klasörleri de silin).

İlk açılış

Başlatmak için .exe dosyasına çift tıklayın. İlk çalıştırmada Snipdeck ayar ve veri klasörlerini oluşturur, arayüz dilini işletim sisteminin yerel ayarından seçer ve sistem tepsisine (saatin yanındaki bildirim alanı) bir simge ekler.

Hemen yakalamak için Win tuşunu basılı tutup bir bölgeyi sürükleyin.

Linux

İndirin ve kurun

Releases sayfasından dağıtımınıza uygun paketi indirin ve kurun:

sudo apt install ./snipdeck_*_amd64.deb      # Debian, Ubuntu, Mint
sudo dnf install ./snipdeck-*.x86_64.rpm     # Fedora, RHEL, Rocky
sudo zypper install ./snipdeck-*.x86_64.rpm  # openSUSE

Başka bir dağıtımda ya da root olmadan tar arşivini kullanın:

tar xzf snipdeck-linux-x64.tar.gz
cd snipdeck-linux-x64
./install.sh

install.sh her şeyi ev dizininize kurar:

Ne	Nereye
Program	`~/.local/bin/snipdeck`
Uygulama menüsü girdisi	`~/.local/share/applications/com.revisetouch.Snipdeck.desktop`
Simge	`~/.local/share/icons/hicolor/256x256/apps/snipdeck.png`
GNOME Shell eklentisi (yalnız GNOME oturumunda)	`~/.local/share/gnome-shell/extensions/[email protected]/`
KWin betiği (yalnız KDE Plasma oturumunda)	`~/.local/share/kwin/scripts/snipdeck/`

Kaldırmak için aynı klasörde ./install.sh --uninstall çalıştırın ya da paketi paket yöneticinizle kaldırın. ~/.local/share/Snipdeck altındaki snip’lerinize dokunulmaz.

Beta: Snipdeck 0.3.0, Linux’ta beta sürümdür. GNOME, KDE Plasma, Xfce, sway ve Hyprland’de denendi; neyin nerede denendiği sürüm notlarında yazıyor.

İlk açılış

Snipdeck’i uygulama menüsünden başlatın. Wayland’de genel kısayollar masaüstü portalı üzerinden bağlanır ve portal Snipdeck’i menü girdisinden tanır. Uçbirimden başlatılan Snipdeck bu adı kendisi bildirir; bunun için xdg-desktop-portal 1.19 ya da sonrası gerekir.

İlk açılışta masaüstünüz bir sistem penceresi gösterir ve kısayolları onaylamanızı ister; bir kez onaylamanız yeterli. Wayland’de ekran, ScreenCast portalı üzerinden okunur: bu izni de bir kez verirsiniz.

GNOME Shell eklentisi

Snipdeck bir GNOME Shell eklentisiyle gelir: [email protected]. install.sh onu GNOME oturumunda kurar ve etkinleştirir; paketler her kullanıcı için kurar, Snipdeck de ilk açılışta etkinleştirir. Wayland’de GNOME Shell kendini yerinde yeniden yükleyemez; eklentinin devreye girmesi için bir kez oturumu kapatıp yeniden açın.

Eklenti şunları yapar:

Snip’leri yakalandıkları yere yerleştirir ve diğer pencerelerin üstünde tutar.
Snip’leri Alt+Tab’dan, genel görünümden ve dock’tan uzak tutar.
Super+Alt + sürükle yakalama hareketini etkinleştirir (yalnız Snipdeck çalışırken). GNOME’da Super + sürükle zaten pencere taşıdığı için hareket Super+Alt iledir. Ayrıntılar için Yakalama kısayolları sayfasına bakın.

Eklentiyi kapatırsanız Snipdeck onu kapalı bırakır.

KDE Plasma

KDE Plasma’da aynı işi bir KWin betiği yapar: snip’leri diğer pencerelerin üstünde tutar, yakalandıkları yere yerleştirir, tüm masaüstlerinde gösterir ve görev çubuğundan uzak tutar. Snipdeck ilk açılışta betiği etkinleştirir; oturumu yeniden açmanız gerekmez.

X11 masaüstleri

X11’de (Xfce, MATE, Cinnamon, Xorg üzerinde GNOME) pencere yöneticisi snip’leri üstte ve görev çubuğunun dışında tutar; ek bir şey gerekmez.

sway, Hyprland ve diğer wlroots masaüstleri

Yakalama, OCR ve tepsi çalışır. Snip döşenmiş pencerelerin üstünde yüzer, ama yakalandığı bölgenin üzerinde değil, masaüstünün koyduğu yerde açılır.

Genel kısayollar masaüstünün kendi ayarlarında bağlanır:

sway’in genel kısayol portalı yok. Bir tuşu snipdeck --action snip komutuna bağlayın; diğer eylemler snip-to-clipboard, clipboard-only, toggle-visibility ve gallery.
Hyprland, Snipdeck’in kısayollarını hyprctl globalshortcuts ile listeler; birini örneğin bind = CTRL ALT SHIFT, A, global, com.revisetouch.Snipdeck:snip ile bağlayın.

GNOME dışında değiştirici + sürükle hareketi yoktur: bunun için genel bir işaretçi kancası gerekir ve Linux bunu ancak /dev/input okunarak, yani sistem genelinde tuş kaydına izin vererek sağlar; Snipdeck bunu istemez.

İlk açılış sonrası: tepsi

Snipdeck tepside yaşar: ana pencereyi kapattığınızda uygulama çalışmaya devam eder ve yakalamaya hazırdır. Menü için tepsi simgesine sağ tıklayın:

Tepsi menüsü	Ne yapar
Snipdeck’i Göster	Galeri penceresini öne getirir
Yeni snip	Bir yakalama başlatır (Windows’ta sonraki sürükleme snip olur; Linux’ta ekran donar ve bölgeyi seçersiniz)
Oturum açılınca başlat	Oturum açılınca başlatmayı açıp kapatır; onay işareti mevcut durumu gösterir
Yönetici olarak çalıştır	Yalnız Windows: yönetici yetkili pencereleri yakalayabilmek için Snipdeck’i UAC ile yeniden başlatır
Çıkış	Snipdeck’ten tamamen çıkar

Snipdeck tek kopya olarak çalışır: yeniden başlatmak (Linux’ta uygulama menüsünden yeniden açmak) ikinci bir kopya açmaz, mevcut pencereyi öne getirir.

Devam etmek için İlk adımlar ve Yakalama kısayolları sayfalarına bakın.

Verilerinizin tutulduğu yer

Snipdeck, ayarlarını ve snip verilerini kullanıcıya özel standart klasörlerde tutar. Bu klasörler ilk çalıştırmada oluşturulur.

	Windows	Linux
Ayarlar	`%APPDATA%\Snipdeck\settings.json`	`~/.config/Snipdeck/settings.json`
Snip veritabanı ve görüntüler	`%LOCALAPPDATA%\Snipdeck\` (`snips.db`, `cache\`)	`~/.local/share/Snipdeck/` (`snips.db`, `cache/`)
Kaydet için varsayılan klasör	`Resimler\Snipdeck\`	Resimler klasörünüz altında `Snipdeck/`

Düzenleyebileceğiniz ayar anahtarları için Ayarlar sayfasına bakın.

Kaynaktan derleme

Snipdeck kararlı (stable) Rust ile derlenir. Gereksinimler: Rust ve Git.

git clone https://github.com/ReviseTouch/snipdeck.git
cd snipdeck
cargo build --release

Windows (10 veya 11): derlenen dosya target\release\snipdeck.exe konumundadır. Releases’teki taşınabilir .exe ile aynıdır; istediğiniz yere kopyalayıp çalıştırabilirsiniz.

Linux: derleme için GTK, X11/Wayland, tepsi, D-Bus ve GL geliştirme başlıkları gerekir. Debian/Ubuntu’da:

sudo apt install libgtk-3-dev libxcb1-dev libxcb-render0-dev libxcb-shape0-dev \
  libxcb-xfixes0-dev libxcb-randr0-dev libxrandr-dev libxkbcommon-dev \
  libwayland-dev libayatana-appindicator3-dev libfontconfig-dev libdbus-1-dev \
  libgl1-mesa-dev libegl1-mesa-dev

PipeWire derleme sırasında gerekmez; Wayland’de ekran yakalamak için çalışma sırasında yüklenir. Derlediğiniz sürümü bir yayın sürümüyle aynı biçimde (menü girdisi, simge ve GNOME eklentisiyle birlikte) kurmak için:

packaging/linux/install-from-source.sh

Betik derler, dosyaları her seferinde baştan hazırlar ve install.sh’i çalıştırır. --uninstall seçeneğini install.sh’e iletir.

Oturum açılınca başlatma

Snipdeck, oturum açtığınızda kendiliğinden başlayabilir. Tepsi menüsünden ya da galerideki ⋯ → Oturum açılınca başlat seçeneğinden açın. Bu şekilde başlayan Snipdeck pencere açmaz, tepside bekler; tepsi, kısayol tuşları ya da uygulamayı yeniden açmak pencereyi getirir.

Nasıl çalışır

Her iki platformda da başlatma bir dosyayla yapılır ve Snipdeck --autostart bağımsız değişkeniyle başlatılır:

Platform	Dosya
Windows	`%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\Snipdeck.lnk`
Linux	`~/.config/autostart/com.revisetouch.Snipdeck.desktop` (XDG autostart girdisi)

Windows’ta Snipdeck, HKCU\…\CurrentVersion\Run altına değer yazmaz. Kayıt defterindeki Run anahtarı, antivirüs ve EDR araçlarının en sık işaretlediği otomatik başlatma yoludur; Başlangıç klasöründeki sıradan bir kısayol, Windows Ayarları’nın da yönettiği, görülebilen bir yoldur. Seçeneği kapatmak yalnızca bu dosyayı siler.

Kısayol programın mevcut konumunu gösterir. .exe dosyasını daha sonra başka bir klasöre taşırsanız seçeneği kapatıp yeniden açın.

Gizlilikle ilgili varsayılanlar için Gizlilik ve güvenlik sayfasına bakın.

Sonraki adımlar

İlk adımlar: ilk snip’inizi alın.
Yakalama kısayolları: yakalama için değiştirici tuş matrisi ve kısayol tuşları.
Ayarlar: settings.json içindeki anahtarlar ve neyi denetledikleri.
Gizlilik ve güvenlik: oturum açılınca başlatmanın nasıl çalıştığı ve yüklemelerin neden onay istediği.

Bu sayfada eksik ya da yanlış bir şey varsa [email protected] adresine yazın.