devlog.

Project · Wearable

Pokewalker

The Pokéwalker that came with HeartGold and SoulSilver, rebuilt and grown up. It runs on a round 412×412 touchscreen, designed to sit in a printed Poké Ball, and turns your steps into Watts. Your team lives in it. One of them can move into a room as a pet. A ring of games, a 3D stadium for battles, sixteen gym leaders, wild areas to catch in, RALLY races, a park other walkers share, a portal on the web, and a real Game Boy link-cable trade. A whole open region is being built round it. All of it is Rust, written from nothing.

Try it in your browser: the walker's own software, compiled to WebAssembly. Watch the one-minute film.

190,198
Lines of Rust, 20 crates
16
Gym leaders, Kanto then Johto
251
Species, each with its real learnset
412×412
Round touch screen, the board's own
The round Poké Ball walker standing on a dark reflective floor, its glass showing the walking face: Pikachu, level 50, 150 Watts and the time 07:30 in a red and white band.
The walker, rendered from the shell's own model, with its real walking face on the glass.

The device

A bought-in board and one printed shell.

The board

Waveshare ESP32-S3, round and touch

  • ESP32-S3-Touch-LCD-1.46B: a round 412×412 IPS panel with touch on the same controller, two side keys (PWR and BOOT) and a motion sensor
  • No custom circuit board. The walk loop drives the panel at about 15 frames a second
  • The software draws a 103×103 picture and scales it four times, so every dot is a crisp 4×4 block
  • A desktop window and a browser build run the same code as the board

The shell

The ball is the picture

  • One printed cup, ⌀51.8 mm at its widest; the board drops in from the front and the glass is the whole face
  • Three M2 screws through the back into the board's own standoffs. Nothing glued, nothing snapped
  • Fit checked against all 420 solids of Waveshare's own 3D model, which caught two clashes under a fiftieth of a millimetre
  • Two printed side keys, a red and white paint line, and a belt clip shaped from a 3D scan of the original's
The walker on a dark reflective floor with its screen lit on Pikachu's walking face.
The shell turning, from the back and its clip round to the face.
CAD render of the shell face on: a round white cup with the black-rimmed glass filling the whole front.
Face on: the glass is the whole front.
CAD render of the shell from the front at an angle, the glass on top and the curved white body below.
The glass sits proud of a curved body.
CAD render of the shell's back: a rounded dome with the belt clip and two screw pockets.
The back, with the clip shaped from the original's.
CAD render of the shell side on, the clip running under the back.
Side on.
Exploded CAD render: the board and glass lifted out of the cup, the battery in the bay, a side key and screws beside it.
Exploded: board, battery, cup, keys, screws.
CAD render of the shell cut in half to show the board seated inside the cup.
Cut through: the board seated in the cup.
CAD render of the shell's side with the two printed keys in their holes.
The two printed side keys.
CAD render close-up of the USB-C opening in the shell's side.
The USB-C opening.

Battles and gym leaders

Generation 1's rules in a 3D stadium, with three lanes on top.

The engine

Gen 1 rules, one twist

  • Damage, types and accuracy follow Pokémon Red and Blue, with no floating point, so the walker, the browser and the server get the same result to the byte
  • The twist: three lanes and a secret stance every turn. Jump the wrong way and an attack lands for double
  • One command screen: four moves, where to aim, where to stand. Leave it alone and it plays the AI's choice

The stadium

A camera that moves

  • A real 3D camera orbits the field and swings behind whoever is acting
  • Surf, Earthquake, Thunderbolt and Thunder get their own effects painted into the stadium. Every other move plays the cartridge's own animation
  • Critical hits become a beam clash in the middle of the field; knockouts crack the wall
  • Pick a squad first: 1V1, 3V3 or 6V6, in the order you tap them

Gyms

Sixteen leaders who read your team

  • Gold's sixteen: Brock to Blue, then Falkner to Clair. 200 Watts a challenge, win or lose
  • The leader sizes up your team and builds one a little ahead of it. Challengers win about four times in ten
  • Each leader has an arena of their own, an entrance, lines written for this, and a badge drawn for it

The wild

Nine areas to catch in

  • Real wild tables from Gold and Blue, under names of their own, unlocked by steps, badges and catches
  • An encounter every 25 steps, or search for 2 Watts. Catch with Gold's catch rules and wobbles
  • Shiny odds you choose: 1 in 8,192, 1 in 4,096 or 1 in 512. A Shiny Charm for all sixteen badges
  • A PC of eight boxes of thirty, and Gold's 57 TMs and HMs
