MockupEngineer

A simple library for creating beautiful screenshots.

## Navigation * [Example](https://github.com/ulbwazhine/MockupEngineer#example) * [Install](https://github.com/ulbwazhine/MockupEngineer#install) * [Update](https://github.com/ulbwazhine/MockupEngineer#update) * [Usage](https://github.com/ulbwazhine/MockupEngineer#usage) * [As a standalone application](https://github.com/ulbwazhine/MockupEngineer#as-a-standalone-application) * [In Python console](https://github.com/ulbwazhine/MockupEngineer#in-python-console) * [MockupEngineerInstance.generate parameters](https://github.com/ulbwazhine/MockupEngineer#mockupengineerinstancegenerate-parameters) * [List of supported mockups](https://github.com/ulbwazhine/MockupEngineer#list-of-supported-mockups) * [Phones](https://github.com/ulbwazhine/MockupEngineer#phones) * [Tablets](https://github.com/ulbwazhine/MockupEngineer#tablets) * [Computers](https://github.com/ulbwazhine/MockupEngineer#computers) * [Wearable devices](https://github.com/ulbwazhine/MockupEngineer#wearable-devices) * [Links](https://github.com/ulbwazhine/MockupEngineer#links) ## Example
Apple iPhone 12 Pro Max Mockup

Apple iPhone 12 Pro Max Mockup

## Install ```console $ python3 -m pip install MockupEngineer ``` ### Update ```console $ python3 -m pip install MockupEngineer --upgrade ``` ## Usage #### As a standalone application: ```console $ python3 -m MockupEngineer ```
#### In Python console: ```python from MockupEngineer import MockupEngineerInstance mockup = MockupEngineerInstance() mockup.generate(template=mockup.templates[0], screenshot_path='/path/to/screenshot', color=mockup.templates[0].colors[0].color) ``` ```console >>> /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](https://github.com/ulbwazhine/TemporaryStorage) (0x0.st etc) ## List of supported mockups Full list of all currently supported mockups ### Phones * [Samsung Galaxy S20](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/galaxys20/example.png) [1440 x 3200] (2020) * Cloud Blue * Cosmic Grey * Pink * [Samsung Galaxy S20 Ultra](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/galaxys20/example.png) [1440 x 3200] (2020) * Cosmic Black * Cosmic Grey * [Apple iPhone 12](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/iphone12/example.png) [1170 x 2532] (2020) * Black * Blue * Green * PRODUCT RED * White * [Apple iPhone 12 Mini](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/iphone12mini/example.png) [1080 x 2340] (2020) * Black * Blue * Green * PRODUCT RED * White * [Apple iPhone 12 Pro](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/iphone12pro/example.png) [1170 x 2532] (2020) * Gold * Graphite * Pacific Blue * Silver * [Apple iPhone 12 Pro Max](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/iphone12promax/example.png) [1284 x 2778] (2020) * Gold * Graphite * Pacific Blue * Silver * [Apple iPhone SE](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/iphonese2020/example.png) [750 x 1334] (2020) * Black * PRODUCT RED * White * [Apple iPhone Xr](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/iphonexr/example.png) [828 x 1792] (2018) * Blue * Coral * PRODUCT RED * Silver * Space Gray * Yellow * [Google Pixel](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/pixel/example.png) [1080 x 1920] (2016) * Quite Black * Really Blue * Very Silver * [Google Pixel 4](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/pixel4/example.png) [1080 x 2280] (2019) * Clearly White * Just Black * Oh So Orange * [Google Pixel 4 XL](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/pixel4xl/example.png) [1440 x 3040] (2019) * Clearly White * Just Black * Oh So Orange * [Google Pixel 5](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/pixel5/example.png) [1080 x 2340] (2020) * Just Black * Sorta Sage ### Computers * [Apple iMac 21"](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/imac212015/example.png) [4096 x 2304] (2015) * Silver * [Apple iMac 24"](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/imac242021/example.png) [4480 x 2520] (2021) * Blue * Green * Orange * Pink * Purple * Silver * Yellow * [Apple MacBook 12"](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/macbook122016/example.png) [2304 x 1440] (2016) * Gold * Space Gray * [Apple MacBook Pro 13"](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/macbookpro132015/example.png) [2560 x 1600] (2015) * Silver * [Apple MacBook Pro 15"](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/macbookpro152015/example.png) [2880 x 1800] (2015) * Silver * [Apple MacBook Pro 16"](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/macbookpro162019/example.png) [3072 x 1920] (2019) * Space Gray * [Apple MacBook Pro 16"](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/macbookpro162021/example.png) [3456 x 2234] (2021) * Silver * Space Gray ### Tablets * [Apple iPad 9](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/ipad9/example.png) [2160 x 1620] (2021) * Gold * Silver * Space Gray * [Apple iPad Air 4](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/ipadair4/example.png) [2360 x 1640] (2020) * Green * Rose Gold * Silver * Sky Blue * Space Gray * [Apple iPad Mini 5](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/ipadmini5/example.png) [2048 x 1536] (2021) * Gold * Silver * Space Gray * [Apple iPad Pro 4 11"](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/ipadpro114/example.png) [2388 x 1668] (2020) * Silver * Space Gray * [Apple iPad Pro 4 12.9"](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/ipadpro134/example.png) [2732 x 2048] (2020) * Silver * Space Gray ### Wearable devices * [Apple Watch Series 6 44mm](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/watchseries644mm/example.png) [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](https://github.com/ulbwazhine/MockupEngineer). ## Links [](https://ulbwa.github.io) [](https://github.com/ulbwazhine/MockupEngineer) [](https://pypi.org/project/MockupEngineer) [](https://ulbwa.github.io/go?to=donate)