基于标签的时间跟踪工具Traggo

预告

老苏在 7 月份收到了付费合集功能灰度测试的通知,一直想研究下怎么玩的,所以国庆期间准备了三篇👇

  • 简单的豆瓣API接口(安装篇)
  • 简单的豆瓣API接口(TaleBook篇)
  • 简单的豆瓣API接口(Jellyfin篇)

预计在周四、周六、周日晚,分三次发布,一、三、五的正常发文不受影响

按照公众号的规则,每篇文章最小售价为 1 个微信豆,所以合集的售价为 3 个微信豆

老苏发现微信豆这玩意儿还有汇率差,iOS 1元=7微信豆,安卓 1元=10微信豆 😂,是因为苹果收了税吗?

为公平起见,这三篇文档不会在微信公众号之外的地方再进行发布。



本文完成于 5 月底,对应的版本为 0.2.3

什么是 Traggo ?

Traggo 是基于标签的时间跟踪工具。在 Traggo 中,没有任务,只有标记的时间跨度。

可以用来跟踪、分析你每天的时间都用在哪些地方,方便你更好的管理时间,提高自己的效率。

除了我们演示的 Docker 版之外,还有桌面客户端版本

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 traggo ,选择第一个 traggo/server,版本选择 latest

docker 文件夹中,创建一个新文件夹 traggo,并在其中建一个子文件夹 data

文件夹 装载路径 说明
docker/traggo/data /opt/traggo/data 存放设置

端口

本地端口不冲突就行,不确定的话可以用命令查一下

1
2
# 查看端口占用
netstat -tunlp | grep 端口号
本地端口 容器端口
3030 3030

环境

可变
TRAGGO_DEFAULT_USER_NAME 缺省的账号
TRAGGO_DEFAULT_USER_PASS 对应的密码

命令行安装

如果你熟悉命令行,可能用 docker cli 更快捷

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 新建文件夹 traggo 和 子目录
mkdir -p /volume2/docker/traggo/data

# 进入 traggo 目录
cd /volume2/docker/traggo

# 运行容器
docker run -d \
--restart unless-stopped \
--name traggo \
-p 3030:3030 \
-v $(pwd)/data:/opt/traggo/data \
-e TRAGGO_DEFAULT_USER_NAME=admin \
-e TRAGGO_DEFAULT_USER_PASS=mynewpassword \
traggo/server:latest

也可以用 docker-compose 安装,将下面的内容保存为 docker-compose.yml 文件

1
2
3
4
5
6
7
8
9
10
11
12
13
version: "3.7"

services:
traggo:
image: traggo/server:latest
container_name: traggo
ports:
- 3030:3030
environment:
TRAGGO_DEFAULT_USER_NAME: "admin"
TRAGGO_DEFAULT_USER_PASS: "mynewpassword"
volumes:
- ./data:/opt/traggo/data

然后执行下面的命令

1
2
3
4
5
6
7
8
9
10
# 新建文件夹 traggo 和 子目录
mkdir -p /volume2/docker/traggo/data

# 进入 traggo 目录
cd /volume2/docker/traggo

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中输入 http://群晖IP:3030 就能看到登录界面

用前面设置的账号、密码登录成功后的主界面

系统设置

很可惜,不支持中文,默认是 English,老苏选了 English24h,意思是采用 24 小时计时方式

新建标签

第一步先创建 tags,用不同的颜色做区分

老苏把现在每天主要的事情分为了 抗疫折腾工作休息 四个类别

时间列表

进入 List 菜单,通过 start 新建

新建了一些,其中 Active Timers 是还在进行(正计时)或者还没开始的(倒计时),下面是已经完成了的

Calendar 是另一种查看的视图,本身又支持 DAYWEEK

汇总统计

Manage –> Create Dashboard

从左侧菜单进入刚创建的 Dashboard –> Edit Dashboard –> +,设定时间范围,直接用了默认的

Add Entry,可以选择各种图表,例如:BarChart(条形图)

可以拖拽改变位置和大小

退出编辑状态后,已完成的事件会出现在表中

小技巧

Add Entry 时,最下面的 Tags 可能会点不出来,先随便输入一个字母。比如:a

然后再用退格键删除,tags 就会显示了

也许是因为使用了中文 tags 带来的问题,当然这只是老苏的猜测,并没有去验证。

参考文档

traggo/server: self-hosted tag-based time tracking
地址:https://github.com/traggo/server

traggo
地址:https://traggo.net/

Installation - traggo
地址:https://traggo.net/install/