iPomodoro · iPomodoro · 爱番茄 · 愛番茄

iPomodoro (爱番茄) is a native SwiftUI productivity app built around the Pomodoro Technique: split deep work into focused intervals with intentional breaks, stay in rhythm, and finish what you start.

Three modes live in one calm app — Pomodoro, Study Timer, and Countdown Tasks — each with its own accent theme, settings, and widgets. No sign-up, no cloud account, no tracking. Your timers and tasks stay on your device.

Getting Started

1. Open the Pomodoro tab. Tap the timer digits to set work duration, or use the defaults (25 min work · 5 min short break · 15 min long break).
2. Tap Start and focus. When a session ends, the app switches to break automatically — or notifies you if the app is in the background.
3. Switch to Study Timer for free-form sessions: set any hour/minute length and run without Pomodoro cycles.
4. Open Tasks to add countdown goals — exam dates, project deadlines, habit milestones. Enable Due date reminder to get a local notification at the target time.
5. Add Home Screen or Lock Screen widgets — Pomodoro and Study Timer are separate widgets, plus an optional Daily Motivation quote widget. See Settings → Widgets → How to Use for a step-by-step guide.
6. Enable Live Activity independently in each mode (gear icon → Live Activity). Each mode gets its own Lock Screen and Dynamic Island countdown — they never overwrite each other.

Three Modes, One App

Pomodoro — Classic focus cycles

The heart of the app. Work intervals, short breaks, and long breaks rotate automatically based on your settings.

• Fully customizable durations — work hours/minutes, short break, long break, and long-break interval (every N pomodoros).
• Tap-to-edit timer — tap the large H:M:S display to open a duration picker; stepper rows in settings for fine tuning.
• Chakra Petch digit display — stable, jitter-free countdown typography scaled from the original Flutter design.
• Startup motivation — a full-screen quote appears once per app launch when you enter the Pomodoro tab (never spammy, never repeated on tab switch).
• Completion feedback — haptics, optional alarm sound, and a Live Activity completed state that dismisses after 10 seconds.
• Keep screen awake — optional always-on display while a session is running.

Study Timer — Learn at your own pace

Not every session fits a 25-minute box.

• Set any duration from hours down to minutes.
• Same polished timer UI, tick sounds, background notifications, and Live Activity support as Pomodoro.
• Independent theme colors — default ocean blue gradient, fully customizable.

Countdown Tasks — Deadlines with clarity

Track what matters and see exactly how many days remain.

• Card-style task list with title, target date/time, notes, and a bold days-remaining counter.
• Sort options — by target date or last modified.
• Swipe to edit or delete; add tasks from the navigation bar.
• Due date reminders — local notification fires at the exact target date & time you choose.
• Reminder manager — view all pending task notifications grouped by Today / Tomorrow / Next 7 days / Later; cancel one or turn off the reminder entirely.
• Reminder toggle is smart: if the target time is already in the past, the switch hides and the reminder is disabled automatically.

Live Activity & Dynamic Island

Available on supported iPhones (iOS 16.2+). Pomodoro and Study Timer each have their own Live Activity — enable them separately under each tab’s gear settings.

Compact Dynamic Island layout: countdown on the left, mode icon on the right — minimal width, maximum clarity.

Session recovery: If iOS terminates the app while your timer still shows on the Lock Screen, iPomodoro restores the in-progress session when you reopen it and jumps to the active Pomodoro or Study tab automatically.

Widgets

All widgets read on-device shared state via App Group — no network required.

The motivation quote algorithm is (year × 400 + dayOfYear) % count, so everyone sees a stable “quote of the day” that changes cleanly at day boundary.

Widget appearance: Settings tab → Widgets → toggle Widget background follows theme to mirror your global accent gradient, or use a clean white / system dark background while keeping accent colors on titles.

Need help? Settings → Widgets → How to Use covers Home Screen, Lock Screen, StandBy, Live Activity, and FAQ — including migrating from the older single timer widget.

Motivation & Mindset

Hundreds of curated quotes (JSON corpus, fully on-device) power four touchpoints:

1. Startup popup — once per launch on the Pomodoro tab (full-screen, language-aware dismiss button)
2. Settings browse — Settings → Motivational Quote Settings → Motivational Quotes: full-screen single quote; tap the bottom button for another; filter language (All / Simplified Chinese / Traditional Chinese / English only)
3. Live Activity hint — subtle encouragement on Lock Screen while timing
4. Motivation widget — daily quote on your Home Screen

Quote fonts adapt to content — English uses Chakra Petch; Simplified Chinese uses Ma Shan Zheng; Traditional Chinese uses Noto Sans TC. Same engine, different moments — always optional to engage with.

