volatouch 1.0.0__tar.gz

volatouch-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Uğur Türker Kebeci
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

volatouch-1.0.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include LICENSE
+include README.md
+recursive-include volatouch/web *
+recursive-include assets *

volatouch-1.0.0/PKG-INFO

@@ -0,0 +1,246 @@
+Metadata-Version: 2.4
+Name: volatouch
+Version: 1.0.0
+Summary: Ultra-low latency mobile air control & wireless trackpad for PC over local Wi-Fi.
+Home-page: https://github.com/ugurturkerkebeci/volatouch
+Author: Uğur Türker Kebeci
+Author-email: Uğur Türker Kebeci <167927605+ugurturkerkebeci@users.noreply.github.com>
+License: MIT
+Project-URL: Homepage, https://github.com/ugurturkerkebeci/volatouch
+Project-URL: Repository, https://github.com/ugurturkerkebeci/volatouch
+Project-URL: Issues, https://github.com/ugurturkerkebeci/volatouch/issues
+Keywords: remote-desktop,trackpad,air-control,mouse,keyboard,low-latency,screen-stream,fastapi,websockets
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Hardware
+Classifier: Topic :: Multimedia :: Graphics :: Capture
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.100.0
+Requires-Dist: uvicorn[standard]>=0.22.0
+Requires-Dist: websockets>=11.0
+Requires-Dist: mss>=9.0.0
+Requires-Dist: opencv-python>=4.8.0
+Requires-Dist: pynput>=1.7.6
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ugurturkerkebeci/volatouch/main/assets/banner.jpg" alt="Volatouch Banner" width="100%" />
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ugurturkerkebeci/volatouch/main/assets/logo.jpg" alt="Volatouch Logo" width="120" style="border-radius: 24px;" />
+</p>
+
+<h1 align="center">VOLATOUCH</h1>
+
+<p align="center">
+  <strong>Ultra-Low Latency Mobile Air Control & Wireless Trackpad for PC over Wi-Fi</strong>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/volatouch/"><img src="https://img.shields.io/pypi/v/volatouch.svg?color=6366f1&style=for-the-badge" alt="PyPI version" /></a>
+  <a href="https://pypi.org/project/volatouch/"><img src="https://img.shields.io/pypi/pyversions/volatouch.svg?color=06b6d4&style=for-the-badge" alt="Python Versions" /></a>
+  <a href="https://github.com/ugurturkerkebeci/volatouch/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-emerald.svg?style=for-the-badge" alt="License: MIT" /></a>
+  <a href="https://github.com/ugurturkerkebeci/volatouch/stargazers"><img src="https://img.shields.io/github/stars/ugurturkerkebeci/volatouch?style=for-the-badge&color=eab308" alt="GitHub Stars" /></a>
+  <a href="https://github.com/ugurturkerkebeci/volatouch/issues"><img src="https://img.shields.io/github/issues/ugurturkerkebeci/volatouch?style=for-the-badge&color=ec4899" alt="GitHub Issues" /></a>
+  <img src="https://img.shields.io/badge/Platform-Windows-0284c7.svg?style=for-the-badge&logo=windows" alt="Platform: Windows" />
+</p>
+
+<p align="center">
+  <a href="#-quick-start-pypi">⚡ Quick Start</a> •
+  <a href="#-key-features">✨ Features</a> •
+  <a href="#-gesture--touch-cheatsheet">📱 Gestures</a> •
+  <a href="#-architecture">🏗️ Architecture</a> •
+  <a href="#-security--sandbox">🛡️ Security</a> •
+  <a href="#-settings--diagnostics">⚙️ Settings</a> •
+  <a href="#-t%C3%BCrk%C3%A7e-rehber">🇹🇷 Türkçe Rehber</a>
+</p>
+
+---
+
+## ⚡ Quick Start (PyPI)
+
+Install and launch Volatouch with a single command from your terminal:
+
+```bash
+# 1. Install Volatouch via pip
+pip install volatouch
+
+# 2. Launch the server
+volatouch
+```
+
+Once started, the console displays your local server address (e.g., `http://192.168.1.5:8000`).  
+Open this URL in **Safari** or **Chrome** on your phone (connected to the same Wi-Fi) — **no mobile app installation required!**
+
+---
+
+## ✨ Key Features
+
+- **🚀 Ultra-Low Latency Binary Video Streaming:**
+  - Screen capture powered by `mss` delivering hardware-level **60 FPS**.
+  - Direct 4-channel BGRA JPEG compression via OpenCV (`cv2.imencode`), skipping CPU color-space conversions.
+  - Raw binary ArrayBuffer transmission over WebSockets with 8-byte high-precision double timestamp headers for sub-millisecond round-trip profiling.
+  - Zero-delay, single-slot subscriber queues (`asyncio.Queue(maxsize=1)`) prevent buffer bloat and queue lag.
+
+- **🎯 Dual Input Modes (Direct Target & Relative Trackpad):**
+  - **Direct Mode:** Tap anywhere on your phone's screen to navigate the cursor directly to that coordinate on your desktop display.
+  - **Relative Trackpad Mode:** Precision multi-touch trackpad navigation with acceleration and configurable sensitivity.
+
+- **🏝️ Draggable Floating Action Island:**
+  - **L-Click / R-Click:** Dedicated, ergonomic primary action buttons.
+  - **Hold / Drag Lock:** One-tap persistent mouse hold with tactile haptic feedback for window movement and drag-and-drop.
+  - **Scroll Up / Down:** Instant micro-step vertical scrolling without needing two-finger gestures.
+  - **Collapsible Mini-Pill:** Compact mode keeps 100% of your screen visible when not interacting.
+  - **Auto Boundary Clamping:** Widgets automatically re-align to stay safely within the viewport across orientation changes and fullscreen toggles.
+
+- **⌨️ Comprehensive Built-In Virtual Keyboard:**
+  - Full **QWERTY layout** with smart dynamic Caps / Shift character switching.
+  - **Sticky Modifier Keys:** `Ctrl`, `Shift`, `Alt`, and `Win (Super)` lock on tap (highlighted in indigo) for seamless desktop combos (e.g., `Ctrl` + `C`).
+  - Dedicated **F1–F12 function row**, navigation keys (`Esc`, `Tab`, `Home`, `End`, Arrows), and **Voice / Text input drawer**.
+
+- **📱 Landscape Edge-to-Edge Fill Mode:**
+  - Switch between **Fit (Aspect Ratio)** and **Fill (Full Screen Stretch)** modes to eliminate black side bars on widescreen mobile displays.
+
+- **🌐 Bilingual UI (English & Türkçe):**
+  - Instant toggle between English and Turkish directly from Settings, remembered via `localStorage`.
+
+---
+
+## 📱 Gesture & Touch Cheatsheet
+
+| Gesture / Action | Relative Mode | Direct Mode |
+| :--- | :--- | :--- |
+| **1-Finger Drag** | Relative Mouse Cursor Movement | Direct Mouse Cursor Positioning |
+| **1-Finger Tap** | Left Click (Mouse 1) | Left Click at Tap Point |
+| **2-Finger Tap** | Right Click (Mouse 2) | Right Click at Tap Point |
+| **2-Finger Scroll** | Smooth Vertical Mouse Wheel Scroll | Smooth Vertical Mouse Wheel Scroll |
+| **Long Press (>350ms)** | Drag & Drop (Left Mouse Down) | Drag & Drop at Point |
+| **Island `[ HOLD ]`** | Toggles Left Button Lock | Toggles Left Button Lock |
+| **Island `[ UP/DOWN ]`**| Mouse Scroll Wheel Increment | Mouse Scroll Wheel Increment |
+
+---
+
+## 🏗️ Architecture
+
+```mermaid
+flowchart TD
+    subgraph Host ["Desktop Host (Windows)"]
+        MSS["mss (Screen Capture 60 FPS)"] --> BGRA["Direct BGRA Frame (No cvtColor)"]
+        BGRA --> CV2["cv2.imencode (JPEG Compression)"]
+        CV2 --> TIME["Timestamp Header (8-Byte Double)"]
+        TIME --> ASYNC["Zero-Copy Queue (asyncio.Queue)"]
+        ASYNC --> WS_STREAM["/ws/stream (Binary WebSocket)"]
+        
+        WS_INPUT["/ws/input (JSON WebSocket)"] --> CTRL["InputController (pynput)"]
+        CTRL --> OS_INPUT["Windows OS Hardware Emulation"]
+    end
+
+    subgraph Client ["Mobile Client (Browser / PWA)"]
+        WS_STREAM --> BITMAP["createImageBitmap (Worker-like GPU decode)"]
+        BITMAP --> RAF["requestAnimationFrame() -> HTML5 Canvas"]
+        
+        TOUCH["Multi-Touch Engine (Direct & Relative)"] --> WS_INPUT
+        KB["Virtual Keyboard & Sticky Modifiers"] --> WS_INPUT
+        ACTIONS["Floating Island (Click, Hold, Scroll)"] --> WS_INPUT
+    end
+```
+
+---
+
+## 🛡️ Security & Sandbox
+
+Volatouch implements defense-in-depth security to protect your workstation on shared Wi-Fi networks:
+
+1. **Subnet Verification (RFC-1918):** Only clients within the identical `/24` private local subnet as the host machine can access endpoints or initiate WebSocket handshakes. External and non-local requests receive an immediate `403 Forbidden`.
+2. **Strict Origin & CSP Isolation:** Rejects unauthorized origin headers; enforces modern `Content-Security-Policy`, `X-Frame-Options: DENY`, and strict frame-ancestors restrictions.
+3. **Whitelisted Hardware Commands:** Only explicit, sanitized commands (`mouse_move`, `mouse_click`, `key_tap`, etc.) are processed. Arbitrary shell commands are impossible.
+4. **Failsafe Key Release:** Whenever a WebSocket connection drops, all pressed keys and mouse buttons are instantly released via `input_ctrl.release_all()` to prevent stuck keys on your PC.
+5. **Private Console Telemetry:** No third-party tracking, no external web calls, and silenced debug logs. The host console only shows an active connection counter.
+
+---
+
+## ⚙️ Settings & Diagnostics
+
+Tap the floating gear icon to access:
+- **JPEG Quality Slider (15% – 95%):** Dynamically tune bandwidth usage vs. visual clarity in real time.
+- **Resolution Scale Slider (30% – 100%):** Downscale resolution for ultra-high FPS over congested Wi-Fi channels.
+- **Cursor Speed & Acceleration:** Fine-tune trackpad velocity and exponential sensitivity curves.
+- **Real-time Latency & FPS Badge:** Monitor live stream frame rates and hardware round-trip ping in milliseconds.
+- **Language Selector:** Seamlessly switch between **English** and **Türkçe**.
+
+---
+
+## 💻 Running From Source
+
+If you prefer building and developing Volatouch locally:
+
+### Prerequisites
+- Python 3.8+ (Recommended: Python 3.10+)
+- Node.js 18+ (for building the frontend)
+
+### Setup
+
+```bash
+# 1. Clone repository
+git clone https://github.com/ugurturkerkebeci/volatouch.git
+cd volatouch
+
+# 2. Install Python dependencies
+pip install -r backend/requirements.txt
+
+# 3. Build React frontend
+cd frontend
+npm install
+npm run build
+cd ..
+
+# 4. Run application
+python run.py
+```
+
+---
+
+## 🇹🇷 Türkçe Rehber
+
+Volatouch, aynı yerel Wi-Fi ağına bağlı bilgisayarınızı mobil cihazınızın web tarayıcısı üzerinden sıfıra yakın gecikmeyle (ultra-low latency) yönetmenizi sağlayan yüksek performanslı bir uzaktan kontrol ve hava trackpad sistemidir.
+
+### Hızlı Kurulum (PyPI):
+```bash
+pip install volatouch
+volatouch
+```
+Konsolda yazan adresi (örn. `http://192.168.1.5:8000`) telefonunuzun tarayıcısında açmanız yeterlidir.
+
+### Başlıca Özellikler:
+- **Sıfır Gecikme:** `mss` ve `OpenCV` tabanlı binary JPEG akışı, doğrudan GPU'da çizilen HTML5 Canvas ile tear veya kare düşmesi yaşatmaz.
+- **Doğrudan ve Bağıl Mod:** İster ekrana dokunup imleci doğrudan oraya yönlendirin (Direct), ister dizüstü bilgisayar trackpad'i gibi kullanın (Relative).
+- **Yüzen Fonksiyon Adası:** Sol tık, sağ tık, dosya sürüklemek için sol tık kilidi (`HOLD`), ve hassas kaydırma (`UP`/`DOWN`) butonları.
+- **Dahili Türkçe/İngilizce QWERTY Klavye:** `Ctrl`, `Alt`, `Shift` gibi niteleyici tuşları basılı tutma desteği, F1–F12 tuşları ve ses/metin aktarım çekmecesi.
+- **Yerel Ağ Güvenliği:** Yalnızca aynı yerel Wi-Fi alt ağındaki (subnet) cihazların bağlanmasına izin verir.
+
+---
+
+## 📄 License
+
+Distributed under the **MIT License**. See [`LICENSE`](./LICENSE) for full details.
+
+---
+
+<p align="center">
+  Crafted with ❤️ by <a href="https://github.com/ugurturkerkebeci">Uğur Türker Kebeci</a>
+</p>

