Getting started
Quick start guide
From box to live market data in a few minutes. Follow the steps below to set up your DeskDisplay.
What's in the box
Check that all parts are present before you begin:
- DeskDisplay with wooden base
- USB-C power cable
- Quick start card
You will need your own USB-C power adapter (5V, at least 2A). A standard phone charger works fine.
Power up
- Connect the USB-C cable to the port on the back of the display.
- Plug the adapter into a wall outlet. The display starts up automatically.
Connect to WiFi
On first boot, the display creates its own WiFi hotspot:
- Open WiFi settings on your phone or laptop and connect to:Network: MatrixOS-Setup
Password: matrix123 - Open your browser and navigate to:192.168.4.1
- Select your home network, enter the password, and click Save & Restart.
- The display restarts and connects. This takes about 10–20 seconds.
- After connecting, the display shows its IP address on screen — you will need this to open the dashboard.
Make sure your router broadcasts on 2.4 GHz. The DeskDisplay does not support 5 GHz networks.
Add your first apps
Once connected, open the cloud dashboard to manage your display:
- Use the App Dashboard button on the setup page (Device-IP), to open the dashboard with your Device ID pre-filled.
- Click + Add App and choose from the available app types.
- Configure the app — for example, enter a ticker symbol or city name.
- Click Save. The app appears on the display within seconds.
- Add multiple apps. The display cycles through them automatically.
Available apps include: Crypto Ticker, Stock Ticker, ETF Ticker, Metal Ticker, Forex Ticker, Clock, Weather, Countdown, Pixel Art, Text Scroller, and more.
Done
Your DeskDisplay is running. Apps update automatically. You can return to the dashboard at any time to add, remove, or reconfigure apps.
Getting started
Using your DeskDisplay
How the display works, what infowidgets are available, and how to manage everything from the dashboard.
The display
The DeskDisplay runs infowidgets — each infowidget occupies the full 64×32 pixel screen. When you have multiple infowidgets configured, the display cycles through them one by one. Each infowidget handles its own layout, animation, and update interval.
- Each infowidget has its own layout and update interval — market data, time, weather, countdowns, and more.
- When multiple infowidgets are active, the display cycles through them automatically.
- All changes made in the dashboard take effect within seconds, no restart needed.
The dashboard
The dashboard runs directly on your device and opens via its local IP address. Type http://<device-IP> in your browser — replace <device-IP> with the address shown on the display after connecting to your network. Tip: save this link as a bookmark so you can always get back quickly.
- Your active apps are listed as cards. Each card shows the app type and its current settings.
- Click the settings icon on a card to change its configuration.
- Click + Add App to add a new app.
- All changes apply within seconds. No restart is required.
Brightness can be adjusted using the side buttons on the device, or from the dashboard. The minimum brightness is 10.
Market infowidgets
These infowidgets show live prices and a candlestick or line chart. Each requires a symbol and optionally a currency and chart interval.
- Crypto Ticker — any cryptocurrency: BTC, ETH, SOL, XRP, ADA, DOGE, and more.
- Stock Ticker — US stocks: AAPL, MSFT, GOOGL, TSLA, NVDA, and more.
- ETF Ticker — ETFs: SPY, QQQ, VOO, VTI, ARKK, and more.
- Metal Ticker — precious metals: XAUUSD (gold) and XAGUSD (silver).
- Forex Ticker — currency pairs: EUR/USD, GBP/USD, USD/JPY, and more.
Stock and ETF data is only available during market hours. Outside trading hours the last known price is shown.
Information infowidgets
- Clock — time and date in 12h or 24h format. Configurable timezone, language, and color.
- Weather — current conditions for any city worldwide.
- Dutch Energy Price — live electricity price per kWh for the Dutch market, with optional min/max display. Supports all major Dutch energy suppliers.
Fun infowidgets
- Countdown — count down the days, hours, and minutes to any date. Useful for holidays, birthdays, or deadlines.
- Is It Time? — displays YES or NO based on whether a set hour has been reached. Set it to your lunch break, end of the workday, or anything else.
- Text Scroller — scroll any custom text across the display in a chosen color and position.
- Pixel Art — display a custom 64×32 PNG image, optionally with a clock overlay.
Restarting and resetting
- To restart: unplug and replug the power cable.
- To reset WiFi: hold the button on the back for 5 seconds until the display blinks. The device returns to hotspot mode and you can reconfigure the WiFi connection.
Reference
Infowidgets
All available infowidget types and their configuration parameters. Add any of these from the dashboard by clicking Add infowidget.
Clock
Displays the current time and date.
- Format — 24h or 12h.
- Color — text color: white, green, blue, orange, red, or purple.
- Language — en (English) or nl (Dutch). Affects the day-of-week label.
- Timezone — the timezone used to display the current time. Choose from Amsterdam, London, Berlin, Paris, New York, Chicago, Los Angeles, or UTC.
Crypto Ticker
Shows the live price of any cryptocurrency along with a price chart and 24h change.
- Symbol — the coin identifier: BTC, ETH, SOL, XRP, ADA, DOGE, and more.
- Percentage position — where the 24h change is shown: topright, bottom, or off.
- Chart interval — candlestick interval: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 1d, 3d, 1w, or 1M.
- Currency — price display currency: usd or eur.
- Show timeframe — show or hide the chart interval label on screen: on or off.
Stock Ticker
Shows the live price of any US-listed stock along with a chart and daily change. Data is only available during market hours.
- Symbol — the ticker symbol: GOOGL, AAPL, MSFT, TSLA, NVDA, and more.
- Percentage position — topright, bottom, or off.
- Chart interval — 1m, 5m, 15m, 30m, 1h, 4h, 1d, or 1w.
- Currency — usd or eur.
- Show timeframe — on or off.
Outside trading hours the last known closing price is displayed.
ETF Ticker
Same as Stock Ticker but for exchange-traded funds. Data is only available during market hours.
- Symbol — the ETF ticker: SPY, QQQ, VOO, VTI, ARKK, and more.
- Percentage position — topright, bottom, or off.
- Chart interval — 1m, 5m, 15m, 30m, 1h, 4h, 1d, or 1w.
- Currency — usd or eur.
- Show timeframe — on or off.
Metal Ticker
Shows the live spot price of precious metals.
- Symbol — XAUUSD (gold) or XAGUSD (silver).
- Percentage position — topright, bottom, or off.
- Chart interval — 1h, 4h, 1d, or 1w. Shorter intervals are not available for metals.
- Currency — usd or eur.
- Show timeframe — on or off.
Forex Ticker
Shows the live exchange rate for a currency pair.
- Symbol — choose one of: EURUSD, GBPUSD, USDJPY, AUDUSD, USDCAD, NZDUSD, EURGBP, or EURJPY.
- Percentage position — topright, bottom, or off.
- Chart interval — 1m, 5m, 15m, 30m, 1h, 4h, 1d, or 1w.
- Show timeframe — on or off.
Weather
Shows current weather conditions for any city worldwide.
- City — enter a city name, for example: Amsterdam, London, or New York.
Countdown
Counts down the days, hours, and minutes to a target date and time.
- Label — a short text label shown on the display, for example: CHRISTMAS, BIRTHDAY, or MEETING.
- Date — the target date in YYYY-MM-DD format, for example: 2026-12-25.
- Time — the target time in HH:MM format, for example: 00:00.
- Color — text color: green, red, blue, orange, purple, or white.
- Timezone — the timezone the countdown is relative to.
Is It Time?
Displays YES or NO depending on whether a set hour has been reached. Useful as a fun desk reminder.
- Item — the thing you are waiting for: BEER, LUNCH, GYM, and so on.
- Time (hour) — the hour at which the answer switches from NO to YES (6–23).
- Timezone — the timezone to use when evaluating the current time.
Text Scroller
Scrolls any custom text across the display.
- Text — the message to display, for example: Hello World!
- Color — white, green, blue, orange, red, purple, or yellow.
- Position — vertical position of the text: center, top, or bottom.
Pixel Art
Displays a custom image on the screen. The image must be a 64×32 PNG file uploaded to the device. Use the built-in Pixel Art editor to draw directly on a 64×32 canvas and export as PNG.
- Filename — the filename of the uploaded PNG, for example: demo.png.
- Clock overlay — optionally draw the current time on top of the image. Choose a corner or center position, or off.
Spotify Now Playing
Shows the track currently playing on Spotify. Requires a Spotify Developer account to generate the necessary credentials.
- Spotify Client ID — from your Spotify Developer app.
- Spotify Client Secret — from your Spotify Developer app.
- Refresh Token — a long-lived token that allows the DeskDisplay to access your Spotify account.
To generate these credentials, use the online tool
- Go to developer.spotify.com/dashboard and log in with your Spotify account.
- Create a new app. Fill in any name and description. Under Which API/SDKs are you planning to use? check Web API.
- Open the Spotify Connect tool — it shows the exact Redirect URI to add to your Spotify app settings.
- Copy your Client ID and Client Secret from the Spotify app dashboard.
- Enter both into the Spotify Connect tool and click Authorize with Spotify.
- Log in to Spotify and click Agree. The tool then displays your Client ID, Client Secret, and Refresh Token.
- Copy all three into the infowidget configuration.
Dutch Energy Price
Shows the live electricity price per kWh for the Dutch market. Prices update hourly.
- Supplier — optionally filter prices by your energy supplier. Leave empty to show the base market rate.
- Show min/max — whether to show the lowest and highest price of the day: on or off.
Dutch Gas Price
Same as Dutch Energy Price but for natural gas, in price per m³.
- Supplier — optionally filter by supplier.
- Show min/max — on or off.