Repolode
Submit
levhakobyan

levhakobyan/OpenTV-Remote

Free, open-source phone remote for Android and iPhone that controls smart TVs over local Wi-Fi, with editable layouts and presets.

View on GitHubWebsite
Stars
194
Forks
13
Open issues
0
Last commit
11 days ago

What is it?

OpenTV-Remote turns an Android or iPhone into a remote control for smart TVs on the same home network. It discovers TVs automatically through network discovery, lets you save several TVs, and shows only the controls that each TV's connection supports.

The Android app is written in Kotlin with Jetpack Compose and supports Android TV / Google TV, Samsung Tizen WebSocket TVs, and legacy LG webOS SSAP on port 3000, plus Bluetooth HID. The iPhone app is native SwiftUI for iOS 17+ and offers the same remote layout, editable grid, eight visual templates, accent colors, and shortcuts. Both apps support English and Russian.

The interface can be rearranged in an editor where you drag, resize, join, or remove buttons and add app shortcuts. Pairing credentials are stored encrypted on Android. The project states that Fire TV, Roku, screen mirroring, and LG port 3001 are not supported, and that real-hardware compatibility still needs testing.

Key features

  • 01Automatic discovery of TVs on the local Wi-Fi network, with manual IP connection as fallback.
  • 02Supports Android TV / Google TV, Samsung Tizen and legacy LG webOS TVs, plus Bluetooth HID.
  • 03Editable grid layout with drag, resize, join, and undo.
  • 04Eight built-in templates and saved custom presets.
  • 05Native apps for Android and iPhone, with English and Russian interfaces.
  • 06MIT licensed with no account or subscription required.

Use cases

  • Controlling a smart TV from a phone when the physical remote is lost or broken.
  • Building a custom remote layout with the most-used buttons and app shortcuts.
  • Managing several TVs on one home network from a single phone app.

Quick start

  1. 1

    Open the install guide or the development releases page to get the Android debug APK

  2. 2

    Build the Android debug APK from the workspace root (needs JDK 17 and Android SDK Platform 34)

    ./android/gradlew -p android assembleDebug testDebugUnitTest lintDebug
  3. 3

    For iPhone, open the Xcode project and run the OpenTVRemote scheme on a Simulator or your own signed device

Things to know

  • This is a development build and does not claim universal TV compatibility.
  • Fire TV Wi-Fi, Roku ECP and screen mirroring are not offered.
  • iOS Bluetooth HID parity is unavailable, and no signed iPhone IPA or TestFlight build is supplied.
  • Physical-iPhone Samsung and LG discovery needs Apple's restricted multicast entitlement.

In collections

Open-source Mac appsAndroid apps & phone tools

Topics

#smart-tv#remote-control#android#ios#kotlin#swiftui#bluetooth#local-network

FAQ

What is OpenTV-Remote?
Free, open-source phone remote for Android and iPhone that controls smart TVs over local Wi-Fi, with editable layouts and presets. OpenTV-Remote turns an Android or iPhone into a remote control for smart TVs on the same home network. It discovers TVs automatically through network discovery, lets you save several TVs, and shows only the controls that each TV's connection supports.
Is OpenTV-Remote free to use? What license does it have?
OpenTV-Remote is open source under the MIT license. Check the license terms before using it in commercial products.
Is OpenTV-Remote still maintained?
Actively maintained. The last commit to OpenTV-Remote was on Oct 27, 2026.
What can I use OpenTV-Remote for?
Controlling a smart TV from a phone when the physical remote is lost or broken. Building a custom remote layout with the most-used buttons and app shortcuts. Managing several TVs on one home network from a single phone app.
How do I install OpenTV-Remote?
Open the install guide or the development releases page to get the Android debug APK Build the Android debug APK from the workspace root (needs JDK 17 and Android SDK Platform 34): ./android/gradlew -p android assembleDebug testDebugUnitTest lintDebug For iPhone, open the Xcode project and run the OpenTVRemote scheme on a Simulator or your own signed device
Where can I get OpenTV-Remote?
The source code and installation instructions are on GitHub: https://github.com/levhakobyan/OpenTV-Remote

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects