Time Progress Widget

Scriptable

Widget Size

Display Modes

Theme

Status

Last Updated

Modular Time Progress

Visualize your day, week, month, year, and more — all in one modular and minimalist design Scriptable widget.

✨ Features

• 📆 Time-Based Visualizations Track progress for:

  • Current day (with circular ring)

  • Current week (ring or dot grid view)

  • Current month (dot grid layout)

  • Current year (animated ring)

  • Week number (dot and ring styles)

• 🎨 Dark Theme with Gradients Clean black-to-gray gradients that make the visual elements pop.

• 🪄 Smooth Progress Rings Each progress type has its own elegant animation — circles, bars, and dots.

• 🧠 Intelligent Defaults No parameter? Widget shows Today, This Week, This Month, and This Year bars in a clean stack.

Setup

1. Download the ModularTimeProgress.js script into your Scriptable app.

2. Long-press your iOS home screen, tap +, and add a Scriptable widget.

3. Edit the widget and choose:

   • Script: ModularTimeProgress

   • Parameter: Any of the valid options (see below)

For visual variety, try stacking different widget sizes and parameters.

📸 Screenshots

Day Progress (day)

Displays progress through the current day as a circular progress ring.

Month Progress (month)

Dot grid showing how far you are into the current month.

Year Progress (year)

Circular ring showing yearly progress with days passed.

Week Progress (week)

Displays how far you are through the current week.

Week Number Dot View (weeknum)

Circular ring showing yearly progress with weeks passed.

Week Number Dot View (weeknumdot)

Dot grid marking each week of the year.

Default Mode (default)

Stacked bars showing:

• Today

• This Week

• This Month

• This Year

Configure Parameters

Parameter	Widget View
day	Circular day progress widget
month	Monthly dot grid with current day
year	Yearly progress ring (0–100%)
week	Weekly ring progress
weeknumdot	52-week grid, active/inactive dots
default (or empty)	Stacked progress bars: day, week, month, year

Parameters are case-insensitive. Use lowercase for best results.

🙌 Feedback

Have questions or want help customizing it? DM me on Instagram or email me at [e-mail].

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