readme.md

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

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

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

  • Clearly White ⬜️
  • Just Black ⬛️
  • Oh So Orange 🟧

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

  • Clearly White ⬜️
  • Just Black ⬛️
  • Oh So Orange 🟧

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

  • Just Black ⬛️
  • Sorta Sage 🔸

Computers

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

  • Silver ⬜️

• Apple iMac 24" (2021) [4480 x 2520] - 808f7bc509565fb4bdaab7c7b5485a68

  • Blue 🟦
  • Green 🟩
  • Orange 🟧
  • Pink 🟪
  • Purple 🟪
  • Silver ⬜️
  • Yellow 🟨

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

  • Gold 🟨
  • Space Gray ⬛️

• Apple MacBook Air (M1) (2020) [2560 x 1600] - d930de4882bee944ff19da75a4b6ee9f

  • Silver ⬜️

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

  • Silver ⬜️

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

  • Silver ⬜️

• Apple MacBook Pro 16" (2019) [3072 x 1920] - ce29763748dd896d6db09f94c626ca4d

  • Space Gray ⬛️

• Apple MacBook Pro 16" (2021) [3456 x 2234] - 75da9011a54ecd48e3da2c20e2c8afd0

  • Silver ⬜️
  • Space Gray ⬛️

• Google Pixelbook Go (2019) [1920 x 1080] - c6ef98219e013c1dca8480b3dba14caa

  • Just Black ⬛️

• Apple Pro Display XDR (2019) [6016 x 3384] - 148a8f19517b4359cfe9db9092bb85a1

  • Silver ⬜️

• Microsoft Surface Book (2015) [3000 x 2000] - 08816799dd7ebd63a9fe2e5a46f8b69c

  • Platinum ⬜️

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 - 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