Skip to content

Modes

Jump to bottom
github-actions[bot] edited this page Apr 7, 2026 · 25 revisions

🎛️ Modes

Clocks: Binary clock | Binary epoch | Breakout clock | Clock | Game of Life | Ping-pong | Snake

Games: Breakout clock | Game of life | Ping-pong| Snake

IKEA Frekvens: Arrow | Blinds | Equalizer | Jagged Waveform | Ring | Smooth waveform

IKEA Obegränsad: Circle | Lines | Noise | Rain | Scan | Stars

Interactive: Animation | Countdown | Draw | Flies | Ticker

Smart-home: Home Thermometer | Stream | Weather

Miscellaneous: Blink | Bright | Firework | Glitter | Leaf fall | Metaballs | Pixel sequence | Waveform

🎬 Animation

Create simple animations and show it off on the display.

Use the Web app to get started.

Tip

The Microphone extension can be used to play/pause the animations.

Configure in .env:

MODE_ANIMATION='true'

See also Draw.

⬇️ Arrow

Inspired by the original IKEA Frekvens mode.

Tip

The Microphone extension can be used to play/pause the arrow, just like on a stock IKEA Frekvens device.

Configure in .env:

MODE_ARROW='true'

0️⃣ Binary clock

Binary clock, counts seconds since midnight.

Configure in .env:

MODE_BINARYCLOCK='true'

See also Binary epoch.

1️⃣ Binary epoch

Binary clock, counts seconds since 1970.

Configure in .env:

MODE_BINARYEPOCH='true'

See also Binary clock.

🪟 Blinds

Inspired by the original IKEA Frekvens mode.

Tip

The Microphone extension can be used to play/pause the blinds.

Configure in .env:

MODE_BLINDS='true'

👁️ Blink

Use it as an alarm.

Configure in .env:

MODE_BLINK='true'

See also Bright.

💥 Breakout clock

Inspired by the classic breakout game.

Configure in .env:

MODE_BREAKOUT='true'

🌟 Bright

Use it as a lamp, if desired.

Configure in .env:

MODE_BRIGHT='true'

See also Blink.

⚪ Circle

Inspired by the original IKEA Obegränsad mode.

Tip

The Microphone extension can be used to play/pause the circle.

Configure in .env:

MODE_CIRCLE='true'

See also Ring.

⏱️ Clock

Clock with font selection and optional seconds indicator.

Configure in .env:

MODE_CLOCK='true'

⏳ Countdown

Start a countdown timer.

The display will blink when the timer reaches zero.

Use the Web app to start a new countdown, it can also be automated via Home Assistant.

API payload examples:

{
    "time": 600
}
{
    "timestamp": "2025-12-02T18:39:00"
}

Note

The expected timestamp format is an ISO 8601 string without timezone suffix.

Configure in .env:

MODE_COUNTDOWN='true'

See also Blink.

🎨 Draw

Create artwork and show it off on the display.

Use the Web app to get started.

Configure in .env:

MODE_DRAW='true'

📊 Equalizer

Inspired by the original IKEA Frekvens mode.

Tip

The Microphone extension can be used to play/pause the equalizer, just like on a stock IKEA Frekvens device.

Configure in .env:

MODE_EQUALIZER='true'

🎆 Firework

Happy new year.

Configure in .env:

MODE_FIREWORK='true'

🪰 Flies

Multiplayer fly-simulator.

Configure in .env:

MODE_FLIES='true'

🌱 Game of life

Inspired by Conway’s Game of Life. Comes with an optional clock.

Configure in .env:

MODE_GAMEOFLIFE='true'

✨ Glitter

Inspired by snow on old analog TVs.

Configure in .env:

MODE_GLITTER='true'

🌡️ Home thermometer

Smart-home integration.

Display the current indoor and outdoor temperatures.

Integrated into Home Assistant.

API payload example:

{
    "indoor": 21,
    "outdoor": 9
}

Configure in .env:

MODE_HOMETHERMOMETER='true'

📈 Jagged waveform

Inspired by the original IKEA Frekvens mode.

Tip

The Microphone extension can be used to play/pause the waveforms, just like on a stock IKEA Frekvens device.

