Add label_date option, separator line, and improved label spacing

Add label_date boolean to group config for appending UTC timestamp.
Draw black separator line between screenshot and label banner.
Increase padding and line spacing in label for better readability.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: Kut Akdogan

shots/config.py

@@ -28,6 +28,7 @@ class ShotGroup:
     shots: list[ShotSpec]
     output: str = "png"  # "png" or "pdf"
     label: str | None = None  # template string applied to all shots
+    label_date: bool = False  # add date/time line below the label
     folder: str | None = None  # override subfolder name (defaults to id)
 
 
@@ -129,6 +130,7 @@ def load_config(path: str) -> RunConfig:
                 shots=shots,
                 output=output,
                 label=str(g["label"]).strip() if g.get("label") else None,
+                label_date=bool(g.get("label_date", False)),
                 folder=str(g["folder"]).strip() if g.get("folder") else None,
             ))
 

shots/image_ops.py

@@ -86,26 +86,40 @@ def _get_font(size: int) -> ImageFont.FreeTypeFont | ImageFont.ImageFont:
 
 def add_label_banner(png_bytes: bytes, label_text: str, font_size: int = 32) -> bytes:
     """
-    Add a white banner with black text below the image. Additive — does not
-    crop into the screenshot, just extends the canvas downward.
+    Add a white banner with black text below the image, separated by a black
+    line. Additive — does not crop into the screenshot, just extends the canvas
+    downward. Supports multiline text (e.g. label + date on separate lines).
     """
     im = Image.open(BytesIO(png_bytes)).convert("RGBA")
     w, h = im.size
 
     font = _get_font(font_size)
-    padding = font_size // 2
-    banner_h = font_size + 2 * padding
+    line_thickness = 2
+    padding = font_size  # gap above and below text block
+    line_spacing = font_size // 2  # extra gap between lines
 
-    # New canvas: original + banner
+    # Measure multiline text height
+    tmp_draw = ImageDraw.Draw(im)
+    text_bbox = tmp_draw.multiline_textbbox((0, 0), label_text, font=font, spacing=line_spacing)
+    text_block_h = text_bbox[3] - text_bbox[1]
+
+    banner_h = line_thickness + 2 * padding + text_block_h
+
+    # New canvas: original + separator + banner
     out = Image.new("RGBA", (w, h + banner_h), (255, 255, 255, 255))
     out.paste(im, (0, 0))
 
     draw = ImageDraw.Draw(out)
-    bbox = draw.textbbox((0, 0), label_text, font=font)
-    text_w = bbox[2] - bbox[0]
+
+    # Black separator line
+    draw.rectangle([(0, h), (w, h + line_thickness)], fill=(0, 0, 0, 255))
+
+    # Centered multiline text
+    text_bbox = draw.multiline_textbbox((0, 0), label_text, font=font, spacing=line_spacing)
+    text_w = text_bbox[2] - text_bbox[0]
     text_x = (w - text_w) // 2
-    text_y = h + padding
-    draw.text((text_x, text_y), label_text, fill=(0, 0, 0, 255), font=font)
+    text_y = h + line_thickness + padding
+    draw.multiline_text((text_x, text_y), label_text, fill=(0, 0, 0, 255), font=font, align="center", spacing=line_spacing)
 
     buf = BytesIO()
     out.save(buf, format="PNG")

shots/runner.py

@@ -470,8 +470,11 @@ def run_config(
                             "id": shot.id,
                             "title": shot.description.strip()[:80],
                         })
+                        if group.label_date:
+                            from datetime import datetime, timezone
+                            label_text += "\n" + datetime.now(timezone.utc).strftime("%Y-%m-%d %H:%M UTC")
                         out_bytes = add_label_banner(out_bytes, label_text)
-                        log.info("added label: %s", label_text)
+                        log.info("added label: %s", label_text.replace("\n", " | "))
 
                     # Save individual shot PNG
                     shot_png_path = group_dir / f"{safe_filename(shot.id)}.png"