volatouch-1.0.0/README.md

@@ -0,0 +1,207 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ugurturkerkebeci/volatouch/main/assets/banner.jpg" alt="Volatouch Banner" width="100%" />
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ugurturkerkebeci/volatouch/main/assets/logo.jpg" alt="Volatouch Logo" width="120" style="border-radius: 24px;" />
+</p>
+
+<h1 align="center">VOLATOUCH</h1>
+
+<p align="center">
+  <strong>Ultra-Low Latency Mobile Air Control & Wireless Trackpad for PC over Wi-Fi</strong>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/volatouch/"><img src="https://img.shields.io/pypi/v/volatouch.svg?color=6366f1&style=for-the-badge" alt="PyPI version" /></a>
+  <a href="https://pypi.org/project/volatouch/"><img src="https://img.shields.io/pypi/pyversions/volatouch.svg?color=06b6d4&style=for-the-badge" alt="Python Versions" /></a>
+  <a href="https://github.com/ugurturkerkebeci/volatouch/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-emerald.svg?style=for-the-badge" alt="License: MIT" /></a>
+  <a href="https://github.com/ugurturkerkebeci/volatouch/stargazers"><img src="https://img.shields.io/github/stars/ugurturkerkebeci/volatouch?style=for-the-badge&color=eab308" alt="GitHub Stars" /></a>
+  <a href="https://github.com/ugurturkerkebeci/volatouch/issues"><img src="https://img.shields.io/github/issues/ugurturkerkebeci/volatouch?style=for-the-badge&color=ec4899" alt="GitHub Issues" /></a>
+  <img src="https://img.shields.io/badge/Platform-Windows-0284c7.svg?style=for-the-badge&logo=windows" alt="Platform: Windows" />
+</p>
+
+<p align="center">
+  <a href="#-quick-start-pypi">⚡ Quick Start</a> •
+  <a href="#-key-features">✨ Features</a> •
+  <a href="#-gesture--touch-cheatsheet">📱 Gestures</a> •
+  <a href="#-architecture">🏗️ Architecture</a> •
+  <a href="#-security--sandbox">🛡️ Security</a> •
+  <a href="#-settings--diagnostics">⚙️ Settings</a> •
+  <a href="#-t%C3%BCrk%C3%A7e-rehber">🇹🇷 Türkçe Rehber</a>
+</p>
+
+---
+
+## ⚡ Quick Start (PyPI)
+
+Install and launch Volatouch with a single command from your terminal:
+
+```bash
+# 1. Install Volatouch via pip
+pip install volatouch
+
+# 2. Launch the server
+volatouch
+```
+
+Once started, the console displays your local server address (e.g., `http://192.168.1.5:8000`).  
+Open this URL in **Safari** or **Chrome** on your phone (connected to the same Wi-Fi) — **no mobile app installation required!**
+
+---
+
+## ✨ Key Features
+
+- **🚀 Ultra-Low Latency Binary Video Streaming:**
+  - Screen capture powered by `mss` delivering hardware-level **60 FPS**.
+  - Direct 4-channel BGRA JPEG compression via OpenCV (`cv2.imencode`), skipping CPU color-space conversions.
+  - Raw binary ArrayBuffer transmission over WebSockets with 8-byte high-precision double timestamp headers for sub-millisecond round-trip profiling.
+  - Zero-delay, single-slot subscriber queues (`asyncio.Queue(maxsize=1)`) prevent buffer bloat and queue lag.
+
+- **🎯 Dual Input Modes (Direct Target & Relative Trackpad):**
+  - **Direct Mode:** Tap anywhere on your phone's screen to navigate the cursor directly to that coordinate on your desktop display.
+  - **Relative Trackpad Mode:** Precision multi-touch trackpad navigation with acceleration and configurable sensitivity.
+
+- **🏝️ Draggable Floating Action Island:**
+  - **L-Click / R-Click:** Dedicated, ergonomic primary action buttons.
+  - **Hold / Drag Lock:** One-tap persistent mouse hold with tactile haptic feedback for window movement and drag-and-drop.
+  - **Scroll Up / Down:** Instant micro-step vertical scrolling without needing two-finger gestures.
+  - **Collapsible Mini-Pill:** Compact mode keeps 100% of your screen visible when not interacting.
+  - **Auto Boundary Clamping:** Widgets automatically re-align to stay safely within the viewport across orientation changes and fullscreen toggles.
+
+- **⌨️ Comprehensive Built-In Virtual Keyboard:**
+  - Full **QWERTY layout** with smart dynamic Caps / Shift character switching.
+  - **Sticky Modifier Keys:** `Ctrl`, `Shift`, `Alt`, and `Win (Super)` lock on tap (highlighted in indigo) for seamless desktop combos (e.g., `Ctrl` + `C`).
+  - Dedicated **F1–F12 function row**, navigation keys (`Esc`, `Tab`, `Home`, `End`, Arrows), and **Voice / Text input drawer**.
+
+- **📱 Landscape Edge-to-Edge Fill Mode:**
+  - Switch between **Fit (Aspect Ratio)** and **Fill (Full Screen Stretch)** modes to eliminate black side bars on widescreen mobile displays.
+
+- **🌐 Bilingual UI (English & Türkçe):**
+  - Instant toggle between English and Turkish directly from Settings, remembered via `localStorage`.
+
+---
+
+## 📱 Gesture & Touch Cheatsheet
+
+| Gesture / Action | Relative Mode | Direct Mode |
+| :--- | :--- | :--- |
+| **1-Finger Drag** | Relative Mouse Cursor Movement | Direct Mouse Cursor Positioning |
+| **1-Finger Tap** | Left Click (Mouse 1) | Left Click at Tap Point |
+| **2-Finger Tap** | Right Click (Mouse 2) | Right Click at Tap Point |
+| **2-Finger Scroll** | Smooth Vertical Mouse Wheel Scroll | Smooth Vertical Mouse Wheel Scroll |
+| **Long Press (>350ms)** | Drag & Drop (Left Mouse Down) | Drag & Drop at Point |
+| **Island `[ HOLD ]`** | Toggles Left Button Lock | Toggles Left Button Lock |
+| **Island `[ UP/DOWN ]`**| Mouse Scroll Wheel Increment | Mouse Scroll Wheel Increment |
+
+---
+
+## 🏗️ Architecture
+
+```mermaid
+flowchart TD
+    subgraph Host ["Desktop Host (Windows)"]
+        MSS["mss (Screen Capture 60 FPS)"] --> BGRA["Direct BGRA Frame (No cvtColor)"]
+        BGRA --> CV2["cv2.imencode (JPEG Compression)"]
+        CV2 --> TIME["Timestamp Header (8-Byte Double)"]
+        TIME --> ASYNC["Zero-Copy Queue (asyncio.Queue)"]
+        ASYNC --> WS_STREAM["/ws/stream (Binary WebSocket)"]
+        
+        WS_INPUT["/ws/input (JSON WebSocket)"] --> CTRL["InputController (pynput)"]
+        CTRL --> OS_INPUT["Windows OS Hardware Emulation"]
+    end
+
+    subgraph Client ["Mobile Client (Browser / PWA)"]
+        WS_STREAM --> BITMAP["createImageBitmap (Worker-like GPU decode)"]
+        BITMAP --> RAF["requestAnimationFrame() -> HTML5 Canvas"]
+        
+        TOUCH["Multi-Touch Engine (Direct & Relative)"] --> WS_INPUT
+        KB["Virtual Keyboard & Sticky Modifiers"] --> WS_INPUT
+        ACTIONS["Floating Island (Click, Hold, Scroll)"] --> WS_INPUT
+    end
+```
+
+---
+
+## 🛡️ Security & Sandbox
+
+Volatouch implements defense-in-depth security to protect your workstation on shared Wi-Fi networks:
+
+1. **Subnet Verification (RFC-1918):** Only clients within the identical `/24` private local subnet as the host machine can access endpoints or initiate WebSocket handshakes. External and non-local requests receive an immediate `403 Forbidden`.
+2. **Strict Origin & CSP Isolation:** Rejects unauthorized origin headers; enforces modern `Content-Security-Policy`, `X-Frame-Options: DENY`, and strict frame-ancestors restrictions.
+3. **Whitelisted Hardware Commands:** Only explicit, sanitized commands (`mouse_move`, `mouse_click`, `key_tap`, etc.) are processed. Arbitrary shell commands are impossible.
+4. **Failsafe Key Release:** Whenever a WebSocket connection drops, all pressed keys and mouse buttons are instantly released via `input_ctrl.release_all()` to prevent stuck keys on your PC.
+5. **Private Console Telemetry:** No third-party tracking, no external web calls, and silenced debug logs. The host console only shows an active connection counter.
+
+---
+
+## ⚙️ Settings & Diagnostics
+
+Tap the floating gear icon to access:
+- **JPEG Quality Slider (15% – 95%):** Dynamically tune bandwidth usage vs. visual clarity in real time.
+- **Resolution Scale Slider (30% – 100%):** Downscale resolution for ultra-high FPS over congested Wi-Fi channels.
+- **Cursor Speed & Acceleration:** Fine-tune trackpad velocity and exponential sensitivity curves.
+- **Real-time Latency & FPS Badge:** Monitor live stream frame rates and hardware round-trip ping in milliseconds.
+- **Language Selector:** Seamlessly switch between **English** and **Türkçe**.
+
+---
+
+## 💻 Running From Source
+
+If you prefer building and developing Volatouch locally:
+
+### Prerequisites
+- Python 3.8+ (Recommended: Python 3.10+)
+- Node.js 18+ (for building the frontend)
+
+### Setup
+
+```bash
+# 1. Clone repository
+git clone https://github.com/ugurturkerkebeci/volatouch.git
+cd volatouch
+
+# 2. Install Python dependencies
+pip install -r backend/requirements.txt
+
+# 3. Build React frontend
+cd frontend
+npm install
+npm run build
+cd ..
+
+# 4. Run application
+python run.py
+```
+
+---
+
+## 🇹🇷 Türkçe Rehber
+
+Volatouch, aynı yerel Wi-Fi ağına bağlı bilgisayarınızı mobil cihazınızın web tarayıcısı üzerinden sıfıra yakın gecikmeyle (ultra-low latency) yönetmenizi sağlayan yüksek performanslı bir uzaktan kontrol ve hava trackpad sistemidir.
+
+### Hızlı Kurulum (PyPI):
+```bash
+pip install volatouch
+volatouch
+```
+Konsolda yazan adresi (örn. `http://192.168.1.5:8000`) telefonunuzun tarayıcısında açmanız yeterlidir.
+
+### Başlıca Özellikler:
+- **Sıfır Gecikme:** `mss` ve `OpenCV` tabanlı binary JPEG akışı, doğrudan GPU'da çizilen HTML5 Canvas ile tear veya kare düşmesi yaşatmaz.
+- **Doğrudan ve Bağıl Mod:** İster ekrana dokunup imleci doğrudan oraya yönlendirin (Direct), ister dizüstü bilgisayar trackpad'i gibi kullanın (Relative).
+- **Yüzen Fonksiyon Adası:** Sol tık, sağ tık, dosya sürüklemek için sol tık kilidi (`HOLD`), ve hassas kaydırma (`UP`/`DOWN`) butonları.
+- **Dahili Türkçe/İngilizce QWERTY Klavye:** `Ctrl`, `Alt`, `Shift` gibi niteleyici tuşları basılı tutma desteği, F1–F12 tuşları ve ses/metin aktarım çekmecesi.
+- **Yerel Ağ Güvenliği:** Yalnızca aynı yerel Wi-Fi alt ağındaki (subnet) cihazların bağlanmasına izin verir.
+
+---
+
+## 📄 License
+
+Distributed under the **MIT License**. See [`LICENSE`](./LICENSE) for full details.
+
+---
+
+<p align="center">
+  Crafted with ❤️ by <a href="https://github.com/ugurturkerkebeci">Uğur Türker Kebeci</a>
+</p>

