# Timespent

**Repository Path**: Czile/timespent

## Basic Information

- **Project Name**: Timespent
- **Description**: 一个在Linux平台上的时间使用统计小工具，使用该应用可以：
1. 统计今天以来、一周以来的电脑使用时间。
2. 统计今天以来、一周以来每个应用的使用时间。
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2021-05-09
- **Last Updated**: 2025-12-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 时间使用统计
一个在Linux平台上的时间使用统计小工具，使用该应用可以：
1. 统计今天以来、一周以来的电脑使用时间。
2. 统计今天以来、一周以来每个应用的使用时间。

[English-version](README_en.md)

## 使用预览
![new-version](picture/3.png)

## 特性
- [x] 使用条形图来显示s使用时间

- [x] 参数 `-h` 显示帮助信息

- [x] 参数 `-i`, `--in` 表示指定天数以来的应用使用情况

- [x] 参数 `-d`, `--day` 表示指定日期的应用使用情况

- [x] 参数 `-f`, `--from` 表示指定日期以来的应用使用情况

- [x] 参数 `-g` 表示今日所有应用的使用情况而不是只显示前五个

- [x] 参数 `-p`, `--program` 表示某一应用的使用情况

- [ ] 可设置应用使用时长控制与使用时间目标

- [ ] 使用时间段分析（这意味着可能与旧版本冲突）

- [ ] 完善的错误处理机制

- [ ] 将整个程序打包成gnome插件

## 用法
1. 将 `dist/getWindows` 设置为开机自动启动程序
2. 将 `dist/display` 放入主目录
3. `Ctrl + Shift + T` 打开终端
4. 输入 `./display` 查看应用使用时间

## 开发注释
`dist` 文件夹下，存有 `getWindows`, `display` 两个可执行文件，其中：第一个可执行文件是用来监听焦点窗口的名称的，该文件将每十秒钟监听以此焦点窗口的名称，并将信息写入 `~/.timespent/{}.csv` 以及 `~/.timespent/log.txt`。其中，`{}` 中的内容为某一天的时间戳。这个应用程序是用pyinstaller生成的，源代码为 `src/getWindows.py`。

而第二个程序是用来显示统计信息的，在命令行输入` ./display` 即可显示统计信息。该可执行文件将读取前述的 `~/.timespent/` 的文件，并提取信息显示。源代码为 `src/display.py`


## 许可证
GPL3.0