myoung34/tilty

Tilty

镜像概述和主要用途

Tilty是一个Python模块和CLI工具，旨在捕获Tilt比重计发送的iBeacon数据包，并将数据异步发送到指定后端。它解决了现有随机脚本质量不一致、缺乏测试、不可扩展等问题，提供可插拔的发射器系统，让用户灵活选择数据推送方式，实现比重和温度数据的长期跟踪与图表化。

Tilt比重计通过广播iBeacon数据包发送信息：UUID标识Tilt类型，major字段表示温度（华氏度），minor字段表示比重。Tilty捕获这些数据并发送到后端，相比Tilt原生支持的Google文档方式更轻量，且支持自定义后端。

核心功能和特性

• 数据捕获：实时捕获Tilt比重计发送的iBeacon数据包，提取温度（华氏度）和比重数据
• 可插拔发射器：支持多种后端发送数据：
  • Webhooks：通过HTTP请求发送数据
  • InfluxDB：写入时序数据库，适合长期存储和图表化
  • Datadog（dogstatsd）：发送到Datadog监控系统
• 灵活配置：通过配置文件自定义发送间隔、payload模板、后端连接参数等
• 轻量部署：支持Docker容器化部署，简化环境依赖管理

使用场景和适用范围

• 家庭酿酒/发酵监控：跟踪发酵过程中的液体比重和温度变化
• 实验室环境：监控液体密度和温度的实时数据
• DIY项目：需要获取Tilt比重计数据并集成到自定义监控系统的场景
• 数据记录与分析：将Tilt数据持久化存储，用于趋势分析和报告生成

使用方法和配置说明

生成配置文件

创建config.ini配置文件，包含通用设置和各发射器的详细配置：

ini
[general]
sleep_interval = 1  # 数据捕获间隔（秒）

[webhook]
url = http://www.foo.com  # Webhook目标URL
payload_template = {"color": "{{ color }}", "gravity": {{ gravity }}, "temp": {{ temp }}, "timestamp": "{{ timestamp }}"}  # 发送的JSON payload模板
method = GET  # HTTP请求方法（GET/POST等）

[influxdb]
url = influxdb.corp.com  # InfluxDB服务器地址
port = 80  # InfluxDB端口
database = tilty  # 目标数据库名
gravity_payload_template = {"measurement": "gravity", "tags": {"color": "{{ color }}"}, "fields": {"value": {{ gravity }}}}  # 比重数据写入模板
temperature_payload_template = {"measurement": "temperature", "tags": {"color": "{{ color }}"}, "fields": {"value": {{ temp }}}}  # 温度数据写入模板

[datadog]
host = statsdhost.corp.com  # Datadog agent地址
port = 8125  # Dogstatsd端口（默认8125）
# 注意：需确保Datadog agent配置DD_DOGSTATSD_NON_LOCAL_TRAFFIC=true以允许非本地流量

运行方式

直接运行（本地安装后）

bash
$ tilty

Docker容器运行

1. 将上述配置文件保存到本地./config/config.ini
2. 执行Docker命令：

bash
$ docker run -it \
  -v $(pwd)/config:/etc/tilty \  # 挂载本地配置目录到容器内/etc/tilty
  --net=host \  # 使用主机网络（需要捕获iBeacon广播）
  myoung34/tilty:latest \  # Tilty镜像
  -r --config-file /etc/tilty/config.ini  # 运行参数（-r表示循环捕获，--config-file指定配置文件路径）

安装（本地开发/直接使用）

bash
$ git clone https://github.com/myoung34/tilty  # 克隆仓库
$ pip install -e .  # 以可编辑模式安装

开发环境设置

bash
# 启动Python 3.7 Alpine容器
$ docker run -it -v $(pwd):/src -w /src --entrypoint /bin/sh python:3.7-alpine

# 安装依赖包
$ apk add -U openssl-dev alpine-sdk libffi-dev python3-dev py3-bluez bluez-dev

# 安装Poetry依赖管理工具
$ pip3 install poetry

# 安装项目依赖
$ poetry install

# 运行测试
$ poetry run tox