Pentab (Android Client)

Turn your Android tablet into a high-precision wireless trackpad & pen tablet for Windows PC

English | 日本語 | 简体中文

PC Server (Pentab_server) | Releases | Technical Docs

---

---

🌟 Key Features

• ⚡ Ultra-Low Latency & High Rate: Powered by RFC 6455 WebSocket streaming, supporting up to 120Hz〜240Hz polling rates.
• 🖊️ Precision Stylus & Pressure Support: Captures pen coordinates, pressure levels, and tilt in real time for direct PC streaming.
• 🖱️ Windows Precision Touchpad Gestures:
  • 1-Finger Tap: Left Click
  • 1-Finger Swipe: Smooth cursor motion (1px precision on micro-movements, smooth acceleration on flicks)
  • 1-Finger Double-Tap & Swipe: Left Drag (Window drag, text selection)
  • 2-Finger Tap: Right Click (Context menu)
  • 2-Finger Vertical Scroll: Smooth mouse wheel scrolling
  • 3-Finger Tap: Middle Click (Wheel click)
• 🎛️ Freely Positionable Floating Toolbar:
  • Drag and place anywhere on screen with Left/Right/Bottom snap presets
  • Vertical ↔ Horizontal orientation switcher
  • Left Click (Hold to drag), Right Click, Drag Lock, Clear Canvas
• 📐 PC Screen Mapping & Aspect Ratio Customization:
  • Aspect ratio presets: 16:9, 16:10, 21:9, 4:3
  • Custom margin sliders to perfectly align drawing active areas with your monitor
• 🔌 USB (ADB) & Wi-Fi Dual Connection:
  • USB wired connection (adb reverse) for minimal latency (< 2ms)
  • Wi-Fi wireless connection over local network

---

📸 Application Screenshots

Android Tablet Canvas & Floating Toolbar Interface

---

🚀 Quick Start

1. Start PC Server

Run Pentab_server on your Windows PC.

2. Install Android App

Download the latest app-debug.apk from Releases and install it on your tablet.

3. Connection Setup

A. USB Connection (Recommended · Lowest Latency)

1. Enable "USB Debugging" in Developer Options on your tablet and connect via USB.
2. Run the following command in PowerShell / CMD on PC:

   adb reverse tcp:8765 tcp:8765

3. Open Pentab on your tablet, keep IP as 127.0.0.1:8765, and tap "Connect".

B. Wi-Fi Wireless Connection

1. Connect both PC and tablet to the same Wi-Fi router (LAN).
2. Enter the local IP address shown on the PC server window (e.g. 192.168.1.50) and tap "Connect".

---

🖐️ Gesture Reference

Gesture	Action
1-Finger Tap	Left Click
1-Finger Swipe	Cursor Movement (Accurate micro-control & velocity acceleration)
1-Finger Double-Tap & Swipe	Left Drag (Move windows, select text)
2-Finger Tap	Right Click (Context menu)
2-Finger Vertical Swipe	Mouse Wheel Scroll
3-Finger Tap	Middle Click
Toolbar [Left Click]	Single tap for Left Click / Hold while swiping with other finger to drag
Toolbar [Right Click]	Right Click
Toolbar [Lock]	Lock / Unlock continuous Left Drag state
Mode Switch [Trackpad / Pen]	Switch between Relative Trackpad mode & Absolute Pen Tablet mode

---

🛠️ Development & Build

Requirements

• Android Studio Ladybug (2024.2.1)+ / IntelliJ IDEA
• JDK 17+
• Android SDK (API Level 24 〜 37)

Build Instructions

# Clone the repository
git clone https://github.com/SSZcreate/Pentab.git
cd Pentab

# Build Debug APK
./gradlew assembleDebug

# Output APK path:
# app/build/outputs/apk/debug/app-debug.apk

---

📄 Documentation

• System Architecture Document
• Protocol Specification (WebSocket JSON)
• Android Client Specification
• PC Server Specification
• Build and Deployment Guide

---

📜 License

This project is licensed under the MIT License.