KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #codex #claude-code #cli #react #mcp #open-source #deepseek-harness #dsh-plugin #ai

daysUntilBirthday

★ 51 Open GitHub ↗

Script for the iOS App Scriptable, which lists up to 20 people of your contacts by their birthday

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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

# Contact Setup for the default mode 1
- provide all the contacts you want to see with a new date
- give the date the label 'daysUntilBirthday'
- an actual birthday set in the regular birthday field is not necessary

![](https://raw.githubusercontent.com/lwitzani/daysUntilBirthday/main/contactSetup.gif)

# Widget Setup
- 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)

![](https://raw.githubusercontent.com/lwitzani/daysUntilBirthday/main/setupWidget.gif)

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

![](https://raw.githubusercontent.com/lwitzani/daysUntilBirthday/main/fullySetupWidget.PNG)

daysUntilBirthday

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README