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

    • 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

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