Skip to main content

storeframe

Frame raw app captures for the App Store and Google Play: a gradient background, the capture inside a drawn device body (no mockup PNGs), a fitted two-line headline, and optional decorations that run across the whole gallery.

Working name. frameapp is already taken on PyPI; renaming is one search-and-replace of storeframe.

Install

pip install storeframe            # once published
pip install -e '.[dev]'           # from this checkout

Use

# frame a fastlane-style tree: captures/<locale>/*.png -> framed/<locale>/*.png
storeframe frame design.json --platform android --captured fastlane/screenshots --out fastlane/framed
storeframe frame design.json --platform ios     --captured fastlane/screenshots --out fastlane/framed --locale en-US

# Play's 1024x500 feature graphic, from the first screen's phone capture
storeframe frame design.json --platform android --captured ... --out ... --feature-graphic

# one picture
storeframe one design.json capture.png out.png --screen 01-path --platform ios

storeframe devices                # list devices, platforms, styles
from PIL import Image
import storeframe

design = storeframe.Design.load("design.json")
picture = storeframe.screenshot(Image.open("phone-01-path.png"), design, "01-path",
                                kind="phone", device="pixel-pro", canvas_size=(1440, 2560))

Platforms and devices

Platform Kind Device Output canvas
android phone pixel-pro 1440×2560 (Play refuses > 2:1)
android tablet pixel-tablet 1600×2560
ios iphone iphone-pro-max capture size (App Store wants the device size)
ios ipad ipad-pro-13 capture size

A capture named <kind>-<screen>.png says its kind; otherwise (fastlane snapshot names like iPhone 17 Pro Max-01-path.png) the kind is picked by aspect ratio. The screen is the design screen whose name (or alias) the file name ends with.

Device geometry is expressed as fractions of the screen width, so a device looks the same however large it is drawn.

Styles

  • plain – centred device, headline above.
  • arc – a dashed parabola spanning the whole gallery, sun in the first picture, moon in the last.
  • tabs – device off-centre, coloured tabs running off the left edge, a dashed line that crosses every picture (each one picks it up where the previous one left it) and a second line hanging off the tabs.

The design file

{
  "style": "arc",
  "font": "Nunito[wght].ttf",
  "backgrounds": { "evening": ["#f2a65a", "#c9655b"] },
  "chips": { "odt": "#4bb3e8" },
  "screens": [
    {
      "name": "01-path",
      "background": "evening",
      "headline": { "en-US": ["See when the sun", "is where."] },
      "chips": [],
      "aliases": ["01-path-lite"]
    }
  ],
  "layouts": { "phone": { "screen_top": 0.22 } },
  "params":  { "phone": { "arc_peak": 0.15 } },
  "options": { "moon": false }
}
  • font is optional and relative to the design file; the bundled Nunito (SIL OFL) is the default. Hindi, Japanese and Chinese headlines use a system font (Noto on Linux, the system fonts on macOS).
  • headline falls back from de-AT to de/de-DE, then to fallback_locale (en-US).
  • layouts / params override a style's numbers per device kind (phone, tablet, iphone, ipad, feature). See src/storeframe/layout.py and the style modules for what each number means.
  • Existing frames.json files from OpenDocument.ios/.droid and almucantar load unchanged ("arc": true → arc, a chips palette → tabs). The OpenDocument "lite" capture needs "aliases": ["04-edit-lite"] on its screen.

Development

uv venv && uv pip install -e '.[dev]'
.venv/bin/pytest

License

MIT. The bundled Nunito font is under the SIL Open Font License 1.1 (src/storeframe/fonts/OFL.txt).

Metadata

Release files for storeframe 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for storeframe 0.1.0
File Size Uploaded Provenance Actions
storeframe-0.1.0.tar.gz 155.1 kB With provenance Details for storeframe-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for storeframe 0.1.0
File Interpreter ABI Platform Actions
storeframe-0.1.0-py3-none-any.whl Python 3 none any Details for storeframe-0.1.0-py3-none-any.whl

Total release size: 316.6 kB

Release files / storeframe-0.1.0.tar.gz

Download URL storeframe-0.1.0.tar.gz
Size 155.1 kB
Tags Source
SHA-256 checksum
How to use checksums
4fa2c1361589ca8924c14bec32b59add0ed0334ad89d0a67481874379817335f
BLAKE2b-256 checksum
How to use checksums
b60d1041b48b33847e38cf30b912cd155104a04fe622641688d1da1ff7d23982
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

Release files / storeframe-0.1.0-py3-none-any.whl

Download URL storeframe-0.1.0-py3-none-any.whl
Size 161.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
75d19f580fa271e1e7b23f186718c42414493523fa7a8db0cc81f677d99a8821
BLAKE2b-256 checksum
How to use checksums
0284d12907150172b6e34dfd76a1f8ff6fceafa5a23c0819805856696913841e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

Security for storeframe 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for storeframe-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page