MockupEngineer

A simple library for creating beautiful screenshots.

Navigation

• Example
• Install
  • Update
• Usage
  • As a standalone application
  • In Python console
  • MockupEngineerInstance.generate parameters
• List of supported mockups
  • Phones
  • Tablets
  • Computers
  • Wearable devices
• Links

Example

Apple iPhone 12 Pro Max Mockup

Install

$ python3 -m pip install MockupEngineer

Update

$ python3 -m pip install MockupEngineer --upgrade

Usage

As a standalone application:

$ python3 -m MockupEngineer

In Python console:

from MockupEngineer import MockupEngineerInstance

mockup = MockupEngineerInstance()

mockup.generate(template=mockup.templates[0],
                screenshot_path='/path/to/screenshot',
                color=mockup.templates[0].colors[0].color)

>>> /path/to/mockup

MockupEngineerInstance.generate parameters:

• template: Template — Device template model, must be passed from MockupEngineerInstance.templates or MockupEngineerInstance.get_templates().
• screenshot_path: str — Absolute path to the image in JPG, PNG format.
• color: Optional[str] — Optional parameter, force device color. Must be passed according to Template.colors[n].color
• orientation: str — Optional parameter, force device orientation. Must be landscape or portrait.
• external_storage: Optional[bool] — Optional parameter, true if you need to upload mockup on TemporaryStorage (0x0.st etc)

List of supported mockups

Full list of all currently supported mockups

Phones

• Samsung Galaxy S20 [1440 x 3200] (2020)

  • Cloud Blue
  • Cosmic Grey
  • Pink

• Samsung Galaxy S20 Ultra [1440 x 3200] (2020)

  • Cosmic Black
  • Cosmic Grey

• Apple iPhone 12 [1170 x 2532] (2020)

  • Black
  • Blue
  • Green
  • PRODUCT RED
  • White

• Apple iPhone 12 Mini [1080 x 2340] (2020)

  • Black
  • Blue
  • Green
  • PRODUCT RED
  • White

• Apple iPhone 12 Pro [1170 x 2532] (2020)

  • Gold
  • Graphite
  • Pacific Blue
  • Silver

• Apple iPhone 12 Pro Max [1284 x 2778] (2020)

  • Gold
  • Graphite
  • Pacific Blue
  • Silver

• Apple iPhone SE [750 x 1334] (2020)

  • Black
  • PRODUCT RED
  • White

• Apple iPhone Xr [828 x 1792] (2018)

  • Blue
  • Coral
  • PRODUCT RED
  • Silver
  • Space Gray
  • Yellow

• Google Pixel [1080 x 1920] (2016)

  • Quite Black
  • Really Blue
  • Very Silver

• Google Pixel 4 [1080 x 2280] (2019)

  • Clearly White
  • Just Black
  • Oh So Orange

• Google Pixel 4 XL [1440 x 3040] (2019)

  • Clearly White
  • Just Black
  • Oh So Orange

• Google Pixel 5 [1080 x 2340] (2020)

  • Just Black
  • Sorta Sage

Computers

• Apple iMac 21" [4096 x 2304] (2015)

  • Silver

• Apple MacBook 12" [2304 x 1440] (2016)

  • Gold
  • Space Gray

• Apple MacBook Pro 13" [2560 x 1600] (2015)

  • Silver

• Apple MacBook Pro 15" [2880 x 1800] (2015)

  • Silver

Tablets

• Apple iPad 9 [2160 x 1620] (2021)

  • Gold
  • Silver
  • Space Gray

• Apple iPad Air 4 [2360 x 1640] (2020)

  • Green
  • Rose Gold
  • Silver
  • Sky Blue
  • Space Gray

• Apple iPad Mini 5 [2048 x 1536] (2021)

  • Gold
  • Silver
  • Space Gray

• Apple iPad Pro 4 11" [2388 x 1668] (2020)

  • Silver
  • Space Gray

• Apple iPad Pro 4 12.9" [2732 x 2048] (2020)

  • Silver
  • Space Gray

Wearable devices

• Apple Watch Series 6 44mm [368 x 448] (2020)
  • Aluminum Case - Blue
  • Aluminum Case - Gold
  • Aluminum Case - PRODUCT RED
  • Aluminum Case - Silver
  • Aluminum Case - Space Gray
  • Stainless Steel Case - Gold
  • Stainless Steel Case - Graphite
  • Stainless Steel Case - Silver
  • Titanium Case - Dark
  • Titanium Case - Light

You can help the project by adding support for new mockups by contributing on GitHub.

Links