LG TV Use

The workIl lavoro

I built a tool that lets an AI agent use TV apps, remote keys, pointer, text and power over the local network. After an agent inspects a new route, the tool turns it into reusable code. Known routes can then run without a screenshot at every step, with visual fallback when the context is uncertain.Ho costruito un tool che permette a un agente AI di usare app, telecomando, puntatore, testo e alimentazione della TV sulla rete locale. Dopo che l’agente ha ispezionato un nuovo percorso, il tool lo trasforma in codice riutilizzabile. I percorsi conosciuti possono così evitare gli screenshot a ogni passaggio, tornando alle immagini quando il contesto è incerto.

What to exploreCosa esplorare

Version 0.3.1 is public under the MIT license, with 17 MCP tools and 55 automated tests. Start with the README for installation and pairing. Internal app navigation remains experimental: a tracked state is a prediction, and external remote input requires a fresh observation.La versione 0.3.1 è pubblica con licenza MIT, 17 tool MCP e 55 test automatici. Parti dal README per installazione e associazione. La navigazione interna delle app resta sperimentale: lo stato tracciato è una previsione e l’uso del telecomando fisico richiede una nuova osservazione.

How it startedCome è nato

I wanted to open a YouTube video on the TV and couldn’t find the remote. I asked Codex to build a local MCP tool for the LG TVs I use. The first attempt worked through webOS screenshots and remote commands, but the whole operation took about 50–60 seconds.Volevo aprire un video su YouTube sulla TV e non trovavo il telecomando. Ho chiesto a Codex di costruire un MCP locale per le TV LG che uso. Il primo tentativo funzionava attraverso screenshot di webOS e comandi del telecomando, ma l’intera operazione richiedeva circa 50–60 secondi.

The next step was to make that exploration reusable: inspect a new screen, verify the result, then compile the route into code for the local MCP. Known routes use direct commands or bounded sequences, with screenshots as a fallback when the app or state is unfamiliar. After exploring the installed apps and testing power control, I made the tool open source. The useful idea is that discovering a route should make the next attempt faster.Il passo successivo è stato rendere riutilizzabile quell’esplorazione: osservare una schermata nuova, verificare il risultato e tradurre il percorso in codice per l’MCP locale. I percorsi conosciuti usano comandi diretti o sequenze limitate, con gli screenshot come fallback quando l’app o lo stato sono sconosciuti. Dopo una prima esplorazione delle app installate e le prove sull’alimentazione, ho reso il tool open source. L’idea utile è che scoprire un percorso renda più veloce il tentativo successivo.

Try itProvalo

You need Python 3.11 or later on macOS or Linux and a compatible LG webOS TV on your local network. Clone the repo, install it in a virtual environment, set your TV’s private IPv4 address and accept the pairing prompt on the television.Servono Python 3.11 o successivo su macOS o Linux e una TV LG webOS compatibile sulla rete locale. Clona la repo, installa il tool in un ambiente virtuale, imposta l’indirizzo IPv4 privato della TV e accetta la richiesta di associazione sul televisore.

Installation and pairing guideGuida a installazione e associazione →

Once paired, ask your MCP agent to open YouTube, search for a video, inspect an unfamiliar screen or learn a checked route. The CLI is available for direct commands. Pair and register each TV separately before using multi-device or wake commands.Dopo l’associazione, chiedi al tuo agente MCP di aprire YouTube, cercare un video, osservare una schermata sconosciuta o imparare un percorso verificato. La CLI permette di inviare comandi diretti. Associa e registra ogni TV separatamente prima di usare i comandi per più dispositivi o per l’accensione.

Evidence and limitsVerifiche e limiti

The public package passes 55 automated tests and build/install checks on macOS and Linux with Python 3.11 and 3.14. Physical exploration covered two LG models; power-off and wake were verified on one. App foreground checks do not prove focus, search results or playback. Wake and screenshots depend on the TV’s firmware and network settings.Il pacchetto pubblico supera 55 test automatici e i controlli di build e installazione su macOS e Linux con Python 3.11 e 3.14. Le prove fisiche hanno coinvolto due modelli LG; spegnimento e riaccensione sono stati verificati su uno. Il controllo dell’app in primo piano non prova il focus, i risultati di ricerca o la riproduzione. Accensione e screenshot dipendono da firmware e impostazioni di rete della TV.

Read the validation notesLeggi le note di verifica → · Download release 0.3.1Scarica la release 0.3.1 →

The code is MIT-licensed. Contributions and sanitized compatibility reports are welcome. This is an independent project; local credentials and private captures are excluded from the repository.Il codice ha licenza MIT. Contributi e segnalazioni di compatibilità senza dati privati sono benvenuti. È un progetto indipendente; credenziali locali e immagini private sono escluse dalla repo.