Scriptable

 

Welcome to my curated collection of Scriptable widgets and scripts, crafted to bring more power and personalization to your iOS home screen.

• Scriptable is an incredibly versatile IOS app that allows you to build custom widgets and automate tasks directly on your Apple devices.
• From interactive calendars to dynamic quotes and real-time weather updates, my collection showcases how Scriptable can transform your device into a dynamic dashboard.
• Explore, customize, and enjoy these widgets and scripts to make your iOS experience more fun and functional!

Table of Contents

• Scriptable Overview
• List of Widgets
  • Countdown Widget
  • Quote Widget
  • GitHubStats Widget
  • Weather Widget
  • Schedule Widget
  • TimeProgress Widget
  • Birthday Widget
  • HinduClrWear Widget
• How to Use Scriptable Widgets?
• Feedback
• License

📜 List of Widgets

Countdown

📆 Track life’s important moments—right from your home screen.
The Countdown Widget helps you stay on top of upcoming events like birthdays, anniversaries, holidays, or personal milestones. It supports multiple display modes based on widget size (Small, Medium, Large) and can be fully customized using script parameters. You can show specific events, display color-coded grids, or even track multiple events in column layout. The widget fetches data from a local .json or a connected Google Sheet for dynamic updates.

Birthday

🎉 The Birthday Widget gives you a beautiful, minimal way to reflect on your life.
It shows your exact age (to 2 decimal places), total days lived, and a progress ring indicating how close you are to your next birthday. Designed for the Small widget size, it offers a clean dark-gradient background and supports parameter customization to set your name and birthdate. You’ll see your name (e.g., “Rushi’s Life”), a countdown ring that updates daily, and age stats—all in one elegant glance.

HinduClrWear

🧘‍♂️ The Hindu Color Wear Widget offers daily color suggestions based on traditional Hindu practices.
Each day of the week is mapped to a specific color, deity, and spiritual quality—helping you dress with intention and align your energy. The widget supports all three sizes (Small, Medium, Large) and changes layout accordingly: Small shows today’s color, Medium displays a full week grid, and Large includes spiritual reasoning. No parameters needed—it auto-detects the day and works offline.

MyQuotes

💬 The Quote of the Day Widget delivers a daily dose of inspiration, wisdom, or stoic reflection.
Based on the selected category (like Zen, Gita, Aurelius, or Kafka), it fetches quotes dynamically from a Google Sheet. The widget adapts its size and style to fit the quote length and device size, and refreshes every night at midnight. Font and background colors can be pulled from the sheet or randomized from a curated palette.
This widget supports small, medium, and large sizes. You can also pass an optional index to show a specific quote or change the category with a parameter.

Class Schedule Viewer

📅 The Class Schedule Widget syncs your school or university timetable from a public Google Sheet and automatically displays today’s classes. It adapts to the widget size: from showing only the current class to displaying a full weekly schedule with a beautiful gradient background per weekday.
This widget supports small, medium, and large views. You can also simulate different days or class times using widget parameters.

Modular Time Progress

⏳ The Modular Time Progress Widget lets you visualize your life in motion— from the minutes in your day to the weeks in your year. This fully modular Scriptable widget supports multiple modes like day, week, month, year, and week number views. Each mode features a clean, minimalist design with gradient themes and dynamic progress animations.
Use parameters like day, month, or weeknumring to customize each instance — perfect for stacking small, medium, or large widgets for a complete time dashboard.

Dynamic Weather Widget

⛅ The Dynamic Weather Widget gives you real-time weather data in a stylish, minimal layout. It auto-detects your current location, fetches current conditions from OpenWeatherMap, and presents the info with dynamically sized text and gradient backgrounds. Whether you use it in small, medium, or large format — it adapts gracefully.
Customize temperature units, color gradients, and update intervals to fit your aesthetic and practical needs.

GitHub Stats Widget

📊 Track your GitHub contributions, commits, stars, PRs, and more — all from your iOS Home Screen. This dynamic widget leverages GitHub's GraphQL and REST APIs to show profile or repo-specific stats using multiple themes and widget sizes.
Supports Small, Medium, and Large layouts with parameter-based customization for themes and content. Keep your dev grind visible. Because contribution streaks matter.

🌐 Other Mentionable Widgets

Looking to explore more creative widgets? Check out these amazing developers and their unique Scriptable projects:

@dharmikumbhani

• Notion Integrations – Widgets linked to your Notion tasks, notes, or pages. 🔗 View
• Periodic Table (Elements) This widget randomly chooses one of 119 elements and displays useful information about it. 🔗 View
• Random Number Fact This widget randomly chooses a number and gives a facton that number. 🔗 View

@marcjulianschwarz

• Small Seasons – Scriptable widget that displays the current sekki ("small season"). 🔗 View
• Binary Date – Scriptable widget that displays the current date in binary. 🔗 View
• location – Scriptable widget that shows your current location using satellite imagery from Google Maps. 🔗 View
• Aerialbot lite – Scriptable widget that shows a random location in the world. 🔗 View

@anviqs

• Habit Tracker – Track your daily progress across up to six habits directly from your Home Screen with a clean and minimal design. 🔗 View

@lwitzani

• Days Until Birthday – up to 20 people of your contacts are shown simultaneously with their birthday and how many days are left. 🔗 View

@bitKrakenCode

• Word Clock – word clock widget inspired by QlockTwo. 🔗 View

🧠 Inspiration doesn’t stop here. Browse GitHub with keyword scriptable and see how far people have taken this app. List

📖 How to Use These Scriptable Widgets?

1. Install Scriptable

   • Download the free Scriptable app from the App Store on your iPhone or iPad.

2. Set Up the Scriptable Folder

   • Ensure a folder named Scriptable exists in your iCloud Drive:
   • Open the Files app
   • Navigate to iCloud Drive
   • If not already present, create a folder named Scriptable (case-sensitive)

3. Download Widget Scripts

   • From this repository:

     • Locate the .js file for the widget you want to use
     • Download and save it to the Scriptable folder in your iCloud Drive

4. Add the Widget to Your Home Screen

   1. Long-press on the home screen to enter jiggle mode
   2. Tap the “+” icon (top-left corner)
   3. Search for Scriptable and choose the desired widget size (Small / Medium / Large)
   4. Tap Add Widget

5. Configure the Widget

   • After adding the widget:

     • Long-press the widget → Tap “Edit Widget”
     • Adjust the following settings:

Setting	Default	What to Change
Script	Choose	Select your downloaded widget script
When Interacting	Open App	Run Script (optional)
Parameter	Empty	Provide any specific config text for the widget (see docs below)

6. Widget-Specific Options

   • Some widgets support extra customization (e.g., theme, filters, category, API keys, etc.).
     Refer to the widget's own folder or the script's header comments to see what parameters are supported.

🙌 Feedback

Have feature ideas or issues? DM me on Instagram or email me at rushiofficial1205@gmail.com.

Widgets shouldn’t be limited to timers—I’d love to build tools that help you passively learn, reflect, or stay organized. If you have a unique concept in mind, I’d love to collaborate.

📜 License

This project is licensed under the MIT License.

Feel free to fork, build upon, and remix with attribution.

Enjoy using this widget ~ RP