Skip to content

Repository files navigation

SalaryTick icon

SalaryTick

A tiny Windows widget that shows how much you have earned today, in real time.

一个实时显示“今天已经赚了多少钱”的轻量 Windows 桌面挂件。

Windows Python License

SalaryTick preview

SalaryTick 根据月薪、每月计薪工作日和上下班时间,按秒计算当天已经获得的薪资。它常驻桌面、支持窗口置顶,并将所有配置保存在本机。

Features

  • 按秒更新今日已赚金额
  • 自动计算日薪和工作进度
  • 上班前归零、下班后封顶为完整日薪
  • 支持跨午夜班次
  • 圆角悬浮窗、金色流光与星点动画
  • 主页面保持简洁,薪资参数集中在独立设置页
  • 支持拖动、置顶和自动保存窗口位置
  • 单文件 Windows EXE,无需安装 Python
  • 不联网、不上传薪资数据

Download

GitHub Releases 下载最新的 SalaryTick.exe,双击即可运行。

当前支持 Windows 10/11 x64。由于开源构建未进行商业代码签名,Windows 首次运行时可能显示 SmartScreen 提示。

Run From Source

需要 Python 3.10 或更高版本。项目只使用 Python 标准库,无运行时第三方依赖。

python app.py

也可以双击 run.bat,使用无控制台窗口模式启动。

Build

安装开发依赖:

python -m pip install -r requirements-dev.txt

生成单文件 Windows 程序:

python -m PyInstaller --noconfirm --clean --onefile --windowed --icon assets/salarytick.ico --add-data "assets/salarytick.ico:assets" --name SalaryTick app.py

构建结果位于 dist/SalaryTick.exe。推送 v* 格式的 Git 标签时,GitHub Actions 也会自动构建并创建 Release。

Calculation

日薪 = 月薪 / 每月计薪工作日
今日已赚 = 日薪 × 当前工作进度
  • 上班前:工作进度为 0%
  • 上班期间:按照已经过去的秒数均匀累计
  • 下班后:工作进度为 100%,金额不再增加
  • 下班时间早于或等于上班时间:按照跨午夜班次计算

当前版本默认整段工作时间均为计薪时间,暂未单独扣除午休或其他休息时间。

Configuration

设置会自动保存在:

%APPDATA%\SalaryTick\settings.json

删除该文件即可恢复默认配置。旧版 %APPDATA%\SalaryNow%APPDATA%\SalaryWidget 配置会自动迁移,SalaryTick 不会读取、收集或上传其他个人数据。

Project Structure

SalaryTick/
├── app.py                    # Application and calculation logic
├── assets/                   # App icon and README images
├── tests/                    # Calculation tests
├── .github/workflows/        # CI and release automation
├── run.bat                   # Windows source launcher
└── requirements-dev.txt      # Packaging dependency

Contributing

欢迎提交 Bug、功能建议和 Pull Request。开始贡献前请阅读 CONTRIBUTING.md,安全问题请参考 SECURITY.md

License

SalaryTick 使用 MIT License 开源。

About

A lightweight Windows widget that tracks today's salary earnings in real time.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages