LSWeather

A Scriptable script to add weather & calendar information on the lock screen. The script is meant to be called from Shortcuts app. It is fully customizable script giving you access to change each data element on the lock screen. The script generates an overlay image which is embedded on top of a wallpaper.

Features

1. Shows weather, calendar and random quote on the lock screen.
2. Fully automated. Create Automations to run this script/shortcut every hour to get most recent information on your lock screen without manual intervention.
3. Choose from many pre-defined layouts or create your own layout.
4. Use custom SF symbols for weather icons.
5. Supports multiple calendars and configure 2 separate sections of calendars for work and personal events.
6. Marked ongoing events for better attention.
7. Fully customisable giving you control of each data element.
   • Easily create new data elements for any of the existing fields.
   • Write custom functions to return data in the format that you need.
8. Supports SF symbols as prefixes.
   • Learn more about SFSymbols here.
   • Check full list by downloading the macOS app from the above site or visit sfsymbols.com.
9. Run in test mode without calling various APIs

Installation

1. Download and extract the content of this repository.
2. Download the script LSWeather.js to Scriptable folder in your iCloud Drive.

iCloud Drive/
├─ Scriptable/
│  ├─ LSWeather.js

1. Launch Scriptable and make sure that LSWeather is listed in the Scripts view.
2. Run the script to check if its working properly. A quicklook window with the default layout overlay will open.
3. Create an Album in Photos with name WeatherLS.
4. Add some wallpapers to this Album.
5. Download and install this shortcut.
6. Configure the shortcut as mentioned below.
7. Run the shortcut.

Shortcut Configuration

1. Open the shortcut in Shortcuts app.
2. Set the dictionary key value layout to one of the predefined values 'welcome', 'minimalWeather', 'feelMotivated', 'mimimalCalendar', 'showMyWork' and 'maximalWeather'.
3. Set the dictionary key value apiKey to your openWeather API key.
   • Note: if layout and apiKey are not passed from Shortcuts app, it should be defined in the LSWeather script.

Script Configuration

1. OpenWeather API

   • Open the script in the Scriptable editor and add your openweather API key at const WEATHER_API_KEY =
   • Get your own API key for free here. Account is needed.
   • Note: Value passed from Shortcuts app will over-ride the API key value set in the script.

2. Template

   • Set LAYOUT to one of the predefined values 'welcome', 'minimalWeather', 'feelMotivated', 'mimimalCalendar', 'showMyWork' and 'maximalWeather'.
   • Or use your customer layout by setting LAYOUT = 'custom'.
   • Note: Value passed from Shortcuts app will over-ride values set in the script.

3. Configure Weather Details

   • To show/hide weather details set WEATHER_SHOW_WEATHER to true or false. Hiding weather details will not call the openweather API.
   • To change weather units set WEATHER_UNITS. Default is metric.
   • To change locale/language set WEATHER_LANG. Default is en.
   • You can get valid values of WEATHER_UNITS & WEATHER_LANG here.

4. Configure Calendar Details

   • To show/hide calendar details set CALENDAR_SHOW_CALENDARS to true or false.
   • To show/hide all day events set CALENDAR_SHOW_ALL_DAY_EVENTS to true or false.
   • To show/hide tomorrow events set CALENDAR_SHOW_TOMORROW_EVENTS to true or false.
   • Set-up personal calendars to be displayed with CALENDAR_PERSONAL_CALENDARS.
     • Ex. const CALENDAR_PERSONAL_CALENDARS = ['Gmail','Football'];.
     • If this variable is empty ([]), script will automatically fetch the default calendar for iOS.
   • Set-up work calendars to be displayed with CALENDAR_WORK_CALENDARS.
     • Ex. const CALENDAR_WORK_CALENDARS = ['Work'];.
     • If this variable is empty ([]), script will not display anything. In this case also set hide value to 1 for the layout item workText (See details below).
   • Maximum personal events to show set CALENDAR_PERSONAL_MAX_EVENTS.
   • Maximum work events to show set CALENDAR_WORK_MAX_EVENTS.

5. Configure Quote Details

   • To show/hide quotes set QUOTE_SHOW_QUOTES to true or false. Hiding quotes details will not call the API.
   • Change quote tags with QUOTE_TAGS to get quotes for specific categories.
     • Ex. `const QUOTE_TAGS=['wisdom','friendship'].
     • Leave blank to get random quote across all categories.
     • You can get list of all valid tags here.
   • To change maximum length of quotes to be fetched set QUOTE_MAX_LENGTH.
   • To change quotes wrap length set QUOTE_WRAP_LENGTH.

6. To test the script without calling the openweather & quotable APIs set TESTING to true.

7. To change the layout of the data elements update dictionary layouts. Checking items which you can change easily to play around with the layout.

   • source: Source of the data. Valid values are "weather", "calendar", "quote", "text" & "function". When using "function", the key should be the function name and function should return the string to be displayed. When using "text", the key should be the text to be displayed.
   • key: JSON key returned by functions fetchWeather(), fetchCalendar(), fetchQuote(). When the source is "text", key will be displayed as data.
   • prefix: If present, will be prefixed to the data. SFSymbols are allowed in prefix. Use "SFSymbol|symbolName".
   • suffix: If present, will be suffixed to the data. Use "temperature" for temperature data and "speed" for wind data, any other string accepted.
   • x: x co-ordinate of the data element. Valid values are "left_margin", "right_margin", "center" and numbers. You can use relative co-ordinates like "center + 100". Use -ve values to start from right margin i.e -50 will place the element at 50 pixels from the right margin.
   • y: y co-ordinate of the data element. Valid values are "top_margin", "bottom_margin", "center" and numbers. You can use relative co-ordinates like "center + 100".
   • w: Width of the data element. Valid values are "half", "full" and numbers. You can use relative width like "half - 100".
   • h: Height of the data element. Valid values are "half", "full" and numbers. You can use relative height like "half - 100".
   • font: Font for the data element. Valid values are Font type objects. Predefined fonts are "ultraSmall", "extraSmall", "small", "medium", "large", "veryLarge", "extraLarge", "big" and "veryBig".
   • color: Color for the data element (except icon). Valid values are "light", "dark" or hex code of the color. If null, white will be used.
   • align: Alignment of the data element within the data rectangle. Valid values are "left", "right" or "center".
   • hide: 0 or null to show this data element, 1 to hide, 2 for sunrise/sunset only (to show only 1 of them based on the time of the day).

8. Check script logs in LSWeatherLogs folder in iCloud/Scriptable (logs are only saved to file when the script is run from Shortcuts, else logs are displayed on the console).

APIs Used

1. OpenWeather API - https://openweathermap.org.
2. Quotable API - https://github.com/lukePeavey/quotable.

Credits

Below widgets/scripts have helped while coding for this script.

1. Futcal for Scriptable.
2. Terminal Widget.
3. termiWidget.
4. Thanks to user schl3ck for the code to tint SF symbols in drawContext which is currently not possible in Scriptable.

Known Issues

1. The API quotable is sometimes slow and doesn't respond on time. You can set const QUOTE_SHOW_QUOTES = 'false' to stop using this API if you are facing this problem.