==============================================================
  STONE GUEST  -  Hızlı Başlangıç / Quick Start
==============================================================

--------------------------------------------------------------
  TÜRKÇE
--------------------------------------------------------------
Stone Guest, çalışma sırasında klavye ve fare etkinliğinizi
yalnızca bu bilgisayarda bir dosyaya kaydeder. Hiçbir veri
otomatik olarak gönderilmez; dosyayı çalışma sonunda siz
yükleme sayfasından yüklersiniz.

ADIM 1 - Kurulum (yalnızca ilk kez)
  macOS   : install_mac.command dosyasına çift tıklayın.
  Windows : install_windows.bat dosyasına çift tıklayın.
  Gerekli: Python 3.9 veya daha yenisi (yoksa kurucu kurmayı dener).
  İnternet bağlantısı yalnızca kurulum sırasında gerekir.

  macOS: dosya "açılamıyor" derse Terminal'i açın, "bash " yazın
  (sonunda boşluk), install_mac.command dosyasını Terminal
  penceresine sürükleyin ve Enter'a basın.
  macOS: kurucu iki ayar sayfasını açar. Her ikisinde de
  Terminal'i AÇIK konuma getirin:
    1. Gizlilik ve Güvenlik > Erişilebilirlik
    2. Gizlilik ve Güvenlik > Giriş İzleme (Input Monitoring)
  Windows: SmartScreen "Windows bilgisayarınızı korudu"
  derse "Ek bilgi" > "Yine de çalıştır" seçeneğini kullanın.

ADIM 2 - Başlatma
  macOS   : "Run Stone Guest.command" dosyasına çift tıklayın.
  Windows : "Run Stone Guest.bat" dosyasına çift tıklayın.
  Önce onam formu görünür, ardından bir tuşa basarak kaydın
  çalıştığını doğrularsınız. Katılımcı kodunuzu yalnızca ilk
  çalıştırmada girersiniz; sonraki oturumlarda hatırlanır.

ADIM 3 - Oturum sırasında
  Duraklatma, durdurma, görev değiştirme ve işaret tuşları
  ekranda gösterilir. Kayıt dosyaları bu klasördeki logs/
  içinde saklanır; lütfen taşımayın veya adını değiştirmeyin.

GÜNCELLEME
  Yeni bir sürüm için size küçük bir "güncelleme paketi" verilir.
  Zip'i herhangi bir yere açın ve içindeki "Update Stone Guest"
  dosyasına çift tıklayın; Stone Guest'in kurulu olduğu klasörü
  sorar. Kayıtlarınız (logs/), katılımcı kodunuz ve kurulum
  silinmez. Kurucuyu yeniden çalıştırmak da aynı işi görür.

--------------------------------------------------------------
  ENGLISH
--------------------------------------------------------------
During the study, Stone Guest records your keyboard and mouse
activity to a file on this computer only. Nothing is sent
automatically; you upload the file yourself from the upload
page when the session is over.

STEP 1 - Install (first time only)
  macOS   : double-click install_mac.command
  Windows : double-click install_windows.bat
  Needs Python 3.9 or newer (the installer tries to install it).
  An internet connection is needed only during installation.

  macOS: if the file "cannot be opened", open Terminal, type
  "bash " (with a trailing space), drag install_mac.command into
  the Terminal window and press Enter.
  macOS: the installer opens two settings pages. Switch Terminal
  ON in both of them:
    1. Privacy & Security > Accessibility
    2. Privacy & Security > Input Monitoring
  Windows: if SmartScreen says "Windows protected your PC",
  choose "More info" > "Run anyway".

STEP 2 - Start
  macOS   : double-click "Run Stone Guest.command"
  Windows : double-click "Run Stone Guest.bat"
  A consent form appears first, then you press a key to confirm
  recording works. You enter your participant code only on the
  first run; later sessions remember it.

STEP 3 - During a session
  The pause, stop, task-switch and marker hotkeys are shown on
  screen. Log files are kept in the logs/ folder here; please do
  not move or rename them.

UPDATING
  For a new version you receive a small "update package". Unzip
  it anywhere and double-click "Update Stone Guest" inside; it
  asks where Stone Guest is installed. Your recordings (logs/),
  participant code and installation are kept. Running the
  installer again does the same job.

--------------------------------------------------------------
  Sorular / Questions: see the contact in the consent form.
--------------------------------------------------------------
