簡介

什么是 TimeTagger ？

TimeTagger 是一個開源的時間跟蹤工具，旨在幫助用戶記錄和分析他們的時間使用情況。它提供了一個互動的用戶界面和強大的報告功能，適合個人和自由職業者使用。

主要特點

1. 直觀的用戶界面：基于互動時間線設計，用戶可以輕松添加和管理時間標記。
2. 輕量級標簽系統：通過使用標簽而非項目，使得時間跟蹤更加靈活和簡便。
3. 多種報告格式：支持將時間記錄導出為 PDF 和 CSV 格式，便于分析和分享。
4. 目標設定：用戶可以設置每日、每周或每月的時間目標，幫助管理時間使用。
5. 集成的番茄工作法：提供實驗性的番茄工作法功能，促進專注工作。
6. 設備間同步：支持在不同設備之間同步時間記錄，方便隨時隨地訪問。
7. 自托管選項：用戶可以選擇在本地或服務器上運行 TimeTagger，提供靈活性。
8. 易于部署：使用 SQLite 數據庫，便于快速部署和管理。

應用場景

• 個人時間管理：適合個人用戶跟蹤日常活動，提高時間使用效率。
• 自由職業者：自由職業者可以使用 TimeTagger 來記錄工作時間，方便計費和項目管理。
• 團隊協作：可用于團隊項目管理，通過時間記錄分析團隊效率。
• 研究與分析：學者和研究人員可以利用 TimeTagger 進行時間使用分析，優化工作流程。

TimeTagger 是一個功能豐富且易于使用的時間跟蹤工具，適合各種用戶。它的主要特點包括直觀的 UI、靈活的標簽系統和多種報告選項，能夠有效幫助用戶管理和分析時間使用。

準備

要生成登錄憑證，需在瀏覽器中打開 https://timetagger.app/cred

輸入用戶名和密碼，復制第三段代碼

這段代碼會用在環境變量 TIMETAGGER_CREDENTIALS 中

安裝

在群暉上以 Docker 方式安裝。

本文寫作時， latest 版本對應為 v24.12.2；

docker cli 安裝

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

# 新建文件夾 timetagger 和 子目錄
mkdir -p /volume1/docker/timetagger/data# 進入 timetagger 目錄
cd /volume1/docker/timetagger# 運行容器
docker run -d \--restart unless-stopped \--name timetagger \-p 8822:80 \-v $(pwd)/data:/opt/_timetagger \-e TIMETAGGER_BIND=0.0.0.0:80 \-e TIMETAGGER_DATADIR=/opt/_timetagger \-e TIMETAGGER_LOG_LEVEL=info \-e TIMETAGGER_CREDENTIALS=laosu:$$2a$$08$$sHvy4a8ZJVk1VDPMtnOX5.G3TcBbjPcmO8W4ZI1hWptDCze29EhVK \ghcr.io/almarklein/timetagger:latest

環境變量的簡單說明如下

可變	值
TIMETAGGER_BIND	指定應用程序綁定的地址和端口
TIMETAGGER_DATADIR	設置數據目錄的路徑
TIMETAGGER_LOG_LEVEL	設置日志記錄的級別
TIMETAGGER_CREDENTIALS	設置應用程序的訪問憑據。以 用戶名:密碼 的形式提供，用于身份驗證

docker-compose 安裝

也可以用 docker-compose 安裝，將下面的內容保存為 docker-compose.yml 文件

version: "3"services:timetagger:image: ghcr.io/almarklein/timetagger:latestcontainer_name: timetaggerports:- "8822:80"volumes:- ./data:/opt/_timetaggerenvironment:- TIMETAGGER_BIND=0.0.0.0:80- TIMETAGGER_DATADIR=/opt/_timetagger- TIMETAGGER_LOG_LEVEL=info- TIMETAGGER_CREDENTIALS=laosu:$$2a$$08$$sHvy4a8ZJVk1VDPMtnOX5.G3TcBbjPcmO8W4ZI1hWptDCze29EhVK

然后執行下面的命令

# 新建文件夾 timetagger 和 子目錄
mkdir -p /volume1/docker/timetagger/data# 進入 timetagger 目錄
cd /volume1/docker/timetagger# 將 docker-compose.yml 放入當前目錄# 一鍵啟動
docker-compose up -d

運行

在瀏覽器中輸入 http://群暉IP:8822

可以進 Demo 看看

真正使用，要進 App

需要登錄

登錄成功后的主界面

進入設置

可以根據需要進行修改和調整

主界面點 Record 開始跟蹤時間

除了 Web 外，TimeTagger 還提供了命令行和 VS Code 插件，方便標記您的時間。如果不知道怎么用，可以看看 Demo 和官方的說明文檔

參考文檔

almarklein/timetagger: Tag your time, get the insight
地址：https://github.com/almarklein/timetagger

TimeTagger - Tag your time, get the insight
地址：https://timetagger.app/

TimeTagger
地址：https://timetagger.readthedocs.io