gzl.dev/blog
field notes, mostly
18 posts
August 27, 2026
7 min
Nine ways to say yes
I taught a Light Phone to speak an Oura ring's protocol over BLE. Then I spent a week failing to tap a button that doesn't exist.
Light PhoneBrightOuraBluetoothAndroid
August 21, 2026
6 min
Field notes on LightOS
What the Light Phone III's OS actually is underneath: Android with the Google removed, hardware that talks in key events, and conventions nobody voted on.
Light PhoneLightOSAndroid
August 21, 2026
1 min
A tape recorder, not a voice recorder
BrightRecorder: clips named for where and when, tapes that are just folders of WAVs, and the wheel finally doing the job it was born for.
Light PhoneBrightRecorder
August 18, 2026
2 min
Why I put an app store on a phone designed to have none
Yes, I see the irony. The argument for building it, why there's no server behind it, and the afternoon I accidentally dropped everyone's apps from the index.
Light PhoneBrightMarket
August 14, 2026
2 min
A good fork says thank you
A lot of what I ship is other people's work with my name nearer the top than it deserves. Some rules I try to fork by.
Light Phoneopen source
August 11, 2026
2 min
My bug reports file themselves
Shake the phone three times and the app files its own GitHub issue. Then an AI triages the queue every hour — under strict instructions that guessing is worse than waiting.
Light PhoneAItooling
August 8, 2026
2 min
Fifteen copies of the same file
The least interesting code I maintain is the code I'd save first in a fire. On finally building the shared library.
Light PhoneKotlin
August 8, 2026
2 min
BrightMarket is out
The app store ships: browse on a desktop, install by QR, track updates on the phone, and get your own app into the catalog.
Light PhoneBrightMarket
August 7, 2026
2 min
One column of scores
Twenty-two leagues from four keyless public APIs, in one grayscale column. How BrightSports gets scores with no account and no push.
Light PhoneBrightSports
August 6, 2026
3 min
The MetroCard inside my phone
I dissolved a transit card in acetone and moved its nervous system into the battery compartment. Tap-to-pay is back, sort of.
Light PhonehardwareNFC
August 6, 2026
2 min
Every button does what you tell it to
The follow-up to the keylayout post: BrightControl itself, why the defaults took longer than the code, and the trust problem with accessibility services.
Light PhoneBrightControldesign
August 5, 2026
1 min
Roll is out
The camera app ships: a filter wheel on real hardware, purikura with four-shot strips, date backs, and a privacy lesson from launch day.
Light PhoneRoll
August 4, 2026
2 min
The keylayout file Light left behind
The scroll wheel is just key events. Everything I learned reading Generic.kl off the phone, and the accessibility service that became BrightControl.
Light PhoneAndroid
August 2, 2026
3 min
Rewriting the camera
Roll's whole design is one gesture, stolen from a contact sheet. Plus the filters that got away from me — purikura on a monochrome phone, and datamoshing experiments that mostly produce mud.
Light Phonedesign
July 29, 2026
1 min
A QR scanner, and its desktop twin
The modern world hands you addresses as QR codes and the Light Phone couldn't read them. A scanner for the phone, a generator page for every other screen.
Light PhoneLightQR
March 22, 2026
1 min
BasilNet, a year later
What broke, what I'd trim, and how the media server quietly became infrastructure for everything else I build.
Dockerhomelabself-hosting
March 8, 2026
1 min
I built a bad DSLR on purpose
It took worse pictures than my phone. It's one of the most useful things I've ever built.
hardwarephotography
January 10, 2025
1 min
Building BasilNet: My Home Server Stack
How I built a 15-service media server with Docker Compose, Gluetun VPN, and Home Assistant integrations.
Dockerhomelabself-hosting
← all posts
August 6, 2026 · 2 min

Every button does what you tell it to

Light PhoneBrightControldesign

A few weeks ago I wrote about reading the keylayout file and learning that the Light Phone’s wheel and buttons are just key events that most apps ignore. That post was the archaeology. This one is about the app that came out of it, BrightControl, and the design questions that turned out to be harder than the code.

The pitch is one sentence

The wheel, the camera button, and the home button work inside every app, not just Light’s. That’s it. Turn the wheel anywhere and you get brightness — or scrolling, or nothing, your choice, per app. Tap the wheel for the flashlight. Hold it for anything you want. Every gesture on the phone is a slot you can bind.

Defaults are the actual product

The code for “catch a key, do a thing” is an afternoon. Deciding what the right thing is took much longer, and I changed my mind a lot.

The rule I landed on: out of the box, BrightControl should feel like Light finished the job rather than like a third party moved in. So the defaults copy Light’s own behavior — wheel is brightness, tap is flashlight, camera button opens the camera — and they extend it to everywhere it didn’t reach. On LightOS’s own screens, the wheel stays LightOS’s entirely, unless you deliberately switch that off. I didn’t want to be the app that broke the phone’s own settings page.

The one invention I’ll claim is small: double-tap the wheel to switch it between brightness and scrolling, and the phone tells you which one you’re now holding. On a screen this minimal, a mode you can’t see is a mode you’ll get wrong, so the mode announces itself.

The trust problem

There’s no polite way around this part: BrightControl works because it’s an accessibility service that can see key presses in every app. That is a real amount of trust to ask for, and “trust me” is not an argument. The honest mitigations are the boring ones — the source is public, the app has no network permission to send anything anywhere, and the README explains exactly which mechanism it uses and why the sanctioned API for this job happens to be the accessibility one. If you read that and still don’t want it on your phone, that’s a reasonable decision and the phone works fine without it.

What I’ve learned from the bindings

People bind the strangest things, and the reports that come in have quietly become a survey of what this phone is missing. The hold-gestures especially — an empty slot that can launch anything turns out to be a suggestion box. More than one app in my collection started as somebody’s binding.