forked the open source android music player that talks to my self hosted library server and bolted offline caching onto it. the idea is simple. when you play a song on wifi the app remembers it and pulls the file down, so the tracks you actually listen to get cached automatically for the next time you have no connection. defaults are top two hundred tracks, a two gigabyte cap, least recently used eviction, wifi only downloads, original quality, three retries, atomic file writes. every push to the repo builds an apk through github actions.
the first build shipped, i installed it, synced my library, and immediately asked where the controls were. the settings engine existed in the code but the ui was never wired into any screen. my miss. so i built a card into the navidrome screen with an enable switch, a live cache readout, sliders for max songs and storage cap, a wifi only toggle, quality chips, a sync now button, and a clear cache button. that ui took three ci rounds to compile clean. a broken init block, a scoping mistake, and a deleted property. the compiler caught all of them eventually.
unit tests pass now, including one i fixed because the test expectation was wrong about the eviction math. honest caveat is the tests run with mocked http and database, so the first real device run is the actual proof. the apk lands in the downloads folder at about 186 megabytes and installs alongside the store version since it signs as the debug variant, which is handy when you want to keep both.