volatouch-1.0.0/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "volatouch"
+version = "1.0.0"
+description = "Ultra-low latency mobile air control & wireless trackpad for PC over local Wi-Fi."
+readme = "README.md"
+authors = [
+    { name = "Uğur Türker Kebeci", email = "167927605+ugurturkerkebeci@users.noreply.github.com" }
+]
+license = { text = "MIT" }
+keywords = ["remote-desktop", "trackpad", "air-control", "mouse", "keyboard", "low-latency", "screen-stream", "fastapi", "websockets"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: System :: Hardware",
+    "Topic :: Multimedia :: Graphics :: Capture",
+]
+requires-python = ">=3.8"
+dependencies = [
+    "fastapi>=0.100.0",
+    "uvicorn[standard]>=0.22.0",
+    "websockets>=11.0",
+    "mss>=9.0.0",
+    "opencv-python>=4.8.0",
+    "pynput>=1.7.6",
+]
+
+[project.urls]
+Homepage = "https://github.com/ugurturkerkebeci/volatouch"
+Repository = "https://github.com/ugurturkerkebeci/volatouch"
+Issues = "https://github.com/ugurturkerkebeci/volatouch/issues"
+
+[project.scripts]
+volatouch = "volatouch.cli:main"
+
+[tool.setuptools]
+packages = ["volatouch"]
+
+[tool.setuptools.package-data]
+volatouch = ["web/**/*", "web/*"]

