PomodoroCountdownter

A modern, cross-platform Pomodoro timer desktop app built with Tauri, Vue 3, and Element Plus.

#alarm#desktop-app#element-plus#pomodoro#rust#tauri

View Repository on GitHub ↗

REPOSITORY OVERVIEW

Live repository statistics

★ 3Stars

⑂ 2Forks

◯ 1Open issues

◉ 3Watchers

38/100

OPENREPOHUB HEALTH SIGNAL

Limited signals

A transparent discovery signal based on current public GitHub metadata.

Recent activity35% weight

Community adoption25% weight

Maintenance state20% weight

License clarity10% weight

100

Project information10% weight

This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.

README preview

✨ Features / 功能特性

Pomodoro Countdown / 番茄工作法倒计时：支持工作/休息时间自定义，自动循环。
Custom Alarm / 个性化闹铃：可选择本地音频作为提醒音，支持路径缓存。
Auto Start / 开机自启动：一键开启/关闭应用随系统启动。
Cross-platform Desktop / 跨平台桌面应用：基于 Tauri，支持 Windows、macOS、Linux。
Modern UI / 现代化界面：采用 Vue3 + Element Plus，界面简洁美观。
Local Persistence / 本地持久化：设置自动保存，无需每次重选。
Safe Asset Access / 安全沙箱：音频等本地资源通过 Tauri asset 协议安全访问。

📦 Directory Structure / 目录结构

tauri-countdown/
├── public/                  # Static assets / 静态资源
├── src/
│   ├── App.vue              # Root component / 根组件
│   ├── main.js              # Entry file / 入口文件
│   ├── assets/              # Frontend static assets / 前端静态资源
│   ├── router/
│   │   └── index.js         # Router config / 路由配置
│   └── views/
│       ├── MainTimer/       # Main timer view / 主计时界面
│       ├── CountdownPage/   # Countdown view / 倒计时运行界面
│       └── TimeUpPage/      # Time up view / 时间到提示界面
├── src-tauri/               # Tauri backend (Rust) / Tauri 后端
│   ├── tauri.conf.json      # Tauri config / 配置
│   └── src/
├── package.json
├── README.md
└── ...

🚀 Quick Start / 快速开始

1. Requirements / 环境要求

Node.js >= 16
pnpm 或 npm
Rust (建议使用 rustup 安装)
Tauri CLI（如未安装，运行 pnpm dlx tauri@latest tauri dev 或 npm install -g @tauri-apps/cli）

2. Install dependencies / 安装依赖

pnpm install
# or / 或
npm install

3. Start development / 启动开发模式

pnpm tauri dev
# or / 或
npm run tauri dev

4. Build for production / 打包发布

pnpm run tauri build
# or / 或
npm run tauri build

🖥️ Main Features / 主要功能界面

Main Timer / 主界面：设置工作/休息时长、选择闹铃、开始/暂停/重置倒计时。
Countdown / 倒计时界面：显示剩余时间、进度条、暂停/恢复操作。
Time Up / 时间到界面：弹窗提醒，自动播放闹铃音频，可一键进入下一个周期。

⚙️ Config & Customization / 配置与自定义

Alarm Audio / 闹铃音频：支持选择本地音频文件，路径自动缓存，下次启动自动加载。
Auto Start / 开机自启动：通过设置菜单一键切换。
Window Size / 窗口大小：可在 src-tauri/tauri.conf.json 配置窗口初始/最小/最大尺寸。

🛠️ Tech Stack / 技术栈

Tauri - Cross-platform desktop framework / 跨平台桌面应用框架
Vue 3 - Frontend UI framework / 前端 UI 框架
Element Plus - UI component library / 组件库
@tauri-apps/api - Tauri JS API
@tauri-apps/plugin-store - Settings persistence / 设置持久化
@tauri-apps/plugin-autostart - Auto start / 开机自启动

📋 TODO

Basic Pomodoro Function / 基本番茄功能
Custom Alarm / 个性化闹铃
Auto Start / 开机自启动
Layout Improvement / 布局优化
Personalize Pomodoro Time / 个性化番茄时间
Multi-theme / 多主题
Statistics & History / 统计与历史

🤝 Contributing / 贡献

受Francesco Cirillo创立的番茄工作法启发，该项目由中山大学软件工程学院大二学生@Ky1ine 和 @Dunjia自主完成。

欢迎 issue、PR 或建议！如需自定义功能或遇到问题，请在 GitHub Issues 提交。

Inspired by Pomodoro Technique developed by Francesco Cirillo, this project is developed by sophomore students @Ky1ine and @Dunjia from the School of Software Engineering at Sun Yat-sen University.

Welcome issues, PRs, or suggestions! If you need custom features or encounter problems, please submit them on GitHub Issues.

📄 License / 许可证

MIT License

Enjoy your efficient Pomodoro time! 🍅 / 祝你高效番茄时光！