Skip to content

About

A simple remote app for your Android TV. Aims to replace the physical remote.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Simple Remote

A minimal native iPhone remote for Android TV / Google TV. iOS 27+, built with Xcode 27.1. Includes adaptive layouts for iPhone Duo.

Live TCL verification is partial. Pairing, reconnect, and YouTube, Stremio, Hotstar and Netflix text entry / replacement / Clear have been observed. Power standby and wake also passed on the live TCL under its existing network settings. HDMI picker, settings panel, actual audio setup, and other streaming apps still require live checks. See TODO.md and verification results.

Open and run

  1. Open SimpleRemote.xcodeproj in Xcode 27.1 or later. Opening Package.swift alone builds the core and Mac tool, not the iPhone app.
  2. Select the SimpleRemote scheme and an iPhone / iPhone Duo simulator, or your iOS 27+ iPhone.
  3. For a physical iPhone, select your Apple development team under Signing & Capabilities. Adjust the bundle identifier if your team requires it. No signing team or credentials are committed.
  4. Run. Tap Choose your TV, allow Local Network access, and select your TV. Manual IP / hostname entry is available.
  5. Enter the six-character hexadecimal remote pairing code displayed on the TV. This is not an ADB or Wireless Debugging code.

The phone and TV must be on the same reachable local network. The TV can use Ethernet. Guest Wi-Fi, VPN routing, or client isolation can block discovery or control. Normally no additional TV app or developer mode is needed; the TV must run Android TV Remote Service v5 or later.

After pairing, the app remembers one TV and reconnects when foregrounded. If the TV's certificate changes, it stops and requires you to forget and pair again. If DHCP changes the TV's address, open the connection sheet and select its rediscovered entry. Forget TV clears the saved TV association; it retains the client's on-device identity.

Controls

A full-screen silver Siri Remote-inspired surface, with a matching app icon and icon-only controls: circular D-pad / Select, Back, Home, Settings, Inputs, vertical Volume − / +, Keyboard, and Power. Keyboard sits at the upper left and Power at the upper right. Hold directions or volume to repeat. VoiceOver retains the control names. Commands are discarded while disconnected.

Hold Power for 700 ms to send one Android POWER command. A short tap does nothing; dragging away, layout changes, or backgrounding cancel the hold. Power toggles standby while the remote service is reachable. Waking from standby depends on the TV retaining network access; standby and wake passed on the actual TCL on October 21 with its existing settings. Extended standby and cold-start behavior remain unverified. No TV settings are changed automatically.

Inputs sends the standard Android TV_INPUT key to open the TV's native source picker. Use the D-pad to choose HDMI or another source. Settings sends SETTINGS. Their exact TCL behavior is pending hardware testing.

Select a compatible text field on the TV, then open Keyboard. Type or paste into the draft and tap Send text to replace the previous query. Clear removes the tracked TV text and empties the phone draft; sending an empty draft also clears. Enter sends a separate Enter key. Native Android fields use the TV’s current editor revision. Netflix uses paced IME characters and deletions; custom keyboards may take a few seconds, and Send / Clear / Enter are disabled during transfer. The draft stays in memory after sending and through rotation, folding, and sheet dismissal, so you can edit and resend it. Apps with custom input controls may not report existing text. For those apps, replacement uses the length last sent by Simple Remote, saved per TV app with the pairing. Text entered or cleared using another remote may leave that tracking out of sync; use the TV's own Clear control to start a fresh query.

iPhone Duo

  • Flat displays / outer display: D-pad above the remaining controls, with scrolling when needed. Control widths stay bounded on wider screens.
  • Volume is a vertical rocker, with + above −.
  • Active vertical fold: the complete D-pad occupies one region; secondary controls occupy the other.
  • Active horizontal fold: status above the fold, complete scrollable remote below.
  • iOS 27.1 reserved regions keep custom controls away from the hinge and active camera regions. iOS 27.0 uses the size-based layout.
  • Connection state and keyboard draft are independent of layout. Interrupted gestures cancel held-button repetition.

Duo simulator and physical posture verification are tracked separately in TODO.md.

Mac diagnostic tool

The command-line tool uses the same Swift connection core as the app, with a separate Keychain identity and saved-TV record. Pairing the Mac does not pair the iPhone.

swift run remote-cli discover
swift run remote-cli pair 192.168.1.100
swift run remote-cli key 192.168.1.100 home
swift run remote-cli key 192.168.1.100 inputs
swift run remote-cli text 192.168.1.100 "hello TV"
swift run remote-cli watch 192.168.1.100 60
swift run remote-cli forget

Run swift run remote-cli --help for all named keys. The text command waits up to 30 seconds for a compatible TV text field. macOS may request Local Network and Keychain access for the terminal or tool.

Build and test

swift test
xcodebuild -project SimpleRemote.xcodeproj -scheme SimpleRemote \
  -destination 'generic/platform=iOS Simulator' CODE_SIGNING_ALLOWED=NO build
xcodebuild -project SimpleRemote.xcodeproj -scheme SimpleRemote \
  -destination 'platform=iOS Simulator,name=iPhone Duo' \
  -parallel-testing-enabled NO CODE_SIGNING_ALLOWED=NO test

Tests cover framing, pairing, command negotiation, field counters / Unicode text, identity reuse, reconnects, layout geometry, held-button cancellation, and real mutual TLS against a loopback server. UI tests opt into an explicit --demo mode; they never pretend to verify a real TV. Add --demo to the scheme's launch arguments to explore the UI without pairing; remove it to control a TV.

Scripts/generate-project.py regenerates the checked-in Xcode project with Python's standard library after adding / removing app source files. No XcodeGen or CocoaPods is required. Scripts/generate-protocol.sh regenerates the checked-in protobuf types with protoc and protoc-gen-swift 1.32.0.

Implementation

  • Sources/RemoteCore: discovery, Keychain identity / pairing storage, TLS, incremental framing, pairing and control state machines, reconnect policy, and layout geometry.
  • Sources/RemoteCLI: Mac diagnostic tool.
  • App: SwiftUI controls, connection sheet, keyboard, lifecycle, and fold-aware layouts.
  • Tests/RemoteCoreTests, AppUITests: protocol / transport / layout tests and simulator UI tests.

No account, backend, analytics, advertising, subscription, ADB, or TV companion app. Private keys remain in Keychain. Debug output does not log pairing codes, private keys, or typed text.

See protocol notes and third-party attribution.

About

A simple remote app for your Android TV. Aims to replace the physical remote.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages