Skip to content

feat: add progress_offset#21

Open
ma-zal wants to merge 4 commits into
Rishi8078:mainfrom
ma-zal:feat/progress_offset
Open

feat: add progress_offset#21
ma-zal wants to merge 4 commits into
Rishi8078:mainfrom
ma-zal:feat/progress_offset

Conversation

@ma-zal

@ma-zal ma-zal commented Oct 4, 2025

Copy link
Copy Markdown

Hi @Rishi8078. I am offering you the new config, what I needed for my own usage.

🎯 Summary

Adds progress_offset - a powerful parameter that allows offsetting only the progress circle without affecting the countdown text display. This creates visual flexibility for various timing scenarios.

✨ What's New

  • New Parameter: progress_offset (optional, number)
    • Offsets the progress circle calculation by specified seconds
    • Does NOT affect countdown text - only visual progress
    • Positive values: Progress moves slower (delayed)
    • Negative values: Progress moves faster (ahead)

🎨 Key Feature

Countdown and Progress can run at different speeds!

  • Countdown text always shows real remaining time
  • Progress circle can be ahead or behind for visual effects

📋 Use Cases

1. Early Warning

type: custom:timeflow-card
target_date: "2025-10-10T15:00:00" # from some sensor
creation_relative: 900
progress_offset: -120  # Progress completes 2 min early
# Effect: Progress hits 100% at 02:00 remaining → gives you prep time!

@ma-zal ma-zal marked this pull request as draft October 4, 2025 08:55
@ma-zal ma-zal force-pushed the feat/progress_offset branch from ec7e71d to 07fd83f Compare October 4, 2025 09:28
@ma-zal ma-zal marked this pull request as ready for review October 5, 2025 10:36
@Rishi8078

Copy link
Copy Markdown
Owner

Hi @ma-zal , thanks for the work, i will go through it. I am working on a visual editor for the card and this might take a while.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants