WinterGram/.wintergram/icons

WinterGram dynamic badges

Profile badges are data-driven from this folder. The app fetches manifest.json (and the referenced assets) from GitHub on a timer and recomposes badges without an app update. Offline / before the first fetch, a bundled fallback manifest is used.

Files

• manifest.json - the live manifest (see manifest.schema.json for the full schema).
• manifest.schema.json - JSON Schema (draft-07). Editors that honour the $schema key in manifest.json will autocomplete and validate as you type.
• <badge>/... — layer assets (.png/.jpg rasters, or .tgs/.json Lottie).

A badge in one glance

A badge is a stack of layers on a canvas (default 1024) coordinate space:

{
  "name": "backplate",
  "source": "developer/backplate.png",
  "x": 0, "y": 0, "width": 1024, "height": 1024,
  "tint": "theme",
  "animation": { "type": "rotate", "duration": 8.0, "direction": "cw", "loop": true }
}

• source — path under .wintergram/icons/. .png/.jpg → raster layer; .tgs/.json → native Lottie layer (then animation is ignored; the Lottie plays itself).
• tint — "theme" (theme accent), "#RRGGBB" (fixed), or "none" (original colours).
• animation.type — none | rotate | blink | pulse | bounce | shake | lottie.
• peers — raw int64 ids; for channels use the part after the -100 prefix (e.g. -1003999337820 → 3999337820). Highest priority wins on overlap.

Validate / preview before pushing

# validate structure, tints, animations, asset existence
scripts/wintergram-badge-tool.py .wintergram/icons/manifest.json

# also render an animated GIF per badge (needs: pip install Pillow)
scripts/wintergram-badge-tool.py .wintergram/icons/manifest.json --preview

Useful flags: --badge <id>, --size 256, --fps 30, --bg "#1C1C1E", --accent "#3478F6" (colour used for tint: "theme" in the preview), --out DIR.

Bump version on every change so clients pick up the update.