logo
0
2
WeChat Login

Bark定时提醒工具

一个基于Bark的Python定时提醒脚本,支持一次性提醒和循环提醒(如生日、纪念日等)。

📁 项目结构

bark-reminder/
├── bark_reminder.py              # 核心提醒逻辑
├── bark_reminder_web.py          # Web管理界面
├── bark_reminder_server.py       # 统一启动脚本(Web + 守护进程)
├── bark_reminder_config.json     # 配置文件(需要创建)
├── bark_reminder_config.json.example  # 配置文件示例
├── requirements.txt              # Python依赖
├── Dockerfile                    # Docker镜像构建文件
├── docker-compose.yml           # Docker Compose配置
├── .dockerignore                # Docker构建忽略文件
├── templates/                   # Web界面模板
│   └── index.html              # 前端页面
├── README.md                    # 本文件
├── BARK_REMINDER_README.md      # 详细使用文档
└── DOCKER_README.md             # Docker部署文档

🚀 快速开始

方式1:Docker部署(推荐)

# 进入项目目录
cd bark-reminder

# 创建配置文件
cp bark_reminder_config.json.example bark_reminder_config.json
# 编辑配置文件,填入你的Bark设备密钥

# 启动服务
docker-compose up -d

# 访问Web界面
# http://localhost:5001

方式2:本地运行

# 进入项目目录
cd bark-reminder

# 安装依赖
pip install -r requirements.txt

# 创建配置文件
cp bark_reminder_config.json.example bark_reminder_config.json
# 编辑配置文件,填入你的Bark设备密钥

# 启动服务(同时运行Web界面和守护进程)
python bark_reminder_server.py

# 或分别运行
# Web界面
python bark_reminder_web.py

# 守护进程(另一个终端)
python bark_reminder.py -d

📚 详细文档

✨ 功能特点

  • 一次性提醒:指定日期和时间,提醒一次后自动标记
  • 年度循环提醒:每年固定日期和时间提醒(如生日、纪念日)
  • 每日提醒:每天固定时间提醒(如吃药、运动)
  • 每周提醒:每周固定星期几提醒(如每周二买票)
  • 每月提醒:每月固定日期提醒(如每月15号洗车)
  • Web管理界面:通过浏览器管理提醒事项,无需编辑JSON文件
  • 配置文件管理:所有提醒事项都在JSON配置文件中,方便管理
  • 热重载配置:修改配置文件后自动生效,无需重启服务
  • 守护进程模式:持续监控,自动发送提醒
  • Docker支持:一键部署,单容器运行

📝 配置文件

配置文件 bark_reminder_config.json 包含:

  • Bark配置:服务器地址和设备密钥
  • 提醒列表:所有提醒事项的配置

详细配置说明请参考 BARK_REMINDER_README.md

🔧 管理命令

Docker方式

# 启动
docker-compose up -d

# 停止
docker-compose down

# 查看日志
docker-compose logs -f

# 重启
docker-compose restart

本地方式

# 启动服务
python bark_reminder_server.py

# 只启动Web界面
python bark_reminder_web.py

# 只启动守护进程
python bark_reminder.py -d

# 单次检查
python bark_reminder.py -o

📞 获取帮助

遇到问题?查看详细文档:

📄 许可证

MIT License

About

一个基于Bark的Python定时提醒脚本,支持一次性提醒和循环提醒(如生日、纪念日等)

Language
Python56.4%
HTML41.7%
Dockerfile2%