Screenshot Tool

ssgen is a Go command line tool for generating simple App Store screenshots. Each project lives under the top-level Projects directory with its own input and output folders.

Build

go build -o ssgen .

Create a Project

go run . init MyApp

With the compiled binary:

./ssgen init MyApp

This creates:

Projects/
  MyApp/
    input/
      welcome/
        config.yaml
        screen.png
    output/

Generate Screenshots

go run . MyApp

or:

go run . generate MyApp

With the compiled binary:

./ssgen MyApp

Every directory inside Projects/MyApp/input becomes one PNG in Projects/MyApp/output. For example, Projects/MyApp/input/onboarding writes Projects/MyApp/output/onboarding.png.

Config

Each input screenshot directory needs one YAML file and one PNG/JPEG image. If there are multiple images, set image.file.

canvas:
  width: 1290
  height: 2796
  background: "#F8FAFC"

layout:
  padding_x: 96
  top_padding: 210
  text_gap: 30
  image_gap: 100
  bottom_padding: 120

text:
  primary: "Everything important, at a glance"
  secondary: "Clean summaries for each screen in your app."
  primary_color: "#111827"
  secondary_color: "#4B5563"
  primary_size: 82
  secondary_size: 44
  align: center
  # Optional TTF/OTF path. If omitted, the tool uses Apple's San Francisco
  # font on macOS, with a bold headline and regular subheadline.
  font: ""

image:
  file: screen.png
  # full or top_3_4
  mode: full
  max_width: 1010
  max_height: 0
  corner_radius: 58
  border_width: 0
  border_color: "#00000000"
  shadow: true
  shadow_color: "#00000024"
  shadow_blur: 28
  shadow_offset_y: 20

image.mode: full fits the whole screenshot. image.mode: top_3_4 crops to the top three quarters of the source image and scales that crop into the final composition.