RunStats

Render transparent run-stat overlays from local .fit and .gpx activity files.

Install

python -m pip install -e .

Usage

Default interactive flow:

python plot_gpx.py

Console entrypoint:

runstats --auto

Machine-facing automation entrypoint:

runstats-automation --input C:\RunStatsAutomation\processing\22321337482_ACTIVITY.fit

Direct Telegram bot runner:

runstats-telegram-bot --chat-id 535004713 --workspace C:\RunStatsAutomation

Direct Telegram bot runner with immediate FIT processing:

runstats-telegram-bot --chat-id 535004713 --workspace C:\RunStatsAutomation --template glass_slab --auto-process-uploads

Render the Instagram Story overlay directly:

python plot_gpx.py --input 21760678383_ACTIVITY.fit --template story_overlay --output story_overlay.png

Render the alternate card layout:

python plot_gpx.py --input activity.gpx --template clean_card --output clean_card.png

Render the Stitch-inspired Instagram Story layout:

python plot_gpx.py --input 21654870128_ACTIVITY.fit --template neon_data_story --output neon_data_story.png

If timing data is missing and you still want the route art:

python plot_gpx.py --input activity.gpx --route-only --output route_only.png

Templates

• story_overlay: transparent 1080x1920 Instagram Story-style overlay
• clean_card: alternate square card layout
• neon_data_story: Stitch-inspired 1080x1920 Instagram Story overlay

Useful flags

• --mode solid|gradient|auto
• --title "MORNING RUN"
• --no-title
• --auto
• --search-dir .

Telegram Automation

For the direct bot workflow without n8n, use:

• docs/telegram_bot_runner.md

For the earlier n8n-based approach, keep using:

• docs/telegram_ingest_automation.md
• n8n/telegram_ingest_workflow.example.json