SHOW DEVICE SCREEN
Position and toggle the elements of each device screen (clock, labels, widgets) with a live preview.
🖼️ Open Layout Editor
PANEL OPTIONS
Rotate the whole screen upside-down (for inverted mounting). Applies instantly.
Fixes panels that show inverted colours (e.g. yellow appears blue). Applies instantly — flip this if the colours look wrong.
Show LVGL's on-screen FPS + CPU% counter (bottom-right). Applies instantly.
VISIBLE SCREENS
Hidden screens are skipped when cycling screens on the device.
BOOT & SPLASH
Custom logo from the SD card (LVGL RGB565
.bin, any size — auto-fit to the panel). Requires an SD card; empty = built-in logo.
File:
(built-in)
Lower it to darken the wallpaper (both SD and internet) so
on-screen text stays readable. Gradient/solid backgrounds are not affected.
100% = original image.
The device downloads a photo straight from the selected service
(on that service's own terms) and uses it as the screen background, kept in RAM
until reboot. A playing radio stream pauses during the download. NASA APOD API
links are resolved automatically (DEMO_KEY is rate-limited — a free personal key
from api.nasa.gov lifts that).
Uses the URL above (saved together with the schedule).
The wallpaper lives in RAM only, so both auto modes re-fetch it ~30 s after
every boot. A playing radio stream is paused for the few seconds of the download.
Changes apply instantly on the device display.
At the evening time dims the screen and can stop the radio; at the morning time brightens and can start a station (fades in). Requires NTP-synced clock.
💡 For idle-based dimming (lowers brightness after inactivity, not by clock), see Screensaver → Style → Dim.
Idle time before the screensaver starts. 0 = OFF.
Keeps the screen on while radio, SD or Bluetooth audio is active.
This screensaver shows the widgets defined in the MQTT settings.
Configure the broker connection and widgets on the
📨 MQTT tab.
After the idle delay the current screen stays on but the backlight
drops to this level. Any tap or encoder restores full brightness.
💡 For clock-based dimming (a fixed night window), see Dim & Wake.
Plays LVGL
.bin slides from the SD card. Convert images with
scripts/img2lvgl.py and upload them via the SD file manager.
Enter the folder as a full path starting with /sdcard,
e.g. /sdcard/slides/320x240 (letter case doesn't matter).
Polls a JSON endpoint and renders one value. Active when screensaver style is "Dashboard".
Must return JSON. HTTPS supported via cert bundle.
Dot/bracket path into the response, e.g.
rates[0].mid,
main.temp, data[2].value. Empty = use root.
Appended to the value. Leave empty for none.
Minimum 5 s. Default 60 s.
Plays a melody when the value crosses a threshold. Fires once per crossing;
rearms when the value comes back across.
When off, the 10-band EQ is bypassed entirely. Volume is unaffected.
When on, if the radio was playing before a restart, it resumes the last station automatically after boot.
When on, starting Bluetooth playback stops the radio and starting the radio pauses the phone, switching the audio source automatically.
Leave blank to keep the existing password.
Web address of the device — copy & paste into a browser.
Clear the field for an automatic name derived from the MAC.
How the clock is shown on the device's home screen. Applies instantly.
How the date is shown on the device's home screen. Applies instantly.
Max 63 chars. Select a preset or type manually.
⚠ Changing the timezone while events are scheduled may cause an already-fired
event to trigger again (or a due event to be skipped) if the local date shifts.
Set your timezone once during initial setup and avoid changing it later.
When disabled, the device does not connect to the broker.
Leave blank to keep the existing password.
Device topics will be: <base>/state/* and <base>/cmd/*.
🔧 Edit MQTT Widgets
Up to 6 widgets (toggle / slider / label) shown on the MQTT screen.
HARDWARE
Remap GPIO pins for display / touch / SD / encoder / Bluetooth, stored on the
device. Advanced — wrong pins can blank the display (recoverable here).
Opens the built-in setup page.
🔌 Open pin setup
Current version
…
🔔 Show an update prompt on the device screen when a newer firmware is
available. The device always checks at boot — this only controls the
on-screen prompt.
Upload an application image —
atlascube.bin, or
AtlasCube-<display>-ota.bin for your display from
atlascube.net/flash.
The device writes it to the inactive slot and reboots into the new firmware.
Do not power off during the upload.
Download the currently running firmware as a
⬇️ Export running firmware
.bin (the full app
slot) — a re-flashable snapshot to keep before updating.
Built
…
Re-upload the web UI after an app-only OTA left it behind (the warning
above). Pick the raw files from
spiffs_image/www/ — get the
matching set (AtlasCube-www.zip) from the
latest release. Include
www_version.txt in the selection to clear the warning.
HTML/CSS/JS are gzipped on the device; .ico isn't supported here.
Download every user file on the
config partition (settings,
theme, events, MQTT, layout and the station list) as a single
.json — a snapshot to keep before a full USB flash, which
erases them. Wi-Fi/MQTT passwords live in a separate secure store and are
not included. Restore reuploads each file, then restart.
Restore a backup made above. Existing files are overwritten.