Configure in .env:

MODE_JAGGEDWAVEFORM='true'

See also Smooth waveform and Waveform.

🍂 Leaf fall

Autumn-inspired.

Configure in .env:

MODE_LEAFFALL='true'

☰ Lines

Inspired by the original IKEA Obegränsad mode.

Tip

The Microphone extension can be used to play/pause the lines, just like on a stock IKEA Frekvens device.

Configure in .env:

MODE_LINES='true'

See also Scan.

🔵 Metaballs

Inspired by organic, blob-like shapes.

Tip

The Microphone extension can be used to play/pause the movement of the shapes.

Configure in .env:

MODE_METABALLS='true'

🔇 Noise

Inspired by the original IKEA Obegränsad mode.

Configure in .env:

MODE_NOISE='true'

🏓 Ping-pong

Inspired by the classic ping-pong game. Comes with an optional clock.

Configure in .env:

MODE_PINGPONG='true'

🔢 Pixel sequence

For tech enthusiasts, it iterates through the pixels one by one, following the SPI bus addressing order.

Tip

The Microphone extension can be used to play/pause the sequence.

Configure in .env:

MODE_PIXELSEQUENCE='true'

☔ Rain

Inspired by the original IKEA Obegränsad mode.

Configure in .env:

MODE_RAIN='true'

💍 Ring

Inspired by the original IKEA Frekvens mode.

Tip

The Microphone extension can be used to play/pause the ring, just like on a stock IKEA Frekvens device.

Configure in .env:

MODE_RING='true'

See also Circle.

🔍 Scan

Inspired by the original IKEA Obegränsad mode.

Tip

The Microphone extension can be used to play/pause the scan.

Configure in .env:

MODE_SCAN='true'

See also Lines.

〰️ Smooth waveform

Inspired by the original IKEA Frekvens mode.

Tip

The Microphone extension can be used to play/pause the waveforms, just like on a stock IKEA Frekvens device.

Configure in .env:

MODE_SMOOTHWAVEFORM='true'

See also Jagged waveform and Waveform.

🐍 Snake

Inspired by the classic snake-game. Comes with an optional clock.

Configure in .env:

MODE_SNAKE='true'

⭐ Stars

Inspired by the original IKEA Obegränsad mode.

Configure in .env:

MODE_STARS='true'

💻 Stream

Provides real-time pixel and lighting data over Wi-Fi, allowing the display to be driven live from external software and controllers.

Multiple widely used streaming protocols are supported:

  • Art-Net – Real-time lighting control data over UDP/IP.
  • Distributed Display Protocol (DDP) – Efficient pixel-oriented data streaming.
  • E1.31 (sACN) – Network-based DMX512 data streaming.

Receivers:

  • example.local:4048
  • example.local:5568
  • example.local:6454

Tip

The Stream csv Python script streams custom content such as animations and drawings.

Configure in .env:

MODE_STREAM='true'

🅰️ Ticker

Rolling text.

Use the Web app to set a message, or automate it via Home Assistant.

API payload example:

{
    "font": "Mini",
    "message": "Hello world!"
}

Configure in .env:

MODE_TICKER='true'

See also Message.

🔊 Waveform

Inspired by the two original IKEA Frekvens modes.

Tip

The Microphone extension can be used to play/pause the waves, just like on a stock IKEA Frekvens device.

Configure in .env:

MODE_WAVEFORM='true'

See also Jagged waveform and Smooth waveform.

⛅ Weather

Providers available:

Configure in secrets.h:

#define LATITUDE "0.000"  // coordinate
#define LONGITUDE "0.000" // coordinate
#define LOCATION "city"

Note

Provide 3-4 decimals for the most accurate weather reports. A small subset of providers also supports a location name, usually in the form of a city or village.

Configure in .env:

MODE_WEATHER='true'
TEMPERATURE_UNIT='°C' # °C, °F or °K

🤝 Contributions are welcome!

To help improve this wiki, open a pull request to docs/wiki.

📌 Getting Started

💡 Devices

📦 Modules

➕ Accessories

🗃️ Miscellaneous

Clone this wiki locally