Tomator

概述

你听说过番茄工作法吗？这是一种很棒的技术, 可以帮助你在学习或工作期间跟踪时间并保持专注. 在 维基百科上了解更多信息.

Tomator 是 MacOS 菜单栏上的番茄钟计时器.

Language

English: ReadMe

介绍

• 简洁的菜单栏界面, 不占用桌面空间
• 可配置的工作和休息间隔
• 支持强制休息、小憩休息
• 可选的声音提示和通知
• 统计功能, 追踪您的工作习惯
• 完全沙盒化, 无需任何特殊权限
• 支持深色模式和浅色模式
• 自定义颜色、背景
• 设置特定的时间表时间启用
• 低资源占用, 对系统性能影响极小

截图

下载安装

1. 访问 GitHub Releases 页面
2. 下载最新版本的 Tomator.dmg 文件
3. 解压后将 Tomator.app 拖到应用程序文件夹中

系统要求

• MacOS 13.0 或更高版本

使用

事件日志

Tomator 以记录日志到 ~/Library/Containers/cn.null.tomator/Data/Documents/logs.

URL

要从命令行启动或停止计时器, 使用 tomator://run, tomator://switch,可以使用 tomator 或 TMT.

功能

1. 启用通知后会在适当的时候发布番茄钟的状态
2. 在菜单栏显示计时器会显示每一个阶段的倒计时
3. 开启休息后停止, 将会在当前番茄钟结束后停止, 否则会继续下一个番茄钟
4. 开启强制休息, 将会在长休息状态下锁定屏幕, 期间无法对电脑进行任何操作
5. 允许滑动跳过将会在锁定屏幕状态下, 允许滑动跳过锁定屏幕
6. 弹窗功能中, 可以配置想保留的项目, 甚至可以通过右键对应的组件进行隐藏
7. 外观功能中, 可以配置语言、外观、主题色和强制窗口的样式, 支持颜色、五种渐变、桌面和自定义图片
8. 时间功能中, 可以设定你喜欢的模板, 比如绘画时的番茄钟或者工作时的番茄钟. 菜单栏 计时器功能需要手动打开, 如果你需要的话
9. 时间表功能中, 可以配置你需要启用的时间表, 不在时间表范围内将不允许使用番茄钟
10. 声音功能中, 可以启用番茄钟的声音, 以及计时器的声音

隐私 Privacy

应用不会收集任何用户的个人信息, 也不会将个人信息用于第三方, 应用不联网.

The App does not collect any user's personal information, nor does it use personal information for third-party services, and the App is not connected to the Internet.

感谢

代码经过了大量的重构, 已经与原仓库没有太多的重合代码, 但是, 非常感谢以下开发人员的贡献, 大家都做了很棒的工作

• wersling
• ivoronin

许可证

• 计时器音效授权自 buddhabeats

图标: lcdtuea

菜单栏图标: 美味的食物, 作者Banada

授权

请不要将此存储库源代码用于任何商业目的, 此应用程序从不收费, 始终更新！详情请参阅 许可证

Please do not use this repository source code for any commercial purposes, this app is never charged, always updated! For details please see LICENSE

开发

参与翻译

为了避免歧义的产生, 我将不会使用机器翻译, 如果你感兴趣, 可以参与翻译, 非常感谢你的工作

1. 下载 Localizable
2. 使用 Xcode 打开
3. 添加语言并完成翻译
4. 提交到开发者邮箱

提交

产生bug后或不可预见行为, 可以提交issue并携带您的系统版本, 能带上日志文件就更好了. 可以打开设置窗口, 信息面板, 打开日志文件夹

有好的想法或者功能新增, 可以发送邮件或者提交 Feature Request, 甚至编写你喜欢的代码, 提交 Pull Request

发布流程

项目包含两个发布脚本, 简化了应用的构建和发布过程:

1. release.sh - 构建、签名和打包应用

   # 使用Xcode项目中的MARKETING_VERSION
   ./release.sh
   
   # 指定版本号
   ./release.sh 1.0.1

   脚本将在./build目录中生成以下文件:

   • Tomator.app - 应用程序
   • Tomator.dmg - 磁盘镜像
   • Tomator.zip - 压缩包

   版本号从Xcode项目文件中的MARKETING_VERSION属性获取, 而不是从Info.plist中获取. 如果未指定版本号, 脚本会自动从project.pbxproj文件中获取当前版本.

   脚本会自动将project.pbxproj文件中的CURRENT_PROJECT_VERSION递增1, 用于标识构建版本.

2. github-release.sh - 创建GitHub发布并上传构建文件

   # 使用Xcode项目中的MARKETING_VERSION
   ./github-release.sh
   
   # 指定版本号
   ./github-release.sh 1.0.1

   运行此脚本前, 请确保已经执行了release.sh, 且安装了GitHub CLI. 此脚本同样会从project.pbxproj文件中获取版本号, 如果没有指定版本参数.