How to connect your TV
Remote TV talks to your TV over your own home network. There is no account and no cloud in the middle: your browser sends each press to a small bridge on your computer, and the bridge talks to the TV.
What you need
- A Hisense TV running VIDAA, on the same network as the computer that runs the Remote TV bridge.
- The Remote TV bridge running on that computer (it is the piece that speaks the TV's local protocol).
- A phone, tablet or computer with any modern browser.
The bridge is what makes the site work with your TV. It stays on your network; the public website never connects to your TV directly.
Two codes, two jobs
Pairing trips people up because there are two different codes, and they are not interchangeable:
- 8 characters — this browser. It proves to the bridge that this browser is allowed to press keys. It comes from the computer running Remote TV, and each browser enters it once.
- 4 digits — the TV. It appears on the TV screen and only the first time that TV is controlled from Remote TV.
Both are in the settings gear, one under 1 · This browser and one under 3 · Pair the TV.
Five steps
- Put the TV on the same Wi-Fi. On the TV: Settings → Network → Network connection. Wired Ethernet is fine too, as long as it is the same network as the bridge.
- Open the home remote. On a device on the same Wi-Fi, open
http://192.168.0.15:8791. Add it to your home screen if you want it to open full-screen. The public site at remote-tv.stream is the guide; it cannot send commands to a TV. - Pair this browser. Open the settings gear → 1 · This browser. On the computer running Remote TV, run
cat ~/.remote-tv/pair-code.txtin Terminal to see the 8-character code, type it here, and press Pair browser. The line above turns green: Paired on this browser. - Find the TV. Still in the gear, under 2 · Find the TV, press Scan my Wi-Fi and pick the TV from the list. If it does not appear, open Type the address instead and enter the IP shown under Settings → Network → Status on the TV.
- Pair the TV, once. Under 3 · Pair the TV, press Show a code on the TV, read the four digits on the TV screen, type them in and press Send code. Skip this step if the remote already works — most homes only ever do it once.
Where the codes live
| Code | Where it comes from |
|---|---|
| Browser code 8 characters | ~/.remote-tv/pair-code.txt on the computer running Remote TV. Enter it once per browser or device. |
| TV code 4 digits | Shown on the TV screen after pressing Show a code on the TV. Enter it once per TV. |
Neither code is stored on remote-tv.stream. The browser code stays on the home computer as a SHA-256 hash; the TV code is used once and discarded.
If the scan finds nothing
- Guest Wi-Fi or AP isolation. Many routers stop devices on guest networks from seeing each other. Use the main network.
- A VPN on the phone. Turn it off while pairing; it can hide the local network.
- The TV is asleep or off the network. Wake it with its own remote once, then scan again.
- Different networks. A phone on mobile data cannot reach a TV at home. Join the same Wi-Fi.
- Manual entry. The TV's IP and MAC are under Settings → Network → Status on the TV. Enter both in the remote's settings sheet.
If pairing fails
- “That code is not right.” Check you used the browser code — 8 characters from
~/.remote-tv/pair-code.txt— and not the 4-digit code from the TV. No spaces, and the letters are not case-sensitive. - “Pairing works only on the home Wi-Fi.” The bridge accepts pairing only from a private home address. Join the home network and reload the page.
- No code appears on the TV. The set has to be on and reachable. Press Show a code on the TV again and watch the screen for four digits.
- “Too many tries.” Pairing is rate-limited on purpose. Wait a few minutes, then try once with the correct code rather than repeating guesses.
- A paired browser stops working. It may have been revoked from the computer:
node devices.mjs list, thennode devices.mjs revoke <id>. Pair it again to restore it.
Which TVs work
Remote TV is built for Hisense TVs running VIDAA. Other brands use different local protocols and are not supported yet. The TV's firmware must allow local control on port 36669; most VIDAA sets do, and pairing is the normal first-time step.
Does it work away from home?
No. The remote controls a TV on the network it can reach. Nothing about your TV is exposed to the public internet by this site, and that is deliberate: a remote that anyone on the internet could press would be a security problem.
Next
Once the dot is green, read how to use the remote, or check the FAQ.
More by set and by problem: Hisense TV remote, VIDAA remote, remote for your phone, and what to do when a remote stops working.