Skip to content

Commit 9d2edd6

Browse files
creationsofm7claude
andcommitted
docs: SEO + conversion rewrite of README and metadata
Optimize for discovery and download conversion when users search to control a Windows PC from their phone. - README: keyword-led H1, wedge-led intro (host-only install, multi-user, free/OSS/LAN-only), competitor-comparison table, FAQ with question headings, demo GIF placeholder - Strong download CTA pinned to the latest release exe (v0.1.1) plus an honest SmartScreen note - package.json + manifest descriptions aligned; drop implied TV claim - gitignore locally installed agent skills (.agents/, skills-lock.json) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 parent eb512fd commit 9d2edd6

4 files changed

Lines changed: 71 additions & 13 deletions

File tree

.gitignore

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,3 +5,7 @@ release/
55
*.log
66
.DS_Store
77
.env
8+
9+
# Agent skills (installed locally via `skills add`)
10+
.agents/
11+
skills-lock.json

README.md

Lines changed: 64 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -19,24 +19,50 @@
1919

2020
---
2121

22-
## What is this?
22+
# Control your Windows PC from your phone — LocalTV Remote
2323

24-
**LocalTV Remote** is a lightweight Windows daemon that turns your phone into a wireless remote — mouse, keyboard, scroll wheel, and volume control — over your local Wi-Fi. Your phone opens a PWA in the browser (no app store install). The PC runs a single Node process at ~25–40 MB RAM.
24+
**LocalTV Remote** is a **free, open-source** app that turns your phone into a **wireless mouse, keyboard, and volume remote** for any **Windows 10/11 PC or laptop** — over your local Wi-Fi.
2525

26-
> This is the **open-source, remote-only** sibling of LocalTV. It contains no Chromium, no DRM, and no TV/streaming mode — just the remote control daemon.
26+
**You only install it on the PC.** Your phone just opens a web page (a PWA in the browser), so there's **nothing to install on the phone — or on any other device** you use to control the PC. No app store, no second download.
27+
28+
**Multiple people can control one PC at the same time**, each paired securely with a QR code and a 6-digit PIN — no shared "remote," no shared password. It's **LAN-only**: no cloud relay, no accounts, and your data never leaves your network. The PC runs a single Node process at ~25–40 MB RAM with **no bundled Chromium**.
29+
30+
> LocalTV Remote is the **open-source, remote-only** companion to **LocalTV**. It contains no Chromium, no DRM, and no TV/streaming mode — just the remote-control daemon.
31+
32+
<!-- TODO: add a real demo at docs/demo.gif (phone moving the PC cursor over Wi-Fi) and uncomment below -->
33+
<!-- ![Controlling a Windows PC from a phone over Wi-Fi, with no app to install on the phone](docs/demo.gif) -->
34+
35+
---
36+
37+
## Why LocalTV Remote?
38+
39+
Looking for a **free, open-source alternative to Unified Remote or Remote Mouse**? Most phone-as-remote apps make you install a companion app on *both* your phone and your PC, lock features behind a paid tier, or route input through their cloud. LocalTV Remote doesn't.
40+
41+
| | **LocalTV Remote** | Typical alternatives* |
42+
|---|---|---|
43+
| Price | ✅ Free & open-source (Apache 2.0) | 💰 Freemium / paid Pro |
44+
| App to install on your phone | ✅ None — opens in the browser (PWA) | 📲 Companion app required |
45+
| Control one PC from several phones at once | ✅ Yes | ⚠️ Usually one device / limited |
46+
| Secure pairing built in (QR + PIN) | ✅ Yes | ⚠️ Varies |
47+
| Cloud / account required | ✅ No — LAN-only, private | ☁️ Often cloud-assisted |
48+
| Footprint on the PC |~27 MB, no Chromium | 📦 Often heavier |
49+
| Source code you can audit | ✅ Yes | ❌ Closed-source |
50+
51+
<sub>*Reflects common free tiers of popular alternatives; their features may change. Compare for yourself.</sub>
2752

2853
---
2954

3055
## Features
3156

3257
| | |
3358
|---|---|
34-
| 🖱️ **Mouse control** | Move, click, right-click, scroll — with DPI-aware scaling |
35-
| ⌨️ **Keyboard input** | Type text and send key combos from your phone |
36-
| 🔊 **Volume control** | Accurate system volume via Windows Core Audio (COM) |
37-
| 📱 **PWA — no install** | Phone opens a web page, installs as a home-screen app |
38-
| 🔗 **QR pairing** | Scan once, token is remembered for future sessions |
39-
| 🔒 **LAN-only** | No cloud relay, no accounts, no data leaves your network |
59+
| 🖱️ **Phone as a wireless mouse** | Move, click, right-click, scroll — a phone trackpad with DPI-aware scaling |
60+
| ⌨️ **Phone as a keyboard** | Type text and send key combos to your PC from your phone |
61+
| 🔊 **Volume remote** | Control Windows system volume from your phone via Core Audio (COM) |
62+
| 📱 **No app to install** | Phone opens a web page (PWA), installs as a home-screen app — no app store |
63+
| 👥 **Multi-user control** | Several phones can control one PC at once, each paired separately |
64+
| 🔗 **QR + PIN pairing** | Scan once, token is remembered for future sessions |
65+
| 🔒 **LAN-only & private** | No cloud relay, no accounts, no data leaves your network |
4066
| 🪶 **Tiny footprint** | ~27 MB installer, ~25–40 MB RAM at idle, no Chromium |
4167
| 🖥️ **System tray** | Sits in the tray; optional start-on-login toggle |
4268
| 🔌 **Auto port** | Free-port fallback if 3000 is occupied — QR auto-updates |
@@ -47,14 +73,18 @@
4773

