tsticker — Telegram Sticker Pack Manager

Prerequisites

• tsticker installed via pipx install tsticker --python python3.13 --pip-args="--ignore-requires-python"
• ffmpeg and ImageMagick installed (for animated sticker conversion)
• Telegram Bot Token (from @BotFather) + owner user ID

Auth

tsticker login -t <BOT_TOKEN> -u <USER_ID>

Credentials stored via system keyring.

Commands

Command	Description
tsticker init -s regular -n 'pack_name' -t 'Pack Title'	Create new sticker pack
tsticker push	Push local stickers → overwrite cloud pack
tsticker sync	Pull cloud pack → overwrite local files
tsticker download -l <sticker_link>	Download any pack (read-only)
tsticker trace -l <sticker_link>	Import pack (editable, must be your bot's pack)
tsticker show	Show local pack info

Sticker Pack Directory Structure

<pack_dir>/
├── index.json          # Pack metadata (only `title` is editable)
└── stickers/           # Put images here
    ├── 😄hello.png     # Emoji in filename = explicit emoji
    ├── coffee.png       # No emoji = auto-detected
    └── animation.gif    # Auto-converted to webm

Workflow: Generate → Publish

1. Create pack (first time only)

cd ~/Pictures/lynn-stickers
tsticker init -s regular -n 'lynn_stickers_by_<bot_name>' -t 'Lynn Stickers'

2. Generate stickers (create-sticker skill)

python3 /path/to/skills/skills/create-sticker/scripts/create_sticker.py "drinking bubble tea happily"

3. Copy approved stickers into pack

cp ~/stickers/drinking_bubble_tea.png ~/Pictures/lynn-stickers/stickers/🧋drinking_tea.png

Emoji prefix in filename sets the sticker's emoji. Without prefix, tsticker auto-selects.

4. Push to Telegram

cd ~/Pictures/lynn-stickers
tsticker push

⚠️ push overwrites the entire cloud pack with local files. Always sync first if cloud has changes you want to keep.

Notes

• Rate limited: ~2s per sticker operation
• Don't push too many stickers at once — errors break the flow, recover with tsticker sync
• Sticker types: regular (static/animated), mask, custom_emoji
• Supported formats: png, jpg, gif, webm, mov (auto-converted)
• Bot can only manage packs it created — losing the bot means manual management only