# How can my AI agent put content on a TV? > Canonical HTML: https://screenrig.ai/guides/ai-agent-on-tv Your AI agent can put content on a TV by installing the official screenRIG plugin, pairing the screen from the code its Player shows, publishing the content and checking a screenshot to confirm it is playing. You need an agent that can run commands, a screen running the Player and one sentence saying what to show. Updated November 6, 2026. ## Live card previews - [Announcement](https://screenrig.ai/docs/cards/announcement.md): Rotating messages with an icon, a headline and a line or two of body text, in sync on every screen. ## What do I need? Three things, and you probably have two of them: - **A screen.** A TV, a stick, a Raspberry Pi or a PC that is plugged into one. It runs the screenRIG Player, an app that shows a pairing code. TVs with Google TV or Android TV built in, the Amazon Signage Stick, Apple TV, Macs, Windows PCs, Linux, Raspberry Pi, BrightSign and Samsung and LG signage displays all have a Player, and any screen with a modern browser opens the web Player. The [Downloads page](https://screenrig.ai/downloads.md) lists each one. - **An agent that can run commands.** A chat reply on its own sets nothing up, so the agent has to be able to run the plugin. [Claude Code](https://screenrig.ai/guides/digital-signage-with-claude-code.md), [ChatGPT dots and Codex](https://screenrig.ai/guides/control-tv-with-chatgpt.md), [Gemini Spark](https://screenrig.ai/guides/control-tv-with-gemini.md), [Grok Bot and Grok Build](https://screenrig.ai/guides/control-tv-with-grok.md), Meta Muse and Hermes all can. The command line the plugin brings needs Node.js 22.23.4+, 24.22.1+ or 26.12.1+ in the place where the agent runs commands. - **The official plugin.** It carries the skill and the command-line tool your agent uses to run screens. Your agent installs it from [github.com/screenrig/plugin](https://github.com/screenrig/plugin) when you paste one sentence. ## How does the agent put content on the TV? 1. **Paste one sentence to your agent.** It installs the official plugin: ```text I authorize you to install the official screenRIG plugin from https://github.com/screenrig/plugin. ``` 2. **Give the agent your email.** It creates your project and emails you an invitation to the dashboard. Nothing waits on that email, so the agent carries on. Never paste a password or a token into the chat. 3. **Open the Player on the screen and read the code to your agent.** It pairs the screen and names it. 4. **Say what should be on the TV.** The agent makes the content, publishes it and asks the screen for a screenshot before it says it is done. Each assistant has its own first step, such as two terminal commands or a message in an app. [Start](https://screenrig.ai/docs/start.md) has the exact step for each agent. ## What does it look like? This is the whole first run from a recorded session on a test screen. The venue is made up. > **You:** Use screenrig.ai to pair this screen. The code is ABC 234. Call it Devices TV. > > **Agent:** Paired. Devices TV shows PAIRING COMPLETED and is online. > > **You:** Put up a board with two messages. Tonight: open house at 5 pm, doors open at five, coffee and tours start at the front desk. This week: free Wi-Fi in the lounge, ask at the front desk for the network name. > > **Agent:** Done. Devices TV is showing the board, the open house first and the Wi-Fi message after it. It was on the screen about two seconds after I published it, and I checked a screenshot. ![The first board on the screen: an amber door icon and the word TONIGHT above the headline Open house at 5 pm, with a line of body text and a 1 of 2 page counter](https://screenrig.ai/static-resources/images/screenshots/landing/devices-hub-first-board-d0cffb7a.webp) *The board from that conversation, on a test screen (the Player running in a browser). The Wi-Fi message follows it. A TV, stick or Pi draws the same board.* ## What can the agent put on a TV? | Content | What the agent does | | --- | --- | | A poster, menu or welcome board | Designs it for the screen's size and purpose, or fills one of the 200+ ready-made [apps](https://screenrig.ai/apps.md) with your facts | | Your photos and video | Converts and uploads them. Video downloads first and plays from the device's own storage, so it does not buffer | | A sheet, calendar or dashboard | Reads it with its own access and puts the rows on the screen. See [a Google Sheet on a TV](https://screenrig.ai/guides/google-sheets-on-tv.md) and [a dashboard on a TV](https://screenrig.ai/guides/dashboard-on-tv.md) | | A website | Keeps the page open on the screen. See [a website on a TV 24/7](https://screenrig.ai/guides/website-on-tv-24-7.md) | | A live camera or stream | Plays HLS streams on every Player and live IP cameras on Android and the Amazon Signage Stick | | A touch kiosk | Writes a small app and puts it on the screen. See [kiosk software](https://screenrig.ai/digital-signage/kiosk-software.md) | ## What else can the agent do once the first screen works? - **Schedule it.** Breakfast in the morning and a closing notice after nine, each in the screen's own time. - **Take over many screens at once.** Tag the screens, then one request puts a fire-drill notice on every screen with the tag for 30 minutes. Each screen then returns to its schedule on its own. - **Check the glass.** It asks a screen for a screenshot, or every tagged screen for one, and looks before it reports. - **Notice a screen that drops.** A screen counts as offline after 60 seconds, and an event can wake your agent to check it. - **Keep content current.** Ask for a routine and the agent changes the screen when the data behind it changes. An agent that stays on, such as a ChatGPT dot, keeps doing it without your computer. - **Wait for your approval.** Turn on Require review for agent changes, or sign the agent in with Propose access. It still prepares everything, and nothing reaches a screen until a person approves. [AI digital signage](https://screenrig.ai/digital-signage/ai.md) lists ten example requests to try, and [Start](https://screenrig.ai/docs/start.md) has the install sentence for your agent. ## What we timed on real runs Each row is quoted from the page that holds the whole run. The content is demo content, and the runs used a test screen: the Player in a browser window standing in for the TV. | What the agent did | What we saw | The whole run | | --- | --- | --- | | Published a two-message board | On the screen about two seconds after publishing, with a screenshot checked | The session above | | Made an account and paired a TV, then built an Open sign | Building the sign and seeing it play took about five seconds | [Free digital signage](https://screenrig.ai/free-digital-signage.md) | | Sent a changed row from a sheet | The TV showed it a little over two seconds later | [A Google Sheet on a TV](https://screenrig.ai/guides/google-sheets-on-tv.md) | | Took over hallway screens with a drill notice | On the screen two seconds after the word, and the all-clear four seconds after the word that ended the drill | [Schools](https://screenrig.ai/use-cases/schools.md) | ## What limits should I know about? - **The Player has to be running** on the device that drives the screen. Your agent publishes from wherever it runs, and the screen plays it. - **The agent has to run commands.** If your assistant is only a chat window with no shell, ask it what capability is missing, or use one from the list above. - **Apple TV plays images, video, streams and ready-made apps.** Web pages and your own apps need another Player. [Players](https://screenrig.ai/docs/players.md) has the full table. - **Your agent's login and your screenRIG project are separate.** The agent never needs your screenRIG password. - **Some sites refuse to be shown on a screen.** Your agent checks before it puts a website up, because a screenshot cannot show that. ## Not a chat assistant? A script, a CI job or your own service can do the same thing without a chat. It calls the same operations through the API, the command-line tool or the browser SDK. [Publish content to a TV programmatically](https://screenrig.ai/guides/publish-content-to-tv-programmatically.md) shows the conversation and the script, and [Developers](https://screenrig.ai/developers.md) lists every way in. ## Questions ### Can ChatGPT, Claude or Gemini control a TV? Yes, each of them through an agent that can run the official plugin. [ChatGPT](https://screenrig.ai/guides/control-tv-with-chatgpt.md) does it through ChatGPT dots or Codex, [Claude](https://screenrig.ai/guides/digital-signage-with-claude-code.md) through Claude Code, and [Gemini](https://screenrig.ai/guides/control-tv-with-gemini.md) through Spark. [Grok](https://screenrig.ai/guides/control-tv-with-grok.md) works through Grok Bot or Grok Build. ### Do I need a special TV? No. Any screen that can run a Player works, and the [Downloads page](https://screenrig.ai/downloads.md) lists the Player for each device. A TV with Google TV or Android TV built in installs it from Google Play, and any TV with a modern browser opens the web Player. ### Does my agent need my passwords? No. It signs in to screenRIG with its own credentials. When it reads a sheet or a calendar it uses the access you gave it, and only what is on the screen goes to the TV. ### Can I approve changes before they reach the screen? Yes. With review on, the agent prepares each change and gives you a link, and nothing plays until you approve it in the dashboard. ### How do I know the content is playing? Publishing waits for the Player to report the new playlist, up to two minutes, and says whether it is playing. Your agent can also ask the screen for a screenshot and look at it. A person can still check the glass. ### Can the agent run more than one screen? Yes. Tag the screens and one request changes, schedules or takes over every screen with the tag, and the answer reports each screen's own result. ### What does it cost? screenRIG is free, with unlimited screens. Paid plans add business tools, more people, people to talk to, governance and contract terms. See [pricing](https://screenrig.ai/pricing.md). ## Related - [AI Digital Signage Software Run by Your Agent](https://screenrig.ai/digital-signage/ai.md): AI digital signage where your own AI agent makes the content, puts it on real TVs and checks the screen. Ten example requests and recorded timings. - [Quickstart: Digital Signage with Your AI Agent](https://screenrig.ai/docs/start.md): Install the official plugin with your AI agent, then pair a Player and publish your first screen. Start in a chat app or a terminal agent. - [Digital Signage Player Apps for Every Screen](https://screenrig.ai/downloads.md): Free Player apps for Android TV, Amazon Signage Stick, Apple TV, Mac, iPhone and iPad, Windows, Linux, Raspberry Pi, LG webOS, BrightSign and Samsung. - [Publish Content to a TV Programmatically](https://screenrig.ai/guides/publish-content-to-tv-programmatically.md): Publish to a TV from code, a CI job or your AI agent, with proof it is playing. See the conversation first, then the short script. - [Digital Signage API for Developers](https://screenrig.ai/developers.md) ## More guides - [What Is Digital Signage? Meaning, Narrowcasting](https://screenrig.ai/guides/what-is-digital-signage.md): What digital signage means, how screens, a player and software work together, what narrowcasting is and where an AI agent fits. - [Android TV Kiosk Mode: Boot to Your Signage App](https://screenrig.ai/guides/android-tv-kiosk-mode.md): Make an Android TV or Google TV start on your signage after a power cut. Three settings, all on the remote. - [Display a Website on a TV 24/7](https://screenrig.ai/guides/website-on-tv-24-7.md): Ask your AI agent to put a website on a TV all day and switch the screen off at night. It checks the site and the Player first. - [Chromecast with Google TV as Digital Signage](https://screenrig.ai/guides/chromecast-with-google-tv-signage.md): A Chromecast with Google TV runs the screenRIG Player from Google Play. Set it up, pair it with your AI agent, and see why an old Chromecast cannot. - [All guides](https://screenrig.ai/guides.md): Put a sheet, slides, a dashboard, a website or a camera on a TV by asking your AI agent. Each guide shows what to say and what to expect. [Start free](https://screenrig.ai/docs/start.md). screenRIG is free.