Sound & Notifications

• Tick sounds during focus — multiple options with loop preview in settings
• Alarm sounds when a session completes — choose what fits your flow
• Background reminders while timing — gentle nudges if the app is backgrounded (configurable per mode)
• Task due reminders — calendar-triggered local notifications at your exact target datetime

All notifications are local — scheduled by your device, not a remote server.

Themes & Appearance

A thoughtful two-layer design:

Default page colors:

Pick any color from the preset palette or reset to defaults anytime.

Languages

Full UI localization in English, Simplified Chinese, and Traditional Chinese.

The app display name adapts too:

Switch language independently in Settings — Tab bar and widgets refresh instantly.

Privacy & Data

• Timers and settings — stored locally in UserDefaults on your device.
• Tasks — stored locally in an on-device SQLite database.
• Widgets & Live Activity — separate Pomodoro / Study timer snapshots plus motivation & theme mirrors via App Group (group.com.iHTCboy.iPomodoros); never leaves your device.
• No analytics SDKs, no advertising, no third-party tracking.
• No account required — ever.
• Optional Tip the Developer in-app purchase is handled entirely by Apple StoreKit.

Open Source

iPomodoro is rebuilt from the ground up in SwiftUI, evolving from the earlier Flutter edition. The Swift source is available on GitHub:

github.com/iHTCTeam/iPomodoros

System Requirements

Contact Us

Questions, feedback, or feature ideas?

• In-App: Settings → Feedback (email composer with device info)
• Email: AppleOSer@gmail.com
• GitHub: github.com/iHTCTeam/iPomodoros/issues

We typically respond within 48 hours.

FAQ · Privacy Policy

爱番茄（iPomodoro）是一款围绕 番茄工作法 打造的 SwiftUI 原生效率应用：把深度工作切成「专注 + 休息」的有节奏循环，帮你进入心流、把事情做完。

三种模式合于一款克制好用的 App——番茄学习、计时学习、定任务——各自拥有独立主题、设置与小组件。无需注册、无需云端账号、无追踪。 你的计时与任务数据只留在设备上。

快速上手

1. 打开 番茄 Tab，点按大号计时数字设置工作时长，或直接使用默认（25 分钟工作 · 5 分钟短休息 · 15 分钟长休息）。
2. 点 开始 专注。一段结束后自动进入休息；若 App 在后台，会推送通知提醒你。
3. 切换到 计时 Tab，自由设定任意时长，不受番茄循环约束。
4. 在 定任务 中添加倒数目标——考试、项目节点、习惯里程碑。开启 到期提醒，到目标时刻会收到本地通知。
5. 添加 主屏 / 锁屏小组件 — 番茄钟与学习计时为两款独立组件，还可添加 今日励志 语录组件。详见 设置 → 小组件 → 使用教程。
6. 在各模式 齿轮 → Live Activity 中分别开启实时活动。番茄与学习计时各自拥有锁屏与灵动岛倒计时，互不覆盖。

三种模式，一款 App

番茄学习 — 经典专注循环

• 时长完全可配 — 工作时分、短休息、长休息、长休息间隔（每 N 个番茄）。
• 点按编辑计时 — 点击 H:M:S 大数字打开滚轮选择器；设置页 Stepper 微调。
• Chakra Petch 数字显示 — 稳定无抖动的倒计时排版，比例继承自 Flutter 原版。
• 启动励志 — 进入番茄 Tab 时全屏展示一句语录（每次启动仅一次，切换 Tab 不重复打扰）。
• 完成反馈 — 触感、可选闹钟音、Live Activity 完成态（10 秒后自动消失）。
• 防息屏 — 计时进行中可选保持屏幕常亮。

计时学习 — 按你的节奏学

• 任意 小时 + 分钟 时长。
• 与番茄模式共享精致 UI、滴答声、后台通知与 Live Activity。
• 独立主题色——默认海洋蓝渐变，可完全自定义。

定任务 — 截止日期，一目了然

• 卡片式列表：标题、目标时间、备注、醒目剩余天数。
• 排序：按目标日期或修改时间。
• 左滑编辑 / 删除；导航栏右上角添加。
• 到期提醒：在你设定的 年月日时分 准时本地推送。
• 提醒管理（定任务 → 齿轮 → 任务到期提醒）：查看系统待触发通知，按今天 / 明天 / 近 7 天 / 更晚分组；可取消单次或关闭任务提醒。
• 目标时间已过时，提醒开关自动隐藏并关闭。

灵动岛与 Live Activity

支持的 iPhone（iOS 16.2+）可用。番茄钟与学习计时各自拥有独立的 Live Activity，请在各 Tab 齿轮设置中分别开启。

