How to play it.

The ESP32

Everything runs on one small board.

Patternflow's brain is an ESP32-S3 module, seated in sockets on the board inside. Slide the back cover off sideways, then lift the module out — gently, straight up.

Hold it like this

Antenna up, ports toward you.

The module at the top, its antenna end up; the two USB-C ports at the bottom. Which way you hold it matters for the next step.

The left port

Plug into the LEFT one.

Use the left port, labelled USB, with a USB-C cable that carries data, and plug the other end into your computer.

The right one (UART) is for Arduino IDE. The browser can flash through it, but it can't set up Wi-Fi there.

Nothing shows up at all? It's almost always a charge-only cable. Try another one first.

Flash

Flash Patternflow.

In desktop Chrome or Edge, press Flash Patternflow below and pick the port. The dialog walks you through the rest; its screens are under the button. The whole thing takes about two minutes.

Flash PatternflowFlashing works in desktop Chrome or Edge.

No port in the list?

Hold BOOT, tap RST, let go.

Put it in download mode by hand, then press Flash Patternflow again. The port appears as USB JTAG/serial debug unit.

In download mode the flasher can't tell it's already Patternflow, so it treats it as new and erases it — installed patterns and saved Wi-Fi too.

1. 1Hold BOOT
2. 2Tap RST
3. 3Release BOOT

Wi-Fi

Type your network.

Press Next, then type your network's name exactly — capitals count — and its password. 2.4 GHz only: the ESP32 can't see 5 GHz.

After the installNo Wi-Fi step?

Power

Back in. Power on.

Seat the ESP32 back in its sockets the way the silkscreen shows, slide the back cover on, and plug Patternflow's power cable into a power bank.

Power always goes in through that cable — never through the ESP32's USB ports.

The numbers

They start at the top right.

K1 top right, K2 top left, K3 bottom right, K4 bottom left. Not the order you'd guess.

Turn

Turning belongs to the pattern.

Each knob moves whatever the running pattern gives it. On Origin: K1 colour, K2 speed, K3 the tiling, K4 the wave's frequency.

Every pattern decides its own four. That's the point.

The one here plays like yours: take the orange dot on a knob's ring and drive it round — beside the knob you'll see what that knob is and where it is. Click to press, hold a second for its screen.

Press

So does a short press.

A click goes to the pattern too. On Origin it zeroes that knob: K1 back to red, K2 stops the motion, K3 back to the first tiling, K4 to its lowest frequency.

Hold K1

Brightness.

Hold any knob for a second and the device takes over from the pattern. K1 is brightness: turn K1 to set it, then press K1 — or just wait five seconds.

Hold K2

The network.

K2 shows the Wi-Fi state and the board's IP address, split over two lines. Remember where it is: it's how your phone finds the board.

Turning K1 here puts the panel to sleep. Any knob wakes it.

Hold K3

Which knob is which.

K3 puts every knob's number on the panel, and the one you're turning lights up in orange.

Hold K4

Patterns.

K4 opens the pattern list. Turn K4 to move — three clicks per pattern — and it loads when you stop. Hold K4 again to close it.

Right now it says 1 / 1. That's next.

1 / 1

A new board has one pattern.

Origin is built into the firmware, so a board can always boot into something. Everything else lives on the board's storage and installs in seconds.

Basics

Let's put the Basics deck on.

The community has patterns one by one, and decks — a set of them, like a hand of cards. Basics is the deck made for a new board: 33 patterns, no account needed.

A single pattern goes on the same way, from its own page (Send to my Patternflow). And you can make a deck of your own and share it.

Install

Install to my board.

On the Basics card, press Install to my board. Your browser opens the board's own page and hands it the whole pack over your Wi-Fi — the board never goes on the internet itself.

The first time, it asks to format its storage. Press Format storage, confirm, and the pack installs by itself, file by file. It takes under a minute.

Android can't open patternflow.local. Hold K2 and type the IP address into Device address on the card first.

1 / 34

Hold K4 again.

Origin and the 33 Basics. Turn K4 to browse, stop to play, hold to close.

patternflow.local

Open it in a browser.

On a computer on the same Wi-Fi, go to patternflow.local. What's playing, brightness, sleep, the four knobs as sliders — and a page for everything else.

The one below is live. Open it, step through patterns with the arrows by Now playing or slide a knob, and watch the panel follow.

On a phone

Use the address on K2.

Phones — Android especially — often can't find patternflow.local. Hold K2 and type the IP address it shows. On Windows, http://patternflow/ works too.

Same console, phone-sized. Try it here too.

Inside

What's in it.

Patterns to install, delete or download. Up to five Wi-Fi networks, the latest first unless you pick one. Which way each knob counts. And new firmware, over Wi-Fi, with your patterns kept.