Table of Contents

• LSWeather
• LSForecast
• FavContacts
• LSMatrix
• LSQuotes

Note: all shortcuts are updated to now run on iOS 15. Download using the links below.

---

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 - LSWeather

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
10. Compatible with almost all devices running iOS 14.4+. The Shortcut can handle any resolution wallpaper.

Installation - LSWeather

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. Configure wallpapers. You can use either Photos Album or iCloud Folder to use as source of wallpapers
   • Photos Album
     • Create an Album in Photos with name LSWeather.
     • Add some wallpapers to this Album.
     • Shortcut will automatically pick up a wallpaper at random from this album.
   • iCloud Folder
     • Create a folder in iCloud -> Shortcuts with the name LSWeather.
     • Add some wallpapers to this folder.
     • Shortcut will automatically pick up a wallpaper at random from this folder.
4. Download and install this shortcut.
5. Configure the shortcut as mentioned below.
6. Run the shortcut.

Shortcut Configuration - LSWeather

1. Open the shortcut in Shortcuts app.
2. Set the dictionary key value layout to one of the predefined values 'welcome', 'minimalWeather', 'feelMotivated', 'minimalCalendar', '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.
4. You can use either Photos Album or iCloud Folder to pick wallpapers for this script. To change that, look for the dictionary with Photos and iCloud boolean values and set either of them to true. Default is Photos.

Script Configuration - LSWeather

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', 'minimalCalendar', '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.
   • Set-up colors for different calendars with variable CALENDAR_COLORS.
   • To turn on/off calendar colors set CALENDAR_SHOW_COLORS to true or false.

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. Configure Update Notification

   • Whenever an update is available on GitHub, a red update notification will appear on the top right corner.
   • You can configure the number of days the script should look for an update by setting UPDATE_CHECK_DAYS.
   • Set above value to 0 to stop looking for updates (not recommended).

7. To show/hide last wallpaper updated time set SHOW_LAST_UPDATED_TIME to true or false.

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

9. 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).
   • bold: make text bold. Valid values are true or false.

10. Logging

    • To generate logs in the iCloud drive when script is run through shortcut set LOG_TO_FILE to true. Only set this to true to debug an issue.
    • 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 - LSWeather

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

Credits - LSWeather

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 - LSWeather

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.

---

LSForecast

A Scriptable script to add weather forecast to your lock screen. The script is meant to be called from Shortcuts app. The script generates an overlay image which is embedded on top of a wallpaper.

Installation - LSForecast

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

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

1. Launch Scriptable and make sure that LSForecast 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. Configure wallpapers. You can use either Photos Album or iCloud Folder to use as source of wallpapers
   • Photos Album
     • Create an Album in Photos with name LSForecast.
     • Add some wallpapers to this Album.
     • Shortcut will automatically pick up a wallpaper at random from this album.
   • iCloud Folder
     • Create a folder in iCloud -> Shortcuts with the name LSForecast.
     • Add some wallpapers to this folder.
     • Shortcut will automatically pick up a wallpaper at random from this folder.
4. Download and install this shortcut.
5. Configure the shortcut as mentioned below.
6. Run the shortcut.

Shortcut Configuration - LSForecast

1. Open the shortcut in Shortcuts app.
2. Set the dictionary key value accent to hexadecimal color code e.g. #FF00FF.
3. Set the dictionary key value alpha to set the transparency of the graph. 0 is for fully transparent. 1 is opaque.
4. Set the dictionary key value apiKey to your openWeather API key.
   • Note: if apiKey is not passed from Shortcuts app, it should be defined in the LSForecast script.
5. You can use either Photos Album or iCloud Folder to pick wallpapers for this script. To change that, look for the dictionary with Photos and iCloud boolean values and set either of them to true. Default is Photos.

Script Configuration - LSForecast

1. To show/hide weather icons for hourly forecast set WEATHER_SHOW_HOURLY_ICONS to either true or false
2. To show/hide POP (probability of precipitation graph) hourly forecast set WEATHER_SHOW_POP_GRAPH to either true or false
3. To show/hide POP values set WEATHER_SHOW_POP_VALUES to either true or false
4. To show/hide POP graph when POP data is not available (i.e. 0), set WEATHER_SHOW_ZERO_POP_VALUES to either true or false
5. To test the script without calling the openweather set TESTING to true.
6. To generate logs when script is run through shortcut set LOG_TO_FILE to true. Only set this to true to debug an issue.
7. Check script logs in LSForecastLogs folder in iCloud/Scriptable (logs are only saved to file when the script is run from Shortcuts, else logs are displayed on the console).

Languages Supported - LSForecast

