Skip to main content

A simple library for creating beautiful screenshots.

Project description

MockupEngineer

A simple library for creating beautiful screenshots.

Navigation

Example

Apple iPhone 12 Pro Max Mockup

Apple iPhone 12 Pro Max Mockup

Notice

The quality of all examples is much worse than real mockups, this is due to the project size limit on PyPI.

Install

$ python3 -m pip install MockupEngineer

Update

$ python3 -m pip install MockupEngineer --upgrade

Usage

As a standalone application:

$ python3 -m MockupEngineer
Usage as a standalone application

In Python console:

from MockupEngineer import MockupEngineerInstance

mockup = MockupEngineerInstance()

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

MockupEngineerInstance.generate parameters:

  • template_id: int — Device template id, 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 (2020) [3200 x 1440] - 8080d01d4bdd37843088986938af2ae0

    • Cloud Blue
    • Cosmic Grey
    • Pink
  • Samsung Galaxy S20 Ultra (2020) [3200 x 1440] - 86fa8df7653bb8559cfc49b8670b16bc

    • Cosmic Black
    • Cosmic Grey
  • Apple iPhone 12 (2020) [2532 x 1170] - 3596ecc24abae25279feddb34dd72a0e

    • Black
    • Blue
    • Green
    • Product Red
    • White
  • Apple iPhone 12 Mini (2020) [2340 x 1080] - 692048fda2b0b645f705066d522c12b8

    • Black
    • Blue
    • Green
    • Product Red
    • White
  • Apple iPhone 12 Pro (2020) [2532 x 1170] - 753cf086117da37d8c2e44e974880a94

    • Gold
    • Graphite
    • Pacific Blue
    • Silver
  • Apple iPhone 12 Pro Max (2020) [2778 x 1284] - 5509eab3ac4c47315753b2e50faeb633

    • Gold
    • Graphite
    • Pacific Blue
    • Silver
  • Apple iPhone 13 (2021) [2532 x 1170] - 33f683bda9f3beb5d0ce8ae5ef9e7fc4

    • Blue
    • Midnight
    • Pink
    • Product Red
    • Starlight
  • Apple iPhone 13 Mini (2021) [2340 x 1080] - 09340db4628d41418a4ed472db07c60e

    • Blue
    • Midnight
    • Pink
    • Product Red
    • Starlight
  • Apple iPhone 13 Pro (2021) [2532 x 1170] - f0247d613f7d390cfb3362fd7242e515

    • Gold
    • Graphite
    • Sierra Blue
    • Silver
  • Apple iPhone 13 Pro Max (2021) [2778 x 1284] - d95345535d98fcc6f4030e1d3ca62052

    • Gold
    • Graphite
    • Sierra Blue
    • Silver
  • Apple iPhone SE (2020) [1334 x 750] - 553673b4367e8ebf59067d764b45e9fd

    • Black
    • Product Red
    • White
  • Apple iPhone Xr (2018) [1792 x 828] - 6ccede90e5879fd87f85cfb2039247b3

    • Blue
    • Coral
    • Product Red
    • Silver
    • Space Gray
    • Yellow
  • Apple iPhone Xs (2019) [2436 x 1125] - f4128697b9cb1963cc4d14727872fa44

    • Gold
    • Silver
    • Space Gray
  • Apple iPhone Xs Max (2019) [2688 x 1242] - 16ebf01c894fb468c05a1b7c3e395d47

    • Gold
    • Silver
    • Space Gray
  • Google Pixel (2016) [1920 x 1080] - c7076ff96733f11e2cd8179fc2d5e7a4

    • Quite Black
    • Really Blue
    • Very Silver
  • Google Pixel 4 (2019) [2280 x 1080] - 3bfff2be23c2c354403f5a622a804f64

    • Just Black
    • Clearly White
    • Oh So Orange
  • Google Pixel 4 XL (2019) [3040 x 1440] - 7b0762b034f6c29f2c77a66bb388f59e

    • Just Black
    • Clearly White
    • Oh So Orange
  • Google Pixel 5 (2020) [2340 x 1080] - 2707894cc5d336d0ba276e6306e9f001

    • Just Black
    • Sorta Sage

Computers

Tablets

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

    • Gold
    • Silver
    • Space Gray
  • Apple iPad Air 4 (2020) [2360 x 1640] - 9a644764f99ccbe46753de8516e053fe

    • Green
    • Rose Gold
    • Silver
    • Sky Blue
    • Space Gray
  • Apple iPad Mini 5 (2021) [2048 x 1536] - d8e92692708b63e444300f3b6dfacc6f

    • Gold
    • Silver
    • Space Gray
  • Apple iPad Pro 4 11" (2020) [2388 x 1668] - a80a78a3f7492bb5d460c59de173bc88

    • Silver
    • Space Gray
  • Apple iPad Pro 4 12.9" (2020) [2732 x 2048] - 198018d62640d23de5ae4e3e6cbc5fd0

    • Silver
    • Space Gray
  • Microsoft Surface Pro 3 (2014) [2160 x 1440] - d250f0d3f84dd0b972c152ee592fbc3a

    • Platinum
  • Microsoft Surface Pro 4 (2015) [2736 x 1824] - 604015046fcf51f1a264bb0333269f80

    • Platinum

Wearable devices

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

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

Links

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

MockupEngineer-2022.3.23.1.tar.gz (48.7 MB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page