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 a touch layer mounted differently than the panel — taps landing mirrored or on the wrong axis. Independent of the display flip above, so rotating the image no longer rotates the touch. Change one at a time and tap to check; all three off = panel default.
Fixes panels that show inverted colours (e.g. yellow appears blue). Applies instantly — flip this if the colours look wrong.
Fixes panels wired in the opposite channel order — red shows as blue, blue as orange, while green stays correct. Independent of Invert colours above, which affects all three channels. Applies instantly. No effect on the AMOLED and mono panels.
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)
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.
Mono sums left and right into both channels — for single-speaker builds.
This affects the output only, not the stream itself: the CHANNELS readout on the device
and in the web player keeps showing the source format (so a stereo stream still reads
STEREO), and the VU meters keep their stereo image.
Bluetooth playback is unaffected (it bypasses the DSP).
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.
Plays a signal on the left channel, then the right — a quick way to verify the wiring, amp and speakers without an SD card or stream. Uses the current volume.
Pick a network instead of typing its name. While connected, a scan
briefly hops off-channel and a playing stream may stutter.
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.
Shows current conditions on the device's home screen.
Widget position is set in the layout editor.
Search powered by Open-Meteo, or enter coordinates manually. Saving remains a separate step.
—
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) plus the hardware
pin map 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. Same file format as the
built-in setup page — a backup made there imports here
and the other way round.
Restore a backup made above or on the setup page. Existing files are
overwritten; a restored pin map needs a full power cycle (not just a
restart) to take effect.
Paired pilot
…
The pilot talks to the radio over ESP-NOW, not Wi-Fi — this button only
opens a 60-second window during which the radio accepts a pairing
request. Press it, then start pairing from the pilot's own menu.
Pairing again replaces the stored pilot.