Setting up a screen
A screen is a television with a small computer behind it. Every screen is built the same way; which organization it belongs to is decided afterwards, from the console.
What goes behind the television
- A Raspberry Pi 4 or newer, with a power supply and an HDMI cable.
- A microSD card, 16GB or larger.
- Wi-Fi or a network cable in the room.
Preparing the card
- Write Raspberry Pi OS Lite (64-bit) to the card with Raspberry Pi Imager. Before writing, open its settings and fill in the name, user, password, Wi-Fi and time zone.
- Give every card its own password. Never reuse one across screens.
- Put the card in the Pi, power it up, and run the Hypeboard setup script on it once, over the network. It installs what the screen needs, points it at your Hypeboard address, and restarts it.
The setup script comes from whoever runs your Hypeboard. It never creates a user, sets a password or changes the Wi-Fi: those stay what you chose in Imager, card by card.
The finished screen opens /display/ on your Hypeboard
address — with nothing after it. No organization, no screen
name, nothing identifying in the address at all. That is what lets
every screen be built the same way.
Do not put anything after /display/ in that
address. A screen set up that way is pinned to whatever was
in the link, for good, and the whole point of the setup code below
is that it is not.
Claiming a screen
Plug it in. Within a few seconds the television shows a six-character code, in very large letters, meant to be read from the back of the room. The letters and digits that look like each other are not in the alphabet it uses, so there is no O-or-zero to guess at.
Then, from a laptop or a phone:
- Open Displays in the console (admins).
- Choose Set up a screen.
- Type the code off the television and give the screen a name, then choose Claim screen. The code is used at once, so it cannot run out while you decide the rest.
- Pick the board it shows. Each one says what it already shows and how many screens it is on; picking one doesn’t change it. New board… makes one on the spot.
- Choose whether people can step through its photos with arrow keys, a clicker or a swipe — usually not.
- Choose Send test card to see the screen’s name on the television.
The screen picks it up on its own within a minute and starts playing. Nothing is typed at the television.
The code is only on the television, and that is the security. The waiting list in the console shows that a screen is waiting, never its code — otherwise one organization’s admin could point a stranger’s television at their own board. Somebody has to be able to see the glass.
A code lasts about fifteen minutes. If it runs out, the screen rolls a fresh one by itself — nobody has to go and restart it.
The bottom-right corner of the setup code shows the screen’s name, its network (Ethernet, or the Wi-Fi network’s name) and its address, or No network. The same corner appears whenever the screen has a problem to report, and never over photos. A screen prepared before late October 2026 needs the setup script run on it again to show it.
Moving a screen to a different board
Change its board on the Displays screen. It repoints itself within a minute, from wherever you are. You never have to go back to the room.
Not sure what a board is, or whether you need another? See Boards, screens and takeovers.
Showing another board at set times
A takeover shows a different board on some screens for a while — every Wednesday evening, or for one Sunday — and each screen goes back to its own board by itself afterwards. It is set up on the board, not the screen: see Takeovers.
Letting people step through the photos
For a screen somebody stands beside — a talk, a welcome desk, a touch screen in a corridor. On Displays, choose Edit beside the screen and tick Let people step through the photos. It is also offered when you set a screen up. It is off unless you turn it on, and it is for that one screen only, not every screen on the board.
Then the arrow keys, a presenter clicker, or a swipe on a touch screen move to the next or previous photo. The slideshow waits 30 seconds after the last one and then carries on by itself. The calendar keeps scrolling on its own; only the photos move.
Retiring a screen
Revoke on the Displays screen. The television stops showing your photos, forgets its setup, and goes back to showing a setup code — ready to be claimed again, by you or by whoever gets the hardware next. Its cached photos go immediately.
Keeping a screen up to date
A screen picks up a new version of Hypeboard by itself, within a minute or two, between one photo and the next. It never does so while a test card or a setup code is showing.
A screen set up before October 2026 needs one restart to learn how: unplug it, wait a few seconds, and plug it back in. After that it keeps itself current.
Fitting the picture to the television
Text sits well inside the edge of the picture already. If your set
still crops it — some older ones do — add
?overscan=5 to the address to push everything a further
5% in. It only ever moves text inward, so a value that is too small
changes nothing.