MockupEngineer

An simple library for creating beautiful screenshots.

## Navigation * [Example](https://github.com/ulbwazhine/MockupEngineer#example) * [Install](https://github.com/ulbwazhine/MockupEngineer#install) * [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) * [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 ``` ## 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 ### 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 ### Computers * [Apple MacBook 12"](https://raw.githubusercontent.com/ulbwazhine/MockupEngineer/main/MockupEngineer/templates/macbook122016/example.png) [2304 x 1440] (2016) * Gold * 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)