The SQUAD screen: 1V1 and 3V3 tabs, Pikachu, Charizard and Heracross listed in order at level 50, and GO 200W at the bottom.
Pick a squad and its order, then GO.
The match card: the screen split diagonally red and green, a portrait of each trainer, a VS badge between them, INDIGO PLATEAU across the top and three bars under each trainer.
The match card. One bar per Pokémon.
A Poké Ball tumbling towards the camera over blue speed lines.
Each Pokémon comes out of its own ball.
Brock's entrance: his portrait over a rocky arena, his name on a ribbon with a ROOKIE tag, and a speech box.
Brock sizes you up as a rookie.
Misty's entrance: her portrait over the stands, a ROOKIE tag, and READY TO GET SOAKED? in the speech box.
Misty.
Lt. Surge's entrance: his portrait crackling with electricity, a ROOKIE tag, and HEY, KID! I'M SURGE! in the speech box.
Lt. Surge.
Morty's entrance: his portrait before red shrine gates at night, a ROOKIE tag, and I SAW YOU COMING in the speech box.
Morty, at his shrine.
Sixteen round screens in a grid, one per gym arena: Kanto's eight then Johto's, from Brock's rocky floor and Misty's pool to Pryce's ice rink and Clair's flooded cave.
All sixteen arenas, in challenge order.
Pikachu against Blastoise: Surf, Earthquake, Thunderbolt and Thunder, each with its own stadium effect. Sound on.
Every leader's entrance, a whole gym fight and all sixteen badges.
A wild encounter in a forest arena.
Whisper Woods: a wild Metapod, a thrown ball, and a fight.
A whole three-on-three, start to finish.

The open world

A whole region to walk, being built now.

The region

Sixteen gym towns round a park

  • One island region: the park and a downtown at the centre, sixteen gym towns round it, Kanto's and Johto's, and the League to the north
  • An organic layout of districts and neighbourhoods, joined by boulevards and a grand canal
  • Every gym town has a full-size arena; each district grows its own trees, from cherry blossom to autumn reds and snowy pines
  • Weather and wind: petals blowing down the boulevards, snow over the snowfields and Mahogany, ash and embers round Cinder Spire, passing showers and dawn mist on the canal

Status

A work in progress

  • The layout, the arenas, the weather and the wind all exist in the world engine
  • These are renders from it on a desktop, not from the walker. The region isn't on the device yet
  • Today's shared park is the piece of it already running, online and off
The Pokewalker Region map: a round island in a blue sea, the park and a street grid at the centre, sixteen numbered gym towns in coloured districts round it, a canal circling between them, snowfields and mountains to the west, the League at the top, and a weather key in the corner.
The region as the engine lays it out, with the weather at seven in the morning. Select it for the full-size map.
A boulevard lined with cherry trees, petals on the road and a fountain at the far end.
The south boulevard: the trees sway and the petals blow down the road.
Downtown: tall office blocks behind cherry trees, a road and paths across the grass.
Downtown.
A neighbourhood of small red-roofed houses among palm trees and winding paths.
A neighbourhood.
Celadon in blossom: a pink path through cherry trees past a green-roofed house.
Celadon in blossom.
Pewter's court: a paved square with pines, a sign, and the arena's stone walls behind.
Pewter, outside the arena.
Inside Pewter's arena: a wooden court ringed by rocks and stone stands.
Pewter's arena, full size.
The League's arena at night, its court lit in the dark under the stands.
The League, at night.
The volcano trail: bare trees and boulders on ashen ground, a glow of lava ahead.
The volcano trail.
The crater rim: a pool of glowing lava in grey ground, ash in the air.
The crater rim.
Snow-covered pines on white ground, snow falling.
The snowfields.
Ecruteak in autumn: red and orange trees over a brick plaza and a house.
Ecruteak in autumn.
The canal at dawn, mist over the water and trees along the bank.
The canal at dawn.
Tidewater Bay: palm trees on rippled sand beside the sea.
Tidewater Bay.

The portal

Your walker, on the web: friends, a league, replays and trades.

You and your friends

Cards, codes and pokes

  • A trainer card with your team, record and badge case, public, friends-only or private
  • Friends by a twelve-digit friend code
  • Poke a friend's ball, or challenge them: the server plays both teams' tactics and your walker replays the fight
  • Edit your team, names and settings from the site; they reach the walker on its next sync

The league

Monthly seasons, kept replays

  • A season a month, a table for each format: open, level caps, and a balanced level 50
  • Every battle is kept as a replay of about a kilobyte, played back in the browser by the walker's own stadium
  • Trophies come home as decorations for the pet's room

Live

Park, races, trades, backups

  • The live park, and live race rooms that anyone can watch
  • Trades between two trainers, held in escrow until both agree
  • Backups of the walker, the newest ten kept, restored with two presses on the device
