Scriptable Script: daysUntilBirthday

Script for the iOS App Scriptable
up to 20 people of your contacts are shown simultaneously with their birthday and how many days are left
contacts are sorted by how far away their birthday is (nearest first)

How to use

Mode 1 (default): Only chosen contacts:

in your contacts app, edit the contacts you want to be visible in this widget
you need to set up an additional 'date' field in your contact and give the date the label 'daysUntilBirthday'
run the script initially in the Scriptable app to create a json file in iCloud containing contact information for faster access
when you add new contacts via the label, run the script again in the app to update the json! This makes the changes visible in iCloud-mode
when setting the script up as Widget, use the largest presentation mode and provide the parameter 'iCloud' (without the ' ')
if contacts have a nickname set, the nickname will be chosen
if the name contains a space character, only the part before the first space is used (in case of a nickname like 'Julian ❤️' the name in this widget will be 'Julian')

Mode 2: Show all contacts with a Birthday configured

set the variable showAllContacts to true or provide the parameter 'showAll' in widget mode to show all contacts that have a birthday in the regular birthday field configured

iCloud-Mode:

set the variable useIcloud to true or provide the parameter 'iCloud' in widget mode to never recalculate which contacts are shown again
if false -> everytime the contacts are scanned
if true -> contacts are not scanned and last used contacts are used again

when using parameter iCloud the contacts are not scanned and the source at the bottom changes to 'iCloud'
when using parameter showAll (without using parameter iCloud) all contacts with birthdays are shown
if the last configuration was empty and next one is 'iCloud,showAll' then because of iCloud-Mode (all previous found contacts are used again) the showAll parameter will not have any effect, since the default mode is mode 1 (only show selected contacts)

you can easily edit the parameter at the top of the script to show the text you like
example in english: