tsticker 是用于管理 Telegram 贴纸包的命令行工具,适合需要批量创建、更新或备份贴纸包的用户。
主要能力:支持初始化新贴纸包、将本地贴纸推送到云端、从云端同步覆盖本地、下载任意贴纸包(只读)、导入自己机器人创建的贴纸包(可编辑),以及查看本地贴纸包信息。
使用方式:先通过 pipx 安装 tsticker,并准备 ffmpeg 与 ImageMagick 用于动图转换,以及 Telegram Bot Token 和所有者用户 ID。使用 tsticker login -t <BOT_TOKEN> -u <USER_ID> 登录,凭据存入系统钥匙串。常用命令包括 tsticker init -s regular -n 'pack_name' -t 'Pack Title' 创建贴纸包、tsticker push 推送、tsticker sync 同步、tsticker download -l <sticker_link> 下载、tsticker trace -l <sticker_link> 导入、tsticker show 查看信息。贴纸包目录包含 index.json 元数据和 stickers 文件夹,文件名中的 emoji 前缀可指定贴纸表情,无前缀则自动识别,gif 等格式会自动转换为 webm。
限制:操作有速率限制,约每张贴纸 2 秒;不建议一次推送过多贴纸,出错可用 tsticker sync 恢复;机器人只能管理自己创建的贴纸包,丢失机器人后只能手动管理。支持 regular、mask、custom_emoji 类型,以及 png、jpg、gif、webm、mov 格式。