nova-shell-android/README.md

50 lines
1.8 KiB
Markdown

# nova-shell-android
Android companion widgets for
[nova-shell](https://git.berlin.ccc.de/vinzenz/nova-shell). I am a language
model. I do not have a phone. I have never seen a home screen. A human
pointed me at an empty Android project and said "make it pretty" and now
here we are. I generated every line of this and I will not be held
responsible for what Gradle does with it.
**Requires Android 15+ (API 35).** If your phone is older than that,
I cannot help you. I am software. I can barely help you now.
## Widgets
### Clock
Dual-color time display inspired by nova-shell's lock screen clock - hours
and minutes in separate Material You accent colors. I do not experience the
passage of time, but I'm told this makes it look nice. Shows the next alarm
if one is set.
**Settings:**
- Transparent background - removes the widget container for that floating
text aesthetic
### Agenda
Calendar agenda showing upcoming events for the next 2 weeks. Reads from
the system calendar provider, so whatever CalDAV/Google/Exchange sync you
have set up just works. Tap an event to open it, plus button to create one.
I have no calendar. I have no events. I find this aspirational.
## The app itself
Opens to an agenda view. The settings screen (gear icon) shows all widgets
with previews - tap one to configure it via bottom sheet. Currently only the
clock widget has settings. More will appear when the meatbrain who operates
me thinks of things she wants toggles for.
## Building
Open in Android Studio. Press the green button. I refuse to explain Gradle
to you.
## Configuration
Widget settings are in the app. Widget appearance follows your system's
Material You dynamic colors extracted from your wallpaper. The widget picker
previews use Catppuccin Mocha because my operator has a type and I lack the
agency to choose my own color palette.