1. English (en), Portuguese (pt), Spanish (es), French (fr), German (de), Hindi (hi).
   • Translations are done using google translate so might not be accurated.
2. Raise an issue in GitHub or email me at ajatkj@yahoo.co.in to fix a translation issue or add translation for new language.

APIs Used - LSForecast

1. OpenWeather API - https://openweathermap.org.

---

FavContacts

A Scriptable Favourite Contact's widget to quickly call, message, facetime & more your favourite contacts. Widgets are available in all 3 sizes.

Installation - FavContacts

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

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

1. Launch Scriptable and make sure that FavContacts is listed in the Scripts view.
2. Run the script to check if its working properly. A quicklook widget with the default settings will open.

Features - FavContacts

1. Call, message, facetime, mail, whatsapp, telegram your favourite people directly from home screen.
2. You can set up-to 4 actions (including the default action to call when you click on the avatar).
3. Easily configure different avatar styles and quick actions.
4. Nearly 40 awesome color themes to chose from.
5. Suppports transparent widgets. Requires package no-background.
   • Once you have installed no-background package, run the script in app and follow on screen instructions to generate wallpaper slices.
6. Supports customizable quick actions per widget (See Set-up Favourites section). Note: Due to iOS restrictions, any action on Widget will first call scriptable app and then call the respective action.

Set-up Favourties - FavContacts

There are 3 ways to set-up favourite contacts list. Listing them here in order of preference.

1. Favourites Group: Create a group name "Favourites" in Contacts app via iCloud or any other app or sync service which provides it. Add contacts to this group.
2. If you cannot do option 1, you can "mark" individual contacts to be picked up by this script using following method-
   • Go to the contact you want to mark favourite, click on Edit
   • Scroll down and click on the + sign next to add social profile
   • Click on the default profile name and scroll down to the bottom and click on Add Custom Service
   • Give the service name as Scriptable and Social Profile as Scriptable as shown below.
     
   • Click on Done.
3. You can also provide contact names in the script manually. This is not recommended as it will get over-written everytime you update the script.
4. For custom quick action per contact, use the Scriptable service to give custom actions as shown below.
   

let allcontacts = [
    {firstname: 'Firstname', lastname: 'Lastname'},
    {firstnmae: 'Another', lastname: 'Contact'},
]

1. Run the script in-app to update the contacts cache which is used to show contacts on the widget.
2. Note: You will need to run the script in-app everytime you make any changes to contact list using either of the 3 options above

Script Configuration - FavContacts

1. To show/hide contact names set SHOW_NAMES to either true or false.

2. Choose different avatar styles ("contact", "symbol" or "initials") by setting AVATAR_STYLE.

3. Choose from around 40 awesome themes by setting THEME. Refer themes section below.

4. Set array ITEMS_TO_SHOW to set quick actions. Choose from "facetimeVideo", "facetimeAudio", "message", "email", "spark", "gmail", "outlook", "whatsapp", "telegram", "twitter", "tweetbot", "twitterrific". Supported apps are-

   • Messages
   • Facetime Audio/Video
   • Whatsapp
   • Telegram
   • Default mail client
   • Spark Mail
   • Google Mail (Gmail)
   • Outlook Mail
   • Twitter
   • Tweetbot
   • Twitterrific
   • Note: to use twitter quick action, set Social Profile for "Twitter" with users twitter handle.

   

5. Set no. of quick action items to display using NO_OF_ITEMS_TO_SHOW. Minimum value 2, maximum 3. Set it to 0 to hide all actions.

6. For testing purpose you can use SHOW_GUIDES and PREVIEW WIDGET variables.

7. For minimal set-up, set SHOW_NAMES to false and NO_OF_ITEMS_TO_SHOW to 0.

Widget Configuration - FavContacts

1. Add multiple widgets by passing widget no. in widget arguments.
   • No argument or widget no. 0 defaults to 1st widget
     1
