Repolode
almarklein

almarklein/timetagger

基于交互式时间线和标签的网页版时间追踪工具,可本地运行或自托管。

可替代:TogglClockifyHarvest

Star
1,808
Fork
170
未关闭 Issue
106
最近提交
27天前

这是什么?

TimeTagger 是一款面向个人和自由职业者的开源时间追踪工具,基于网页运行。记录以交互式时间线展示,用标签而非项目层级来分类,既可以作为单用户应用在本地运行,也可以部署到服务器供多人使用,并在多台设备之间同步。

工具支持导出 PDF 和 CSV 格式的报表,可设置每日、每周、每月的时间目标,并提供实验性的番茄钟功能。界面适配小屏和大屏。也可以直接使用官方托管版本 timetagger.app。

服务端基于异步 Python,使用 uvicorn 和 asgineer,数据存储在 SQLite 中。客户端代码同样用 Python 编写,通过 PScript 编译为 JavaScript。项目提供 Docker 镜像,支持基于 BCrypt 的账户凭据,也可配合反向代理进行身份验证。

核心功能

  • 01交互式时间线,用于记录和回顾时间条目。
  • 02使用标签分类,而非嵌套项目。
  • 03支持导出 PDF 和 CSV 格式报表。
  • 04可设置每日、每周、每月的时间目标。
  • 05多设备同步,界面适配不同尺寸屏幕。
  • 06支持通过 pip 或 Docker 自托管,可使用账户凭据或反向代理认证。

适用场景

  • 自由职业者按客户记录计费工时并导出报表。
  • 希望在自己服务器上自托管时间追踪工具的个人用户。
  • 需要在同一实例中为多个用户开设账户的团队或家庭。
  • 使用每日、每周或每月目标跟踪个人计划的用户。

快速上手

  1. 1

    使用 pip 安装 TimeTagger

    pip install -U timetagger
  2. 2

    在本地运行服务器

    python -m timetagger

使用前须知

  • 需要 Python 3.6 或更高版本。
  • 若要多用户或在非本机服务器上使用,需要自行搭建服务器并配置凭据或反向代理。
  • 番茄工作法功能标注为实验性功能。

收录于专题

标签

常见问题

timetagger 是什么?
基于交互式时间线和标签的网页版时间追踪工具,可本地运行或自托管。 TimeTagger 是一款面向个人和自由职业者的开源时间追踪工具,基于网页运行。记录以交互式时间线展示,用标签而非项目层级来分类,既可以作为单用户应用在本地运行,也可以部署到服务器供多人使用,并在多台设备之间同步。
timetagger 可以免费使用吗?用的什么许可证?
timetagger 以 GPL-3.0 许可证开源。用于商业产品前,请先确认许可证条款。
timetagger 还在维护吗?
活跃维护中。timetagger 最近一次提交是在 2026年9月28日。
timetagger 适合用来做什么?
自由职业者按客户记录计费工时并导出报表。 希望在自己服务器上自托管时间追踪工具的个人用户。 需要在同一实例中为多个用户开设账户的团队或家庭。 使用每日、每周或每月目标跟踪个人计划的用户。
timetagger 怎么安装和运行?
使用 pip 安装 TimeTagger: pip install -U timetagger 在本地运行服务器: python -m timetagger
在哪里获取 timetagger?
源代码和安装说明在 GitHub 上:https://github.com/almarklein/timetagger

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目