The portal's home page on a phone: a Poké Ball, POKEWALKER ONLINE, the heading Your walker, in the League, and buttons to sign in and see the league.
The front door.
A trainer card: a trainer portrait, battles 4, badges 10 of 16, trophies 3, a win, a loss and a draw, a friend code and the badge case.
A trainer card.
The gym challenge page: a short explanation of the sixteen leaders, then a grid of all sixteen with their portraits and badges.
The gym challenge and its sixteen leaders.

Walking

Steps become Watts, and Watts pay for everything else.

The face

A ball that opens on your lead

  • At rest it is a lit Poké Ball you can turn with a finger. Double-tap and it opens on the walking face
  • The face shows your lead Pokémon, its level and health, the day's steps, Watts and the time
  • Tap the Pokémon and it cries and plays one of its real moves
  • Five ball styles, Poké to Safari, chosen per team member

Steps and Watts

One Watt a step

  • The board's motion sensor has no step counter, so the walker counts steps itself from the raw motion, 62.5 times a second
  • One Watt for every step, up to 65,535 in the purse. The original wanted twenty steps a Watt
  • Watts buy gym challenges (200), slot spins (5), Poké Radar (10), dowsing (3), searches in the wild (2), better balls and the pet's furniture
  • A 10,000-step daily ring and a seven-day history

The team

Six, and a roll between them

  • Up to six Pokémon, shown as a column of balls down the right of the face, each in its own colour
  • Flick up or down and the ball rolls a whole turn and opens on the next member, with its cry
  • All 251 species of the first two generations know their real moves and play the cartridge's own animations
  • Levels and experience on Generation 1's curves: the lead earns a point a step, the rest one every four
The walking face open on Pikachu, level 50, 150 Watts.
The ball opens on Pikachu, rolls to Charizard, and Charizard moves into the room.
Pikachu on the walking face.
Tap the lead and it shows off: Quick Attack, Swift, Agility.
Charizard in Gold's bedroom, next to the bed and the PC.
Pet mode: Charizard in the bedroom, using Flamethrower when it feels like it.

Pet mode

A Tamagotchi in Gold's bedroom.

The room

Your lead moves in

  • Tap the egg at the top of the face and your lead walks into the bedroom from Pokémon Gold
  • It gets hungry, sleepy and bored. Rub it, feed it berries, throw it a ball
  • Neglect makes it sad and nothing worse: no fainting, no running away
  • Teammates drop in to play, and every so often it uses one of its moves on its own

The rest of it

A shop, eggs and evolutions

  • PORYGON's PC sells furniture and food for Watts, at Gold's prices
  • Mom sends dolls at 10,000, 30,000, 50,000 and 100,000 lifetime steps
  • Two happy friends leave an egg that hatches after 2,000 steps
  • Friendship evolutions happen in the room

The games ring

Twelve icons round the rim, one double-tap from the face.

Radio

44 tracks, played by a sound chip

  • Every looping song from Pokémon Blue plus Yellow's extras, including the Game Corner and Surfing Pikachu's theme
  • Stored as notes for an emulated Game Boy sound chip, not as audio: 440 KB instead of about 30 MB
  • Star a favourite and it sorts to the front, and stays there after power-off

Slots · Radar · Dowsing

Three ways to spend Watts

  • Slots: three rings turning round the glass, tap to stop each one. Three of a kind wins, 1 in 64
  • Poké Radar: the original's rustling bushes, with chaining for shinies
  • Dowsing Machine: six spots, two guesses, "It's near!" or "Far away!". One find in ten is a rare TM

Surfing Pikachu

Yellow's minigame, on a round wave

  • The physics and scoring are ported from Pokémon Yellow's own minigame
  • Ride the waves and jump them for points
  • The rest of the ring is the pedometer, pet mode, settings, the trainer card, BATTLE, RALLY and the PC
Surfing Pikachu riding a blue wave on the round screen, the score at the top.
From the games ring into Surfing Pikachu.

RALLY and the park

Somewhere to go, and other people to meet there.

RALLY

Two laps against seven rivals

  • Your lead races a field of eight over three courses: Lakeside Loop, Forest Run and Grand Circuit
  • It runs itself. Hold a side to steer, tap for its fast move, flick for its power move
  • Rain, sun and sandstorm, and traits read from each racer's own stats
  • The same seed and the same inputs make the same race anywhere, so a whole run keeps as a ghost under 3,000 bytes

The park

One world, shared

  • A single park that walkers and the portal's web page share in real time, drawn by the stadium's own camera
  • Offline, your lead wanders it on its own and the camera follows
  • Online, you steer, and see up to sixteen other trainers near you
  • Only public profiles appear to other people
Pikachu racing on a dirt track through green country, its lap and place at the top.
Lakeside Loop: through the water and over the cobbles, Swift and Thunder in hand.
Pikachu walking a path through the trees of the shared park.
Pikachu out in the park.