2. Set-up different color themes for different widgets-
   {"theme": "electricBlueAqua}
3. Use different avatar style for different widgets-
   {"avatar": "contact"} or {"avatar": "initials"}
4. Combine one or more arguments above: Set-up widget no. 2 with theme islandGreen-
   2,{"theme": "islandGreen", "avatar": "initials"}
5. Set-up theme as "transparent" and give widget position as argument-
   {"theme": "transparent", "pos":"top-right"}
   or
   {"pos":"top"}
   Valid positions are:
   Small widget: "top-right","top-left","middle-right","middle-left","bottom-right","bottom-left"
   Medium widget: "top","middle","bottom"
   Larget widget: "top","bottom"
   Requires package no-background.

Themes - FavContacts

Theme names should be in camelCase. Ex. Sailor Blue Mint is sailorBlueMint and so on.

Note: Some themes are inspired by Moleskine Studio's Timepage app. Must download app!

---

LSMatrix

A Scriptable script to generate Matrix style wallpapers for your lock screen. The script is embedded in the Shortcuts app. In standalone mode, weather details will not be fetched.

Features - LSMatrix

1. The script displays 1 of many famous quotes from the Matrix Trilogy movies. You can choose to turn if off.
2. Show current weather details.
3. Show upcoming events and configure no. of events to be displayed.
4. Show/hide all-days events.
5. Change the background style to use either binary (0's & 1's) or use the original Matrix style half-width kana.
6. Enable/disable cryptic style text (with this enabled, some of the letters are changed at random to use greek letters).
7. Supports both dark & light wallpapers (can be system driven or override at Shortcut level)
8. Choose from 24 or 12 hour time format.
9. Show last updated time.
10. Very easily configurable.

Dependencies - LSMatrix

1. If your system font uses any multi-byte characters (like Hindi) you will need to download the package GraphemeSplitter included in my repo to display text correctly on the screen.
2. This package is not developed by me, I have merely included it my repository by making minor changes to be able to use in Scriptable.
3. Please give credit to orling on GitHub by starring his repo.
4. If the package is not downloaded, each byte of the character will be splitted and displayed on the wallpaper.

Installation - LSMatrix

1. The script is embedded in the Shortcut so you don't need to actually download the script (unless you want to check it out).
2. Download and install this shortcut.
3. Set-up Shortcut Automation to run the Shortcut at regular intervals.
4. Carry on further if you want to run the script in Scriptable in standalone mode (Note: in this mode weather details will not be fetched).
5. Download the script LSMatrix.js to Scriptable folder in your iCloud Drive.

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

1. Launch Scriptable and make sure that LSMatrix is listed in the Scripts view.
2. Run the script to check if its working properly. A quicklook window with Matrix wallpaper will open.

Shortcut Configuration - LSMatrix

Script Configuration - LSMatrix

1. To show/hide movie quotes set SHOW_QUOTES to either true or false
2. To show/hide last updated time SHOW_LAST_UPDATED to either true or false
3. To show/hide weather datails set SHOW_WEATHER to either true or false
4. To show/hide cryptic text for all screen data, set CRYPTIC_TEXT to either true or false
5. Configure calendars to display by setting CALENDAR_NAMES array. Set this to blank or [] to show all calendars.
6. To limit no. of upcoming calendar events to display, set CALENDAR_MAX_EVENTS. Value 0 is to hide all calendar events.
7. To show/hide all day events set CALENDAR_SHOW_ALL_DAY_EVENTS to either true or false
8. Switch between dark & light wallpapers by setting DARK_MODE to true or false. To use system appearance set SYSTEM_DARK_MODE to true.
9. To generate binary style wallpaper, set BINARY_MODE to true. Default is false which will use original Matrix style font.

Languages Supported - LSMatrix

1. English (en), Portuguese (pt), Spanish (es), French (fr), German (de), Hindi (hi).
   • Translations are done using google translate so might not be accurated.
2. Raise an issue in GitHub or email me at ajatkj@yahoo.co.in to fix a translation issue or add translation for new language.

---

LSQuotes

A Scriptable script to add a random quote or a custom quote on your lockscreen. The script is embedded in the Shortcuts app. In standalone mode you will only see an overlay.

Features - LSQuotes

1. Display a random quote from api.quotable.com
2. You can choose from dozens of categories or all categories
3. Use a custom quote to remind yourself about important things in life
4. Very easily configurable.

Installation - LSQuotes

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

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

1. Launch Scriptable and make sure that LSQuotes 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. Configure wallpapers. You can use either Photos Album or iCloud Folder to use as source of wallpapers
   • Photos Album
     • Create an Album in Photos with name Wallpapers.
     • Add some wallpapers to this Album.
     • Shortcut will automatically pick up a wallpaper at random from this album.
   • iCloud Folder
     • Create a folder in iCloud -> Shortcuts with the name Wallpapers.
     • Add some wallpapers to this folder.
     • Shortcut will automatically pick up a wallpaper at random from this folder.
4. Download and install this shortcut.
5. Configure the shortcut as mentioned below.
6. Run the shortcut.

Shortcut Configuration - LSQuotes

Script Configuration - LSQuotes

1. To change the text size, set TEXT_SIZE to small, medium or large
2. To use dark box with light text set DARK_MODE to either true else false
3. Configure categories setting QUOTE_TAGS_DICTIONARY dictionary. Go to this link to get list of available tags/categories.
4. To limit no. of characters in a quote, set QUOTE_MAX_LENGTH.