Use Android & Chrome Devices to make great Mobile PoS terminals

📱 Installing ViewTouch on Android & Chrome Devices

📋 Prerequisites

🔗 Source Code

The source code for running ViewTouch remote displays on Android devices is available here.

⚠️ Requirements

• Host Machine: ViewTouch must already be functioning on a host machine
• Network: ViewTouch Server and Android Client MUST communicate directly

---

📥 Android App Installation

1. Download APK

Download the APK from the ViewTouch website.

2. Install APK

• File Manager: Browse to APK and install
• Alternative: Use Easy Installer

3. Security Settings (if installation fails)

4. Launch App

• Open the installed app
• Note the connection info: App displays address:port format

---

⚙️ ViewTouch Configuration

1. Access Administrative Panel

• Open ViewTouch on host machine
• Login: User with permission to add/remove POS terminals (default: 42)
• Navigate: Select 'Start' → 'Hello Developer' / 'Manager's Gateway'

2. Display Management

• Select "Displays, Printers"
• Click "Create Display Definition"

3. Configure Display Settings

Required Fields:

• Terminal Name: Human-readable (any descriptive name)
• Display Address: Enter address:port from Android device

Optional Fields:

• Device Name: Add a friendly name
• Receipt Printer: Add CUPS Queue Name (e.g., receipt1)
• Printer Model: Usually Epson

---

🔄 Activate Remote Display

1. Change View

• Select "Change View"
• Select Display: Choose the newly added display

2. Toggle Display On

• Find toggle labeled "Turn Display On/Off"
• Status Progression:
  • 🔵 Connecting (Blue text)
  • 🟢 On (Green text)
  • 📱 Login Screen appears on Android device

---

🖨️ Printer Configuration

Receipt Printers

• Configure in "Displays & Receipt Printers" section
• Printer Name: Human-readable description
• Printer Queue Name: Must exactly match CUPS Queue Name (e.g., receipt1)

Kitchen/Bar Printers

1. Select toggle 'Displays & Receipt Printers' → 'Kitchen, Bar, Expediting & Report Printers'
2. Printer Name: Human-readable (e.g., "Hot Line", "Cold Line", "Grill")
3. Printer Queue Name: Must exactly match CUPS Queue Name

---

📐 Hardware Mounting Options

VESA Tablet Mounts

Great selection available at B&H Photo Video

Benefits:

• 📱 Secure Mounting: Tablets can be wall-mounted in kitchen/bar areas
• 🖥️ Professional Setup: Integrated into existing workspace
• 🔧 VESA Standard: Compatible with various mounting solutions

---

📋 Quick Setup Checklist

• ✅ Host ViewTouch system running
• 📱 Download and install Android APK
• 🔓 Enable "Unknown Sources" if needed
• 📋 Note Android device's address:port
• 👤 Login to ViewTouch as admin (ID: 42)
• ⚙️ Navigate to Displays, Printers
• ➕ Create Display Definition
• 🔗 Enter Display Address from Android device
• 🖨️ Configure printers (optional)
• 🔄 Toggle display ON
• 📺 Verify Android shows ViewTouch login screen

Your Android device is now a fully functional ViewTouch remote terminal!