README

STF (or Smartphone Test Farm) is a web application for debugging smartphones, smartwatches and other gadgets remotely, from the comfort of your browser.

 Overview

!Close-up of device shelf

!Super short screencast showing usage

 Contributors
Thank you to all the people who have already contributed to STF!

  


 Features

 OS support
  - Android
     Supports versions 2.3.3 (SDK level 10) to 15 (SDK level 35)
     Supports Wear 5.1 (but not 5.0 due to missing permissions)
     Supports Fire OS, CyanogenMod, and other heavily Android based distributions
     root is not required for any current functionality
  - Experimental iOS on a Linux USB host
     Live screen, touch/text/Home, signed IPA installation, device health and iPhone controls
     Local Compose/native setup and provider behavior and limits
     Requires a signed WebDriverAgent prepared with Xcode; no Mac runtime node is needed
 Remote control any device from your browser
  - Real-time screen view
     Refresh speed can reach 30-40 FPS depending on specs and Android version. See minicap for more information.
     Rotation support
  - Supports typing text from your own keyboard
     Supports meta keys
     Copy and paste support (although it can be a bit finicky on older devices, you may need to long-press and select paste manually)
     May sometimes not work well with non-Latin languages unfortunately.
  - Multitouch support on touch screens via minitouch, two finger pinch/rotate/zoom gesture support on regular screens by pressing Alt while dragging
  - Drag & drop installation and launching of .apk files
     Launches main launcher activity if specified in the manifest
  - Reverse port forwarding via minirev
     Access your local server directly from the device, even if it's not on the same network
  - Open websites easily in any browser
     Installed browsers are detected in real time and shown as selectable options
     Default browser is detected automatically if selected by the user
  - Execute shell commands and see real-time output
  - Display and filter device logs
  - Use adb connect to connect to a remote device as if it was plugged in to your computer, regardless of ADB mode and whether you're connected to the same network
     Run any adb command locally, including shell access
     Android Studio and other IDE support, debug your app while watching the device screen on your browser
     Supports Chrome remote debug tools
  - File Explorer to access device file system
  - Experimental VNC support (work in progress)
 Monitor your device inventory
  - See which devices are connected, offline/unavailable (indicating a weak USB connection), unauthorized or unplugged
  - See who's using a device
  - Search devices by phone number, IMEI, ICCID, Android version, operator, product name, group name and/or many other attributes with easy but powerful queries
  - Show a bright red screen with identifying information on a device you need to locate physically
  - Track battery l