tylercoxdruin/live-context

Live Context is a home screen widget for iPhone that changes what it shows based on what is happening in your day. Instead of displaying the same static information all the time, it looks at your calendar, location, battery level, and weather conditions, then picks what is most useful to show you at that moment. It is built using an iOS app called Scriptable, which lets you run JavaScript scripts on your phone. Setting it up takes a few steps but nothing too involved. You install the free Scriptable app, create a new script inside it, paste in the code from this repository, and optionally grab a free API key from OpenWeatherMap for weather data. The widget works without the API key, you just lose the weather features. After running the script once to enter your settings, you add the widget to your home screen the same way you would add any other iOS widget, then tell it which script to run. What makes the widget different from a typical one is that it does not use a single fixed layout. It checks for things like an upcoming calendar event, a severe weather alert, low battery, incoming rain, a birthday, and other situations. Based on what it finds, it picks the most relevant thing to display. If nothing notable is happening, it falls back to showing a greeting and the current weather. Each of these modes can be toggled on or off in the settings. There is also a Wind Down mode for the evening. During a time window you choose, the widget switches to a minimal dark display instead of its usual layout, meant to be less distracting at night. The repository includes a separate advanced guide for people who want to go further. That guide covers pulling in data from the Health app or other sources through Shortcuts, using a transparent background, changing which information takes priority, placing the widget on the lock screen, and understanding how the script works internally. The project is released under the MIT license.