GitHunt
FA

FallingMY/pyObsCountDown

基于 Python 的 OBS 计时脚本。通过生成并实时修改 OUTPUT.txt 文本文件,使 OBS 可以读取并显示计时内容。

pyObsCountDown

基于 Python 的 OBS 计时脚本。通过生成并实时修改 OUTPUT.txt 文本文件,使 OBS 可以读取并显示计时内容。

安装

pip install -r requirements.txt

使用方法

交互模式 (TUI)

直接运行脚本,按提示输入参数:

python main.py

命令行模式 (CLI)

python main.py -m <mode> -t <time> [-d <date>] [-f <format>]

参数说明:

参数 说明 必填
-m, --mode 计时模式 (0/1/2)
-t, --time 时间值
-d, --date 日期 (仅模式0)
-f, --format 显示格式 (0/1/2),默认0

计时模式

模式 说明
0 倒计时到指定时间点
1 倒计时指定时长
2 正计时(从启动开始)

时间格式

  • ss - 秒数
  • mm:ss - 分:秒
  • hh:mm:ss - 时:分:秒

日期格式

  • 留空 - 当天
  • mm/dd - 月/日(当年)
  • yyyy/mm/dd - 年/月/日

显示格式

格式 示例 说明
0 4:03 最短格式
1 04:03 保留前导零
2 00:04:03 完整格式

运行时按键

按键 功能
r 重新开始(需确认 y/n)
p 暂停/继续(模式0无效)
q 退出(需确认 y/n)

示例

# 倒计时 5 分钟
python main.py -m 1 -t 5:00

# 倒计时到今天 14:30:00
python main.py -m 0 -t 14:30:00

# 正计时,完整格式显示
python main.py -m 2 -t 0 -f 2

# 倒计时到 2026/3/1 12:00:00
python main.py -m 0 -t 12:00:00 -d 2026/3/1

OBS 配置

  1. 添加「文本 (GDI+)」来源
  2. 勾选「从文件读取」
  3. 选择 OUTPUT.txt 文件

Languages

Python100.0%

Contributors

Created February 27, 2026
Updated March 1, 2026
FallingMY/pyObsCountDown | GitHunt