Widget Library

Widgets showcase

This library gathers every widget shipped in the repository. Each page explains setup requirements, configuration parameters, screenshots, and tips so you can copy the script into Scriptable with confidence.

Featured Widgets

🌡️ Weather Widget

• Real-time OpenWeatherMap data with themed layouts.

• Auto location plus manual overrides for full control.

• Multiple widget sizes with compact typography.

• View setup guide.

⏰ Countdown Widget

• Connects to Google Sheets for collaborative event boards.

• Supports repeating events, icons, and color accents.

• Includes v1 + v2 script options for different layouts.

• Read the countdown docs.

📊 GitHub Stats Widget

• Shows contributions, streaks, repo counts, and more.

• Great for personal dashboards or developer portfolios.

• Cache aware to keep API usage low.

• Explore the GitHub widget.

Complete Widget Catalog

Widget	Overview	Ideal size
🌬️ AQI Widget	OpenWeatherMap powered AQI + temperature readout	Small/Medium
🎂 Birthday Widget	Precise age tracker with milestone reminders	Small
⏱️ Countdown Widget	Multi-event tracker with repeat logic	Medium/Large
👨‍💻 GitHub Stats	Personal GitHub analytics	Medium
🕉️ Hindu Calendar	Auspicious colors, festivals, lunar info	Medium
💭 Quote Widget	Daily inspiration with light/dark themes	Medium
📅 Schedule Widget	Timetable view sourced from Google Sheets	Large
⏳ Time Progress	Day, week, month, year progress bars	Small/Medium
🚗 Toyota Widget	Vehicle stats and maintenance reminders	Medium
🌤️ Weather Widget	Minimal weather snapshot with theming	Small/Medium

Categories at a Glance

• Time & Calendar: Countdown, Schedule, Time Progress, Hindu Calendar

• Weather & Environment: Weather, AQI

• Personal & Social: Birthday, Quote, GitHub Stats

• Specialized: Toyota

How to Use These Docs

1. Pick a widget above and open its page.

2. Follow the prerequisites (API keys, Google Sheets templates, etc.).

3. Copy the script into Scriptable.

4. Test within the app to validate permissions and API responses.

5. Add the widget to your home screen and set optional parameters.

Tips for Smooth Setup

🌟 New to Scriptable? Start with low-complexity widgets such as Quote or Birthday and build confidence before trying data-heavy scripts.

📖 Always read the README bundled with each widget inside the Widgets/ directory—they include script-level notes and troubleshooting steps.

⚡ Test first, add later. Run the script directly in Scriptable to confirm data pulls and API keys before pinning it to the home screen.

🤝 Ask the community. Open a GitHub Discussion if you need help with parameters, theming, or API limits.

Helpful Links

• Repository home

• Issues

• Contributing guide

Happy building! Share screenshots of your layouts—we love seeing creative combinations of these widgets.