User Manual

On its first boot, and after a factory reset, FlugVel starts its own Wi-Fi setup mode and shows a QR code.

FlugVel has two physical controls, and a strip along the bottom of the screen that says what they do right now:

Left-handed, or mounted the other way up? The Customise tab has a left-handed mode, which flips the layout 180° and reverses the encoder to match. There is a separate knob reversed option for an encoder that is simply wired the wrong way round.

The default order is Plane → Weather → Games → Focus → Calendar → Notes → Stocks → Settings. Reorder or hide any of them except Settings from the Customise tab. If you never play the games, leave them out of the cycle.

Plane

The nearest aircraft overhead, with its callsign, altitude, speed and bearing. An animation plays when one passes close by, and you can turn that off. When the sky is empty the screen shows a bouncing callsign and a quote of the day, each of which switches off on its own. A minimum-altitude filter keeps low traffic out.

Weather

A forecast table of 3 to 7 days. Turn the knob to move between days and press the button to open one day hour by hour. Turn to flip through the hours, press again to go back to the week. Condition icons, how often it refreshes, and whether it fetches each day in the background are all adjustable.

Games

A small games menu. Flappy Plane (tap to flap and dodge pipes), Paddle Catch (turn the knob to slide a paddle), Simon Says (repeat a growing sequence of pads) and Air Traffic (land each plane once it reaches the approach zone). Hide any entry from the menu in Customise. Turning the knob during a game, or on the game-over screen, backs out to the menu.

Focus

A Pomodoro-style timer. Turn the knob to set the focus length (5 to 120 minutes) and the break length (1 to 30 minutes), then press the button to start. Two options are worth knowing about. One locks screen-switching while a session runs, so a stray knob click can't abandon it. The other starts the break the moment focus ends, instead of waiting for a button press.

Calendar

An agenda of the next 60 days or so, pulled from up to four read-only iCal feeds of your own. You add those in Customise, and most calendar apps offer one as a "secret address in iCal format" in their sharing settings. Turn the knob to move through the list, press to open or close one event's details. An event that appears on two feeds is merged into a single entry rather than listed twice. You can also cap how many events are held in memory, and hide events once they have ended.

Notes

A short list pulled from one Notion page: to-do checkboxes, bullet and numbered items, paragraphs and headings, in the order they sit on the page. Turn the knob to scroll. A selected row too long for the screen scrolls through the rest of its text on its own.

The button changes with the row. It ticks or unticks the selected to-do, opens or closes a day when Group notes by day is on (described below), and otherwise forces a refresh instead of waiting for the next scheduled check. The legend at the bottom says which of those it will do next.

Ticking a box updates the screen at once and syncs to Notion in the background. If checked items are set to stay hidden ("Show checked items" off in Customise), the row dims but stays put until the next refresh, rather than vanishing under your thumb mid-scroll. Ticking from the device needs the Notion integration to have update permission, not only read. The setup is in §4.

Turn on Group notes by day in Customise and every heading becomes a collapsible day section instead of a plain divider. The first heading on the page opens itself. The rest stay closed, each with a done-count beside its name, like "Tuesday (2/3)". Only one day is open at a time, so opening another closes the one before it. Anything written above the first heading is always shown.

Only some Notion blocks are read, and only the ones sitting directly on the page. The device asks Notion for the page's immediate children and nothing else, so anything inside a toggle, a column or another block is invisible to it. Keep the page flat and it appears as you wrote it:

Here is a template to start from. Press Copy, then paste it into an empty Notion page. Notion reads plain text written this way as you paste and turns each line into a real block: # starts a heading, - [ ] a to-do checkbox, and a plain - a bulleted list item. Nothing needs reformatting afterwards.

# Monday
- [ ] Gym
- [ ] Laundry
- Call mom about the weekend
# Tuesday
- [ ] Team meeting prep
- Bring the charger this time

Share the page with your integration (§4) and it reads like this on the device. Repeat the pattern for each day. With Group notes by day on you get a collapsible day-by-day list, with the first day already open. With it off, the same page reads as one flat list and each heading is a plain divider.

Stocks

A short price list of up to 10 tickers you choose, each with its symbol, current price and the day's change. Turn the knob to scroll if you have more tickers than fit on screen. The button forces a refresh instead of waiting for the next scheduled check. A row that never resolves is usually a typo in the ticker rather than a fetch problem, which the next paragraph explains how to tell apart.

Tickers are fetched one at a time, so the list fills in gradually. A row still waiting shows a dim placeholder rather than sitting blank. When a fetch fails, the row settles into one of two states. "Not found" means the symbol does not exist, so check its spelling in Customise. "Unavailable" is temporary, usually a network blip or a rate limit, and a later refresh normally clears it.

Settings

Always last in the cycle, and the one screen that cannot be hidden. It holds device info, a quick theme picker, and the way to updates, restart and factory reset. Everything deeper lives in the setup console (§4). §5 covers it in full.

FlugVel keeps its configuration page running the whole time it is on your Wi-Fi, not only during setup, so most settings never need the knob. Open Settings → Configure on phone on the device and it shows a QR code and an address. Scan it, or type the address into any browser on the same network, and the page opens on the Customise tab.

Typing it by hand, use the name shown on the device, something like flugvel-a1b2.local. Some phones and routers cannot resolve .local names. If yours is one of them, use the numeric IP address shown next to it, which is also on the Settings → Device Info screen.

The console has three tabs:

Changes save back to the device over Wi-Fi. There is no reboot and no app to install. Save, then close the page.

Connect your notes (Notion)

Connect your events (calendar)

Connect your stocks (Finnhub)

FlugVel can update its own firmware over Wi-Fi. It checks a small version file online and compares it to what's currently installed.

• Updates are checked automatically after connecting to Wi-Fi at boot, and any time you select Update from the Settings menu.
• If a newer version is available, the screen shows the new version number and release notes, and asks you to confirm before downloading.
• Downloading and flashing takes a minute or two, with a progress bar on screen. The device reboots itself once the update finishes.
• If an update fails partway through, the device keeps running the firmware it already has. Nothing is lost.

To wipe saved Wi-Fi credentials and settings and start over: