What is the Pomodoro Technique?
The Pomodoro Technique is a time-management method: work in focused intervals (classically 25 minutes), then take a short break. After several cycles, take a longer break. iPomodoro automates this rhythm so you can focus on the work, not the clock.
How is iPomodoro different from the old Flutter version?
This is a complete SwiftUI rewrite for Apple platforms. Same core ideas — Pomodoro, study timer, countdown tasks — but native performance, Live Activity, modern widgets, and tighter iOS integration. The Flutter edition remains on GitHub for reference; the App Store listing (ID 6775220048) is the new Swift version.
Do I need an account or internet connection?
No. All core features work fully offline. Timers, tasks, themes, and widgets run on-device. Internet is only needed for App Store updates, optional in-app tip purchase, or sending feedback email.
How do I customize work and break durations?
Tap the gear icon on the Pomodoro tab → adjust stepper rows, or tap the large timer digits on the main screen to open a duration picker. Long break interval (every N pomodoros) is also configurable.
How do Live Activity and Dynamic Island work?
Enable Live Activity separately in Pomodoro and Study Timer settings (gear icon). Each mode gets its own Lock Screen and Dynamic Island countdown — they never overwrite each other. While a session runs, you see a live countdown; when it completes, a brief celebration shows for 10 seconds. If iOS terminates the app while your timer still appears on the Lock Screen, reopening iPomodoro restores the session and jumps to the active tab.
How do I add widgets?
Long-press the Home Screen → + → search for iPomodoro (or 爱番茄 / 愛番茄). Pick iPomodoro · Pomodoro or iPomodoro · Study Timer for timer countdowns (they are separate widgets), or Daily Motivational Quote for the daily quote. For step-by-step help, open Settings → Widgets → How to Use.
Why doesn’t my timer widget update?
Pomodoro and Study Timer are separate widgets. Start or pause a session in the matching tab and make sure you added the correct widget. iOS may delay refreshes to save battery — open the app once to sync faster.
Where is the old timer widget?
Timers are now iPomodoro · Pomodoro and iPomodoro · Study Timer. Remove any old timer widget and add the new ones from the widget gallery.
How does the daily motivation quote work?
One quote is selected deterministically each day using (year × 400 + dayOfYear) % total. Filter quote language under Settings → Motivational Quote Settings → Motivational Quote Languages (All / Simplified / Traditional / English). The same quote appears in the Motivation widget and Live Activity hint until midnight. Browse random quotes in Settings → Motivational Quote Settings → Motivational Quotes (full-screen, one at a time).
Can widget backgrounds follow my theme?
Yes. Settings → Widgets → Widget background follows theme mirrors your global accent gradient on Home and Lock Screen widgets. Turn it off for a clean white (light) or system dark background while keeping accent colors on titles.
How do task due reminders work?
When creating or editing a task, enable Due date reminder and set a future target date/time. A local notification fires at that exact moment. Manage pending reminders under Tasks tab → gear → Task due reminders.
Why can’t I enable a reminder for a past date?
If the target datetime has already passed, the reminder toggle is hidden and any existing reminder is disabled automatically — there is nothing meaningful left to schedule.
Can I use a different language than my system?
Yes. Go to Settings tab → Language and pick English, Simplified Chinese, or Traditional Chinese. The app name on your Home Screen follows system language; in-app UI follows your in-app choice.
Does the app collect my data?
No analytics, no tracking, no cloud upload of your timers or tasks. See our Privacy Policy for full details.
Is the app open source?
Yes — github.com/iHTCTeam/iPomodoros. Issues and contributions welcome.
Will macOS be supported?
macOS support is planned. The Xcode project already includes macOS SDK configuration; stay tuned for updates on the App Store and GitHub.
Still need help?
Contact us at AppleOSer@gmail.com or open an issue on GitHub. We typically respond within 48 hours.
什么是番茄工作法？
番茄工作法是一种时间管理方法：在一段专注时间内（经典为 25 分钟）深度工作，然后短休息；若干轮后进行一次长休息。爱番茄自动帮你切换节奏，让你专注内容，而不是盯时钟。
爱番茄和以前的 Flutter 版有什么区别？
这是面向 Apple 平台的 SwiftUI 全面重写。核心理念相同——番茄、计时、倒数任务——但原生性能、Live Activity、现代小组件与更紧密的系统集成。Flutter 旧版仍在 GitHub 供参考；App Store 上架版（ID 6775220048）为 Swift 原生新版。
需要账号或联网吗？
不需要。所有核心功能 完全离线 可用。计时、任务、主题、小组件均在设备本地运行。联网仅用于 App Store 更新、可选打赏或发送反馈邮件。
如何自定义工作与休息时长？
在番茄 Tab 点 齿轮 → 调整 Stepper 行，或直接 点按主屏大号计时数字 打开滚轮选择器。长休息间隔（每 N 个番茄）也可配置。
Live Activity 和灵动岛怎么用？
在番茄或计时的 齿轮 → Live Activity 中分别开启。两种模式各自拥有锁屏与（支持的 iPhone）灵动岛倒计时，互不覆盖。会话运行中显示实时倒计时；完成后约 10 秒祝贺态后消失。若系统在计时进行中终止 App 而锁屏仍显示倒计时，重新打开爱番茄会恢复会话并跳转到对应 Tab。
如何添加小组件？
长按主屏幕 → + → 搜索 爱番茄（或 iPomodoro）。选择 爱番茄 · 番茄钟 或 爱番茄 · 学习计时（两款独立计时组件），或 今日励志语录。详细步骤见 设置 → 小组件 → 使用教程。
计时小组件为什么不更新？
番茄钟与学习计时是两款独立小组件。请在对应 Tab 开始或暂停计时，并确认添加的是正确的那一款。为省电，系统可能稍晚才刷新——打开 App 可更快同步。
找不到原来的计时小组件？
计时已拆分为 爱番茄 · 番茄钟 与 爱番茄 · 学习计时。请删除旧组件后从组件库重新添加。
每日励志语录如何选取？
每日一句由 (year × 400 + dayOfYear) % 总数 确定。在 设置 → 励志语设置 → 励志语录语言 中筛选（全部 / 仅简体 / 仅繁体 / 仅英文）。励志小组件与 Live Activity hint 共用同一句，到零点切换。在 设置 → 励志语设置 → 励志语录 全屏随机浏览（一次一条）。
小组件背景能跟随主题色吗？
可以。设置 → 小组件 → 小组件背景跟随主题色 会让主屏/锁屏组件背景与全局强调色渐变一致；关闭后浅色白底/深色系统底，标题强调色仍跟主题。
任务到期提醒如何工作？
创建或编辑任务时开启 到期提醒 并设定未来的目标时间，到点触发本地通知。在 定任务 Tab → 齿轮 → 任务到期提醒 中管理待触发列表。
为什么过去的时间不能开提醒？
目标时刻已过时，提醒开关会隐藏并自动关闭——没有可合理调度的通知。
能否使用与系统不同的语言？
可以。设置 Tab → 语言 中选择 English、简体中文或繁體中文。主屏幕应用名跟随系统语言；App 内界面跟随 App 内选择。
应用会收集我的数据吗？
无统计、无追踪、不上传计时或任务数据。详见 隐私政策。
应用开源吗？
是的 — github.com/iHTCTeam/iPomodoros，欢迎 Issue 与贡献。
会支持 macOS 吗？
macOS 版本在规划中，Xcode 工程已预留 SDK 配置，请关注 App Store 与 GitHub 动态。
仍需帮助？
请联系 AppleOSer@gmail.com 或在 GitHub 提交 Issue，我们通常 48 小时内回复。
什麼是番茄工作法？
番茄工作法是一種時間管理方法：在一段專注時間內（經典為 25 分鐘）深度工作，然後短休息；若干輪後進行一次長休息。愛番茄自動幫你切換節奏，讓你專注內容，而不是盯時鐘。
愛番茄和以前的 Flutter 版有什麼區別？
這是面向 Apple 平台的 SwiftUI 全面重寫。核心理念相同——番茄、計時、倒數任務——但原生效能、Live Activity、現代小工具與更緊密的系統整合。Flutter 舊版仍在 GitHub 供參考；App Store 上架版（ID 6775220048）為 Swift 原生新版。
需要帳號或連網嗎？
不需要。所有核心功能 完全離線 可用。計時、任務、主題、小工具均在裝置本地運行。連網僅用於 App Store 更新、可選打賞或傳送回饋郵件。
如何自訂工作與休息時長？
在番茄 Tab 點 齒輪 → 調整 Stepper 列，或直接 點按主畫面大型計時數字 開啟滾輪選擇器。長休息間隔（每 N 個番茄）也可設定。
Live Activity 和靈動島怎麼用？
在番茄或計時的 齒輪 → Live Activity 中分別啟用。兩種模式各自擁有鎖定畫面與（支援的 iPhone）靈動島倒數，互不重疊。工作階段執行中顯示即時倒數；完成後約 10 秒祝賀態後消失。若系統在計時進行中終止 App 而鎖定畫面仍顯示倒數，重新開啟愛番茄會恢復工作階段並跳轉到對應 Tab。
如何新增小工具？
長按主畫面 → + → 搜尋 愛番茄（或 iPomodoro）。選擇 愛番茄 · 番茄鐘 或 愛番茄 · 學習計時（兩款獨立計時元件），或 今日勵志語錄。詳細步驟見 設定 → 小組件 → 使用教學。
計時小工具為什麼不更新？
番茄鐘與學習計時是兩款獨立小工具。請在對應 Tab 開始或暫停計時，並確認新增的是正確的那一款。為省電，系統可能稍晚才重新整理——開啟 App 可更快同步。
找不到原來的計時小工具？
計時已拆分為 愛番茄 · 番茄鐘 與 愛番茄 · 學習計時。請刪除舊元件後從元件庫重新新增。
每日勵志語錄如何選取？
每日一句由 (year × 400 + dayOfYear) % 總數 確定。在 設定 → 勵志語錄設定 → 勵志語錄語言 中篩選（全部 / 僅簡體 / 僅繁體 / 僅英文）。勵志小工具與 Live Activity hint 共用同一句，到零點切換。在 設定 → 勵志語錄設定 → 勵志語錄 全螢幕隨機瀏覽（一次一條）。
小工具背景能跟隨主題色嗎？
可以。設定 → 小組件 → 小組件背景跟隨主題色 會讓主畫面/鎖定畫面元件背景與全域強調色漸層一致；關閉後淺色白底/深色系統底，標題強調色仍跟主題。
任務到期提醒如何運作？
建立或編輯任務時開啟 到期提醒 並設定未來的目標時間，到點觸發本地通知。在 定任務 Tab → 齒輪 → 任務到期提醒 中管理待觸發列表。
為什麼過去的時間不能開提醒？
目標時刻已過時，提醒開關會隱藏並自動關閉——沒有可合理排程的通知。
能否使用與系統不同的語言？
可以。設定 Tab → 語言 中選擇 English、简体中文 或 繁體中文。主畫面應用名跟隨系統語言；App 內介面跟隨 App 內選擇。
應用會收集我的資料嗎？
無統計、無追蹤、不上傳計時或任務資料。詳見 隱私政策。
應用開源嗎？
是的 — github.com/iHTCTeam/iPomodoros，歡迎 Issue 與貢獻。
會支援 macOS 嗎？
macOS 版本在規劃中，Xcode 工程已預留 SDK 設定，請關注 App Store 與 GitHub 動態。
仍需協助？
請聯絡 AppleOSer@gmail.com 或在 GitHub 提交 Issue，我們通常 48 小時內回覆。