PUZZLE·CAM
Elinle çek, elinle çöz.  /  Shoot by hand, solve by hand.
==========================================================


TÜRKÇE
------

NASIL ÇALIŞTIRILIR

  Windows        : start.bat dosyasına çift tıkla
  Linux / macOS  : start.sh dosyasına çift tıkla
                   (açılmazsa terminalde:  bash start.sh)

Tarayıcın kendiliğinden açılır. Kamera izni istendiğinde "izin ver" de.
Durdurmak için açılan siyah terminal penceresini kapat.


NEDEN index.html'i DOĞRUDAN AÇAMIYORUM?

Tarayıcılar kamerayı yalnızca güvenli adresten gelen sayfalara verir. Dosyayı
çift tıklayınca adres file:// olur, kamera izni hiç sorulmaz. start dosyası
klasörü küçük bir yerel adres (127.0.0.1) olarak yayınlar — orası güvenli
sayılır. Dışarıya hiçbir şey açılmaz, internet kullanılmaz.


NASIL OYNANIR

  1. İki elinle aynı anda çimdik yap (başparmak + işaret parmağı)
     → geri sayım başlar, fotoğrafın çekilir ve parçalara ayrılır
  2. Tek elle çimdikleyip parçayı yerine sürükle
     → doğru yere yaklaşınca kendi kendine oturur
  3. Puzzle bitince yumruk yap → şeride kaydedilir
     3 puzzle biriktir, "şeridi indir" ile tek PNG olarak al

Kameran yoksa: yükleme ekranında "kamerasız devam et" düğmesi çıkar.
Sonrasında SPACE fotoğraf çeker, fareyle parça sürüklersin, R kaydeder/sıfırlar.

Sağdaki panelden zorluk (3×3 / 4×4 / 5×5), filtre ve dil değiştirilir.


BİLİNMESİ GEREKENLER

- İlk açılışta el takibi modeli internetten indirilir (birkaç MB, bir kereliğine).
  Tamamen çevrimdışı bir kurulum istiyorsan modeli yerele almak gerekir.
- Jest eşiği uzaklığa duyarlı: kameraya çok yakınsan çimdik zorlaşır,
  uzaklaşınca kolaylaşır. Bir adım geri çekilmek genelde işe yarar.
- Işık yetersizse el takibi zorlanır.
- Gereken: güncel Chrome, Edge veya Firefox + Python 3.


LİSANS

MIT. Ayrıntı: LICENSE ve NOTICE.md dosyaları.


==========================================================


ENGLISH
-------

HOW TO RUN

  Windows        : double-click start.bat
  Linux / macOS  : double-click start.sh
                   (if that does nothing, run:  bash start.sh)

Your browser opens on its own. Allow camera access when asked.
To stop, close the black terminal window that opened.


WHY CAN'T I OPEN index.html DIRECTLY?

Browsers only hand the camera to pages served from a secure address. Opening
the file directly gives you a file:// address, which never gets a camera
prompt. The start file serves this folder at a small local address (127.0.0.1),
which does count as secure. Nothing is exposed to the network and no internet
connection is used.


HOW TO PLAY

  1. Pinch with BOTH hands at once (thumb + index finger)
     → a countdown starts, your photo is taken and cut into pieces
  2. Pinch with one hand to drag a piece into place
     → it snaps once it is close enough
  3. Make a fist when the puzzle is done → it is saved to the strip
     Collect 3 puzzles, then "download strip" gives you a single PNG

No camera? The loading screen offers a "continue without camera" button.
Then SPACE takes the photo, the mouse drags pieces, R saves or resets.

The side panel changes difficulty (3×3 / 4×4 / 5×5), filter and language.


GOOD TO KNOW

- On first run the hand-tracking model is downloaded (a few MB, once).
  A fully offline setup would require vendoring the model locally.
- Pinch sensitivity depends on distance: very close to the camera it gets
  harder, further away it gets easier. Stepping back usually helps.
- Poor lighting makes hand tracking struggle.
- You need: a current Chrome, Edge or Firefox + Python 3.


LICENSE

MIT. See the LICENSE and NOTICE.md files.
