The manual. Moonwatcher is a round eye that shows you how the crypto market feels – no numbers needed. Here's how to read it and how to use it.
Don't have one yet? Build your own · already have the board? Install and set up.
1. What the eye shows
Everything the eye does comes from the market of the coin it watches (Bitcoin unless you pick another) – except the sky and the moon, which are real.
| You see | It means |
|---|---|
| Iris colour | green = rising, orange = sideways, red = falling, over the last 24 hours |
| Pupil | wide in a wild market, narrow in a calm one |
| Gaze | lots of trading: restless, blinks and looks around · little trading: it dozes |
| Shimmer, glitter, full sparkle | the coin is unusually cheap compared with its own last two years – the stronger, the cheaper. Full sparkle = BTFD (“buy the dip”). See the sparkle chart. |
| Water rises in the eye | the price is crashing within the hour – the eye is underwater |
| It flinches | a sudden price jump |
| It’s happy and hops | a new all-time high (ATH) |
| Wide eyes | the price breaks a round number |
| Shooting stars | the price takes off, or there is something to celebrate |
| Grey eye, searching | no prices right now (e.g. no internet) – it comes back by itself |
| Stars in the sky | it is dark outside – the real night sky above the place you set, not a price signal |
| The moon | the real moon, phase and position as outside – not a price signal |
| It falls asleep | late at night when the market is quiet |
| Golden eye | Bitcoin halving day. Before that it counts down the days: at start-up, on a few special days, and in the last 100 days once a day – at the first tap, then the price follows. |
| Snow falling in the eye | it is snowing outside in the city you set (November to March) – real weather, not a price signal. See settings. |
| A bright point drifts across the sky, the eye follows it | the International Space Station is passing over your city right now and can be seen outside. The eye announces it once (“in the west / ISS / 10 deg up”); a tap during the pass shows where to look. See settings. |
A few things happen only rarely or at special times. Let it surprise you.
2. The sparkle chart, explained
On the settings page there is a small chart. It shows why the eye sparkles – or why not.
Example drawing – your chart shows the real data of your coin.
The line
The line is the price of the last two years, measured as distance below the all-time high. The top edge is 0 %: there the price was at its high. The lower the line, the further below the high. So it has the same shape as a normal price chart: price up, line up – price down, line down.
On a new all-time high the line touches the top edge, and all older days move down a little – they are now further below the new high. The shape stays the same, only the scale changes.
The three bands
The bands come from the coin's own history: the eye looks at every day of the last two years and asks “how far below the high was it that day?”.
- Shimmer from the middle value: the coin was this cheap or cheaper on half of all days (50% of days).
- Glitter: this cheap on only 1 in 4 days (25% of days).
- BTFD, full sparkle: this cheap on only 1 in 10 days (10% of days).
When the line dips into a band, the eye shimmers, glitters or sparkles fully. The deeper, the stronger.
BTFD is a scene joke, not a buy signal. Sparkling only means: unusually cheap compared with the past – not that the price will rise again. Cheap can always get cheaper.
Why are the bands flat?
The bands show today's yardstick, laid over all past days: “how would the eye judge each of these days today?”. The eye recalculates them every day from the last two years, so they move slowly – a little each day, but always as straight lines.
Good to know
- Every coin has its own bands, because every coin swings differently: for a calm coin even a small drop is unusual – for a wild one, big drops are everyday, so it only sparkles much further down.
- So that a strong bull market doesn't sparkle at every small dip, there are minimums: shimmer at least 5 %, glitter 12 %, BTFD 20 % below the high.
- Right after switching on or changing coins, the eye first loads the two-year history – usually within a few seconds. Until then, fixed values per coin group apply. The same goes for a young coin that has been traded for less than about 300 days.
- The chart has 180 points; each point covers about four days and shows the cheapest of them – the dips are what counts here.
- Tip: put your phone next to the eye with the settings page open. The chart follows whatever coin the eye shows – also when it switches coins by itself (watchlist).
3. Using it
On the screen
- Tap: price, change over 24 hours and a small 24-hour chart.
- Swipe left / right: next / previous coin, like a photo gallery. With a watchlist set, only through those coins.
- Long press: quick help with all gestures.
- Swipe up: menu. Keep swiping up or tap = next item, swipe down = previous, hold = start. Doing nothing for 5 seconds closes it.
The menu
The eye starts in English; switch to German on the settings page.
| Demo | shows everything the eye can do; a tap ends it |
| Moonball | a little game against the eye: after 3-2-1, turn the whole device like a steering wheel or steer with your finger; swipe up = end. The eye is a sore loser. |
| Clock | clock in the eye on/off: hands as glowing iris fibres, a dial made of stars |
| Rotate | turns the picture by 90° – if the board sits differently in a stand or case |
| Settings | shows a QR code to the settings page (see below) |
| Tip jar | QR code for a small Lightning tip to the developer – entirely optional |
| Exit | closes the menu |
On the device itself
- Knock twice (on the table next to it or on the case): shows the price too. Best clearly with a small pause, “knock … knock” – a very fast “knockknock” counts as one knock.
- Shake: it gets dizzy.
- Pick it up: it notices and looks at you. Tilt it: its gaze rolls a little to the lower side.
Power
The eye runs on any USB power adapter, e.g. a phone charger, via USB-C. It starts as soon as it gets power – there is no power button. For running, any USB-C cable will do; only installing the firmware needs a data cable.
4. The settings page
Open it: your phone must be in the same Wi-Fi as the eye. On the eye, swipe up until it says “Settings” and hold your finger on it. Scan the QR code with your phone camera and tap the link. (The address is shown below the code; on a computer http://moonwatcher.local usually works too.) A tap closes the QR code.
What you can set there:
- Currency (EUR or USD) and location – for the time and the real night sky.
- Personality: calm, normal or nervous – how lively the eye moves.
- Brightness and night dimming: between two times of day the eye gets darker; a tap lights it up for 30 seconds. Things you start yourself (Moonball, demo, menu QR codes) stay bright. Same hour for “from” and “to” = always dimmed. Stars and sleep come regardless of the dimmer.
- Clock in the eye, rotate display, demo mode (the demo repeats endlessly, e.g. for a shop window), Milky Way in the night sky while the eye sleeps.
- Snow when it snows outside (on from the start): from November to March the eye asks the Norwegian weather service MET Norway about every 30 minutes for the weather in the city you set – only the city, never an address. If it snows there, it snows in the eye too: light, moderate or heavy. MET Norway sees your connection's IP address and the city's coordinates. Weather data: MET Norway, CC BY 4.0 – the snow in the eye is derived from it.
- ISS in the sky when it passes over your city (on from the start): when the International Space Station crosses the sky above your city and can be seen outside (it is dark there and the station is still in sunlight), it drifts across the eye's sky in real time – a pass takes four to six minutes – and the eye follows it with its gaze. Passes that climb higher than 20 degrees are announced once, while the eye is awake; a sleeping eye is not woken. For this the eye fetches the station's orbit from CelesTrak once a day – the request contains no location, the passes are worked out in the device.
- Moonball: difficulty (up to “cheater”), steering sensitivity, invert steering.
- More coins: pick another coin, or set a watchlist – the eye then switches between the ticked coins every few minutes. Switching off takes it back to the coin you picked yourself.
- Price, “Below ATH” and the sparkle chart (see above) – they update by themselves while the page is open.
- Language (English / Deutsch) at the top.
Updates: once a day the eye checks over Wi-Fi whether there is a new version – and if there is, installs it by itself. Don't want to wait for the next check? Tap “Check for updates”. If an update ever doesn't work out, the eye goes back to the previous version on its own.
5. If something seems off
- Grey eye: it has no prices for a moment. Usually they come back within a few minutes, also after a Wi-Fi outage. If not: unplug it briefly and plug it back in.
- Doesn't react to touch: knock twice – that also wakes the touch sensor.
- Brightness slider does nothing: night dimming is probably active – the page says so; then the night brightness applies.
- New router or Wi-Fi password: on the settings page, tap “Set up Wi-Fi again”. If the eye can't find its Wi-Fi, it shows a QR code for setting it up – just like the first time, see the install page.
- Picture upside down or sideways: menu → Rotate.
- Your Wi-Fi doesn't show up or won't connect: the eye only knows 2.4 GHz Wi-Fi (take the network without “5G” in its name). Routers set to WPA3 only need the mixed mode “WPA2/WPA3”. Hotel or company Wi-Fi with a login page doesn't work.
- The eye runs, but the settings page won't open: your phone has to be in the same Wi-Fi as the eye – not on mobile data, not in a different network. In a guest Wi-Fi the devices can't see each other: the eye still works, but you can't reach its settings page. Better use your normal home Wi-Fi.
- iPhone during setup: don't tap “Done” in the setup window before you have saved your Wi-Fi – otherwise it closes too early. If that happens, just scan the eye's QR code again.
- Something strange happened? On the settings page open “Diagnostics” at the bottom and tap “Send a report to the developer” – it includes the log of what the device went through. That helps a lot.
Questions or ideas: moonwatcher@funktronix.de
Moonwatcher shows moods, not advice. Not investment advice.
← Back to the Moonwatcher page · © 2026 Torsten Hillmann
Ideas & design: Torsten Hillmann (@manhill) · Funktronix. Built with Claude, an AI by Anthropic.
Testing & prototype case: Bix