灵动岛紧凑布局：左侧倒计时、右侧模式图标——少占宽度，信息清晰。

会话恢复： 若系统在计时进行中终止 App，而锁屏仍显示倒计时，重新打开爱番茄时会自动恢复进行中的会话，并跳转到对应的番茄或计时 Tab。

小组件

通过 App Group 读取设备本地共享快照，无需联网。

励志算法：(year × 400 + dayOfYear) % count，全员同一天看到同一句，跨日 cleanly 切换。

小组件外观： 设置 Tab → 小组件 → 小组件背景跟随主题色，可让背景与全局强调色渐变一致；关闭后浅色白底/深色系统底，标题强调色仍跟主题。

使用帮助： 设置 → 小组件 → 使用教程，含主屏/锁屏/StandBy、Live Activity 说明与 FAQ——包括如何从旧版单一计时组件迁移。

励志与心态

数百条精选语录（JSON 语料，全在设备本地），四个触点：

1. 启动弹窗 — 番茄 Tab 每次启动一次（全屏，按钮文案随语录语言）
2. 设置浏览 — 设置 → 励志语设置 → 励志语录：全屏单条展示，底部换一条；可筛选语录语言（全部 / 仅简体 / 仅繁体 / 仅英文）
3. Live Activity hint — 锁屏计时时单行鼓励
4. 励志小组件 — 主屏每日一句

字体随语录语言适配——英文 Chakra Petch、简体 Ma Shan Zheng、繁体 Noto Sans TC。同一引擎，不同场景——想看就看。

声音与通知

• 滴答声 — 专注时可选多种，设置页循环试听
• 闹钟音 — 阶段结束提醒
• 后台计时通知 — App 退到后台时的温和提醒（各模式可配）
• 任务到期提醒 — 按目标 datetime 触发的本地通知

所有通知均为 本地调度，不经远程服务器。

主题与外观

双层主题设计：

默认页面色：

可从预设调色板任选，随时恢复默认。

多语言

完整支持 English、简体中文、繁體中文。

应用展示名随语言变化：

在设置中独立切换语言——Tab 栏与小组件即时刷新。

隐私与数据

• 计时与设置 — UserDefaults 本地存储。
• 任务 — 设备本地 SQLite。
• 小组件 & Live Activity — 番茄/学习独立计时快照，以及励志与主题镜像，经 App Group（group.com.iHTCboy.iPomodoros）共享，不出设备。
• 无统计 SDK、无广告、无第三方追踪。
• 无需账号。
• 可选 打赏开发者 由 Apple StoreKit 处理。

开源

爱番茄由 SwiftUI 全面重写，承袭早期 Flutter 版 的功能理念：

github.com/iHTCTeam/iPomodoros

系统要求

联系我们

有问题、反馈或功能建议？

• 应用内：设置 → 反馈（邮件模板含设备信息）
• 邮箱： AppleOSer@gmail.com
• GitHub： github.com/iHTCTeam/iPomodoros/issues

我们通常在 48 小时内回复。

常见问题 · 隐私政策

愛番茄（iPomodoro）是一款圍繞 番茄工作法 打造的 SwiftUI 原生效率應用：把深度工作切成「專注 + 休息」的有節奏循環，幫你進入心流、把事情做完。

三種模式合於一款克制好用的 App——番茄學習、計時學習、定任務——各自擁有獨立主題、設定與小工具。無需註冊、無需雲端帳號、無追蹤。 你的計時與任務資料只留在裝置上。

快速上手

1. 開啟 番茄 Tab，點按大型計時數字設定工作時長，或直接使用預設（25 分鐘工作 · 5 分鐘短休息 · 15 分鐘長休息）。
2. 點 開始 專注。一段結束後自動進入休息；若 App 在背景，會推送通知提醒你。
3. 切換到 計時 Tab，自由設定任意時長，不受番茄循環約束。
4. 在 定任務 中新增倒數目標——考試、專案節點、習慣里程碑。開啟 到期提醒，到目標時刻會收到本地通知。
5. 新增 主畫面 / 鎖定畫面小工具 — 番茄鐘與學習計時為兩款獨立元件，還可新增 今日勵志 語錄小工具。詳見 設定 → 小組件 → 使用教學。
6. 在各模式 齒輪 → Live Activity 中分別啟用實時動態。番茄與學習計時各自擁有鎖定畫面與靈動島倒數，互不重疊。

三種模式，一款 App

番茄學習 — 經典專注循環

