User Manual
MagicWaits Display Devices — Complete reference for all features, settings, and troubleshooting. Covers both the Colour Touchscreen (TFT) and the E-Ink Display.
Throughout this manual, sections that differ between the two devices are clearly marked with TFT and E-Ink badges. Where no badge appears, the information applies to both.
Overview
MagicWaits displays connect to your home WiFi and automatically pull live data from your MagicWaits account at magicwaits.com. All settings are managed from any browser — your display picks up changes on its next data fetch.
TFT Colour Touchscreen
Compact 4.0" colour display with a live-updating touchscreen. Shows wait times in colour, a clock, animated sun arc, and 11 different screen views. Tap anywhere to interact.
E-Ink E-Paper Display
Large 7.5" black and white e-paper display. Ultra-low power — ideal for wall mounting with a small power bank. Press a button to cycle through 10 views including a clock. Screen takes up to 30 seconds to refresh.
- Live wait times for attractions
- A countdown to your trip (in days, or weeks + days)
- Live weather — temperature, conditions, feels-like, humidity
- Lightning Lane Multipass and Premier Pass prices by park
- A single ride's wait time in giant figures
- Custom quotes or the famous Yeti tracker
- Current time and date (12hr or 24hr clock)
- TFT only Colour-coded wait times, animated sun arc view
Hardware
Colour Touchscreen (TFT)
| Component | Detail |
|---|---|
| Display | 4.0" ST7796S TFT, 480×320 px, landscape orientation |
| Microcontroller | ESP32 dual-core 240 MHz |
| Touch | XPT2046 resistive touchscreen (tap right/left to navigate; hold to refresh) |
| WiFi | 802.11 b/g/n — 2.4 GHz only |
| Power | USB-C, 5V, ~300 mA typical |
E-Ink Display
| Component | Detail |
|---|---|
| Display | 7.5" Waveshare e-Paper, 800×480 px, landscape, black/white |
| Microcontroller | Waveshare ESP32 Driver Board (Universal) |
| Input | Physical button — short press, hold (3 s), or 15-second hold |
| WiFi | 802.11 b/g/n — 2.4 GHz only |
| Power | USB-C, 5V, ~50 mA average (very low — ideal for power banks) |
| Mounting | Can be wall-mounted; a small power bank provides days of runtime |
| Refresh time | Up to 30 seconds for a full screen update |
First-Time Setup
The setup process is identical for both devices.
Plug in the device
Connect via USB-C to any phone charger, USB port, or power bank. The display will show a startup/WiFi setup screen.
Connect to "MagicWaits Setup"
On your phone or laptop, join the WiFi network called MagicWaits Setup. A setup page should open automatically. If not, go to 192.168.4.1 in your browser.
Enter your WiFi credentials
Tap Configure WiFi, select your home network, enter your password. Tap Save. The device reboots and connects. 2.4 GHz only.
Startup sequence
After connecting, the device syncs the clock and fetches your data. This takes 15–30 seconds. E-Ink: the screen will flash and refresh slowly — this is normal.
Log in to magicwaits.com
Visit www.magicwaits.com. Your username and password are on the label on the back of the device.
Activate your subscription
Press the flashing gold button to go to Choose Your Package. Your promo code allows you to choose any package for free. On the payment page, select "Promo Code or Add Code" to reveal the entry box and enter your promo code (found in your packaging). You won't be charged during your free period and can cancel any time. Payment is securely handled by Stripe. Make sure to enter your email address when prompted.
Select your parks
Select any number of parks your package allows. The number of available slots depends on your subscription tier. Press Save to continue.
Pick your rides
Under Ride Selection, choose the attractions you want to monitor. Each park is listed separately — tap the dropdown arrow to expand its ride list.
Customise your display zones
Go to the top right and left zones to further customise your display. You can make one selection per zone. Scroll down after each selection as new settings may appear (e.g. weather location). We recommend Holiday Countdown and Weather or Clock for first-timers.
Configure your settings
Go to Settings near the bottom: set your Time Zone, Holiday Date, Refresh Time (how often your screen updates), and View Modes.
Screen Views
Main Dashboard (both devices)
The default view: top-left panel (configurable), top-right panel (configurable), and a bottom section with live ride wait times.
TFT — Main Dashboard
E-Ink — Main Dashboard
Views on Both Devices
Main Dashboard — two configurable panels + live wait time list. Big Countdown — full-screen countdown as weeks + remaining days. Left Panel Full Screen — expands the left panel. Right Panel Full Screen — expands the right panel.
TFT-Only Views TFT
Clock Only — minimalist full-screen clock with date. Clock + Wait Times — clock at top, wait list below. Countdown + Clock Split — countdown and clock side by side. Sun Arc — animated arc of the sun's position through the day. Zen Scroll — slowly scrolling ride list with large typography. Art Deco — stylised art deco countdown panel. Info / Control Panel — shows username, IP, subscription status, firmware version, and a WiFi reset button.
E-Ink Views E-Ink
The E-Ink display has 10 views: Main Dashboard, Full Panel Left, Full Panel Right, Days Countdown + Rides, Split Panels + Rides, Departure Board, Big Clock + Rides, Quad Grid, Weekly Strip, and Info Screen (shows username, IP, subscription status, firmware version — hold 15 s to reset WiFi).
Controls
TFT — Touch Controls
| Gesture | Duration | Action |
|---|---|---|
| Tap right side | < 0.7 s | Next screen view |
| Tap left side | < 0.7 s | Previous screen view |
| Hold | 0.7 s | Force data refresh |
| Long hold | 15 s | Reset WiFi + reboot |
E-Ink — Button Controls
| Action | Duration | Result |
|---|---|---|
| Short press | < 3 s | Next screen view |
| Hold | 3 s | Force data refresh |
| Long hold | 15 s | Reset WiFi + reboot |
The button is the button on the Waveshare ESP32 Driver Board.
Colour / Display Codes
| Colour | Wait range | Notes |
|---|---|---|
| ● Green | Under 15 minutes | Go now! |
| ● Amber | 15 – 29 minutes | Moderate queue |
| ● Red | 30 minutes or more | Long queue |
| ● Cyan | N/A | Virtual queue / boarding group active |
| ● Grey | N/A | Attraction closed or data unavailable |
Control Panel (magicwaits.com)
All configuration is done at magicwaits.com. Changes are picked up automatically on the next data fetch.
| Setting | Description |
|---|---|
| Trip Date | The date you are travelling. The countdown is calculated from today to this date. |
| Park Selection | Which theme park's wait times to display. |
| Timezone | Your local timezone as an offset from UTC (e.g. −5 for Eastern Time USA, +0 for UK, +1 for Central Europe). |
| Clock Format | 12-hour (with AM/PM) or 24-hour display. |
| Theme | Dark theme (default) or Light theme. E-Ink: "High Contrast" mode (white-on-black) is enabled when LightMode=0 in the control panel. |
| Left / Right Panel Mode | What each top panel shows (see Panel Modes below). |
| Selected Rides | Which rides to show in the bottom wait time list. |
| Refresh Interval | How often the device polls for new data, in minutes. |
| Countdown Label | The text below the countdown number, e.g. "DAYS TO GO". |
Panel Modes
Days Until
Countdown to your trip in large figures. Shows "TODAY!" when days = 0.
Status / Hello
Shows "MAGIC WAITS" and subscription status (LIVE / NO SUBSCRIPTION).
Yoda Quote
A custom quote attributed to Yoda. Use :: for line breaks.
Yeti Tracker
Auto-generated message counting how long the Yeti has been out of action.
Custom Quote
Your own quote. Use :: for line breaks.
Premier Pass Prices
Individual Lightning Lane prices per park, colour-coded by availability.
Single Ride
One attraction's wait time in giant numbers.
Multipass Prices
Lightning Lane Multipass prices per park.
Weather
Live weather for any city. Format: UNIT|Display Name|City, Country
Weather Setup
Panel content format: UNIT|Display Name|City, Country Code
| Content string | Result |
|---|---|
F|Orlando|Orlando, US | Shows "Orlando", temp in °F |
C|London|London, GB | Shows "London", temp in °C |
C|Paris|Paris, FR | Shows "Paris", temp in °C |
~ — e.g. F|Orlando|Lake Buena Vista~FL~US.
Ride Selection
The bottom section shows live attraction wait times. The number of ride slots depends on your subscription tier. Closed rides show as "CLOSED"; boarding groups show their group status.
Premier Pass Pricing
Modes 6 and 8 show up to 5 park entries with price and availability. Format: PARK $X.XX - Status separated by ::. On the TFT, Status determines colour: "Available" → green, "Limited" → amber, "Unavailable"/"Sold" → red. On the E-Ink, prices display in black with no colour coding.
WiFi Reset
TFT — Method 1: Screen Hold (15 s)
- At 0.7 s — data refresh fires
- At 3.7 s — amber banner: "Keep holding to reset WiFi"
- At 10 s — red banner: "WiFi resetting in 5s"
- At 15 s — WiFi cleared, device reboots
E-Ink — Button Hold (15 s)
Hold the button on the Waveshare driver board for 15 seconds. The device shows a confirmation on screen, then clears WiFi settings and reboots. A shorter hold (3 s) triggers a data refresh instead.
Auto-Refresh
The device fetches new data at a configurable interval (default: every 5 minutes). Shorter intervals are useful during park visits; longer intervals suit countdown-only use.
Both devices also perform a nightly reboot at 3:00 AM local time to stay healthy. The current view is restored after reboot.
Subscription
Live wait time data requires an active MagicWaits subscription, from just $2/month. Manage via magicwaits.com → Account → Subscription.
Free without subscription: countdown, weather, custom quotes, Yeti tracker.
Requires subscription: live wait times, Premier Pass / Lightning Lane pricing, boarding group status, single-ride panel.
Troubleshooting
Setup screen appears on every boot
The device could not connect to the saved WiFi. The router may be offline, the password changed, or you're on a different network. Re-run WiFi setup.
FETCH ERR / No data displayed
WiFi is connected but the server couldn't be reached. Try a manual refresh (TFT: hold screen 0.7 s · E-Ink: hold button 3 s). If it persists, check your internet connection and power-cycle the device.
Clock shows wrong time
Check the Timezone setting. Common values: −5 (Eastern US), −6 (Central US), −8 (Pacific US), +0 (UK/GMT), +1 (Central Europe), +10 (Eastern Australia). Daylight Saving may require ±1.
Screen is very dim or slow to light up TFT
Try a different USB cable or charger. The TFT needs at least 500 mA.
Touchscreen registers random touches TFT
The resistive touchscreen can be affected by moisture. Clean gently with a dry soft cloth.
E-Ink screen takes a long time to update E-Ink
This is normal. E-paper displays require a full-panel refresh cycle that can take up to 30 seconds. The display will flash through several greyscale stages before settling on the final image.
Ghost / shadow image visible on E-Ink screen E-Ink
Ghosting (faint remnants of a previous image) is a normal characteristic of e-paper. It will clear on the next full refresh. If ghosting persists, power-cycle the device.
E-Ink screen is completely blank / white E-Ink
The display may have entered hibernate mode. Press the button once to trigger a view cycle and refresh. If the screen remains blank after 30 seconds, power-cycle the device.
Frequently Asked Questions
Can I use the device without a subscription?
Yes — the countdown, weather, and quote panels all work without a subscription. Only live wait time features require an active subscription.
How often does the wait time data update?
The device fetches at your configured interval (default 5 minutes). The MagicWaits server fetches from park data sources approximately every 5 minutes, so data may be up to 10 minutes old in the worst case.
Does the device work outside the USA?
Yes. Parks supported include Disneyland Paris, Alton Towers, and others in addition to US parks.
Can I power the E-Ink display from a USB power bank?
Yes — the E-Ink device uses very little power. A 10,000 mAh power bank will typically last several days. Note: some power banks switch off when detecting a low-draw device. Choose one that stays on with low-current loads, or enable a "keep alive" mode if available.
Can I power the TFT from a USB power bank?
Yes, provided the power bank delivers 5V and at least 500 mA. Note some power banks switch off after detecting a low-draw device.
Can I wall-mount the E-Ink display?
Yes. The E-Ink display and its driver board are small and light. A small power bank taped to the back provides a completely wireless, wall-mounted installation. Use a power bank with a keep-alive feature to prevent it from switching off.
Why does the E-Ink screen flash when updating?
E-paper displays use a full-inversion refresh cycle to align the particles in the display medium. The flashing through black/white/grey stages is normal and ensures the best image quality.
Does the E-Ink display show the time?
Yes — the E-Ink display now has a working clock. Set panel mode 2 (or 10) on either panel, or switch to the Big Clock view (view 6). The clock uses a fast partial refresh every minute, so you won't see the usual 30-second full redraw each time. A full ghost-clearing refresh happens automatically every 30 clock updates.
What is High Contrast mode on the E-Ink display?
High Contrast mode inverts the display to white text on a black background. Enable it by setting LightMode to 0 in the control panel (0 = dark/high-contrast, 1 = normal light).
What is Bold mode on the E-Ink display?
Bold mode promotes the body fonts to larger, bolder variants for improved legibility. Enable it by setting Expansion1 to 1 in the control panel.
Need more help? Visit www.magicwaits.com and use the contact form.