Sign in Request access

Set up a screen in about 20 minutes.

You'll need the parts from the hardware page, a computer to prepare the SD card, and a ResGeek account. No Linux experience needed: you'll type one command.

1. Prepare the SD card

Use Raspberry Pi Imager, the free tool from raspberrypi.com, on your Mac or PC.

  1. Choose the device and systemPick your Pi model, then Raspberry Pi OS (other) → Raspberry Pi OS Lite (64-bit). The Lite version has no desktop, which is what you want.
  2. Edit the settings before writingWhen Imager offers to customize the settings, set a hostname (like lobby-screen), a username and password you'll remember, your Wi-Fi network if you're not using a cable, and your time zone. Turn on SSH if you'd like to run the install from your laptop.
  3. Write the cardPut the card in the Pi, connect the TV and network, then plug in the power last.

The first start takes a few minutes. You'll end up at a text login prompt on the TV.

2. Install the player

Sign in on the Pi with the username and password you chose (plug in a keyboard, or connect from your laptop with ssh). Then run:

curl -fsSL https://your-resgeek/install.sh | sudo bash

It installs a full-screen browser and the ResGeek player, sets the Pi to start straight into the player whenever it powers on, keeps the screen from going to sleep, and adds a small helper that lets you take screenshots and restart the screen from ResGeek.

When it finishes, restart the Pi:

sudo reboot

3. Pair the screen

After the restart, the TV shows a pairing code and a QR code.

  1. Open ResGeekSign in, then go to Screens → Add screen. Or scan the QR code on the TV with your phone.
  2. Type the codeEnter the eight characters on the TV. Codes expire after 15 minutes; if one runs out, the TV shows a new one.
  3. Name it and choose a locationUse a name people will recognize, like "Main lobby" or "Room 204".

The screen connects within a few seconds and starts playing whatever is set for that location. It shows up as playing on your Overview.

Nothing to show yet? Open any image in Media and choose Show on screens.

On a Linux mini PC

Install Debian 12 or 13 without a desktop environment (untick the desktop options in the installer and keep "standard system utilities"). Sign in, install curl if it's missing, then run the same install command as above with sudo, and pair the screen the same way.

sudo apt install -y curl

Download the apps

No Raspberry Pi? The ResGeek Player app runs the same player on these. Each one opens full-screen, starts by itself, and keeps playing offline.

Windows 10 and 11

Windows

Installer for 64-bit PCs.

Download for Windows
macOS 11 or later

Mac

For Apple silicon and Intel Macs.

Download for Mac
Android 5.1 or later

Android and Fire TV

One app for Android TV, Google TV, Fire TV, tablets and players.

Download for Android
webOS 4 or later

LG TVs

Installed with LG's Developer Mode app for now.

Download for LG

iPads and Samsung TVs: during early access we set these up with you. Ask in your welcome email.

On Windows or Mac

  1. Install the appRun the installer. Until our apps are signed, Windows may say it "protected your PC": choose More info → Run anyway. On a Mac, open the disk image, drag ResGeek Player to Applications, then right-click it and choose Open the first time.
  2. Start itLeave the address as it is, add a setup code if you have one, and choose Start the player. It goes full-screen and starts by itself whenever the computer does.
  3. Pair itWith a setup code it adds itself. Otherwise, enter the code it shows in Screens → Add screen.

On the player, Ctrl+Shift+S opens its settings and Ctrl+Shift+Q quits (use Cmd on a Mac). Set the computer to never sleep, and to log in automatically if it's in a public place. The app updates itself overnight.

On Android or Fire TV

Fire TV

  1. Allow the installOn the Fire TV, install the free Downloader app from the Amazon Appstore. Then go to Settings → My Fire TV → Developer options → Install unknown apps and turn it on for Downloader. (No Developer options? Open Settings → My Fire TV → About and press OK on the device name seven times.)
  2. Download ResGeek PlayerIn Downloader, type this address and install the app when it finishes:
https://your-resgeek/download/android

Android TV, Google TV, tablets and players

Open the same address in the device's browser, or copy the file to it on a USB stick, and allow installs from that app when Android asks.

Then

  1. Start itOpen ResGeek Player, add a setup code if you have one, and choose Start the player.
  2. Let it start by itselfOn Android 10 and later, choose Allow it on the setup screen and turn on "Display over other apps", so the player opens after a power cut.

To get back to the settings, press Menu on the remote or Back three times quickly. On a touch screen, hold the top-left corner for 5 seconds.

On an iPad

  1. Install and open the appEnter a setup code if you have one, then tap Start the player.
  2. Lock it to ResGeekIn Settings → Accessibility → Guided Access, turn it on. Then open ResGeek Player and triple-click the top (or home) button to start Guided Access, so nobody can leave the app.
  3. Keep it poweredLeave the iPad on its charger. ResGeek keeps the screen from sleeping.

To change the iPad's settings later, press and hold its top-left corner for 5 seconds. iPads managed by device management can receive the address and setup code as the server and setupCode settings.

On an LG or Samsung TV

Smart TVs run ResGeek with no box behind them. Until the apps are in LG's and Samsung's stores, they're installed with each maker's free developer tools.

LG (webOS)

  1. Turn on Developer ModeInstall LG's Developer Mode app from the LG Content Store, sign in with an LG developer account, and turn Developer Mode on. The TV restarts.
  2. Install ResGeek PlayerFrom a computer on the same network, install the downloaded .ipk file with LG's webOS command-line tools, or with a desktop helper such as webOS Dev Manager.
  3. Keep the session goingDeveloper Mode runs for a limited time. Open the Developer Mode app now and then and choose Extend, or the TV removes the app when it runs out.

Samsung (Tizen)

Samsung requires each app to be signed for the specific TV. During early access we install it with you.

On both

Open ResGeek Player, add a setup code if you have one, and press Start the player. On the player, press Back three times quickly to get back to the settings. Turn off the TV's eco and auto power-off settings (see the hardware page), and set the TV to open the last app when it turns on, if it has that option.

Setting up many screens

Typing a pairing code for every screen gets old fast. In ResGeek, go to Screens → Setup codes and make one code for a location, with the tags you want and how many screens may use it. Start each screen with that code and it adds itself, named and in the right place.

curl -fsSL https://your-resgeek/install.sh | sudo bash -s -- --setup-code ABCD-EFGH-JKMN-PQRS

All the ResGeek Player apps have a setup code box on their first screen. You can turn a code off at any time; screens already set up keep working.

Updating and removing

The player updates itself. When we release a new version of the installer, run the install command again: it's safe to repeat, and your screen stays paired.

To take ResGeek off a device:

curl -fsSL https://your-resgeek/install.sh | sudo bash -s -- --uninstall

To give the screen to someone else, remove it from Screens in ResGeek. It shows a new pairing code.

Troubleshooting

The TV says it can't connect to the server

Check the network first: is the cable in, or was the Wi-Fi name and password right in Imager? Guest networks with a "click to accept" page won't work. If the network is fine, run the install command again to make sure the screen points at the right address.

The screen is black, or says "no signal"

Use the HDMI port nearest the Pi's power socket, check the TV input, and give it a minute after power-on. If you see a lightning-bolt icon in a corner, the power supply isn't strong enough.

The picture is cut off at the edges

Turn off overscan on the TV. It's usually called "Just Scan", "Screen Fit" or "1:1 pixel" in the picture settings.

The screen shows as offline in ResGeek

It has lost its connection or its power. It keeps playing what it has, and reports in again when it reconnects. Open the screen in ResGeek to see when it was last seen.

Request early access How ResGeek works