volatouch-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

volatouch-1.0.0/setup.py

@@ -0,0 +1,54 @@
+from setuptools import setup, find_packages
+import os
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="volatouch",
+    version="1.0.0",
+    author="Uğur Türker Kebeci",
+    author_email="167927605+ugurturkerkebeci@users.noreply.github.com",
+    description="Ultra-low latency mobile air control & wireless trackpad for PC over local Wi-Fi.",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/ugurturkerkebeci/volatouch",
+    project_urls={
+        "Bug Tracker": "https://github.com/ugurturkerkebeci/volatouch/issues",
+        "Source Code": "https://github.com/ugurturkerkebeci/volatouch",
+    },
+    packages=find_packages(include=["volatouch", "volatouch.*"]),
+    package_data={
+        "volatouch": ["web/**/*", "web/*"],
+    },
+    include_package_data=True,
+    classifiers=[
+        "Development Status :: 5 - Production/Stable",
+        "Intended Audience :: Developers",
+        "Intended Audience :: End Users/Desktop",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: Microsoft :: Windows",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Topic :: System :: Hardware",
+        "Topic :: Multimedia :: Graphics :: Capture",
+    ],
+    python_requires=">=3.8",
+    install_requires=[
+        "fastapi>=0.100.0",
+        "uvicorn[standard]>=0.22.0",
+        "websockets>=11.0",
+        "mss>=9.0.0",
+        "opencv-python>=4.8.0",
+        "pynput>=1.7.6",
+    ],
+    entry_points={
+        "console_scripts": [
+            "volatouch=volatouch.cli:main",
+        ],
+    },
+)

