skymap-release-splashscreen

name	skymap.release-splashscreen
description	Update the Sky Map splash screen for a new planetary release. Composites a portrait image onto the base splash with a branded strip. Use when asked to "update splash", "add splash for X release", or "create release branding". ARGUMENTS: "<ReleaseName> <path/to/source.png> [crop x1,y1,x2,y2]"

Sky Map Release Splash Screen

Update the splash screen assets for a new Sky Map release.

Arguments

$ARGUMENTS should be: <ReleaseName> <path/to/source.png> [x1,y1,x2,y2]

Examples:

• /release-splash Earth ~/Downloads/earth.png
• /release-splash Mars ~/Downloads/mars.png 200,0,1800,1600
• /release-splash "T CrB" ~/Downloads/tcrb.png 400,100,1600,1300

If no arguments are provided, ask the user for:

1. The release label (e.g. "Earth", "Mars", "T CrB")
2. The path to the source portrait image
3. (Optional) A crop region x1,y1,x2,y2 — suggest skipping if the image is already square and well-centered

Workflow

Step 1 — Inspect the source image

Read the image file to see it visually. Check:

• Dimensions (via python3 -c "from PIL import Image; img = Image.open('PATH'); print(img.size)")
• Whether it is already square and subject is centered
• If not square or subject is off-center, ask the user to confirm a crop region

Step 2 — Copy source image to assets with version stamp

cp <source_path> assets/splashscreens/<version>_<release_name_lowercase>.png

Use the version number and release label lowercased with spaces replaced by underscores as the filename. This ensures different sub-releases of the same name have distinct source images preserved. Examples: "1.16.1_caelus.png", "1.15.5_saturn.png", "t_crb.png" (for single releases)

Step 3 — Generate the main splash, large splash, and circular icon

python3 tools/make_release_splash.py \
    --input assets/splashscreens/<name>.png \
    --label "<ReleaseName>" \
    --output /tmp/splash_main.webp \
    --icon-output /tmp/<name>_icon.png \
    --icon-size 256 \
    [--crop x1,y1,x2,y2]

python3 tools/make_release_splash.py \
    --input assets/splashscreens/<name>.png \
    --label "<ReleaseName>" \
    --output /tmp/splash_large.jpg \
    --splash assets/splashscreens/stardroid_big_image_large.jpg \
    [--crop x1,y1,x2,y2]

Read /tmp/splash_main.webp and /tmp/splash_large.jpg to visually verify they look correct before proceeding. Read /tmp/<name>_icon.png to confirm the circular icon looks good (should be a small round portrait with transparent background).

Step 4 — Deploy to res/ and assets/

cp /tmp/splash_main.webp  app/src/main/res/drawable/stardroid_big_image.webp
cp /tmp/splash_large.jpg  app/src/main/res/drawable-large/stardroid_big_image.jpg
cp /tmp/<name>_icon.png   assets/splashscreens/<version>_<name>_icon.png

Important: The icon filename must include the version to preserve version-specific branding.

Step 5 — Report

Confirm to the user:

• Source saved as: assets/splashscreens/<version>_<name>.png
• Circular icon saved as: assets/splashscreens/<version>_<name>_icon.png
• Main splash updated: app/src/main/res/drawable/stardroid_big_image.webp
• Large splash updated: app/src/main/res/drawable-large/stardroid_big_image.jpg
• Suggest committing: git add assets/splashscreens/<version>_<name>.png assets/splashscreens/<version>_<name>_icon.png app/src/main/res/drawable/stardroid_big_image.webp app/src/main/res/drawable-large/stardroid_big_image.jpg && git commit -m "Add <version>:<ReleaseName> release splash screen branding"

Reference: Base Splash Assets

The script reads from backup originals, not the live res files:

• Main base: assets/splashscreens/stardroid_big_image.webp
• Large base: assets/splashscreens/stardroid_big_image_large.jpg

This means it is safe to re-run without double-overlaying branding.

Reference: Past Releases

Release	Source file	Crop
Venus	assets/splashscreens/venus.png	808,0,2016,1200
Earth	assets/splashscreens/earth.png	none (2048×2048, centered)

Troubleshooting

• Pillow not installed: pip install Pillow
• Text clipped: try a narrower label or reduce --strip-height
• Portrait looks squashed: provide a square --crop centred on the subject
• Portrait too dark/bright: adjust with --opacity (default 1.0)