Trade, WiFi and updates

The link cable

A Gen 1 trade, byte for byte

  • The walker is its own Generation 1 trade partner. SEND offers a token; TAKE BACK gives up a team member for whatever the game offers
  • Checked against a partner verified on a real Pokémon Blue: 900,000 fuzzed bytes over 300 sessions, every answer the same
  • A recorded real Blue trade plays through the board's own code and ends traded

WiFi

Set up from a phone

  • Hold the closed ball's button. The walker opens a hotspot named POKEWALKER-XXXX
  • Join it and a page opens: pick your network, type the password, choose a trainer name and one of HeartGold's 129 trainer looks
  • The radio is never on at boot, and the hotspot closes itself when it's done

Updates

Over the air, with a way back

  • New firmware is checked against a signing key built into the walker, then downloaded in resumable pieces into the spare slot
  • The new build boots on trial. If it fails three times, the walker goes back to the old one
A real Pokémon Blue's Cable Club trade table: BLUE offering MEWTWO, WALKER offering PIKACHU, and the line 'PIKACHU will be traded.'
A real Pokémon Blue at the Cable Club, agreeing to take the walker's token.

Shorts

Vertical videos written as a script.

pw-shorts

A plain-text script in, a vertical video out

  • A short is a text file of lines like use venusaur PETAL_DANCE on meganium
  • Everything on screen is drawn by the walker's own code: Gold's move animations and their sounds, the League stadium, the sixteen arenas, the wild areas
  • 1080×1920 at 30 frames a second, with sound
Pikachu against the whole dungeon: a swarm closing in down a cave, a Thunder Shield, and out the other side. Made entirely by pw-shorts from a script. Sound on.

What it's built of

CrateLinesWhat it is
pw-pet124,263The walker itself: every screen, the walk, pet mode, the games, the stadium, RALLY, the park, the sound chip
pw-pet-window18,653The desktop simulator, with recording and scripting
pw-pet-firmware10,293The board build: panel, touch, keys, steps, WiFi, updates, the link port
pw-shorts9,394A maker for short vertical videos of the walker
pw-battle5,513The battle engine, shared by the walker, the browser and the server
pw-link3,047The Generation 1 trade partner and its cable driver
Fourteen more19,035Browser builds, the panel drivers, graphics tools, a save editor

Where it stands

Plans

What's next.

Milestones

15 Nov 2026

The film, and the big moves

Surf, Earthquake, Thunderbolt and Thunder get effects of their own in the stadium, and the walker gets a one-minute promo film. Watch it →

14 Nov 2026

Battles, a stadium, and sixteen gym leaders

Generation 1 battles with three lanes and a secret stance, played out in a 3D stadium, and Gold's sixteen leaders building their teams to match yours. The same day, the walker counted its first real steps on the board.

13 Nov 2026

Pet mode, and the moonwalk

One of your Pokémon moves into the Gold bedroom: fed, rubbed, visited by the rest of the team, dancing to the radio. A bug made it moonwalk away from a friend; now every song ends that way. Read it →

29 Sep 2026

A Generation 1 trade partner, checked against the real one

pw-link landed with an oracle test beside it: the same bytes fed to it and to a partner verified against a real Pokémon Blue, with every answer required to match.

25 Sep 2026

The build target becomes the Waveshare board

A round 412×412 touch panel bought in rather than built, with the Poké Ball drawn on the glass and the shell printed round it.

24 Sep 2026

The software becomes this project's own, in Rust

The earlier C reference stays something to check against. Everything that ships from here is written from nothing.

16 Sep 2026

The infrared had to go

The first hardware line: a Game Boy link interface where the infrared was, in a machined steel ball. Superseded by the Waveshare board. Read it →

28 Jun 2026

The first commit

KiCad hardware for a real Pokéwalker, on a forked RP2350 board.

Writing


Where these numbers come from

Every figure is read or counted from the project's repository as of 15 Nov 2026: line counts per crate, the game rules from its own source, the 900,000-byte trade check from its oracle test. The clips are the walker's own software recorded at its native 412×412 and scaled up without smoothing; the turning ball and the hero picture are Blender renders of the shell's model with real screen footage on the glass. The shell views are CAD renders of the current design, and the region views are renders from the world engine on a desktop. The portal pictures are screenshots of it running locally.

Pokewalker is a personal reimplementation of a Nintendo accessory, and the source repository is private. The Pokémon, trainers, rooms, sounds and music on its screen come from the owner's own cartridges when the software is built; the repository stores none of them, and the browser demo uses its own stand-ins. The badges, arenas, park, race courses and leaders' lines are the project's own. Pokémon is Nintendo's.

← All projects