Set up a screen
Choose the device connected to your TV. For a computer that you want to manage remotely, use the paired browser guide.
Help me choose a player
Do you already have a device you can leave connected to the TV?
Yes, I’d like to use what I have
What device do you have?
- Mac, Windows PC or Chromebook — Pair a browser and keep the playlist full screen on the TV.
- Raspberry Pi — Flash our player image on a Pi 4 or 5. Pi 3B and 3B+ support is experimental.
- Fire TV Stick or Android TV — Check the OS before trying the development app. It requires sideloading on compatible Android or Fire OS devices.
- Apple TV or Roku — Developer installation only. If you need a screen running today, a spare computer can use the paired browser.
- BrightSign, LG webOS or Samsung Tizen — Check the hardware pilot guide for your model.
- Amazon Signage Stick — Check 7signage compatibility before setting it up.
No, I’m considering buying a player
Which matters most for this screen?
I need reliable playback today, even if Wi-Fi drops
Choose a Raspberry Pi 4 or 5. You’ll need a computer and microSD card reader to write the player image once. After pairing, the Pi can restart and play its last cached image playlist offline. See the parts list and setup steps.
I’d like a small TV stick and I’m comfortable testing an app
Try a compatible Fire TV Stick if you have access to one. Setup skips the microSD card, but currently requires installing our development app manually. Confirm the model runs compatible Fire OS before buying. The Android build cannot run on Vega OS. Check the Fire TV setup steps.
I want the easiest setup, with no flashing or sideloading
Use a computer with a browser for now. Connect HDMI, pair the browser and go full screen. If you want a dedicated stick, check compatibility before ordering an Amazon Signage Stick. See its current status or pair a browser.
Compare hardware players
Choose by the features you need, not just the HDMI connector. This table describes the current 7signage player software. Development apps and hardware pilots still need testing on your exact device.
| Player | Photos & clocks | Vertical display | Live websites | Restart offline | Capture screen | TV power / input |
|---|---|---|---|---|---|---|
| Raspberry Pi 4 / 5 | ✓ Yes | ✓ Portal rotation: 90°, 180°, 270° | ✓ External HTTPS pages | ✓ Last fully cached photo playlist | ✓ Whole display | ✓ HDMI-CEC, when TV supports it |
| Mac / Windows / ChromeOS browser | ✓ Yes | Use the computer’s display rotation | Not through managed publishing | Conditional: saved photos or clock, up to 128 MiB | Not available | Not available |
| Fire TV / Android TV app | ✓ Development build | No managed rotation yet | 7signage playback only | Not supported for startup | Not available | No portal controls |
| Apple TV app | ✓ Development build | No managed rotation yet | Not supported | Needs internet at startup; photos cache during playback | Not available | No portal controls |
| Roku channel | ✓ Development build | No managed rotation yet | Not supported | Not supported for startup | Not available | No portal controls |
| BrightSign / LG / Samsung | Hardware pilot | Model-dependent; unverified | Launcher uses 7signage web player | Unverified on these devices | Not available | Unverified |
| Amazon Signage Stick | 7signage integration is not verified yet. Confirm compatibility before buying. | |||||
For vertical screens, live dashboards, or remote TV controls: choose a Raspberry Pi 4 or 5. Pi 3B / 3B+ remains experimental.
For a spare computer: the paired browser is the quickest starting point. Rotate the output in the operating system, keep the browser full screen, and disable sleep. Offline playback requires retained site storage and a completed download; test a disconnected restart before relying on it.
For TV apps: photo and clock support does not imply website, video, rotation, or full operating-system control. Mounting a TV vertically alone will not rotate the app. Hardware CEC support does not necessarily expose controls to our app.
Paired players support portal publishing, groups, and server-selected schedules while online. Offline playback repeats the last saved content; it does not promise offline schedule changes. External websites may require login and must be tested; their content is not included in offline photo caching.
Supported players
Raspberry Pi
Use the player image on a Pi 4 or 5. Pi 3B and 3B+ support is experimental.
- Gather a microSD card of at least 16 GB, a suitable power supply and an HDMI cable. Pi 4 and 5 use micro-HDMI. Pi 3B and 3B+ use full-size HDMI.
- Sign in and open Screens. Expand Need a player? Set up a Raspberry Pi and choose Get player image, then Download player image. In Raspberry Pi Imager choose the custom image, select your spare card and skip OS customization. Writing the image erases the selected card.
- Insert the card, connect the TV, select its HDMI input and power on. Connect Ethernet for a wired setup, or scan the first on-screen QR code to join the player’s Wi-Fi hotspot. Stay connected if your phone reports no internet.
- Scan the second QR code or visit http://10.42.0.1 while on the hotspot. Select the venue Wi-Fi and enter its password. The current image goes straight to Wi-Fi setup. After pairing and an online check-in, later Wi-Fi changes use your organization’s recovery PIN, available under Access in the portal.
- Once the player displays its six-digit code, reconnect your phone to the internet. Scan the pairing QR code or open Pair a screen. Choose the organization, name the screen and enter the code within ten minutes.
- In Playlists, choose New playlist, name it and add images. Save your edits, choose Publish, select your screen or group and confirm. Check the TV for the first image.
My screen won’t pair
Use the current code shown on the TV. Check that the player has internet access and your portal account can manage screens. If the organization has reached its screen limit, free a slot before retrying.
Pair a browser for remote management
- On the device attached to the TV, open the 7signage web player in a dedicated browser profile with site storage enabled. Move the window onto the TV and enter full screen. Keep the device awake. After pairing, bookmark the /play/screen/ address to reopen this screen in the same browser profile.
- Leave the six digits visible. On a phone or another computer, sign in, select the organization, choose Screens → Pair a screen and enter the code.
- Publish a playlist. Reopen the same web player in the same browser profile to resume. Clearing site data gives the browser a new identity. Each separately paired screen needs its own profile or device.
Check that this browser can play offline
Publish an image playlist or clock while online. Press I or move the pointer and choose Player status. Once it says Ready to restart offline with this playlist, disconnect the network and reopen the same web player in the same profile. You should see the last complete playlist. Reconnect to receive new assignments. The browser stores one playlist of up to 128 MiB. Clearing site data removes both the download and the pairing.
For an enrolled Chromebox, an administrator can use the player URL as the web kiosk app. Test automatic launch and persistence on your ChromeOS configuration.
Mac with a second display (manual playback)
- Connect the TV with HDMI or a compatible USB-C display adapter. In System Settings → Displays, select the TV and choose extended display. Arrange it on the side where you’ll drag the playback window.
- In Playlists, expand the saved playlist’s Playback link and choose Open preview. Move the preview into its own window on the TV. Use the green window control to enter full screen.
- Keep the Mac awake during signage hours. Confirm you can use the portal on the Mac while the images or clock remain visible on the TV.
A desktop window follows its playback link. For remote publishing to a named screen, pair this browser.
Windows PC with a second display (manual playback)
- Connect the TV over HDMI and select its HDMI input. Press Win + P and choose Extend.
- Open Playlists in Edge or Chrome. For your saved image or clock playlist, expand Playback link and choose Open preview. Drag the preview into its own window and move it to the TV.
- Press F11 for full screen. Check that the first slide appears on the TV while your desktop stays usable. Adjust the computer’s sleep settings for your signage hours.
For remote publishing and schedules, follow the paired browser instructions. Open another playback link to switch programs manually. Anyone with the link can view its playlist.
Development builds and hardware pilots
Fire TV and Android TV
- Check the model and OS version in the TV’s About screen. The test APK targets Android API 25 or newer, including compatible Fire OS devices. Vega OS uses a different app format.
- If you have the test APK, install it using ADB on a development-enabled device. Open 7signage. Enter the TV’s six-digit code in Screens → Pair a screen.
- Publish an image or clock playlist to the new screen. Leave the app open with an internet connection. Check for the first slide, then publish a second playlist to verify switching.
Store installation and offline playback are planned. Amazon Signage Stick fleet enrollment needs separate validation.
Roku
- On a test Roku with developer mode enabled, upload the 7signage ZIP using the Roku development installer.
- Open 7signage. On your phone or computer, go to Screens → Pair a screen, name the TV and enter its six digits. Publish an image or clock playlist to that name.
- If you previously entered a playback link, press the star button and choose Use portal pairing. Reopen the app to confirm it restores the paired screen.
Which players can show a live website?
Use the Raspberry Pi player to publish an external HTTPS page through the portal. Test the page on the Pi if it requires a login or uses protected media.
Apple TV and Roku render photos and clocks natively. Android TV and Fire OS have a web view, but the 7signage app opens only 7signage playback links. The paired browser on Mac, Windows, and ChromeOS also accepts only 7signage playlists. The BrightSign, Samsung Tizen, and LG webOS launchers use that same browser player. You can open a website directly in a desktop browser outside 7signage. Amazon Signage Stick integration is unverified.
Apple TV
Publish a 7signage photo or clock playlist to Apple TV. The tvOS app cannot display a live website, embedded dashboard, or video playlist. For a static page, upload a screenshot as a photo. For a live page, choose a Raspberry Pi.
- Install the development app from Xcode on a provisioned tvOS 16 or newer test device, or run it in the Apple TV simulator.
- Open 7signage. In Screens → Pair a screen on your phone or computer, enter the code on the TV and name the screen. Publish an image or clock playlist.
- To keep a screen on a single playlist, choose Use a playback link instead. While playing a manual link, press Back to edit it or return to pairing.
Amazon Signage Stick
This commercial player is designed for compatible signage providers. We haven’t verified 7signage playback on it. If you’re buying a dedicated player for 7signage today, use the Raspberry Pi guide.
BrightSign, LG webOS and Samsung Tizen
BrightSign. On an HTML5-capable test player with a network connection, place the supplied autorun.brs at the root of a spare SD card and boot from it. The launcher opens the web player. Pair the code, publish and verify that power cycling restores the same screen.
LG webOS TV. On a developer-enabled test TV, install the 7signage IPK and launch the app. Pair using the code in Screens. Commercial webOS Signage screens may require a model-specific deployment method.
Samsung. On models with a compatible browser, open the web player and test pairing. A Tizen Studio pilot project is available for hosted-app testing with the appropriate Samsung developer profile. Confirm the exact model, firmware and installation method before buying hardware for a rollout.