volatouch-1.0.0/volatouch/__init__.py

@@ -0,0 +1,7 @@
+"""
+Volatouch: Ultra-low latency mobile air control & wireless trackpad for PC over local Wi-Fi.
+"""
+
+__version__ = "1.0.0"
+__author__ = "Uğur Türker Kebeci"
+__license__ = "MIT"

volatouch-1.0.0/volatouch/__main__.py

@@ -0,0 +1,4 @@
+from volatouch.cli import main
+
+if __name__ == "__main__":
+    main()

volatouch-1.0.0/volatouch/cli.py

@@ -0,0 +1,19 @@
+import argparse
+import sys
+import uvicorn
+from volatouch.config import config, LOCAL_IP
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="volatouch",
+        description="Volatouch: Zero-Latency Mobile Air Control & Remote Trackpad for PC over local Wi-Fi."
+    )
+    parser.add_argument("--host", default=config.host, help=f"Host interface to bind (default: {config.host})")
+    parser.add_argument("--port", type=int, default=config.port, help=f"Port to listen on (default: {config.port})")
+    parser.add_argument("--version", action="version", version="%(prog)s 1.0.0")
+    args = parser.parse_args()
+
+    uvicorn.run("volatouch.main:app", host=args.host, port=args.port, log_level="warning", access_log=False)
+
+if __name__ == "__main__":
+    main()

volatouch-1.0.0/volatouch/config.py

@@ -0,0 +1,26 @@
+import socket
+from dataclasses import dataclass
+
+def get_local_ip() -> str:
+    """Attempts to find the LAN IP address of this machine."""
+    try:
+        s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+        # Does not actually create a connection, just gets outbound interface
+        s.connect(("8.8.8.8", 80))
+        ip = s.getsockname()[0]
+        s.close()
+        return ip
+    except Exception:
+        return "127.0.0.1"
+
+@dataclass
+class StreamConfig:
+    host: str = "0.0.0.0"
+    port: int = 8000
+    default_quality: int = 55       # JPEG quality (10-100)
+    default_scale: float = 0.70     # Resolution scale (0.3 - 1.0)
+    target_fps: int = 60            # Maximum capture rate
+    monitor_index: int = 1          # Primary monitor in mss
+
+config = StreamConfig()
+LOCAL_IP = get_local_ip()