Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lightloop.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Requirements

  • Apple TV 4th generation or newer (Apple TV HD or Apple TV 4K)
  • LightLoop app installed from the App Store
  • Your server URL and Feed ID (both found on the Feeds page of the dashboard)

​
Finding your server URL and Feed ID

In the web dashboard, open the Feeds tab and select your feed. You’ll see:
  • Server URL — the address of your LightLoop server (e.g., https://screens.myorg.workers.dev)
  • Feed ID — a 6-character code (e.g., AB12CD)
Your server URL is the same for all feeds in your account. Only the Feed ID changes per feed.

​
Pairing the Apple TV

1

Open LightLoop on Apple TV

Launch the LightLoop app. First-time users will see the setup screen.
2

Enter your server URL

Use the on-screen keyboard (or the Siri Remote’s voice input) to type your server URL. Include https:// at the start.
3

Enter your Feed ID

Type the 6-character Feed ID. It is not case-sensitive.
4

Press Connect

The app validates your credentials and begins fetching your feed. You’ll see a playlist grid appear as media starts downloading.

​
What happens after connecting

Once connected, the Apple TV:
  1. Downloads all media in the feed to local storage
  2. Opens a live WebSocket connection to receive instant updates from the dashboard
  3. Polls every 30 seconds as a fallback if the WebSocket is interrupted
  4. Begins playback automatically once a playlist has finished downloading

​
Multiple Apple TVs, one feed

You can connect as many Apple TVs as you want to the same feed. All TVs receive the same updates simultaneously. For different screens showing different content, create a separate feed for each screen and give each TV its own Feed ID.

​
Changing orientation

If your screen is mounted vertically (portrait mode), set the orientation in the dashboard before pairing:
  1. Open the feed in the dashboard
  2. Click Settings
  3. Under Orientation, choose Portrait Left or Portrait Right (depending on which way your screen rotates)
  4. Save — the Apple TV will rotate its layout automatically

​
Disconnecting a TV

To unpair an Apple TV from a feed:
  1. On the Apple TV, open the app menu (press and hold the Menu button, or navigate to the settings gear)
  2. Select Disconnect
  3. The app clears all cached files and returns to the setup screen
Disconnecting removes all locally cached media from the device. Reconnecting will re-download everything from scratch.