4874
### Option 1 — Installer (recommended)
4975

50-
Download **[LocalTVRemote-Setup-0.1.0.exe](https://github.com/creationsofm7/localtv-remote/releases/latest)** from the latest release and run it.
76+
### ⬇️ [Download LocalTV Remote for Windows — Free](https://github.com/creationsofm7/localtv-remote/releases/download/v0.1.1/LocalTVRemote-Setup-0.1.1.exe)
77+
78+
Latest release: **[v0.1.1](https://github.com/creationsofm7/localtv-remote/releases/latest)** · Windows 10/11 · ~27 MB. Download the installer, run it, and you're paired in under a minute. Already installed? Grab the link above to **update to the latest version**.
5179

5280
The setup wizard will:
5381
- Install to `%ProgramFiles%\LocalTV Remote`
5482
- Create a Start Menu shortcut
5583
- Add a Windows Firewall inbound rule (so your phone can reach the daemon without a popup)
5684
- Optionally create a desktop shortcut and enable start-on-login
5785

86+
> First run shows a Windows SmartScreen "unknown publisher" notice (the installer isn't code-signed yet). Click **More info → Run anyway** to continue.
87+
5888
### Option 2 — winget *(coming soon)*
5989

6090
```
@@ -176,6 +206,30 @@ Windows is the only supported target today. The input layer is abstracted behind
176206

177207
---
178208

209+
## FAQ
210+
211+
### How do I control my laptop from my phone without installing an app?
212+
213+
Install LocalTV Remote on your **Windows PC** (it's the only device that needs anything installed). Launch it, scan the QR code with your phone's camera, and your phone's browser opens a controller page — a trackpad, keyboard, and volume remote. Nothing to install on the phone, no app store, no account.
214+
215+
### Can multiple people control one PC at the same time?
216+
217+
Yes. LocalTV Remote accepts several connected phones at once, and each one pairs independently with its own QR code and 6-digit PIN. There's no single shared "remote" to hand around — handy for a shared screen, a meeting room, or a media PC.
218+
219+
### Is there a free, open-source alternative to Unified Remote or Remote Mouse?
220+
221+
LocalTV Remote is exactly that: free, Apache-2.0 open-source, with no companion app required on the phone and no paid tier. See the [comparison above](#why-localtv-remote).
222+
223+
### Is controlling my PC from my phone over Wi-Fi safe?
224+
225+
It's **LAN-only** — input never leaves your local network and there's no cloud relay or account. Pairing requires a 6-digit PIN derived from machine identity, WebSocket connections are origin-checked, traffic is rate-limited, and the pairing PIN is only served to the PC itself, never to other devices. See [Security](#security).
226+
227+
### Does it work in games and full-screen apps?
228+
229+
Yes. Input is injected OS-wide via Win32 `SendInput`, so it works in any app, including games and full-screen windows.
230+
231+
---
232+
179233
## License
180234

181235
Apache 2.0 — see [LICENSE](LICENSE).

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "localtv-remote",
33
"version": "0.1.1",
4-
"description": "Lightweight, open-source phone-as-remote-mouse/keyboard daemon for Windows. No Chromium, no DRM.",
4+
"description": "Control your Windows PC from your phone — free, open-source wireless mouse, keyboard & volume remote over Wi-Fi. No app to install on the phone, multi-user, LAN-only.",
55
"license": "Apache-2.0",
66
"private": false,
77
"main": "dist/daemon/index.js",

public/control/manifest.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
{
22
"name": "LocalTV Remote",
33
"short_name": "LTV Remote",
4-
"description": "Control your LocalTV from your phone — trackpad, volume, media controls, and keyboard.",
4+
"description": "Control your Windows PC from your phone — trackpad, keyboard, and volume remote over Wi-Fi.",
55
"start_url": "/",
66
"scope": "/",
77
"display": "standalone",
88
"orientation": "portrait",
99
"theme_color": "#000000",
1010
"background_color": "#000000",
11-
"categories": ["utilities", "entertainment"],
11+
"categories": ["utilities", "productivity"],
1212
"lang": "en",
1313
"dir": "ltr",
1414
"icons": [

0 commit comments

Comments
 (0)