• 時長完全可配 — 工作時分、短休息、長休息、長休息間隔（每 N 個番茄）。
• 點按編輯計時 — 點擊 H:M:S 大數字開啟滾輪選擇器；設定頁 Stepper 微調。
• Chakra Petch 數字顯示 — 穩定無抖動的倒數排版，比例繼承自 Flutter 原版。
• 啟動勵志 — 進入番茄 Tab 時全螢幕展示一句語錄（每次啟動僅一次，切換 Tab 不重複打擾）。
• 完成回饋 — 觸感、可選鬧鐘音、Live Activity 完成態（10 秒後自動消失）。
• 防息屏 — 計時進行中可選保持螢幕常亮。

計時學習 — 按你的節奏學

• 任意 小時 + 分鐘 時長。
• 與番茄模式共享精緻 UI、滴答聲、背景通知與 Live Activity。
• 獨立主題色——預設海洋藍漸層，可完全自訂。

定任務 — 截止日期，一目了然

• 卡片式列表：標題、目標時間、備註、醒目剩餘天數。
• 排序：按目標日期或修改時間。
• 左滑編輯 / 刪除；導覽列右上角新增。
• 到期提醒：在你設定的 年月日時分 準時本地推送。
• 提醒管理（定任務 → 齒輪 → 任務到期提醒）：查看系統待觸發通知，按今天 / 明天 / 近 7 天 / 更晚分組；可取消單次或關閉任務提醒。
• 目標時間已過時，提醒開關自動隱藏並關閉。

靈動島與 Live Activity

支援的 iPhone（iOS 16.2+）可用。番茄鐘與學習計時各自擁有獨立的 Live Activity，請在各 Tab 齒輪設定中分別啟用。

靈動島緊湊版面：左側倒數、右側模式圖示——少占寬度，資訊清晰。

工作階段恢復： 若系統在計時進行中終止 App，而鎖定畫面仍顯示倒數，重新開啟愛番茄時會自動恢復進行中的工作階段，並跳轉到對應的番茄或計時 Tab。

小工具

透過 App Group 讀取裝置本地共享快照，無需連網。

勵志演算法：(year × 400 + dayOfYear) % count，全員同一天看到同一句，跨日 cleanly 切換。

小工具外觀： 設定 Tab → 小組件 → 小組件背景跟隨主題色，可讓背景與全域強調色漸層一致；關閉後淺色白底/深色系統底，標題強調色仍跟主題。

使用說明： 設定 → 小組件 → 使用教學，含主畫面/鎖定畫面/StandBy、Live Activity 說明與 FAQ——包括如何從舊版單一計時元件遷移。

勵志與心態

數百條精選語錄（JSON 語料，全在裝置本地），四個觸點：

1. 啟動彈窗 — 番茄 Tab 每次啟動一次（全螢幕，按鈕文案隨語錄語言）
2. 設定瀏覽 — 設定 → 勵志語錄設定 → 勵志語錄：全螢幕單條展示，底部換一條；可篩選語錄語言（全部 / 僅簡體 / 僅繁體 / 僅英文）
3. Live Activity hint — 鎖屏計時時單行鼓勵
4. 勵志小工具 — 主畫面每日一句

字體隨語錄語言適配——英文 Chakra Petch、簡體 Ma Shan Zheng、繁體 Noto Sans TC。同一引擎，不同場景——想看就看。

聲音與通知

• 滴答聲 — 專注時可選多種，設定頁循環試聽
• 鬧鐘音 — 階段結束提醒
• 背景計時通知 — App 退到背景時的溫和提醒（各模式可配）
• 任務到期提醒 — 按目標 datetime 觸發的本地通知

所有通知均為 本地排程，不經遠端伺服器。

主題與外觀

雙層主題設計：

預設頁面色：

可從預設調色盤任選，隨時恢復預設。

多語言

完整支援 English、简体中文、繁體中文。

應用展示名隨語言變化：

在設定中獨立切換語言——Tab 列與小工具即時重新整理。

隱私與資料

• 計時與設定 — UserDefaults 本地儲存。
• 任務 — 裝置本地 SQLite。
• 小工具 & Live Activity — 番茄/學習獨立計時快照，以及勵志與主題鏡像，經 App Group（group.com.iHTCboy.iPomodoros）共享，不出裝置。
• 無統計 SDK、無廣告、無第三方追蹤。
• 無需帳號。
• 可選 打賞開發者 由 Apple StoreKit 處理。

開源

愛番茄由 SwiftUI 全面重寫，承襲早期 Flutter 版 的功能理念：

github.com/iHTCTeam/iPomodoros

系統需求

聯絡我們

有問題、回饋或功能建議？

• 應用內：設定 → 回饋（郵件範本含裝置資訊）
• 電子郵件： AppleOSer@gmail.com
• GitHub： github.com/iHTCTeam/iPomodoros/issues

我們通常在 48 小時內回覆。

常見問題 · 隱私政策