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 14, 2026 · 2 min

A good fork says thank you

Light Phoneopen source

A decent amount of what I ship for the Light Phone is other people’s work with my name nearer the top than it deserves. BrightChat is Craig Eley’s chat app. BrightMusic builds on Jonathan Caudill’s phono. BrightNews started as zachattack323’s LightRSS. BrightLibrary is a FastRead fork, and BrightThumb is a port of Thumb-Key. None of these were my ideas. The community around this phone is tiny, the good ideas are unevenly distributed, and forking is how the work compounds.

Which is fine — that’s what open source is for. But forking has an etiquette, I’ve been on both ends of it now, and I have opinions.

Keep their README

When I forked Craig’s chat app, his README didn’t get rewritten — it got moved to the bottom of mine, preserved as he wrote it, under his name. The top of the file says plainly: Craig wrote the app; here’s what this fork adds; nothing here is upstream’s responsibility. That last part matters more than the credit. The worst thing a fork can do to its upstream isn’t stealing glory, it’s leaking bug reports. If my Favorites tab breaks, that issue belongs on my repo, and the README’s job is to make sure it lands there and not in Craig’s inbox.

Never touch the applicationId

This one’s technical and absolute. On Android, the applicationId is the app’s identity. Change it and you haven’t renamed the app — you’ve created a second app that installs alongside the first, and every user’s data stays trapped in the old one. Several of my apps still carry light* package names from before a rename, and they always will. The name on the screen is free to change. The identity underneath is not, and no amount of tidiness justifies breaking it. This rule is written into the BrightMarket index with a comment that says, roughly, do not “fix” this.

Renaming is not rebranding

The Bright* names exist so the collection reads as a collection — so someone who liked one app can find the others, and so update tracking has a consistent home. The rename is packaging, not authorship. If the name change ever starts implying the work is mine when it isn’t, the README exists to un-imply it, loudly and first.

Send things back when they fit

Not everything I add belongs upstream — a Favorites tab tuned to this phone’s wheel probably doesn’t help a general-purpose app. But when a fix is general, it should travel. The fork relationship shouldn’t be a one-way valve.

I don’t think any of this is original wisdom either. It’s mostly what the licenses already ask, plus some manners. But small communities run on the assumption that building on someone’s work is a compliment and not a raid, and that assumption survives exactly as long as forks keep saying where they came from.